Class StringUtil

java.lang.Object
org.seppiko.commons.utils.StringUtil

public class StringUtil extends Object
String utility
Author:
Leonard Woo
  • Field Details

    • BETWEEN

      protected static final Integer BETWEEN
      between '!' and {!} number
  • Method Details

    • requireNonBlank

      public static CharSequence requireNonBlank(CharSequence value) throws NullPointerException
      Require a CharSequence with default value.
      Parameters:
      value - CharSequence instance.
      Returns:
      CharSequence without null.
      Throws:
      NullPointerException - If value is null, throw this.
    • requireNonBlankElse

      public static CharSequence requireNonBlankElse(CharSequence value, CharSequence defaultValue)
      Require a CharSequence with default value.
      Parameters:
      value - CharSequence instance.
      defaultValue - default CharSequence instance.
      Returns:
      CharSequence without null.
    • isNullOrEmpty

      public static boolean isNullOrEmpty(CharSequence value)
      Test CharSequence is empty or contains only whitespace codepoints
      Parameters:
      value - CharSequence instance.
      Returns:
      true is yes.
    • hasLength

      public static boolean hasLength(CharSequence input)
      Test CharSequence has any char
      Parameters:
      input - CharSequence instance.
      Returns:
      true is yes.
    • hasText

      public static boolean hasText(CharSequence input)
      Test CharSequence has any char without non-blank character
      Parameters:
      input - CharSequence instance.
      Returns:
      true is not null and without whitespace, false is otherwise.
    • nonText

      public static boolean nonText(CharSequence input)
      Test CharSequence is not null and empty or has non-blank character
      Parameters:
      input - CharSequence instance.
      Returns:
      true is not null and empty, false is otherwise.
    • isUppercase

      public static boolean isUppercase(CharSequence input)
      Test CharSequence is uppercase
      Parameters:
      input - uppercase CharSequence.
      Returns:
      true is uppercase.
    • isLowercase

      public static boolean isLowercase(CharSequence input)
      Test CharSequence is lowercase
      Parameters:
      input - lowercase CharSequence.
      Returns:
      true is lowercase.
    • isNumeric

      public static boolean isNumeric(CharSequence input)
      Test CharSequence is numeric
      Parameters:
      input - numeric CharSequence.
      Returns:
      true is numeric.
    • isInteger

      public static boolean isInteger(CharSequence input)
      Test CharSequence is integer
      Parameters:
      input - integer CharSequence.
      Returns:
      true is integer.
    • isDecimal

      public static boolean isDecimal(CharSequence input)
      Test CharSequence is decimal
      Parameters:
      input - decimal CharSequence.
      Returns:
      true is decimal.
    • isPunctuation

      public static boolean isPunctuation(CharSequence input)
      Test CharSequence is punctuation
      Parameters:
      input - punctuation CharSequence.
      Returns:
      true is punctuation.
    • isAlphaNum

      public static boolean isAlphaNum(CharSequence input)
      Test CharSequence is alphabet or numeric
      Parameters:
      input - alphabet or numeric CharSequence.
      Returns:
      true is alphabet or numeric.
    • transcoding

      public static String transcoding(CharSequence data, Charset oldEncoding, Charset newEncoding) throws NullPointerException
      Convert string data from old encoding to new encoding
      Parameters:
      data - CharSequence data.
      oldEncoding - old encoding.
      newEncoding - new encoding.
      Returns:
      new encoding CharSequence.
      Throws:
      NullPointerException - old encode or new decode exception.
    • fixedLengthWithPreChar

      public static String fixedLengthWithPreChar(String str, int length, char preChar)
      Return fixed length string
      Parameters:
      str - string object.
      length - count length.
      preChar - pre-padded character.
      Returns:
      fixed length string object.
    • fixedLengthWithFillChar

      public static String fixedLengthWithFillChar(String str, int length, char fillChar)
      Return fixed length string
      Parameters:
      str - string.
      length - count length.
      fillChar - fill character.
      Returns:
      fixed length string.
    • cuts

      public static String[] cuts(String str, String sep)
      Cut slices str around the first instance of sep, returning the text before and after sep. The found result reports whether sep appears in str. If sep does not appear in str, cut returns [str, ""].
      Parameters:
      str - string.
      sep - separator.
      Returns:
      string array [before, after].
    • toFirstUpperCase

      public static String toFirstUpperCase(String input)
      Capitalize the first letter
      Parameters:
      input - origin string.
      Returns:
      new string.
    • replaceBetween

      public static String replaceBetween(CharSequence data, int start, int end, CharSequence replacement)
      Replace CharSequence between start and end
      Parameters:
      data - origin data.
      start - replace start index.
      end - replace end index.
      replacement - replace data.
      Returns:
      new string.
    • convertJoinerString

      public static String convertJoinerString(String delimiter, String... strs)
      convert joiner string with delimiter
      Parameters:
      delimiter - the sequence of characters to be used between each array element.
      strs - string array.
      Returns:
      the string representation.
    • convertToString

      public static String convertToString(CharSequence input, int splitNum, String split)
      Convert Char Sequence to String with separate
      Parameters:
      input - Raw data.
      splitNum - Separation interval.
      split - Separator.
      Returns:
      encoded string.
    • convertToCharArray

      public static char[] convertToCharArray(String src, String separator) throws NullPointerException
      Delete string separator and to char array.
      Parameters:
      src - string.
      separator - separator.
      Returns:
      char array.
      Throws:
      NullPointerException - when data or separator is null.
    • toFullWidth

      public static String toFullWidth(CharSequence src)
      Convert half-width string ('\u0021' through '\u007E') to full-width string ('\uFF01' through '\uFF5E')
      Parameters:
      src - Half-width string.
      Returns:
      Full-width string.
    • toHalfWidth

      public static String toHalfWidth(CharSequence src)
      Convert full-width string ('\uFF01' through '\uFF5E') to half-width string ('\u0021' through '\u007E')
      Parameters:
      src - Full-width string.
      Returns:
      Half-width string.
    • unicodeDecode

      public static String unicodeDecode(String src)
      Unicode decoding. When not found return origin String
      Parameters:
      src - unicode string like '\\uXXXX'.
      Returns:
      String. If src is null or empty return empty string.
    • unicodeEncode

      public static String unicodeEncode(String src)
      Unicode encoding
      Parameters:
      src - String
      Returns:
      unicode string like '\\uXXXX'. If src is null or empty return empty string.