oracle.jdeveloper.util

Class CharacterEncodingMapping

java.lang.Object

oracle.jdeveloper.util.CharacterEncodingMapping

public class CharacterEncodingMapping
extends java.lang.Object

Provides two static conversion functions to translate between IANA names for character set encodings and JDK names as used in the java.io and java.lang packages. The classes in the java.nio package are able to use IANA names.

Method Summary

Modifier and Type	Method and Description
static java.lang.String	convertIanaToJdk(java.lang.String ianaName) Map IANA to JDK character encoding names.
static java.lang.String	convertJdkToIana(java.lang.String jdkName) Mapping of JDK to IANA character encoding names.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

convertIanaToJdk

public static java.lang.String convertIanaToJdk(java.lang.String ianaName)

Map IANA to JDK character encoding names. Warning, this method uses the sun.io.CharacterEncoding class which was discontinued in JDK8. You're encouraged to start using the java.nio classes. This method can be used if the encoding name will be used by the classes in the java.io and java.lang packages, which use old-style JDK encoding names. If you use the classes in the java.nio package, there is no need to use this method, those classes can handle IANA names. Use Charset.isSupported(String) to determine if the encoding name is supported. If not, you can use this method to see if it will return a name that IS supported.

Parameters:

ianaName - A IANA encoding name

Returns:

An old-style JDK encoding name which might be null

See Also:

java.nio.charset.Charset.isSupported

convertJdkToIana

public static java.lang.String convertJdkToIana(java.lang.String jdkName)

Mapping of JDK to IANA character encoding names. This function is used by XMLOutputstream to produce XML files which are in the native encoding of the client workstation.

Parameters:

jdkName - A JDK encoding name

Returns:

A IANA encoding name. In case no mapping is found between the jdk name and an IANA name, the jdk name is returned