Class Strings


  • public final class Strings
    extends Object
    Utility methods related to Strings.
    Author:
    Alex Ruiz
    • Constructor Detail

      • Strings

        private Strings()
    • Method Detail

      • isNullOrEmpty

        public static boolean isNullOrEmpty​(String s)
        Indicates whether the given String is null or empty.
        Parameters:
        s - the String to check.
        Returns:
        true if the given String is null or empty, otherwise false.
      • quote

        public static String quote​(String s)
        Returns the given String surrounded by single quotes, or null if the given String is null.
        Parameters:
        s - the given String.
        Returns:
        the given String surrounded by single quotes, or null if the given String is null.
      • quote

        public static Object quote​(Object o)
        Returns the given object surrounded by single quotes, only if the object is a String.
        Parameters:
        o - the given object.
        Returns:
        the given object surrounded by single quotes, only if the object is a String.
        See Also:
        quote(String)
      • concat

        public static String concat​(Object... objects)
        Concatenates the given objects into a single String. This method is more efficient than concatenating using "+", since only one StringBuilder is created.
        Parameters:
        objects - the objects to concatenate.
        Returns:
        a String containing the given objects.
      • formatIfArgs

        public static String formatIfArgs​(String message,
                                          Object... args)
        Format with String.format(String, Object...) the given message iif some args have been given otherwise juts return the message.
        Parameters:
        message - the string to format
        args - args used to format the message, can be null or empty
        Returns:
        the formatted string if any args were given
      • escapePercent

        public static String escapePercent​(String value)
        Escape any % to %% to avoid interpreting it in String.format(String, Object...).
        Parameters:
        value - the String to escape
        Returns:
        the escaped String
      • join

        public static Strings.StringsToJoin join​(String... strings)
        Joins the given Strings using a given delimiter. The following example illustrates proper usage of this method:
         Strings.join("a", "b", "c").with("|");
        which will result in the String "a|b|c".
        Parameters:
        strings - the Strings to join.
        Returns:
        an intermediate object that takes a given delimiter and knows how to join the given Strings.
        See Also:
        Strings.StringsToJoin.with(String)
      • join

        public static Strings.StringsToJoin join​(Iterable<?> toStringable)
        Joins the given Objects using a given delimiter. The following example illustrates proper usage of this method:
         Strings.join(new ArrayList("a", "b", "c")).with("|");
        which will result in the String "a|b|c".
        Parameters:
        toStringable - the Objects to join.
        Returns:
        an intermediate object that takes a given delimiter and knows how to join the given Objects.
        See Also:
        Strings.StringsToJoin.with(String)
      • append

        public static Strings.StringToAppend append​(String toAppend)
        Appends a given String to the given target, only if the target does not end with the given String to append. The following example illustrates proper usage of this method:
         Strings.append("c").to("ab");
         Strings.append("c").to("abc");
        resulting in the String "abc" for both cases.
        Parameters:
        toAppend - the String to append.
        Returns:
        an intermediate object that takes the target String and knows to append the given String.
        See Also:
        Strings.StringToAppend.to(String)
      • escapePercentExceptWhenFollowedBy_n

        private static String escapePercentExceptWhenFollowedBy_n​(String message)
      • revertEscapingPercent_n

        private static String revertEscapingPercent_n​(String value)