java.nio.charset
클래스 Charset

java.lang.Object 
  java.nio.charset.Charset

모든 구현된 인터페이스:

Comparable <Charset >

public abstract class Charset
extends Object 
implements Comparable <Charset >

16 비트 Unicode 코드 단위 순서와 바이트 순서간의 지정 맵입니다. 이 클래스에는 디코더나 엔코더를 작성하는 메서드나, 캐릭터셋에 관련된 다양한 이름을 얻는 메서드를 정의합니다. 이 클래스의 인스턴스는 불변입니다.

또, 이 클래스에는 어느 캐릭터셋가 지원 되고 있는지 어떤지의 체크, 이름에 한 캐릭터셋의 인스턴스의 검색 및 현재의 Java 가상 머신으로 지원 떠날 수 있어 모든 캐릭터셋를 기재한 맵의 구축을하기 위한 정적 메서드도 정의되고 있습니다. 새로운 캐릭터셋를 추가하는 경우는 CharsetProvider 클래스에 정의되고 있는 서비스 프로바이더 인터페이스를 사용합니다.

이 클래스에서 정의 떠날 수 있어 모든 메서드는 복수의 병행 thread로 안전하게 사용할 수 있습니다.

캐릭터셋명

캐릭터셋명은 다음의 문자를 포함한 캐릭터 라인으로 나타내집니다.

• 대문자의 'A' ~ 'Z' ('\u0041' ~ '\u005a')
• 소문자의 'a' ~ 'z' ('\u0061' ~ '\u007a')
• 숫자의 '0' ~ '9' ('\u0030' ~ '\u0039')
• 데쉬 문자 '-' ('\u002d', HYPHEN-MINUS)
• 피리어드 문자 '. ' ('\u002e', FULL STOP)
• 구두점 문자 ':' ('\u003a', COLON)
• 밑줄 문자 '_' ('\u005f', LOW LINE)

캐릭터셋명의 최초의 문자는 반드시 알파벳이나 숫자가 됩니다. 비어있는 캐릭터 라인은 정당한 캐릭터셋명으로서 인식되지 않습니다. 캐릭터셋명에서는 알파벳의 대문자와 소문자가 구별되지 않기 때문에 2개의 캐릭터셋명을 비교할 때, 대문자와 소문자의 차이는 무시됩니다. 보통, 캐릭터셋명은, RFC 2278: IANA Charset Registration Procedures 규칙에 준거합니다.

모든 캐릭터셋에는 「표준명」이 있습니다. 이 밖에 몇개의 「별명」이 존재하는 경우도 있습니다. 이 클래스의 name 메서드에서는 표준명을 리턴합니다. 보통, 표준명은 알파벳의 대문자로 기술됩니다. aliases 메서드는 캐릭터셋의 별명을 리턴합니다.

일부의 캐릭터셋에는 이전의 버전의 Java 플랫폼과의 호환성을 고려한 「호환명」이 포함되어 있습니다. 호환명은 그 캐릭터셋의 표준명이나 별명이 됩니다. InputStreamReader 클래스와 OutputStreamWriter 클래스의 getEncoding() 메서드는 호환명을 리턴합니다.

IANA Charset Registry에 기재되어 있는 캐릭터셋를 Java 플랫폼의 구현이 지원하는인 경우, 그 캐릭터셋의 표준명은 레지스트리내의 이름이 됩니다. 캐릭터셋의 상당수는 레지스트리내에 복수의 이름을 가지고 있습니다. 이 경우 레지스트리는 몇개의 이름을 「MIME 우선」이라고 합니다. 이와 같이, 캐릭터셋가 복수의 레지스트리명을 가지고 있는 경우, MIME 우선명이 표준명이 되어, 그 외의 레지스트리명은 유효한 별명이 됩니다. 지원 되고 있는 캐릭터셋가 IANA 레지스트리에 기재되지 않은 경우, 표준명은 "X-" 또는 "x-"로 시작되는 캐릭터 라인이 됩니다.

IANA 캐릭터셋 레지스트리의 내용은 시간의 경과와 함께 변화합니다. 이것에 수반해, 캐릭터셋의 표준명이나 별명도 변화합니다. 호환성을 확보할 필요가 있는 경우는 캐릭터셋의 별명을 삭제하지 않는 것, 캐릭터셋의 표준명이 바뀌었을 경우는 원의 표준명을 별명으로서 추가하는 것을 추천합니다.

표준 캐릭터셋

Java 플랫폼의 구현은 모두 다음의 표준 캐릭터셋를 지원 할 필요가 있습니다. 지원 되고 있는 그 외의 캐릭터셋에 대해서는 구현의 릴리스 노트를 참조하십시오. 그러한 옵션의 캐릭터셋의 동작은 구현 마다 다를 가능성이 있습니다.

캐릭터셋	설명
US-ASCII	7 비트 ASCII (ISO646-US/Unicode 캐릭터셋의 Basic Latin 블록)
ISO-8859-1	ISO Latin Alphabet No. 1 (ISO-LATIN-1)
UTF-8	8 비트 UCS 변환 형식
UTF-16BE	16 비트 UCS 변환 형식, 빅 endian 바이트순서
UTF-16BE	16 비트 UCS 변환 형식, little endian 바이트순서
UTF-16	16 비트 UCS 변환 형식, 옵션의 바이트순서 마크로 식별되는 바이트순서

UTF-8 캐릭터셋는 RFC 2279 에 의해 규정되고 있습니다. 또, 그 변환 형식은 ISO 10646-1 Amendment 2 내에서 규정되고 있어Unicode Standard 에서도 설명되고 있습니다.

UTF-16 캐릭터셋는 RFC 2781 에 의해 규정되고 있습니다. 또, 그 변환 형식은 ISO 10646-1 Amendment 1 내에서 규정되고 있어Unicode Standard 에서도 설명되고 있습니다.

UTF-16 캐릭터셋는 16 비트의 양을 사용하기 위해, 바이트순서의 영향을 받습니다. 이러한 인코딩에서는 스트림의 바이트순서는 Unicode 문자 '\uFEFF' 「바이트순서 마크」로 지정됩니다. 바이트순서 마크의 취급은 다음과 같습니다.

• 디코드때, UTF-16BE 캐릭터셋과 UTF-16LE 캐릭터셋는 바이트순서 마크를 무시한다. encode때는 바이트순서 마크를 출력하지 않는다

• 디코드때, UTF-16 캐릭터셋는 바이트순서 마크를 해석해 스트림의 바이트순서를 결정하지만, 바이트순서 마크가 없는 경우는 빅 endian 바이트순서를 사용한다. encode때는 빅 endian 바이트순서를 사용해, 빅 endian 바이트순서 마크를 출력한다

어느 쪽의 경우도, 디코드 처리의 개시시에 바이트순서 마크가 읽어내졌을 경우, 그 마크는 최종적인 문자 순서로부터 생략해집니다. 그러나, 입력 순서의 최초의 요소의 후에 출현한 바이트순서 마크는 생략 되지 않습니다. 이것은, ZERO-WIDTH NON-BREAKING SPACE가 같은 코드로 표현되기 때문입니다.

Java 가상 머신의 각 인스턴스에는 디폴트의 캐릭터셋가 있습니다. 이 캐릭터셋는 표준 캐릭터셋이다고는 할 수 없습니다. 디폴트의 캐릭터셋는 가상 머신의 시작시로 결정됩니다만, 그것은 보통 OS가 사용하고 있는 로케일과 캐릭터셋에 의해 정해집니다.

용어

이 클래스의 이름은, RFC 2278 로 사용되고 있는 용어에 유래하고 있습니다. 이 문서내에서 「캐릭터셋」는 코드화 문자 집합과 문자 인코딩 방식의 편성으로서 정의되고 있습니다.

「코드화 문자 집합」은 추상 문자의 집합과 정수의 집합간의 매핑을 나타냅니다. 코드화 문자 집합의 예로서는 US-ASCII, ISO 8859-1, JIS X 0201, 완전 Unicode (ISO 10646-1와 같다)등을 들 수 있습니다.

「문자 인코딩 방식」은 코드화 문자 집합과 8중창 (8 비트 바이트) 순서간의 매핑을 나타냅니다. 문자 인코딩 방식의 예로서는 UTF-8, UCS-2, UTF-16, ISO 2022, EUC 등을 들 수 있습니다. 인코딩 방식은 보통, 특정의 코드화 문자 집합에 관련지을 수 있습니다. 예를 들어 UTF-8는 Unicode 인코딩 전용입니다. 인코딩 방식안에는 복수의 문자 집합에 관련된 것도 있습니다. 예를 들어 EUC를 사용하면, 아시아 지역의 다양한 문자 집합의 문자를 encode 할 수 있습니다.

코드화 문자 집합과 문자 인코딩 방식이 1 대 1에 대응하고 있는 경우, 일반적으로 그 문자 집합의 이름에 연관된 캐릭터셋명을 붙일 수 있습니다. 그 외의 경우는 보통, 인코딩 방식 (와 지원하는 문자 집합의 로케일)으로 연관된 이름을 붙일 수 있습니다. 따라서, US-ASCII 캐릭터셋명은 US-ASCII, JIS X 0201, JIS X 0208, and JIS X 0212 각 문자 집합을 encode 하는 캐릭터셋의 이름은, EUC-JP가 됩니다.

Java 프로그램 언어의 네이티브의 문자 인코딩 방식은 UTF-16 입니다. 따라서, Java 플랫폼내의 각 캐릭터셋는 16 비트의 UTF-16 코드 단위의 순서와 바이트 순서와의 사이의 매핑을 정의합니다.

도입된 버전 :

1.4

관련 항목:

CharsetDecoder, CharsetEncoder, CharsetProvider, Character

생성자 개요

protected

Charset (String canonicalName, String [] aliases) 지정된 표준명과 별명세트를 사용해, 새로운 캐릭터셋를 초기화합니다.

메서드 개요

Set <String >	aliases () 이 캐릭터셋의 별명이 포함되는 세트를 리턴합니다.
static SortedMap <String, Charset >	availableCharsets () 표준 캐릭터셋명으로부터 Charset 객체에의 소트된 맵을 구축합니다.
boolean	canEncode () 이 캐릭터셋가 encode를 지원 할지 어떨지를 판단합니다.
int	compareTo (Charset that) 이 캐릭터셋를 다른 캐릭터셋과 비교합니다.
abstract boolean	contains (Charset cs) 이 캐릭터셋로 지정된 캐릭터셋가 포함되어 있는지를 판단합니다.
CharBuffer	decode (ByteBuffer bb) 이 캐릭터셋로 표현된 바이트를 Unicode 문자에 디코드하는 간이 메서드입니다.
static Charset	defaultCharset () 이 Java 가상 머신의 디폴트의 캐릭터셋를 리턴합니다.
String	displayName () 디폴트 로케일에 있어서의, 이 캐릭터셋의 이름 (가독형식)을 리턴합니다.
String	displayName (Locale locale) 지정된 로케일에 있어서의, 이 캐릭터셋의 이름 (가독형식)을 리턴합니다.
ByteBuffer	encode (CharBuffer cb) Unicode 문자를 이 캐릭터셋로 표현된 바이트에 encode 하는 간이 메서드입니다.
ByteBuffer	encode (String str) 캐릭터 라인을 이 캐릭터셋로 표현된 바이트에 encode 하는 간이 메서드입니다.
boolean	equals (Object ob) 이 객체가 다른 객체와 등가일지 어떨지를 판단합니다.
static Charset	forName (String charsetName) 지정된 캐릭터셋의 Charset 객체를 리턴합니다.
int	hashCode () 이 캐릭터셋의 해시 코드를 계산합니다.
boolean	isRegistered () 이 캐릭터셋가 IANA Charset Registry에 등록되어 있는지를 판단합니다.
static boolean	isSupported (String charsetName) 지정된 캐릭터셋가 지원 되고 있는지를 판단합니다.
String	name () 이 캐릭터셋의 표준명을 리턴합니다.
abstract CharsetDecoder	newDecoder () 이 캐릭터셋의 새로운 디코더를 구축합니다.
abstract CharsetEncoder	newEncoder () 이 캐릭터셋의 새로운 엔코더를 구축합니다.
String	toString () 이 캐릭터셋를 기술한 캐릭터 라인을 리턴합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

생성자 상세

Charset

protected Charset(String  canonicalName,
                  String [] aliases)

지정된 표준명과 별명세트를 사용해, 새로운 캐릭터셋를 초기화합니다.

파라미터:

canonicalName - 이 캐릭터셋의 표준명

aliases - 이 캐릭터셋의 별명의 배열 (별명이 없는 경우는 null)

예외:

IllegalCharsetNameException - 표준명 또는 별명이 부당한 경우

메서드의 상세

isSupported

public static boolean isSupported(String  charsetName)

지정된 캐릭터셋가 지원 되고 있는지를 판단합니다.

파라미터:

charsetName - 요구된 캐릭터셋의 이름. 표준명, 별명의 언젠가

반환값:

현재의 Java 가상 머신으로 지정된 캐릭터셋를 이용할 수 있는 경우에 한정해 true

예외:

IllegalCharsetNameException - 지정된 캐릭터셋명이 부당한 경우

forName

public static Charset  forName(String  charsetName)

지정된 캐릭터셋의 Charset 객체를 리턴합니다.

파라미터:

charsetName - 요점 제공된 캐릭터셋의 이름. 표준명, 별명의 언젠가

반환값:

지정된 캐릭터셋의 Charset 객체

예외:

IllegalCharsetNameException - 지정된 캐릭터셋명이 부당한 경우

UnsupportedCharsetException - 지정된 캐릭터셋가 이 Java 가상 머신 인스턴스상에서는 이용할 수 없는 경우

availableCharsets

public static SortedMap <String,
Charset > availableCharsets()

표준 캐릭터셋명으로부터 Charset 객체에의 소트된 맵을 구축합니다.

이 메서드로부터 리턴된 맵에는 현재의 Java 가상 머신으로 지원 되고 있는 각 캐릭터셋 마다 엔트리가 1개 씩 포함됩니다. 지원 되고 있는 캐릭터셋 속에 같은 표준명을 가지는 것이 복수 존재했을 경우, 결과의 맵에는 그 중의 1개 만이 포함됩니다. 다만, 어느 쪽의 캐릭터셋가 포함될까는 미정입니다.

이 메서드의 호출이나, 그 결과적으로 얻을 수 있던 맵을 이용하려면, 시간이 걸리는 디스크 입출력 조작이나 네트워크 입출력 조작이 발생할 가능성이 있습니다. 이 메서드는 사용자에 게 캐릭터셋를 선택시키는 경우 등, 사용 가능한 모든 캐릭터셋를 열거할 필요가 있는 어플리케이션용으로서 제공되고 있습니다. forName 메서드에서는 이 메서드를 사용하지 않고, 효율의 좋은 증분 검색 알고리즘을 채용하고 있습니다.

새로운 캐릭터셋 프로바이더가 현재의 Java 가상 머신에 대해서 동적으로 이용 가능하게 되는 경우, 이 메서드는 매회 다른 결과를 돌려줄 가능성이 있습니다. 그러한 변경이 발생하지 않는 경우는 이 메서드로부터 리턴된 캐릭터셋는 forName 메서드로부터 취득 가능한 캐릭터셋과 완전히 같게 됩니다.

반환값:

표준 캐릭터셋명으로부터 Charset 객체에의 불변 맵 (알파벳의 대문자와 소문자는 구별되지 않는다)

defaultCharset

public static Charset  defaultCharset()

이 Java 가상 머신의 디폴트의 캐릭터셋를 리턴합니다.

디폴트의 캐릭터셋는 가상 머신의 시작시로 결정됩니다만, 그것은 보통, OS 의 로케일과 캐릭터셋에 의해 정해집니다.

반환값:

디폴트의 캐릭터셋에 대한 Charset 객체

도입된 버전 :

1.5

name

public final String  name()

이 캐릭터셋의 표준명을 리턴합니다.

반환값:

이 캐릭터셋의 표준명

aliases

public final Set <String > aliases()

이 캐릭터셋의 별명이 포함되는 세트를 리턴합니다.

반환값:

이 캐릭터셋의 별명이 포함되는 불변세트

displayName

public String  displayName()

디폴트 로케일에 있어서의, 이 캐릭터셋의 이름 (가독형식)을 리턴합니다.

이 메서드의 디폴트 구현은 이 캐릭터셋의 표준명만을 리턴합니다. 이 클래스의 구상 서브 클래스에서 이 메서드를 오버라이드(override) 하면, 지역 대응의 표시명을 제공할 수 있습니다.

반환값:

디폴트 로케일에 있어서의, 이 캐릭터셋의 표시명

isRegistered

public final boolean isRegistered()

이 캐릭터셋가 IANA Charset Registry에 등록되어 있는지를 판단합니다.

반환값:

이 캐릭터셋가 IANA에 등록되어 있는 것을 구현자가 인식하고 있는 경우에 한정해 true

displayName

public String  displayName(Locale  locale)

지정된 로케일에 있어서의, 이 캐릭터셋의 이름 (가독형식)을 리턴합니다.

이 메서드의 디폴트 구현은 이 캐릭터셋의 표준명만을 리턴합니다. 이 클래스의 구상 서브 클래스에서 이 메서드를 오버라이드(override) 하면, 지역 대응의 표시명을 제공할 수 있습니다.

파라미터:

locale - 표시명을 취득하기 위한 로케일

반환값:

지정된 로케일에 있어서의 이 캐릭터셋의 표시명

contains

public abstract boolean contains(Charset  cs)

이 캐릭터셋로 지정된 캐릭터셋가 포함되어 있는지를 판단합니다.

캐릭터셋 D 로 표현할 수 있는 모든 문자를 캐릭터셋 C 에서도 표현할 수 있는 경우에 한정해, 캐릭터셋 C는 캐릭터셋 D를 「포함한다」라고 말할 수 있습니다 . 이 관계가 성립하고 있는 경우, 캐릭터셋 D에 encode 할 수 있는 모든 캐릭터 라인은 문자의 치환을 일절 실시하는 일 없이, 캐릭터셋 C 에도 encode 할 수 있습니다.

캐릭터셋 C가 캐릭터셋 D를 「포함한다」라고 말해도, 쌍방의 캐릭터셋가 개개의 문자를 표현하기 위해서 전혀 같은 바이트 순서를 사용하고 있다고는 할 수 없습니다.

모든 캐릭터셋에는 그 캐릭터셋 자신이 포함되어 있습니다.

이 메서드는 포함 관계의 근사치를 계산합니다. 이 메서드의 반환값이 true 이면, 지정된 캐릭터셋는 확실히 현재의 캐릭터셋에 포함되어 있습니다. 다만, 반환값이 false인 경우에서도, 지정된 캐릭터셋가 현재의 캐릭터셋에 포함되어 있는 일이 있습니다.

반환값:

지정된 캐릭터셋가 이 캐릭터셋에 포함되어 있는 경우에 한정해 true

newDecoder

public abstract CharsetDecoder  newDecoder()

이 캐릭터셋의 새로운 디코더를 구축합니다.

반환값:

이 캐릭터셋의 새로운 디코더

newEncoder

public abstract CharsetEncoder  newEncoder()

이 캐릭터셋의 새로운 엔코더를 구축합니다.

반환값:

이 캐릭터셋의 새로운 엔코더

예외:

UnsupportedOperationException - 이 캐릭터셋가 encode를 지원 하지 않는 경우

canEncode

public boolean canEncode()

이 캐릭터셋가 encode를 지원 할지 어떨지를 판단합니다.

캐릭터셋의 대부분은 encode를 지원 하고 있습니다만, 예외도 있습니다. 예를 들어 특수 목적의 「자동 검출」캐릭터셋 등입니다. 이 캐릭터셋의 디코더는 입력 바이트 순서를 조사하는 것으로 복수의 인코딩 방식 가운데 어떤 것이 사용되고 있을까를 결정할 수 있습니다. 이러한 캐릭터셋는 encode를 지원 하지 않습니다. 출력시에 사용해야 할 인코딩 방식을 특정할 수 없기 때문입니다. 이러한 캐릭터셋의 구현에서는 이 메서드를, false가 돌려주고지도록 오버라이드(override) 할 필요가 있습니다.

반환값:

이 캐릭터셋가 encode를 지원하는인 경우에 한정해 true

decode

public final CharBuffer  decode(ByteBuffer  bb)

이 캐릭터셋로 표현된 바이트를 Unicode 문자에 디코드하는 간이 메서드입니다.

이 메서드를 캐릭터셋 cs에 대해서 호출하면, 다음의 식과 같은 결과를 얻을 수 있습니다.

     cs.newDecoder()
       . onMalformedInput(CodingErrorAction.REPLACE)
       . onUnmappableCharacter(CodingErrorAction.REPLACE)
       . decode(bb); 

다만, 연속 호출시에 디코더를 캐쉬할 수 있다고 하는 점으로써, 이 메서드 쪽이 효율적입니다.

이 메서드는 부정 입력 순서나 맵 불가 문자 순서를, 이 캐릭터셋의 디폴트의 치환 바이트 배열로 옮겨놓습니다. 그러한 순서를 검출하는 경우는 CharsetDecoder.decode(java.nio.ByteBuffer) 메서드를 직접 사용해 주세요.

파라미터:

bb - 디코드하는 byte 버퍼

반환값:

디코드된 문자를 포함한 char 버퍼

encode

public final ByteBuffer  encode(CharBuffer  cb)

Unicode 문자를 이 캐릭터셋로 표현된 바이트에 encode 하는 간이 메서드입니다.

이 메서드를 캐릭터셋 cs에 대해서 호출하면, 다음의 식과 같은 결과를 얻을 수 있습니다.

     cs.newEncoder()
       . onMalformedInput(CodingErrorAction.REPLACE)
       . onUnmappableCharacter(CodingErrorAction.REPLACE)
       . encode(bb); 

다만, 연속 호출시에 엔코더를 캐쉬할 수 있다고 하는 점으로써, 이 메서드 쪽이 효율적입니다.

이 메서드는 부정 입력 순서나 맵 불가 문자 순서를, 이 캐릭터셋의 디폴트의 치환 캐릭터 라인으로 옮겨놓습니다. 그러한 순서를 검출하는 경우는 CharsetEncoder.encode(java.nio.CharBuffer) 메서드를 직접 사용해 주세요.

파라미터:

cb - encode 하는 char 버퍼

반환값:

encode 된 문자를 포함한 byte 버퍼

encode

public final ByteBuffer  encode(String  str)

캐릭터 라인을 이 캐릭터셋로 표현된 바이트에 encode 하는 간이 메서드입니다.

이 메서드를 캐릭터셋 cs에 대해서 호출하면, 다음의 식과 같은 결과를 얻을 수 있습니다.

     cs.encode(CharBuffer.wrap(s)); 

파라미터:

str - encode 하는 캐릭터 라인

반환값:

encode 된 문자를 포함한 byte 버퍼

compareTo

public final int compareTo(Charset  that)

이 캐릭터셋를 다른 캐릭터셋과 비교합니다.

캐릭터셋는 표준명 순서에 늘어놓을 수 있습니다 (알파벳의 대문자와 소문자는 구별되지 않는다).

정의:

인터페이스 Comparable <Charset > 내의 compareTo

파라미터:

that - 이 캐릭터셋과 비교하는 캐릭터셋

반환값:

이 캐릭터셋가 지정된 캐릭터셋보다 작은 경우는 부의 정수, 동일한 경우는 제로 큰 경우는 정의 정수

hashCode

public final int hashCode()

이 캐릭터셋의 해시 코드를 계산합니다.

오버라이드(override):

클래스 Object 내의 hashCode

반환값:

정수값 로 나타내지는 해시 코드

관련 항목:

Object.equals(java.lang.Object), Hashtable

equals

public final boolean equals(Object  ob)

이 객체가 다른 객체와 등가일지 어떨지를 판단합니다.

2개의 캐릭터셋는 같은 표준명을 가지고 있는 경우에 한정해 같습니다. 캐릭터셋가 다른 형태의 객체와 등가가 될 것은 없습니다.

오버라이드(override):

클래스 Object 내의 equals

파라미터:

ob - 비교 대상의 참조 객체

반환값:

이 캐릭터셋가 지정된 객체와 등가인 경우에 한정해 true

관련 항목:

Object.hashCode(), Hashtable

toString

public final String  toString()

이 캐릭터셋를 기술한 캐릭터 라인을 리턴합니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 캐릭터셋를 기술한 캐릭터 라인