update javadoc for utils methods

Author: JavaSaBr

rlib-common/src/main/java/com/ss/rlib/common/util/ArrayUtils.java

@@ -158,10 +158,11 @@ public static <T> void fill(@NotNull T[] array, @NotNull IntFunction<T> factory)
     /**
      * Fill the array using the factory.
      *
+     * @param <T>      the element's type.
+     * @param <F>      the argument's type.
      * @param array    the array.
      * @param argument the additional argument.
      * @param factory  the element's factory.
-     * @param <T>      the element's type.
      */
     public static <T, F> void fill(@NotNull T[] array, @Nullable F argument, @NotNull Function<F, T> factory) {
         for (int i = 0; i < array.length; i++) {
@@ -577,6 +578,7 @@ public static <T> void sort(@NotNull final T[] array, final int fromIndex, final
     /**
      * Convert the array to a string presentation.
      *
+     * @param <T>      the element's type.
      * @param array    the array.
      * @param toString the to string function.
      * @return the string presentation.
@@ -587,11 +589,11 @@ public static <T> void sort(@NotNull final T[] array, final int fromIndex, final
             return "[]";
         }
 
-        String className = array.array()
+        var className = array.array()
                 .getClass()
                 .getSimpleName();
 
-        StringBuilder builder = new StringBuilder(className.substring(0, className.length() - 1));
+        var builder = new StringBuilder(className.substring(0, className.length() - 1));
 
         for (int i = 0, length = array.size() - 1; i <= length; i++) {
 
@@ -1890,11 +1892,12 @@ public static boolean isEmpty(@Nullable double[] array) {
     /**
      * Create a new array with mapped each element from source array.
      *
+     * @param <T>        the source component type.
+     * @param <M>        the mapped element's type.
+     * @param <R>        the result element's type.
      * @param source     the source array.
      * @param mapper     the mapper.
      * @param resultType the result component type.
-     * @param <T>        the source component type.
-     * @param <R>        the result component type.
      * @return the mapped array or null.
      * @since 9.3.0
      */

rlib-common/src/main/java/com/ss/rlib/common/util/ObjectUtils.java

@@ -17,13 +17,20 @@
 public final class ObjectUtils {
 
     /**
+     * @param <T>     the object's type.
+     * @param obj     the object to check on not null.
+     * @param message the message for exception if the object is null.
+     * @return the passed object if it is not null.
      * @see Objects#requireNonNull(Object, String)
      */
     public static <T> @NotNull T notNull(@Nullable T obj, @NotNull String message) {
         return Objects.requireNonNull(obj, message);
     }
 
     /**
+     * @param <T> the object's type.
+     * @param obj the object to check on not null.
+     * @return the passed object if it is not null.
      * @see Objects#requireNonNull(Object)
      */
     public static <T> @NotNull T notNull(@Nullable T obj) {
@@ -33,6 +40,7 @@ public final class ObjectUtils {
     /**
      * Check the object to be not null. If the object is null this method throws an exception from the supplier.
      *
+     * @param <T>      the object's type.
      * @param obj      the checked object.
      * @param supplier the exception factory.
      * @return the object.
@@ -50,6 +58,8 @@ public final class ObjectUtils {
     /**
      * Check the object to be not null. If the object is null this method throws an exception from the factory.
      *
+     * @param <T>     the object's type.
+     * @param <F>     the argument's type.
      * @param obj     the checked object.
      * @param arg     the argument for the exception factory.
      * @param factory the exception factory.
@@ -72,6 +82,7 @@ public final class ObjectUtils {
     /**
      * Check the object to be not null. If the object is null this method throws an exception from the factory.
      *
+     * @param <T>     the object's type.
      * @param obj     the checked object.
      * @param arg     the argument for the exception factory.
      * @param factory the exception factory.

rlib-common/src/main/java/com/ss/rlib/common/util/StringUtils.java

@@ -452,9 +452,9 @@ public static int length(@Nullable String string) {
      * Replace the variables in the string.
      *
      * @param string the source string.
-     * @param params the variable's parameters, name -> val, name -> val.
+     * @param params the variable's parameters, name -> val, name -> val.
      * @return result string.
-     * @throws IllegalArgumentException if params count < 2 or % 2 != 0
+     * @throws IllegalArgumentException if params count &lt; 2 or % 2 != 0
      */
     public static @NotNull String replace(@NotNull String string, @NotNull String... params) {
 

rlib-common/src/main/java/com/ss/rlib/common/util/Utils.java

@@ -276,6 +276,7 @@ public static <F, S> void unchecked(
      * @param <R>      the result's type.
      * @param argument the argument.
      * @param function the function.
+     * @param def      the default value.
      * @return the result or null.
      * @since 9.3.0
      */
@@ -296,7 +297,8 @@ public static <F, S> void unchecked(
      * Try to execute a function with some result and convert this result to another.
      *
      * @param <F>             the argument's type.
-     * @param <R>             the result's type.
+     * @param <R>             the function result's type.
+     * @param <FR>            the converter result's type.
      * @param argument        the argument.
      * @param function        the function.
      * @param resultConverter the result converter.

rlib-mail/src/main/java/com/ss/rlib/mail/sender/MailSender.java

@@ -25,7 +25,7 @@ public interface MailSender {
      * @param subject the subject.
      * @param content the email's content.
      * @return the async result of sending process.
-     * @throws CompletionException -> UncheckedMessagingException if something was wrong.
+     * @throws CompletionException -> UncheckedMessagingException if something was wrong.
      */
     @NotNull CompletableFuture<Void> sendAsync(@NotNull String email, @NotNull String subject, @NotNull String content);
 }