Class Text


  • public final class Text
    extends Object
    A utility class for working with text, such as sorting and reading from files
    • Method Detail

      • randomString

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

        public static void collate​(List<?> values)
        Sorts the string representations of the list contents, using the space aware collator
        Parameters:
        values - the list to sort (collate)
        See Also:
        spaceAwareCollator()
      • spaceAwareCollator

        public static <T> Comparator<T> spaceAwareCollator()
        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:
        DEFAULT_COLLATOR_LANGUAGE
      • spaceAwareCollator

        public static <T> Comparator<T> spaceAwareCollator​(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:
        DEFAULT_COLLATOR_LANGUAGE
      • collateSansSpaces

        public static void collateSansSpaces​(Collator collator,
                                             List<?> list)
        Collates the contents of the list, replacing spaces with underscores before sorting
        Parameters:
        collator - the collator
        list - the list
      • collateSansSpaces

        public static int collateSansSpaces​(Collator collator,
                                            String stringOne,
                                            String stringTwo)
        Collates the given strings after replacing spaces with underscores
        Parameters:
        collator - the collator to use
        stringOne - the first string
        stringTwo - the second string
        Returns:
        the collation result
      • padString

        public static String padString​(String string,
                                       int length,
                                       char padChar,
                                       Text.Alignment alignment)
        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
        alignment - the padding alignment, left or right side
        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
      • underscoreToCamelCase

        public static String underscoreToCamelCase​(String text)
        Converts a string with underscores into a camelCaseString. Just don't use this, it's far from bulletproof.
        Parameters:
        text - the text
        Returns:
        a camelCase version of the given text