Class StringUtils


  • public class StringUtils
    extends java.lang.Object
    Converts String to and from bytes using the encodings required by the Java specification. These encodings are specified in Standard charsets
    Since:
    1.4
    Version:
    $Id: StringUtils.java 801391 2009-08-05 19:55:54Z ggregory $
    Author:
    Gary Gregory
    See Also:
    CharEncoding, Standard charsets
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.lang.String UTF_8  
    • Constructor Summary

      Constructors 
      Constructor Description
      StringUtils()  
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static byte[] getBytesUnchecked​(java.lang.String string, java.lang.String charsetName)
      Encodes the given string into a sequence of bytes using the named charset, storing the result into a new byte array.
      static byte[] getBytesUtf8​(java.lang.String string)
      Encodes the given string into a sequence of bytes using the UTF-8 charset, storing the result into a new byte array.
      static java.lang.String newString​(byte[] bytes, java.lang.String charsetName)
      Constructs a new String by decoding the specified array of bytes using the given charset.
      static java.lang.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
    • Constructor Detail

      • StringUtils

        public StringUtils()
    • Method Detail

      • newString

        public static java.lang.String newString​(byte[] bytes,
                                                 java.lang.String charsetName)
        Constructs a new String by decoding the specified array of bytes using the given charset.

        This method catches UnsupportedEncodingException and re-throws it as IllegalStateException, which should never happen for a required charset name. Use this method when the encoding is required to be in the JRE.

        Parameters:
        bytes - The bytes to be decoded into characters
        charsetName - The name of a required Charset
        Returns:
        A new String decoded from the specified array of bytes using the given charset.
        Throws:
        java.lang.IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen for a required charset name.
        See Also:
        CharEncoding, String(byte[], String)
      • newStringUtf8

        public static java.lang.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 given charset.
        Throws:
        java.lang.IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen since the charset is required.
      • getBytesUtf8

        public static byte[] getBytesUtf8​(java.lang.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
        Returns:
        encoded bytes
        Throws:
        java.lang.IllegalStateException - Thrown when the charset is missing, which should be never according the the Java specification.
        See Also:
        Standard charsets, getBytesUnchecked(String, String)
      • getBytesUnchecked

        public static byte[] getBytesUnchecked​(java.lang.String string,
                                               java.lang.String charsetName)
        Encodes the given string into a sequence of bytes using the named charset, storing the result into a new byte array.

        This method catches UnsupportedEncodingException and rethrows it as IllegalStateException, which should never happen for a required charset name. Use this method when the encoding is required to be in the JRE.

        Parameters:
        string - the String to encode
        charsetName - The name of a required Charset
        Returns:
        encoded bytes
        Throws:
        java.lang.IllegalStateException - Thrown when a UnsupportedEncodingException is caught, which should never happen for a required charset name.
        See Also:
        CharEncoding, String.getBytes(String)