Module is.codion.common.core
Package is.codion.common

Class Text

java.lang.Object
is.codion.common.Text
public final class Text extends Object
A utility class for working with text, such as sorting and reading from files

  • Field Details

    • DEFAULT_COLLATOR_LANGUAGE

      public static final PropertyValue<String> DEFAULT_COLLATOR_LANGUAGE
      Specifies the default collator locale language.
      Value type: String
      Default value: Locale.getDefault().getLanguage().
      See Also:

    • WILDCARD_CHARACTER

      public static final PropertyValue<Character> WILDCARD_CHARACTER
      Specifies the wildcard character used
      Value type: Character
      Default value: %

  • Method Details

    • randomString

      public static String randomString(int minimumLength, int maximumLength)
      Creates a random string from alphanumeric uppercase characters
      Parameters:
      minimumLength - the minimum length
      maximumLength - the maximum length
      Returns:
      a random string

    • collate

      public static <T> List<T> collate(List<T> values)
      Sorts the string representations of the list contents, using the space aware collator
      Type Parameters:
      T - the list element type
      Parameters:
      values - the list to sort (collate)
      Returns:
      the sorted list
      See Also:

    • collator

      public static <T> Comparator<T> collator()
      Creates a Comparator which compares the string representations of the objects using the default Collator, taking spaces into account.
      Type Parameters:
      T - the type of the objects to compare
      Returns:
      a space aware collator
      See Also:

    • collator

      public static <T> Comparator<T> collator(Locale locale)
      Creates a Comparator which compares the string representations of the objects using the default Collator, taking spaces into account.
      Type Parameters:
      T - the type of the objects to compare
      Parameters:
      locale - the collator locale
      Returns:
      a space aware collator
      See Also:

    • rightPad

      public static String rightPad(String string, int length, char padChar)
      Right pads the given string with the given pad character until a length of length has been reached
      Parameters:
      string - the string to pad
      length - the desired length
      padChar - the character to use for padding
      Returns:
      the padded string

    • leftPad

      public static String leftPad(String string, int length, char padChar)
      Left pads the given string with the given pad character until a length of length has been reached
      Parameters:
      string - the string to pad
      length - the desired length
      padChar - the character to use for padding
      Returns:
      the padded string

    • delimitedString

      public static String delimitedString(List<String> header, List<List<String>> lines, String columnDelimiter)
      Creates a delimited string from the given input lists.
      Parameters:
      header - the header
      lines - the lines
      columnDelimiter - the column delimiter
      Returns:
      a String comprised of the given header and lines using the given column delimiter

    • textFileContents

      public static <T> String textFileContents(Class<T> resourceClass, String resourceName) throws IOException
      Fetch the entire contents of a resource text file, and return it in a String, using the default Charset.
      Type Parameters:
      T - the resource class type
      Parameters:
      resourceClass - the resource class
      resourceName - the name of the resource to retrieve
      Returns:
      the contents of the resource file
      Throws:
      IOException - in case an IOException occurs

    • textFileContents

      public static <T> String textFileContents(Class<T> resourceClass, String resourceName, Charset charset) throws IOException
      Fetch the entire contents of a resource textfile, and return it in a String.
      Type Parameters:
      T - the resource class type
      Parameters:
      resourceClass - the resource class
      resourceName - the name of the resource to retrieve
      charset - the Charset to use when reading the file contents
      Returns:
      the contents of the resource file
      Throws:
      IOException - in case an IOException occurs

    • textFileContents

      public static String textFileContents(String filename, Charset charset) throws IOException
      Fetch the entire contents of a textfile, and return it in a String
      Parameters:
      filename - the name of the file
      charset - the charset to use
      Returns:
      the file contents as a String
      Throws:
      IOException - in case of an exception

    • textFileContents

      public static String textFileContents(File file, Charset charset) throws IOException
      Fetch the entire contents of a textfile, and return it in a String
      Parameters:
      file - the file
      charset - the charset to use
      Returns:
      the file contents as a String
      Throws:
      IOException - in case of an exception

    • textFileContents

      public static String textFileContents(InputStream inputStream, Charset charset) throws IOException
      Fetch the entire contents of an InputStream, and return it in a String. Does not close the stream.
      Parameters:
      inputStream - the input stream to read
      charset - the charset to use
      Returns:
      the stream contents as a String
      Throws:
      IOException - in case of an exception

    • parseCommaSeparatedValues

      public static List<String> parseCommaSeparatedValues(String commaSeparatedValues)
      Parses, splits and trims the given comma separated string. Returns an empty list in case of null or empty string argument.
      Parameters:
      commaSeparatedValues - a String with comma separated values
      Returns:
      the trimmed values