Class StringUtil

java.lang.Object
org.apache.openjpa.lib.util.StringUtil

public final class StringUtil extends Object
  • Method Details

    • isEmpty

      public static boolean isEmpty(String val)
      Returns:
      true if the given string is null or empty.
    • isNotEmpty

      public static boolean isNotEmpty(String val)
    • isBlank

      public static boolean isBlank(CharSequence cs)

      Checks if a CharSequence is whitespace, empty ("") or null.

       StringUtils.isBlank(null)      = true
       StringUtils.isBlank("")        = true
       StringUtils.isBlank(" ")       = true
       StringUtils.isBlank("bob")     = false
       StringUtils.isBlank("  bob  ") = false
       
      Ported over from Apache commons-lang3
      Parameters:
      cs - the CharSequence to check, may be null
      Returns:
      true if the CharSequence is null, empty or whitespace
    • isNotBlank

      public static boolean isNotBlank(CharSequence cs)

      Checks if a CharSequence is not empty (""), not null and not whitespace only.

       StringUtils.isNotBlank(null)      = false
       StringUtils.isNotBlank("")        = false
       StringUtils.isNotBlank(" ")       = false
       StringUtils.isNotBlank("bob")     = true
       StringUtils.isNotBlank("  bob  ") = true
       
      Ported over from Apache commons-lang3
      Parameters:
      cs - the CharSequence to check, may be null
      Returns:
      true if the CharSequence is not empty and not null and not whitespace
    • contains

      public static boolean contains(String val, char charToSearchFor)
      Parameters:
      val - the string to search in
      charToSearchFor - the character to search for
      Returns:
      true if the charToSearchFor is contained in the String val
    • equalsIgnoreCase

      public static boolean equalsIgnoreCase(String str1, String str2)
    • split

      public static String[] split(String str, String token, int max)
      Splits the given string on the given token. Follows the semantics of the Java 1.4 String.split(String, int) method, but does not treat the given token as a regular expression.
    • replace

      public static String replace(String str, String from, String to)
      Replace all instances of from in str with to.
      Parameters:
      str - the candidate string to replace
      from - the token to replace
      to - the new token
      Returns:
      the string with all the replacements made
    • trim

      public static String trim(String str)
      Null-safe String.trim()
    • trimToNull

      public static String trimToNull(String str)
      Returns:
      the trimmed string str or null if the trimmed string would be empty.
    • join

      public static String join(Object[] values, String joinToken)
    • parse

      public static <T> T parse(String val, Class<T> type)
      Parse the given
      Parameters:
      val - value to parse
      type - the target type of the the parsed value
      Returns:
      the converted value
    • capitalize

      public static String capitalize(String str)

      Capitalizes a String changing the first letter to title case as per Character.toTitleCase(char). No other letters are changed.

       StringUtil.capitalize(null)  = null
       StringUtil.capitalize("")    = ""
       StringUtil.capitalize("cat") = "Cat"
       StringUtil.capitalize("cAt") = "CAt"
       
      Ported over from Apache commons-lang3
      Parameters:
      str - the String to capitalize, may be null
      Returns:
      the capitalized String, null if null String input
      See Also:
    • uncapitalize

      public static String uncapitalize(String str)

      Uncapitalizes a String changing the first letter to title case as per Character.toLowerCase(char). No other letters are changed.

       StringUtil.uncapitalize(null)  = null
       StringUtil.uncapitalize("")    = ""
       StringUtil.uncapitalize("Cat") = "cat"
       StringUtil.uncapitalize("CAT") = "cAT"
       
      Ported over from Apache commons-lang3
      Parameters:
      str - the String to uncapitalize, may be null
      Returns:
      the uncapitalized String, null if null String input
      See Also:
    • endsWithIgnoreCase

      public static boolean endsWithIgnoreCase(String str, String suffix)
    • stripEnd

      public static String stripEnd(String str, String stripChars)

      Strips any of a set of characters from the end of a String.

      A null input String returns null. An empty string ("") input returns the empty string.

      If the stripChars String is null, whitespace is stripped as defined by Character.isWhitespace(char).

       StringUtils.stripEnd(null, *)          = null
       StringUtils.stripEnd("", *)            = ""
       StringUtils.stripEnd("abc", "")        = "abc"
       StringUtils.stripEnd("abc", null)      = "abc"
       StringUtils.stripEnd("  abc", null)    = "  abc"
       StringUtils.stripEnd("abc  ", null)    = "abc"
       StringUtils.stripEnd(" abc ", null)    = " abc"
       StringUtils.stripEnd("  abcyx", "xyz") = "  abc"
       StringUtils.stripEnd("120.00", ".0")   = "12"
       
      Ported over from Apache commons-lang3
      Parameters:
      str - the String to remove characters from, may be null
      stripChars - the set of characters to remove, null treated as whitespace
      Returns:
      the stripped String, null if null String input