update some utils methods

Author: JavaSaBr

build.gradle

@@ -8,7 +8,7 @@ buildscript {
     }
 }
 
-rootProject.version = '9.2.1'
+rootProject.version = '9.3.0'
 group = 'com.spaceshift'
 
 allprojects {

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

@@ -1,6 +1,9 @@
 package com.ss.rlib.common.util;
 
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Optional;
 
 /**
  * The utility class.
@@ -87,6 +90,64 @@ public static short getShort(@NotNull byte[] bytes, int offset) {
         return (short) (bytes[offset + 1] << 8 | bytes[offset] & 0xff);
     }
 
+    /**
+     * Return true if a string is not null and can be converted to a long.
+     *
+     * @param string the string to convert.
+     * @return if the string is not null and can be converted to a long.
+     */
+    public static boolean isLong(@Nullable String string) {
+
+        if (string == null) {
+            return false;
+        } else {
+            try {
+                Long.parseLong(string);
+                return true;
+            } catch (NumberFormatException e) {
+                return false;
+            }
+        }
+    }
+
+    /**
+     * Convert a string to long object or null if this string is null or not a number.
+     *
+     * @param string the string to convert.
+     * @return the long object or null.
+     */
+    public static @Nullable Long safeToLong(@Nullable String string) {
+
+        if (string == null) {
+            return null;
+        } else {
+            try {
+                return Long.valueOf(string);
+            } catch (NumberFormatException e) {
+                return null;
+            }
+        }
+    }
+
+    /**
+     * Convert a string to long object.
+     *
+     * @param string the string to convert.
+     * @return the optional of long object.
+     */
+    public static @NotNull Optional<Long> toOptionalLong(@Nullable String string) {
+
+        if (string == null) {
+            return Optional.empty();
+        } else {
+            try {
+                return Optional.of(Long.valueOf(string));
+            } catch (NumberFormatException e) {
+                return Optional.empty();
+            }
+        }
+    }
+
     private NumberUtils() {
         throw new IllegalArgumentException();
     }

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

@@ -8,8 +8,10 @@
 import java.math.BigInteger;
 import java.security.MessageDigest;
 import java.security.NoSuchAlgorithmException;
+import java.time.Instant;
+import java.time.format.DateTimeFormatter;
+import java.time.temporal.TemporalAccessor;
 import java.util.concurrent.ThreadLocalRandom;
-import java.util.regex.Matcher;
 import java.util.regex.Pattern;
 
 /**
@@ -30,6 +32,9 @@ public class StringUtils {
     private static final ThreadLocal<MessageDigest> LOCAL_HASH_MD =
             ThreadLocal.withInitial(StringUtils::getHashMD5);
 
+    private static final DateTimeFormatter TIMESTAMP_FORMETTER =
+        DateTimeFormatter.ofPattern("HH:mm:ss:SSS");
+
     /**
      * Return an empty string if the received string is null.
      *
@@ -51,10 +56,30 @@ public class StringUtils {
         return isEmpty(string) ? another : string;
     }
 
+    /**
+     * Format a time to a string by pattern HH:mm:ss:SSS
+     *
+     * @param timestamp the timestamp.
+     * @return the string presentation.
+     */
+    public static @NotNull String formatTimestamp(long timestamp) {
+        return TIMESTAMP_FORMETTER.format(Instant.ofEpochMilli(timestamp));
+    }
+
+    /**
+     * Format some temporal accessor to a string by pattern HH:mm:ss:SSS
+     *
+     * @param temporal the timestamp.
+     * @return the string presentation.
+     */
+    public static @NotNull String formatTimestamp(@NotNull TemporalAccessor temporal) {
+        return TIMESTAMP_FORMETTER.format(temporal);
+    }
+
     /**
      * @see #isValidEmail(String)
      */
-    @Deprecated
+    @Deprecated(forRemoval = true)
     public static boolean checkEmail(@NotNull String email) {
         var matcher = EMAIL_PATTERN.matcher(email);
         return matcher.matches();