MIME2Java (Apache Tomcat 8.0.15 API Documentation)

java.lang.Object
- org.apache.catalina.util.MIME2Java

public class MIME2Java
extends Object

MIME2Java is a convenience class which handles conversions between MIME charset names and Java encoding names.

The supported XML encodings are the intersection of XML-supported code sets and those supported in JDK 1.1.

MIME charset names are used on xmlEncoding parameters to methods such as TXDocument#setEncoding and DTD#setEncoding.

Java encoding names are used on encoding parameters to methods such as TXDocument#printWithFormat and DTD#printExternal.

MIME charset name to Java encoding name mapping
Common Name	Use this name in XML files	Name Type	Xerces converts to this Java Encoder Name
8 bit Unicode	UTF-8	IANA	UTF8
ISO Latin 1	ISO-8859-1	MIME	ISO-8859-1
ISO Latin 2	ISO-8859-2	MIME	ISO-8859-2
ISO Latin 3	ISO-8859-3	MIME	ISO-8859-3
ISO Latin 4	ISO-8859-4	MIME	ISO-8859-4
ISO Latin Cyrillic	ISO-8859-5	MIME	ISO-8859-5
ISO Latin Arabic	ISO-8859-6	MIME	ISO-8859-6
ISO Latin Greek	ISO-8859-7	MIME	ISO-8859-7
ISO Latin Hebrew	ISO-8859-8	MIME	ISO-8859-8
ISO Latin 5	ISO-8859-9	MIME	ISO-8859-9
EBCDIC: US	ebcdic-cp-us	IANA	cp037
EBCDIC: Canada	ebcdic-cp-ca	IANA	cp037
EBCDIC: Netherlands	ebcdic-cp-nl	IANA	cp037
EBCDIC: Denmark	ebcdic-cp-dk	IANA	cp277
EBCDIC: Norway	ebcdic-cp-no	IANA	cp277
EBCDIC: Finland	ebcdic-cp-fi	IANA	cp278
EBCDIC: Sweden	ebcdic-cp-se	IANA	cp278
EBCDIC: Italy	ebcdic-cp-it	IANA	cp280
EBCDIC: Spain, Latin America	ebcdic-cp-es	IANA	cp284
EBCDIC: Great Britain	ebcdic-cp-gb	IANA	cp285
EBCDIC: France	ebcdic-cp-fr	IANA	cp297
EBCDIC: Arabic	ebcdic-cp-ar1	IANA	cp420
EBCDIC: Hebrew	ebcdic-cp-he	IANA	cp424
EBCDIC: Switzerland	ebcdic-cp-ch	IANA	cp500
EBCDIC: Roece	ebcdic-cp-roece	IANA	cp870
EBCDIC: Yogoslavia	ebcdic-cp-yu	IANA	cp870
EBCDIC: Iceland	ebcdic-cp-is	IANA	cp871
EBCDIC: Urdu	ebcdic-cp-ar2	IANA	cp918
Chinese for PRC, mixed 1/2 byte	gb2312	MIME	GB2312
Extended Unix Code, packed for Japanese	euc-jp	MIME	eucjis
Japanese: iso-2022-jp	iso-2020-jp	MIME	JIS
Japanese: Shift JIS	Shift_JIS	MIME	SJIS
Chinese: Big5	Big5	MIME	Big5
Extended Unix Code, packed for Korean	euc-kr	MIME	iso2022kr
Cyrillic	koi8-r	MIME	koi8-r

Author:: TAMURA Kent <kent@trl.ibm.co.jp>

Method Summary

Methods
Modifier and Type	Method and Description
`static String`	`convert(String mimeCharsetName)` Convert a MIME charset name, also known as an XML encoding name, to a Java encoding name.
`static String`	`reverse(String encoding)` Convert a Java encoding name to MIME charset name.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - convert
```
public static String convert(String mimeCharsetName)
```
    Convert a MIME charset name, also known as an XML encoding name, to a Java encoding name.
    
    Parameters:
    mimeCharsetName - Case insensitive MIME charset name: UTF-8, US-ASCII, ISO-8859-1, ISO-8859-2, ISO-8859-3, ISO-8859-4, ISO-8859-5, ISO-8859-6, ISO-8859-7, ISO-8859-8, ISO-8859-9, ISO-2022-JP, Shift_JIS, EUC-JP, GB2312, Big5, EUC-KR, ISO-2022-KR, KOI8-R, EBCDIC-CP-US, EBCDIC-CP-CA, EBCDIC-CP-NL, EBCDIC-CP-DK, EBCDIC-CP-NO, EBCDIC-CP-FI, EBCDIC-CP-SE, EBCDIC-CP-IT, EBCDIC-CP-ES, EBCDIC-CP-GB, EBCDIC-CP-FR, EBCDIC-CP-AR1, EBCDIC-CP-HE, EBCDIC-CP-CH, EBCDIC-CP-ROECE, EBCDIC-CP-YU, EBCDIC-CP-IS and EBCDIC-CP-AR2.
    
    Returns:
    Java encoding name, or null if mimeCharsetName is unknown.
    See Also:
    reverse(java.lang.String)
  - reverse
```
public static String reverse(String encoding)
```
    Convert a Java encoding name to MIME charset name. Available values of encoding are "UTF8", "8859_1", "8859_2", "8859_3", "8859_4", "8859_5", "8859_6", "8859_7", "8859_8", "8859_9", "JIS", "SJIS", "EUCJIS", "GB2312", "BIG5", "KSC5601", "ISO2022KR", "KOI8_R", "CP037", "CP277", "CP278", "CP280", "CP284", "CP285", "CP297", "CP420", "CP424", "CP500", "CP870", "CP871" and "CP918".
    
    Parameters:
    encoding - Case insensitive Java encoding name: UTF8, 8859_1, 8859_2, 8859_3, 8859_4, 8859_5, 8859_6, 8859_7, 8859_8, 8859_9, JIS, SJIS, EUCJIS, GB2312, BIG5, KSC5601, ISO2022KR, KOI8_R, CP037, CP277, CP278, CP280, CP284, CP285, CP297, CP420, CP424, CP500, CP870, CP871 and CP918.
    
    Returns:
    MIME charset name, or null if encoding is unknown.
    See Also:
    convert(java.lang.String)

Class MIME2Java

Method Summary

Methods inherited from class java.lang.Object

Method Detail

convert

reverse