パッケージ java.nio.charset
| クラス名 | 説明 |
|---|---|
Charset |
文字とバイト間の指定された マッピング |
CharsetDecoder |
バイトから文字へのデコード |
CharsetEncoder |
文字からバイトへのエンコード |
CoderResult |
コーダーの結果の説明 |
CodingErrorAction |
コーディング・エラーが検出されたときに 実行するアクションの説明 |
文字セットは、「RFC 2278」で定義されている、16ビットUnicode文字シーケンスとバイト・シーケンスとの間の指定マッピングです。 デコーダは、特定の文字セットで表現されたバイトを文字に変換するエンジンです。エンコーダは、文字をバイトに変換するエンジンです。 エンコーダとデコーダは、byteバッファやcharバッファを操作します。 この2つをまとめてコーダーと呼びます。
Charsetクラスは、特定の文字セット用のコーダーを作成するメソッドや、文字セットに関連したさまざまな名前を取得するメソッドを定義します。 さらに、特定の文字セットがサポートされているかどうかをテストするstaticメソッド、名前から文字セットのインスタンスを検索するstaticメソッド、現在のJava仮想マシンでサポートされているすべての文字セットのマップを構築するstaticメソッドも定義します。
ほとんどのユーザーは、これらのクラスを直接使用する代わりに、Stringクラスにある既存の文字セット関連のコンストラクタおよびメソッドと、既存のInputStreamReaderクラスおよびOutputStreamWriterクラスを使用します。これらの実装はすべて、このパッケージで定義されている文字セット機能を活用できるように作り直されました。 特に、InputStreamReaderクラスとOutputStreamWriterクラスには、そのインスタンスの構築時に明示的に文字セット・オブジェクトを指定できるように、若干の変更が加えられています。
新しい文字セットのサポートは、java.nio.charset.spiパッケージのCharsetProviderクラスで定義されているインタフェースを介して利用できます。
ほかで指定がない場合、null引数をこのパッケージの任意のクラスまたはインタフェースのメソッドまたはコンストラクタへ渡すと、NullPointerExceptionがスローされます。
- 導入されたバージョン:
- 1.4
-
クラスのサマリー クラス 説明 Charset 16ビットUnicode コード単位のシーケンスとバイト・シーケンス間の指定マップです。CharsetDecoder 特定の文字セットで表現されたバイト・シーケンスを16ビットUnicode文字のシーケンスに変換するエンジンです。CharsetEncoder 16ビットUnicode文字のシーケンスを特定の文字セットで表現されたバイト・シーケンスに変換するエンジンです。CoderResult コーダーの結果状態の説明です。CodingErrorAction コーディング・エラーが発生したときに実行するアクションの型保証された列挙です。StandardCharsets 標準charsets用の定数定義。 -
例外のサマリー Exception 説明 CharacterCodingException 文字のエンコード・エラーやデコード・エラーが発生したときにスローされるチェック例外です。IllegalCharsetNameException ある文字列が、正当な文字セット名ではないのに正当であるかのように使用された場合にスローされる非チェック例外です。MalformedInputException 入力バイト・シーケンスが指定文字セットにとって正当でない場合、または入力文字シーケンスが16ビットの正規Unicodeシーケンスでない場合にスローされるチェック例外です。UnmappableCharacterException 入力文字(またはバイト)シーケンスは有効だが出力バイト(または文字)シーケンスにマップできない場合にスローされるチェック例外です。UnsupportedCharsetException 要求された文字セットがサポートされない場合にスローされる非チェック例外です。 -
エラーのサマリー エラー 説明 CoderMalfunctionError CharsetDecoderのdecodeLoopメソッドまたはCharsetEncoderのencodeLoopメソッドから予期しない例外がスローされたときにスローされるエラーです。