Class StringUtils

java.lang.Object
com.google.api.client.util.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
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    Line separator to use for this OS, i.e.
  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    private
     
  • Method Summary

    Modifier and Type
    Method
    Description
    static byte[]
    Encodes the given string into a sequence of bytes using the UTF-8 charset, storing the result into a new byte array.
    static String
    newStringUtf8(byte[] bytes)
    Constructs a new String by decoding the specified array of bytes using the UTF-8 charset.

    Methods inherited from class java.lang.Object

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

    • LINE_SEPARATOR

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

    • StringUtils

      private StringUtils()
  • Method Details

    • 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:
    • 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[])