Class Utils


  • public class Utils
    extends java.lang.Object
    Any kind of utility.
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String EOL
      Deprecated.
      New code should use LineSeparator.SYSTEM if referring to the current host system's line separator, else LineSeparator.CR or LineSeparator.LF or LineSeparator.CRLF if referring to a specific style of line separator.
      static java.lang.String SYSTEM_EOL
      Deprecated.
      Renamed from EOL to make it explicit that we're using the system's line separator.
    • Constructor Summary

      Constructors 
      Constructor Description
      Utils()  
    • Method Summary

      All Methods Static Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      static java.lang.String assertNonEmpty​(java.lang.String string)  
      static <T extends java.lang.Number>
      T
      assertNonNegative​(T number)  
      static <T> T assertNotNull​(T o)  
      static <T extends java.lang.Number>
      T
      assertPositive​(T number)  
      static java.lang.String camelCaseToScreaming​(java.lang.String input)  
      static java.lang.String capitalize​(java.lang.String s)
      Capitalizes the first character in the string.
      static java.lang.String decapitalize​(java.lang.String s)
      Lower-cases the first character in the string.
      static java.lang.String escapeEndOfLines​(java.lang.String string)  
      static boolean hasUnaryMinusAsParent​(Node n)
      Checks, if the parent is a unary expression with a minus operator.
      static java.lang.StringBuilder indent​(java.lang.StringBuilder builder, int indentLevel)
      Make an indent by appending indentLevel tab characters to the builder.
      static <E> int indexOfElementByObjectIdentity​(java.util.List<E> list, E o)
      Like List.indexOf(Object), but using ==, not equals.
      static <E> boolean isNullOrEmpty​(java.util.Collection<E> collection)  
      static java.lang.String nextWord​(java.lang.String string)
      Return the next word of the string, in other words it stops when a space is encountered.
      static java.lang.String normalizeEolInTextBlock​(java.lang.String content, LineSeparator desiredEndOfLineCharacter)  
      static java.lang.String normalizeEolInTextBlock​(java.lang.String content, java.lang.String desiredEndOfLineCharacter)  
      static java.lang.String readerToString​(java.io.Reader reader)  
      static <E> void removeElementByObjectIdentity​(java.util.List<E> list, E o)
      Like List.remove(Object), but using ==, not equals.
      static java.lang.String removeFileExtension​(java.lang.String filename)  
      static <E> void replaceElementByObjectIdentity​(java.util.List<E> list, E oldObject, E newObject)
      Like List.set(int, Object) at List.indexOf(Object), but using ==, not equals.
      static java.lang.String screamingToCamelCase​(java.lang.String original)
      Transform a string to the camel case conversion.
      static <T> java.util.Set<T> set​(T... items)  
      private static java.lang.String stringTransformer​(java.lang.String s, java.lang.String operationDescription, java.util.function.Function<java.lang.String,​java.lang.String> transformation)  
      static java.lang.String toCamelCase​(java.lang.String original)
      Deprecated.
      use screamingToCamelCase
      static java.lang.String trimTrailingSpaces​(java.lang.String line)
      Like String.trim(), but only the trailing spaces.
      static boolean valueIsNullOrEmpty​(java.lang.Object value)  
      static boolean valueIsNullOrEmptyStringOrOptional​(java.lang.Object value)  
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • SYSTEM_EOL

        @Deprecated
        public static final java.lang.String SYSTEM_EOL
        Deprecated.
        Renamed from EOL to make it explicit that we're using the system's line separator. New code should use LineSeparator.SYSTEM if referring to the current host system's line separator, else LineSeparator.CR or LineSeparator.LF or LineSeparator.CRLF if referring to a specific style of line separator.
    • Constructor Detail

      • Utils

        public Utils()
    • Method Detail

      • isNullOrEmpty

        public static <E> boolean isNullOrEmpty​(java.util.Collection<E> collection)
      • assertNotNull

        public static <T> T assertNotNull​(T o)
      • assertNonEmpty

        public static java.lang.String assertNonEmpty​(java.lang.String string)
      • assertNonNegative

        public static <T extends java.lang.Number> T assertNonNegative​(T number)
      • assertPositive

        public static <T extends java.lang.Number> T assertPositive​(T number)
      • escapeEndOfLines

        public static java.lang.String escapeEndOfLines​(java.lang.String string)
        Returns:
        string with ASCII characters 10 and 13 replaced by the text "\n" and "\r".
      • readerToString

        public static java.lang.String readerToString​(java.io.Reader reader)
                                               throws java.io.IOException
        Throws:
        java.io.IOException
      • toCamelCase

        @Deprecated
        public static java.lang.String toCamelCase​(java.lang.String original)
        Deprecated.
        use screamingToCamelCase
      • screamingToCamelCase

        public static java.lang.String screamingToCamelCase​(java.lang.String original)
        Transform a string to the camel case conversion.

        For example "ABC_DEF" becomes "abcDef"

      • camelCaseToScreaming

        public static java.lang.String camelCaseToScreaming​(java.lang.String input)
        Parameters:
        input - "aCamelCaseString"
        Returns:
        "A_CAMEL_CASE_STRING"
      • nextWord

        public static java.lang.String nextWord​(java.lang.String string)
        Return the next word of the string, in other words it stops when a space is encountered.
      • indent

        public static java.lang.StringBuilder indent​(java.lang.StringBuilder builder,
                                                     int indentLevel)
        Make an indent by appending indentLevel tab characters to the builder.
      • capitalize

        public static java.lang.String capitalize​(java.lang.String s)
        Capitalizes the first character in the string.
      • decapitalize

        public static java.lang.String decapitalize​(java.lang.String s)
        Lower-cases the first character in the string.
      • stringTransformer

        private static java.lang.String stringTransformer​(java.lang.String s,
                                                          java.lang.String operationDescription,
                                                          java.util.function.Function<java.lang.String,​java.lang.String> transformation)
      • valueIsNullOrEmpty

        public static boolean valueIsNullOrEmpty​(java.lang.Object value)
        Returns:
        true if the value is null, an empty Optional, or an empty String.
      • valueIsNullOrEmptyStringOrOptional

        public static boolean valueIsNullOrEmptyStringOrOptional​(java.lang.Object value)
      • replaceElementByObjectIdentity

        public static <E> void replaceElementByObjectIdentity​(java.util.List<E> list,
                                                              E oldObject,
                                                              E newObject)
        Like List.set(int, Object) at List.indexOf(Object), but using ==, not equals.
      • removeElementByObjectIdentity

        public static <E> void removeElementByObjectIdentity​(java.util.List<E> list,
                                                             E o)
        Like List.remove(Object), but using ==, not equals.
      • indexOfElementByObjectIdentity

        public static <E> int indexOfElementByObjectIdentity​(java.util.List<E> list,
                                                             E o)
        Like List.indexOf(Object), but using ==, not equals.
      • set

        @SafeVarargs
        public static <T> java.util.Set<T> set​(T... items)
        Returns:
        a set of the items.
      • normalizeEolInTextBlock

        public static java.lang.String normalizeEolInTextBlock​(java.lang.String content,
                                                               java.lang.String desiredEndOfLineCharacter)
        Returns:
        content, with all kinds of EOL characters replaced by desiredEndOfLineCharacter
      • normalizeEolInTextBlock

        public static java.lang.String normalizeEolInTextBlock​(java.lang.String content,
                                                               LineSeparator desiredEndOfLineCharacter)
        Returns:
        content, with all kinds of EOL characters replaced by desiredEndOfLineCharacter
      • removeFileExtension

        public static java.lang.String removeFileExtension​(java.lang.String filename)
        Returns:
        the filename with the last "." and everything following it removed.
      • trimTrailingSpaces

        public static java.lang.String trimTrailingSpaces​(java.lang.String line)
        Like String.trim(), but only the trailing spaces.
      • hasUnaryMinusAsParent

        public static boolean hasUnaryMinusAsParent​(Node n)
        Checks, if the parent is a unary expression with a minus operator. Used to check for negative literals.