Class StringUtils


  • public class StringUtils
    extends Object
    Utilities for strings.

    Some of these methods are a proxy for version 1.6 (or newer) of the Apache Commons Codec StringUtils implementation. This is needed in order to support platforms like Android which already include an older version of the Apache Commons Codec (Android includes version 1.3). To avoid a dependency library conflict, this library includes a reduced private copy of version 1.6 (or newer) of the Apache Commons Codec (using a tool like jarjar).

    Since:
    1.8
    Author:
    Yaniv Inbar
    • Field Detail

      • LINE_SEPARATOR

        public static final String LINE_SEPARATOR
        Line separator to use for this OS, i.e. "\n" or "\r\n".
        Since:
        1.8
    • Method Detail

      • getBytesUtf8

        public static byte[] getBytesUtf8​(String string)
        Encodes the given string into a sequence of bytes using the UTF-8 charset, storing the result into a new byte array.
        Parameters:
        string - the String to encode, may be null
        Returns:
        encoded bytes, or null if the input string was null
        Throws:
        IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.
        Since:
        1.8
        See Also:
        Standard charsets, StringUtils.getBytesUtf8(String)
      • newStringUtf8

        public static String newStringUtf8​(byte[] bytes)
        Constructs a new String by decoding the specified array of bytes using the UTF-8 charset.
        Parameters:
        bytes - The bytes to be decoded into characters
        Returns:
        A new String decoded from the specified array of bytes using the UTF-8 charset, or null if the input byte array was null.
        Throws:
        IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the charset is required.
        Since:
        1.8
        See Also:
        StringUtils.newStringUtf8(byte[])