Module org.omnifaces.utils
Package org.omnifaces.utils

Class Lang

java.lang.Object
org.omnifaces.utils.Lang
public final class Lang extends Object

  • Method Details

    • isEmpty

      public static boolean isEmpty(String string)
      Returns true if the given string is null or is empty.
      Parameters:
      string - The string to be checked on emptiness.
      Returns:
      true if the given string is null or is empty.

    • isEmpty

      public static boolean isEmpty(Object[] array)
      Returns true if the given array is null or is empty.
      Parameters:
      array - The array to be checked on emptiness.
      Returns:
      true if the given array is null or is empty.

    • isEmpty

      public static boolean isEmpty(Collection<?> collection)
      Returns true if the given collection is null or is empty.
      Parameters:
      collection - The collection to be checked on emptiness.
      Returns:
      true if the given collection is null or is empty.

    • isEmpty

      public static boolean isEmpty(Map<?,?> map)
      Returns true if the given map is null or is empty.
      Parameters:
      map - The map to be checked on emptiness.
      Returns:
      true if the given map is null or is empty.

    • isEmpty

      public static boolean isEmpty(Object value)
      Returns true if the given value is null or is empty. Types of String, Collection, Map, Optional and Array are recognized. If none is recognized, then examine the emptiness of the toString() representation instead.
      Parameters:
      value - The value to be checked on emptiness.
      Returns:
      true if the given value is null or is empty.

    • isAllEmpty

      public static boolean isAllEmpty(Object... values)
      Returns true if all values are empty, false if at least one value is not empty.
      Parameters:
      values - the values to be checked on emptiness
      Returns:
      True if all values are empty, false otherwise

    • isAnyEmpty

      public static boolean isAnyEmpty(Object... values)
      Returns true if at least one value is empty.
      Parameters:
      values - the values to be checked on emptiness
      Returns:
      true if any value is empty and false if no values are empty

    • isNotBlank

      public static boolean isNotBlank(String string)

    • requireNotEmpty

      public static <T, E extends Exception> T requireNotEmpty(T value, Supplier<E> exceptionSupplier) throws E
      Throws:
      E extends Exception

    • ifEmptyGet

      public static <T> T ifEmptyGet(T value, Supplier<T> defaultSupplier)

    • setIfNotEmpty

      public static <T> void setIfNotEmpty(T value, Consumer<? super T> setter)
      Call the given setter with the given value if isEmpty(Object) returns false for the given value.
      Type Parameters:
      T - the generic type of the value
      Parameters:
      value - the value to set
      setter - a consumer that calls the setter with the value

    • coalesce

      @SafeVarargs public static <T> T coalesce(T... objects)
      Returns the first non-null object of the argument list, or null if there is no such element.
      Type Parameters:
      T - The generic object type.
      Parameters:
      objects - The argument list of objects to be tested for non-null.
      Returns:
      The first non-null object of the argument list, or null if there is no such element.

    • isOneOf

      @SafeVarargs public static <T> boolean isOneOf(T object, T... objects)
      Returns true if the given object equals one of the given objects.
      Type Parameters:
      T - The generic object type.
      Parameters:
      object - The object to be checked if it equals one of the given objects.
      objects - The argument list of objects to be tested for equality.
      Returns:
      true if the given object equals one of the given objects.

    • startsWithOneOf

      public static boolean startsWithOneOf(String string, String... prefixes)
      Returns true if the given string starts with one of the given prefixes.
      Parameters:
      string - The string to be checked if it starts with one of the given prefixes.
      prefixes - The argument list of prefixes to be checked.
      Returns:
      true if the given string starts with one of the given prefixes.

    • endsWithOneOf

      public static boolean endsWithOneOf(String string, String... suffixes)
      Returns true if the given string ends with one of the given suffixes.
      Parameters:
      string - The string to be checked if it ends with one of the given suffixes.
      suffixes - The argument list of suffixes to be checked.
      Returns:
      true if the given string ends with one of the given suffixes.

    • replaceLast

      public static String replaceLast(String string, String regex, String replacement)
      Replaces the last substring of given string that matches the given regular expression with the given replacement. Author: https://stackoverflow.com/a/2282998
      Parameters:
      string - The string to be replaced.
      regex - The regular expression to which given string is to be matched.
      replacement - The string to be substituted for the last match.
      Returns:
      The resulting string.

    • containsIsoControlCharacters

      public static boolean containsIsoControlCharacters(String string)
      Returns true if the given string contains any ISO control characters.
      Parameters:
      string - the string to check for control characters
      Returns:
      true if the string contains any ISO control characters and false otherwise

    • capitalize

      public static String capitalize(String string)
      Converts the first character of given string to upper case.
      Parameters:
      string - String to be capitalized.
      Returns:
      The given string capitalized.

    • toTitleCase

      public static String toTitleCase(String string)
      Converts given string to title case.
      Parameters:
      string - String to be converted to title case.
      Returns:
      The given string converted to title case.

    • toUrlSafe

      public static String toUrlSafe(String string)
      Converts given string to URL safe format, also called a "slug".
      Parameters:
      string - String to be converted to URL safe format.
      Returns:
      The given string converted to URL safe format.

    • escapeAsProperty

      public static String escapeAsProperty(String string) throws IOException
      Escape given string as valid Properties entry value.
      Parameters:
      string - String to be escaped as valid Properties entry value.
      Returns:
      The given string escaped as valid Properties entry value.
      Throws:
      IOException - When appending a character fails.