update Java doc & README.md

README.md

@@ -38,11 +38,11 @@ Convenient Utilities for Vert.x [`Future`](https://vertx.io/docs/apidocs/io/vert
 - [x] Java 15
 
 ### Vert.x
-- [x] 3.9.1
-- [x] 4.0.0 ([with `vertx-core` excluded](#with-vertx-core-excluded))
+- [x] 4.0.0
 - [x] 3.9.4 ([with `vertx-core` excluded](#with-vertx-core-excluded))
 - [x] 3.9.3 ([with `vertx-core` excluded](#with-vertx-core-excluded))
 - [x] 3.9.2 ([with `vertx-core` excluded](#with-vertx-core-excluded))
+- [x] 3.9.1 ([with `vertx-core` excluded](#with-vertx-core-excluded))
 - [x] 3.9.0 ([with `vertx-core` excluded](#with-vertx-core-excluded))
 - [x] 3.8.5 ([with `vertx-core` excluded](#with-vertx-core-excluded))
 
@@ -61,26 +61,26 @@ Convenient Utilities for Vert.x [`Future`](https://vertx.io/docs/apidocs/io/vert
 <dependency>
   <groupId>me.hltj</groupId>
   <artifactId>vertx-future-utils</artifactId>
-  <version>1.0.1</version>
+  <version>1.1.0</version>
 </dependency>
 ```
 
 ### Gradle Kotlin DSL
 
 ``` kotlin
-implementation(group = "me.hltj", name = "vertx-future-utils", version = "1.0.1")
+implementation(group = "me.hltj", name = "vertx-future-utils", version = "1.1.0")
 ```
 
 ### Gradle Groovy DSL
 
 ``` groovy
-implementation 'me.hltj:vertx-future-utils:1.0.1'
+implementation 'me.hltj:vertx-future-utils:1.1.0'
 ```
 
 ### With `vertx-core` Excluded
 
-The default dependent version of `io.vertx:vertx-core` is `3.9.1`, if you want to use `vertx-future-utils`
-with `vertx-core` `3.8.5`/`3.9.0`/`3.9.2` to `3.9.4`/`4.0.0`, please exclude the default one.
+The default dependent version of `io.vertx:vertx-core` is `4.0.0`, if you want to use `vertx-future-utils`
+with `vertx-core` `3.8.5` or `3.9.0` to `3.9.4`, please exclude the default one.
 
 <details>
 
@@ -90,7 +90,7 @@ with `vertx-core` `3.8.5`/`3.9.0`/`3.9.2` to `3.9.4`/`4.0.0`, please exclude the
 <dependency>
   <groupId>me.hltj</groupId>
   <artifactId>vertx-future-utils</artifactId>
-  <version>1.0.1</version>
+  <version>1.1.0</version>
   <exclusions>
     <exclusion>
       <groupId>io.vertx</groupId>
@@ -103,15 +103,15 @@ with `vertx-core` `3.8.5`/`3.9.0`/`3.9.2` to `3.9.4`/`4.0.0`, please exclude the
 #### for Gradle Kotlin DSL
 
 ``` kotlin
-implementation(group = "me.hltj", name = "vertx-future-utils", version = "1.0.1") {
+implementation(group = "me.hltj", name = "vertx-future-utils", version = "1.1.0") {
     exclude(group = "io.vertx", module = "vertx-core")
 }
 ```
 
 #### for Gradle Groovy DSL
 
 ``` groovy
-implementation 'me.hltj:vertx-future-utils:1.0.1', {
+implementation 'me.hltj:vertx-future-utils:1.1.0', {
     exclude group: "io.vertx", module: "vertx-core"
 }
 ```

src/main/java/me/hltj/vertx/FutureExtensions.java

@@ -1,11 +1,17 @@
 package me.hltj.vertx;
 
 import io.vertx.core.Future;
+import lombok.experimental.ExtensionMethod;
 
 import java.util.Optional;
 import java.util.function.Function;
 import java.util.function.Supplier;
 
+/**
+ * For working with lombok {@link ExtensionMethod}.
+ *
+ * @since 1.1.0
+ */
 public final class FutureExtensions {
 
     private FutureExtensions() {

src/main/java/me/hltj/vertx/FutureUtils.java

@@ -87,6 +87,7 @@ public static <T> Future<T> defaultWith(Future<T> future, Supplier<T> supplier)
      * @param supplier a supplier to get the default {@code Future}
      * @param <T>      the type parameter of the {@code Future}
      * @return the result {@code Future}
+     * @since 1.1.0
      */
     public static <T> Future<T> flatDefaultWith(Future<T> future, Supplier<Future<T>> supplier) {
         return future.flatMap(x -> x == null ? supplier.get() : Future.succeededFuture(x));
@@ -139,6 +140,7 @@ public static <T> Future<T> fallbackWith(Future<T> future, Function<Throwable, T
      * @param function a function to get the default {@code Future}
      * @param <T>      the type parameter of the {@code Future}
      * @return the result {@code Future}
+     * @since 1.1.0
      */
     public static <T> Future<T> flatFallbackWith(Future<T> future, Function<Optional<Throwable>, Future<T>> function) {
         return flatFallbackWith(future, function.compose(Optional::of), () -> function.apply(Optional.empty()));
@@ -152,6 +154,7 @@ public static <T> Future<T> flatFallbackWith(Future<T> future, Function<Optional
      * @param supplier a function to get the default {@code Future} on success with null
      * @param <T>      the type parameter of the {@code Future}
      * @return the result {@code Future}
+     * @since 1.1.0
      */
     public static <T> Future<T> flatFallbackWith(
             Future<T> future, Function<Throwable, Future<T>> mapper, Supplier<Future<T>> supplier
@@ -165,6 +168,7 @@ public static <T> Future<T> flatFallbackWith(
      * @param future the {@code Future}
      * @param <T>    the type parameter of the {@code Future}
      * @return the result {@code Future}
+     * @since 1.1.0
      */
     public static <T> Future<T> nonEmpty(Future<T> future) {
         return flatDefaultWith(future, () -> Future.failedFuture(new NullPointerException()));
@@ -182,6 +186,7 @@ public static <T> Future<T> nonEmpty(Future<T> future) {
      * @param <T>    the type parameter of the {@code Future}
      * @param <R>    the type parameter of the result {@code Future}
      * @return the result {@code Future}
+     * @since 1.1.0
      */
     public static <T, R> Future<R> mapSome(Future<T> future, Function<T, R> mapper) {
         return future.map(v -> v == null ? null : mapper.apply(v));
@@ -199,6 +204,7 @@ public static <T, R> Future<R> mapSome(Future<T> future, Function<T, R> mapper)
      * @param <T>    the type parameter of the {@code Future}
      * @param <R>    the type parameter of the result {@code Future}
      * @return the result {@code Future}
+     * @since 1.1.0
      */
     public static <T, R> Future<R> flatMapSome(Future<T> future, Function<T, Future<R>> mapper) {
         return future.flatMap(v -> v == null ? Future.succeededFuture() : mapper.apply(v));