org.apache.xalan.serialize
Class Encodings

java.lang.Object
  |
  +--org.apache.xalan.serialize.Encodings

public class Encodings

extends java.lang.Object

Provides information about encodings. Depends on the Java runtime to provides writers for the different encodings, but can be used to override encoding names and provide the last printable character for each encoding.

Field Summary

static java.lang.String

DEFAULT_MIME_ENCODING The default encoding, ISO style, ISO style.

Constructor Summary

Encodings()

Method Summary

static java.lang.String	convertJava2MimeEncoding(java.lang.String encoding) Try the best we can to convert a Java encoding to a XML-style encoding.
static java.lang.String	convertMime2JavaEncoding(java.lang.String encoding) Try the best we can to convert a Java encoding to a XML-style encoding.
static int	getLastPrintable() Returns the last printable character for an unspecified encoding.
static int	getLastPrintable(java.lang.String encoding) Returns the last printable character for the specified encoding.
static java.lang.String	getMimeEncoding(java.lang.String encoding) Get the proper mime encoding.
static java.io.Writer	getWriter(java.io.OutputStream output, java.lang.String encoding) Returns a writer for the specified encoding based on an output stream.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MIME_ENCODING

public static final java.lang.String DEFAULT_MIME_ENCODING

The default encoding, ISO style, ISO style.

Constructor Detail

Encodings

public Encodings()

Method Detail

getWriter

public static java.io.Writer getWriter(java.io.OutputStream output,
                                       java.lang.String encoding)
                                throws java.io.UnsupportedEncodingException

Returns a writer for the specified encoding based on an output stream.

Parameters:

output - The output stream

encoding - The encoding

Returns:

A suitable writer

Throws:

java.io.UnsupportedEncodingException - There is no convertor to support this encoding

getLastPrintable

public static int getLastPrintable(java.lang.String encoding)

Returns the last printable character for the specified encoding.

Parameters:

encoding - The encoding

Returns:

The last printable character

getLastPrintable

public static int getLastPrintable()

Returns the last printable character for an unspecified encoding.

Returns:

the default size

getMimeEncoding

public static java.lang.String getMimeEncoding(java.lang.String encoding)

Get the proper mime encoding. From the XSLT recommendation: "The encoding attribute specifies the preferred encoding to use for outputting the result tree. XSLT processors are required to respect values of UTF-8 and UTF-16. For other values, if the XSLT processor does not support the specified encoding it may signal an error; if it does not signal an error it should use UTF-8 or UTF-16 instead. The XSLT processor must not use an encoding whose name does not match the EncName production of the XML Recommendation [XML]. If no encoding attribute is specified, then the XSLT processor should use either UTF-8 or UTF-16."

Parameters:

encoding - Reference to java-style encoding string, which may be null, in which case a default will be found.

Returns:

The ISO-style encoding string, or null if failure.

convertJava2MimeEncoding

public static java.lang.String convertJava2MimeEncoding(java.lang.String encoding)

Try the best we can to convert a Java encoding to a XML-style encoding.

Parameters:

encoding - non-null reference to encoding string, java style.

Returns:

ISO-style encoding string.

convertMime2JavaEncoding

public static java.lang.String convertMime2JavaEncoding(java.lang.String encoding)

Try the best we can to convert a Java encoding to a XML-style encoding.

Parameters:

encoding - non-null reference to encoding string, java style.

Returns:

ISO-style encoding string.