This is an automated email from the ASF dual-hosted git repository.
ahuber pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/causeway.git
The following commit(s) were added to refs/heads/master by this push:
new 839aedc2ad CAUSEWAY-3304: Try: java-doc fixes
839aedc2ad is described below
commit 839aedc2ad9b7e97ac97f16c221eb3d00f7c1627
Author: Andi Huber <[email protected]>
AuthorDate: Sun Feb 26 22:27:52 2023 +0100
CAUSEWAY-3304: Try: java-doc fixes
---
commons/src/main/java/org/apache/causeway/commons/functional/Try.java | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git
a/commons/src/main/java/org/apache/causeway/commons/functional/Try.java
b/commons/src/main/java/org/apache/causeway/commons/functional/Try.java
index 3fa5639f14..43c3585521 100644
--- a/commons/src/main/java/org/apache/causeway/commons/functional/Try.java
+++ b/commons/src/main/java/org/apache/causeway/commons/functional/Try.java
@@ -106,9 +106,11 @@ public interface Try<T> {
*/
Try<T> ifSuccess(final @NonNull ThrowingConsumer<Optional<T>>
valueConsumer);
/**
- * If this is a {@link Success} with a present {@code value}, peeks into
the {@code value}.
+ * If this is a {@link Success} peeks into the (null-able) {@code value}.
* <p>
* If given valueConsumer throws an exception, a failed {@link Try} is
returned.
+ * @apiNote If preceded with a call to {@link #mapEmptyToFailure()},
+ * the success value - as passed over to the valueConsumer - is
guaranteed non-null.
*/
Try<T> ifSuccessAsNullable(final @NonNull ThrowingConsumer<T>
valueConsumer);
/**
