Class CharacterEncodingUtils


  • public class CharacterEncodingUtils
    extends java.lang.Object
    CharacterEncodingUtils provides utility methods for detection and conversion of character encodings.
    • Method Summary

      All Methods Static Methods Concrete Methods 
      Modifier and Type Method Description
      static java.nio.ByteBuffer convertCharacterEncoding​(byte[] value, java.nio.charset.Charset fromCharacterSet, java.nio.charset.Charset toCharacterSet, java.util.function.BiFunction<java.lang.String,​org.apache.commons.lang3.tuple.Pair<java.nio.charset.Charset,​java.nio.charset.Charset>,​java.lang.String> textTransformFunction)
      Convert the character encoding of value.
      static com.ibm.icu.text.CharsetMatch detectOneOfCharacterEncodings​(byte[] value, java.lang.String characterEncoding)
      Detect the character encoding of value.
      static com.ibm.icu.text.CharsetMatch detectOneOfCharacterEncodings​(byte[] value, java.util.Set<java.lang.String> characterEncodingsLowercase)
      Detect the character encoding of value.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Constructor Detail

      • CharacterEncodingUtils

        public CharacterEncodingUtils()
    • Method Detail

      • detectOneOfCharacterEncodings

        public static com.ibm.icu.text.CharsetMatch detectOneOfCharacterEncodings​(byte[] value,
                                                                                  java.lang.String characterEncoding)
        Detect the character encoding of value.
        Parameters:
        value - byte[] content to detect on
        characterEncoding - String character encoding to detect for
        Returns:
        CharsetMatch or null if no match to one of characterEncodingsLowercase
        Throws:
        java.lang.NullPointerException - if value or characterEncoding is null
      • detectOneOfCharacterEncodings

        public static com.ibm.icu.text.CharsetMatch detectOneOfCharacterEncodings​(byte[] value,
                                                                                  java.util.Set<java.lang.String> characterEncodingsLowercase)
        Detect the character encoding of value.
        Parameters:
        value - byte[] content to detect on
        characterEncodingsLowercase - Set of character encodings to detect for
        Returns:
        CharsetMatch or null if no match to one of characterEncodingsLowercase
        Throws:
        java.lang.NullPointerException - if value or characterEncodingsLowercase is null
      • convertCharacterEncoding

        public static java.nio.ByteBuffer convertCharacterEncoding​(byte[] value,
                                                                   java.nio.charset.Charset fromCharacterSet,
                                                                   java.nio.charset.Charset toCharacterSet,
                                                                   java.util.function.BiFunction<java.lang.String,​org.apache.commons.lang3.tuple.Pair<java.nio.charset.Charset,​java.nio.charset.Charset>,​java.lang.String> textTransformFunction)
        Convert the character encoding of value.
        Parameters:
        value - byte[] content to convert
        fromCharacterSet - Charset to convert from
        toCharacterSet - Charset to convert to
        textTransformFunction - Function text transform function to apply to the decoded String for value; can be null
        Returns:
        ByteBuffer containing converted bytes, encoded in toCharacterSet
        Throws:
        java.lang.NullPointerException - if value, fromCharacterSet, or toCharacterSet is null