Module org.opengis.geoapi

Package org.opengis.metadata.identification

Class CharacterSet

Object

CodeList<CharacterSet>

CharacterSet

All Implemented Interfaces:

Serializable, Comparable<CharacterSet>, ControlledVocabulary

@Deprecated(since="3.1")
@UML(identifier="MD_CharacterSetCode",
     specification=ISO_19115)
public final class CharacterSet
extends CodeList<CharacterSet>

Deprecated.

As of ISO 19115:2014, replaced by a reference to the IANA Character Set register. Represented in Java by Charset.

Name of the character coding standard used for the resource. The UML identifiers were defined in ISO 19115:2003, but removed from ISO 19115:2014. Mapping from legacy UML identifiers to the IANA names is as below:

 # From ISO 19115:2003 to java.nio.charset
 ucs2       = UCS-2
 ucs4       = UCS-4
 utf7       = UTF-7
 utf8       = UTF-8
 utf16      = UTF-16
 8859part1  = ISO-8859-1
 8859part2  = ISO-8859-2
 8859part3  = ISO-8859-3
 8859part4  = ISO-8859-4
 8859part5  = ISO-8859-5
 8859part6  = ISO-8859-6
 8859part7  = ISO-8859-7
 8859part8  = ISO-8859-8
 8859part9  = ISO-8859-9
 8859part10 = ISO-8859-10
 8859part11 = ISO-8859-11
 8859part12 = ISO-8859-12
 8859part13 = ISO-8859-13
 8859part14 = ISO-8859-14
 8859part15 = ISO-8859-15
 8859part16 = ISO-8859-16
 jis        = JIS_X0201
 shiftJIS   = Shift_JIS
 eucJP      = EUC-JP
 usAscii    = US-ASCII
 ebcdic     = EBCDIC
 eucKR      = EUC-KR
 big5       = Big5
 GB2312     = GB2312

This mapping is provided by GeoAPI in the org/opengis/metadata/2003/charset-codes.properties file. This file can be read as below:

final Properties codes = new Properties();
try (InputStream in = Metadata.class.getResourceAsStream("2003/charset-codes.properties")) {
    codes.load(in);
}

Since:

2.1

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.opengis.util.CodeList

CodeList.Filter

Field Summary

Fields

Modifier and Type	Field	Description
static final CharacterSet	BIG_5	Deprecated. Traditional Chinese code set used in Taiwan, Hong Kong, and other areas.
static final CharacterSet	EBCDIC	Deprecated. IBM mainframe code set.
static final CharacterSet	EUC_JP	Deprecated. Japanese code set used on UNIX based machines.
static final CharacterSet	EUC_KR	Deprecated. Korean code set.
static final CharacterSet	GB2312	Deprecated. Simplified Chinese code set.
static final CharacterSet	ISO_8859_1	Deprecated. ISO/IEC 8859-1, Information technology. 8-bit single-byte coded graphic character sets - Part 1: Latin alphabet No. 1.
static final CharacterSet	ISO_8859_10	Deprecated. ISO/IEC 8859-10, Information technology. 8-bit single-byte coded graphic character sets - Part 10: Latin alphabet No. 6.
static final CharacterSet	ISO_8859_11	Deprecated. ISO/IEC 8859-11, Information technology. 8-bit single-byte coded graphic character sets - Part 11: Latin/Thai alphabet.
static final CharacterSet	ISO_8859_12	Deprecated. A future ISO/IEC 8-bit single-byte coded graphic character set.
static final CharacterSet	ISO_8859_13	Deprecated. ISO/IEC 8859-13, Information technology. 8-bit single-byte coded graphic character sets - Part 13: Latin alphabet No. 7.
static final CharacterSet	ISO_8859_14	Deprecated. ISO/IEC 8859-14, Information technology. 8-bit single-byte coded graphic character sets - Part 14: Latin alphabet No. 8 (Celtic).
static final CharacterSet	ISO_8859_15	Deprecated. ISO/IEC 8859-15, Information technology. 8-bit single-byte coded graphic character sets - Part 15: Latin alphabet No. 9.
static final CharacterSet	ISO_8859_16	Deprecated. ISO/IEC 8859-16, Information technology. 8-bit single-byte coded graphic character sets - Part 16: Latin alphabet No. 10.
static final CharacterSet	ISO_8859_2	Deprecated. ISO/IEC 8859-2, Information technology. 8-bit single-byte coded graphic character sets - Part 2: Latin alphabet No. 2.
static final CharacterSet	ISO_8859_3	Deprecated. ISO/IEC 8859-3, Information technology. 8-bit single-byte coded graphic character sets - Part 3: Latin alphabet No. 3.
static final CharacterSet	ISO_8859_4	Deprecated. ISO/IEC 8859-4, Information technology. 8-bit single-byte coded graphic character sets - Part 4: Latin alphabet No. 4.
static final CharacterSet	ISO_8859_5	Deprecated. ISO/IEC 8859-5, Information technology. 8-bit single-byte coded graphic character sets - Part 5: Latin/Cyrillic alphabet.
static final CharacterSet	ISO_8859_6	Deprecated. ISO/IEC 8859-6, Information technology. 8-bit single-byte coded graphic character sets - Part 6: Latin/Arabic alphabet.
static final CharacterSet	ISO_8859_7	Deprecated. ISO/IEC 8859-7, Information technology. 8-bit single-byte coded graphic character sets - Part 7: Latin/Greek alphabet.
static final CharacterSet	ISO_8859_8	Deprecated. ISO/IEC 8859-8, Information technology. 8-bit single-byte coded graphic character sets - Part 8: Latin/Hebrew alphabet.
static final CharacterSet	ISO_8859_9	Deprecated. ISO/IEC 8859-9, Information technology. 8-bit single-byte coded graphic character sets - Part 9: Latin alphabet No. 5.
static final CharacterSet	JIS	Deprecated. Japanese code set used for electronic transmission.
static final CharacterSet	SHIFT_JIS	Deprecated. Japanese code set used on MS-DOS based machines.
static final CharacterSet	UCS_2	Deprecated. 16-bit fixed size Universal Character Set, based on ISO/IEC 10646.
static final CharacterSet	UCS_4	Deprecated. 32-bit fixed size Universal Character Set, based on ISO/IEC 10646.
static final CharacterSet	US_ASCII	Deprecated. United States ASCII code set (ISO 646 US).
static final CharacterSet	UTF_16	Deprecated. 16-bit variable size UCS Transfer Format, based on ISO/IEC 10646.
static final CharacterSet	UTF_7	Deprecated. 7-bit variable size UCS Transfer Format, based on ISO/IEC 10646.
static final CharacterSet	UTF_8	Deprecated. 8-bit variable size UCS Transfer Format, based on ISO/IEC 10646.

Method Summary

Modifier and Type	Method	Description
CharacterSet[]	family()	Deprecated. Returns the list of codes of the same kind as this code list element.
static CharacterSet	fromCharset(Charset cs)	Deprecated. Converts the given Java Character Set to CharacterSet.
String[]	names()	Deprecated. Returns all the names of this code.
Charset	toCharset()	Deprecated. Converts the Character Set to a java Charset, if it can.
static CharacterSet	valueOf(String code)	Deprecated. Returns the character set that matches the given string, or returns a new one if none match it.
static CharacterSet[]	values()	Deprecated. Returns the list of CharacterSets.

Methods inherited from class org.opengis.util.CodeList

compareTo, identifier, name, ordinal, readResolve, toString, valueOf, valueOf, valueOf, values

Methods inherited from class java.lang.Object

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

Field Details

UCS_2

@UML(identifier="ucs2",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet UCS_2

Deprecated.

16-bit fixed size Universal Character Set, based on ISO/IEC 10646.

UCS_4

@UML(identifier="ucs4",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet UCS_4

Deprecated.

32-bit fixed size Universal Character Set, based on ISO/IEC 10646.

UTF_7

@UML(identifier="utf7",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet UTF_7

Deprecated.

7-bit variable size UCS Transfer Format, based on ISO/IEC 10646.

UTF_8

@UML(identifier="utf8",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet UTF_8

Deprecated.

8-bit variable size UCS Transfer Format, based on ISO/IEC 10646.

UTF_16

@UML(identifier="utf16",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet UTF_16

Deprecated.

16-bit variable size UCS Transfer Format, based on ISO/IEC 10646.

ISO_8859_1

@UML(identifier="8859part1",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_1

Deprecated.

ISO/IEC 8859-1, Information technology. 8-bit single-byte coded graphic character sets - Part 1: Latin alphabet No. 1.

ISO_8859_2

@UML(identifier="8859part2",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_2

Deprecated.

ISO/IEC 8859-2, Information technology. 8-bit single-byte coded graphic character sets - Part 2: Latin alphabet No. 2.

ISO_8859_3

@UML(identifier="8859part3",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_3

Deprecated.

ISO/IEC 8859-3, Information technology. 8-bit single-byte coded graphic character sets - Part 3: Latin alphabet No. 3.

ISO_8859_4

@UML(identifier="8859part4",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_4

Deprecated.

ISO/IEC 8859-4, Information technology. 8-bit single-byte coded graphic character sets - Part 4: Latin alphabet No. 4.

ISO_8859_5

@UML(identifier="8859part5",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_5

Deprecated.

ISO/IEC 8859-5, Information technology. 8-bit single-byte coded graphic character sets - Part 5: Latin/Cyrillic alphabet.

ISO_8859_6

@UML(identifier="8859part6",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_6

Deprecated.

ISO/IEC 8859-6, Information technology. 8-bit single-byte coded graphic character sets - Part 6: Latin/Arabic alphabet.

ISO_8859_7

@UML(identifier="8859part7",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_7

Deprecated.

ISO/IEC 8859-7, Information technology. 8-bit single-byte coded graphic character sets - Part 7: Latin/Greek alphabet.

ISO_8859_8

@UML(identifier="8859part8",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_8

Deprecated.

ISO/IEC 8859-8, Information technology. 8-bit single-byte coded graphic character sets - Part 8: Latin/Hebrew alphabet.

ISO_8859_9

@UML(identifier="8859part9",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_9

Deprecated.

ISO/IEC 8859-9, Information technology. 8-bit single-byte coded graphic character sets - Part 9: Latin alphabet No. 5.

ISO_8859_10

@UML(identifier="8859part10",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_10

Deprecated.

ISO/IEC 8859-10, Information technology. 8-bit single-byte coded graphic character sets - Part 10: Latin alphabet No. 6.

ISO_8859_11

@UML(identifier="8859part11",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_11

Deprecated.

ISO/IEC 8859-11, Information technology. 8-bit single-byte coded graphic character sets - Part 11: Latin/Thai alphabet.

ISO_8859_12

@UML(identifier="8859part12",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_12

Deprecated.

A future ISO/IEC 8-bit single-byte coded graphic character set.

ISO_8859_13

@UML(identifier="8859part13",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_13

Deprecated.

ISO/IEC 8859-13, Information technology. 8-bit single-byte coded graphic character sets - Part 13: Latin alphabet No. 7.

ISO_8859_14

@UML(identifier="8859part14",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_14

Deprecated.

ISO/IEC 8859-14, Information technology. 8-bit single-byte coded graphic character sets - Part 14: Latin alphabet No. 8 (Celtic).

ISO_8859_15

@UML(identifier="8859part15",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_15

Deprecated.

ISO/IEC 8859-15, Information technology. 8-bit single-byte coded graphic character sets - Part 15: Latin alphabet No. 9.

ISO_8859_16

@UML(identifier="8859part16",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet ISO_8859_16

Deprecated.

ISO/IEC 8859-16, Information technology. 8-bit single-byte coded graphic character sets - Part 16: Latin alphabet No. 10.

JIS

@UML(identifier="jis",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet JIS

Deprecated.

Japanese code set used for electronic transmission.

SHIFT_JIS

@UML(identifier="shiftJIS",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet SHIFT_JIS

Deprecated.

Japanese code set used on MS-DOS based machines.

EUC_JP

@UML(identifier="eucJP",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet EUC_JP

Deprecated.

Japanese code set used on UNIX based machines.

US_ASCII

@UML(identifier="usAscii",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet US_ASCII

Deprecated.

United States ASCII code set (ISO 646 US).

EBCDIC

@UML(identifier="ebcdic",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet EBCDIC

Deprecated.

IBM mainframe code set.

EUC_KR

@UML(identifier="eucKR",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet EUC_KR

Deprecated.

Korean code set.

BIG_5

@UML(identifier="big5",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet BIG_5

Deprecated.

Traditional Chinese code set used in Taiwan, Hong Kong, and other areas.

GB2312

@UML(identifier="GB2312",
     obligation=CONDITIONAL,
     specification=ISO_19115,
     version=2003)
public static final CharacterSet GB2312

Deprecated.

Simplified Chinese code set.

Method Details

fromCharset

public static CharacterSet fromCharset(Charset cs)

Deprecated.

Converts the given Java Character Set to CharacterSet.

Parameters:

cs - the character set, or null.

Returns:

a code list for the given character set, or null if the given cs was null.

Since:

3.1

toCharset

public Charset toCharset()
                  throws UnsupportedCharsetException

Deprecated.

Converts the Character Set to a java Charset, if it can. This method is provided for migration from this legacy code lists to Charset.

Returns:

the Java Charset.

Throws:

UnsupportedCharsetException - if no support for the charset is available.

See Also:

• Supported encodings

names

public String[] names()

Deprecated.

Returns all the names of this code. The returned array contains the following elements, with duplicated values and null values removed:

• The programmatic name
• The UML identifier
• The charset name

Those names are typically equal except for the case (programmatic names are upper case while UML names are lower case) and special characters like '-'.

Returns:

all names of this code constant. This array is never null and never empty.

values

public static CharacterSet[] values()

Deprecated.

Returns the list of CharacterSets.

Returns:

the list of codes declared in the current JVM.

family

public CharacterSet[] family()

Deprecated.

Returns the list of codes of the same kind as this code list element. Invoking this method is equivalent to invoking values(), except that this method can be invoked on an instance of the parent CodeList class.

Specified by:

family in interface ControlledVocabulary

Specified by:

family in class CodeList<CharacterSet>

Returns:

all code values for this code list.

valueOf

public static CharacterSet valueOf(String code)

Deprecated.

Returns the character set that matches the given string, or returns a new one if none match it. This methods returns the first instance (in declaration order) for which the name is equals, ignoring case, to the given name. If no existing instance is found, then a new one is created for the given name.

Parameters:

code - the name of the code to fetch or to create.

Returns:

a code matching the given name.