Package org.apache.wicket.util.crypt

Class StringUtils

    • Constructor Summary

      Constructors 
      Constructor Description
      StringUtils()  

    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static byte[] getBytesIso8859_1​(java.lang.String string)
      Encodes the given string into a sequence of bytes using the ISO-8859-1 charset, storing the result into a new byte array.
      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[] getBytesUsAscii​(java.lang.String string)
      Encodes the given string into a sequence of bytes using the US-ASCII charset, storing the result into a new byte array.
      static byte[] getBytesUtf16​(java.lang.String string)
      Encodes the given string into a sequence of bytes using the UTF-16 charset, storing the result into a new byte array.
      static byte[] getBytesUtf16Be​(java.lang.String string)
      Encodes the given string into a sequence of bytes using the UTF-16BE charset, storing the result into a new byte array.
      static byte[] getBytesUtf16Le​(java.lang.String string)
      Encodes the given string into a sequence of bytes using the UTF-16LE 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 newStringIso8859_1​(byte[] bytes)
      Constructs a new String by decoding the specified array of bytes using the ISO-8859-1 charset.
      static java.lang.String newStringUsAscii​(byte[] bytes)
      Constructs a new String by decoding the specified array of bytes using the US-ASCII charset.
      static java.lang.String newStringUtf16​(byte[] bytes)
      Constructs a new String by decoding the specified array of bytes using the UTF-16 charset.
      static java.lang.String newStringUtf16Be​(byte[] bytes)
      Constructs a new String by decoding the specified array of bytes using the UTF-16BE charset.
      static java.lang.String newStringUtf16Le​(byte[] bytes)
      Constructs a new String by decoding the specified array of bytes using the UTF-16LE 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

      • getBytesIso8859_1

        public static byte[] getBytesIso8859_1​(java.lang.String string)
        Encodes the given string into a sequence of bytes using the ISO-8859-1 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)

      • getBytesUsAscii

        public static byte[] getBytesUsAscii​(java.lang.String string)
        Encodes the given string into a sequence of bytes using the US-ASCII 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)

      • getBytesUtf16

        public static byte[] getBytesUtf16​(java.lang.String string)
        Encodes the given string into a sequence of bytes using the UTF-16 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)

      • getBytesUtf16Be

        public static byte[] getBytesUtf16Be​(java.lang.String string)
        Encodes the given string into a sequence of bytes using the UTF-16BE 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)

      • getBytesUtf16Le

        public static byte[] getBytesUtf16Le​(java.lang.String string)
        Encodes the given string into a sequence of bytes using the UTF-16LE 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)

      • 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)

      • 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)

      • newStringIso8859_1

        public static java.lang.String newStringIso8859_1​(byte[] bytes)
        Constructs a new String by decoding the specified array of bytes using the ISO-8859-1 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.

      • newStringUsAscii

        public static java.lang.String newStringUsAscii​(byte[] bytes)
        Constructs a new String by decoding the specified array of bytes using the US-ASCII 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.

      • newStringUtf16

        public static java.lang.String newStringUtf16​(byte[] bytes)
        Constructs a new String by decoding the specified array of bytes using the UTF-16 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.

      • newStringUtf16Be

        public static java.lang.String newStringUtf16Be​(byte[] bytes)
        Constructs a new String by decoding the specified array of bytes using the UTF-16BE 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.

      • newStringUtf16Le

        public static java.lang.String newStringUtf16Le​(byte[] bytes)
        Constructs a new String by decoding the specified array of bytes using the UTF-16LE 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.

      • 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.