electric.util.encoding
Class XMLEncodings

java.lang.Object
  electric.util.encoding.XMLEncodings

public class XMLEncodings

extends java.lang.Object

XMLEncodings defines a set of static methods for deciphering encoding information. This includes mapping an encoding in Java to an encoding in xml, switching back and forth between java and xml encoding, and manipulating the default encodings to check through.

Author:

webMethods

Constructor Summary

XMLEncodings()

Method Summary

static void	addBidirectionalEncoding(java.lang.String xmlEncoding, java.lang.String javaEncoding)
static void	addJavaToXMLEncoding(java.lang.String javaEncoding, java.lang.String xmlEncoding)
static void	addSuggestedEncoding(java.lang.String encoding) In order to know the encoding of an XML document, we must get the encoding attribute of the xml decl.
static void	addXMLToJavaEncoding(java.lang.String xmlEncoding, java.lang.String javaEncoding)
static void	clearSuggestedEncodings() Warning, this is dangerous territory to play in.
static java.lang.String	getJavaEncoding(byte[] header) determine what encoding the byte array claims it's in.
static java.lang.String	getJavaEncoding(java.lang.String xmlEncoding)
static java.lang.String[]	getSuggestedEncodings()
static java.lang.String	getSystemEncoding() return the default java encoding for the system
static java.lang.String	getXMLEncoding(java.lang.String javaEncoding)
static java.lang.String	getXMLSystemEncoding() return the default xml encoding for the system
static java.lang.String[]	initSuggestedEncodings(java.lang.String[] userSuggestedEncodings) Add encodings to try when attempting to parse the document.
static void	initXMLToJavaEncodings()

Methods inherited from class java.lang.Object

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

Constructor Detail

XMLEncodings

public XMLEncodings()

Method Detail

addSuggestedEncoding

public static void addSuggestedEncoding(java.lang.String encoding)
                                 throws java.io.UnsupportedEncodingException

In order to know the encoding of an XML document, we must get the encoding attribute of the xml decl. In order to read the xml decl, we need to know what encoding the xml document is in. Since the first 5 characters of an xml decl are guaranteed to be "

Parameters:

encoding -

Throws:

java.io.UnsupportedEncodingException

getSuggestedEncodings

public static java.lang.String[] getSuggestedEncodings()

getJavaEncoding

public static java.lang.String getJavaEncoding(byte[] header)
                                        throws java.io.UnsupportedEncodingException

determine what encoding the byte array claims it's in. this searches through the bytes for the xml decl, and looks at the encoding stated there.

Parameters:

header -

Throws:

java.io.UnsupportedEncodingException

getJavaEncoding

public static java.lang.String getJavaEncoding(java.lang.String xmlEncoding)

Parameters:

xmlEncoding -

getXMLEncoding

public static java.lang.String getXMLEncoding(java.lang.String javaEncoding)

Parameters:

javaEncoding -

addBidirectionalEncoding

public static void addBidirectionalEncoding(java.lang.String xmlEncoding,
                                            java.lang.String javaEncoding)

Parameters:

xmlEncoding -

javaEncoding -

addXMLToJavaEncoding

public static void addXMLToJavaEncoding(java.lang.String xmlEncoding,
                                        java.lang.String javaEncoding)

Parameters:

xmlEncoding -

javaEncoding -

addJavaToXMLEncoding

public static void addJavaToXMLEncoding(java.lang.String javaEncoding,
                                        java.lang.String xmlEncoding)

Parameters:

javaEncoding -

xmlEncoding -

getSystemEncoding

public static java.lang.String getSystemEncoding()

return the default java encoding for the system

getXMLSystemEncoding

public static java.lang.String getXMLSystemEncoding()

return the default xml encoding for the system

clearSuggestedEncodings

public static void clearSuggestedEncodings()

Warning, this is dangerous territory to play in. If you don't reinitialize suggestedEncodings after calling this method, every document will be assumed to be UTF-8.

initSuggestedEncodings

public static java.lang.String[] initSuggestedEncodings(java.lang.String[] userSuggestedEncodings)

Add encodings to try when attempting to parse the document. Returns encodings that could not be resolved.

Parameters:

userSuggestedEncodings -

initXMLToJavaEncodings

public static void initXMLToJavaEncodings()