■

java.nio.charset.Charset;
java.nio.charset.CharsetEncoder;
java.nio.charset.CharsetDecoder;

・生成
　・Charset#forName
public static Charset forName(String charsetName)

Charsetrオブジェクトを生成するためのファクトリメソッドです。引数は文字集合名です。文字集合名にはIANAで定義されている正準名とエイリアスがあります。例えば、シフトJISの場合、Shift_JISが正準名で、MS_KanjiやShift-JISなどがエイリアスになります。リスト1ではシフトJISのCharsetオブジェクトを正準名とエイリアスで生成しています。

・リスト 1 シフトJISのCharsetオブジェクトの生成例

Charset charset1 = Charset.forName("Shift_JIS");
Charset charset2 = Charset.forName("MS_Kanji");
Charset charset3 = Charset.forName("Shift-JIS");

・CharsetEncoderオブジェクトの生成
　・Charset#newEncoder
public CharsetEncoder newEncoder()

CharsetオブジェクトからCharsetEncoderを生成します。

・CharsetDecoderオブジェクトの生成
　・Charset#newDecoder
public CharsetDecoder newDecoder()

CharsetオブジェクトからCharsetDecoderを生成します。

・char列からbyte列への変換
　・Charset#encoder
　・CharsetEncoder#encode

public ByteBuffer encode(CharBuffer cb)
public ByteBuffer encode(String str)
public ByteBuffer encode(CharBuffer in)
public CoderResult encode(CharBuffer in, ByteBuffer out, boolean endOfInput)

char列からbyte列に変換するencodeメソッドはCharsetクラスとCharsetEncoderクラスの両方に定義されていますが、Charsetクラスで定義されたものはCharsetEncodeクラスのencodeメソッドをコールしているだけの簡易メソッドになっています。

CharBufferもしくはStinrが引数のencodeメソッドは一括変換を行います。しかし、一括で変換することができない場合、endOfInputを引数とするencodeメソッドを利用します。このメソッドの使用法は次のようになります。

reset() メソッドをコールして初期化する
追加の入力が無くなるまでencodeメソッドを繰り返しコールする。このときendOfInputはfalseにしておく
最後の入力の時にendOfInputをtrueにして、encodeメソッドをコールする
flush()メソッドを使用して変換結果をフラッシュする
リスト2にCharset#encodeメソッドと一括変換を行うCharsetEncoder#encodeメソッドの例を示します。また、リスト3に逐次変換を行うCharsetEncode#encodeの例を示します。

・リスト 2 char列からbyte列への一括変換

CharBuffer chbuf = CharBuffer.wrap("あいうえおかきくけこ");

Charset charset = Charset.forName("Shift_JIS");
CharsetEncoder encoder = charset.newEncoder();

// Charset#encode を使用
ByteBuffer result1 = charset.encode(chbuf);
// CharsetEncoder#encode を使用
ByteBuffer result2 = encoder.encode(chbuf);

・リスト 3 char列からbyte列への逐次変換

CharBuffer chbufs = new CharBuffer[3] {
CharBuffer.wrap("あいうえおかきくけこ"),
CharBuffer.wrap("さしすせそたちつてと"),
CharBuffer.wrap("なにぬねのはひふへほ") };

Charset charset = Charset.forName("Shift_JIS");
CharsetEncoder encoder = charset.newEncoder();

ByteBuffer bybuf = ByteBuffer.allocate(50);

encoder.reset();
int i;
for (i = 0 ; i < chbufs.length -1 ; i++) {
encoder.encode(chbufs[i], bybuf, false);
}
encoder.encode(chbufs[i], bybuf, true);
encoder.flush(bybuf);

・byte列からchar列への変換
　・Charset#decoder
　・CharsetDecoder#decode

public CahrBuffer decode(ByteBuffer bb)
public CharBuffer decode(ByteBuffer in)
public CoderResult decode(ByteBuffer in, CharBuffer out, boolean endOfInput)

char列からbyte列に変換するdecodeメソッドもCharsetクラスとCharsetDecoderクラスの両方に定義されており、encodeメソッドと同様にCharsetクラスで定義されたものは簡易メソッドです。

CharsetDecoderで定義されているdecodeメソッドはencodeと同様に一括変換と逐次変換の両方をサポートしています。逐次変換の使用法はencodeの場合と同じです。

リスト4にCharset#decodeメソッドと一括変換を行うCharsetDecoder#decodeメソッドの例を示します。また、リスト5は逐次変換の例です。

・リスト 4 byte列からchar列への一括変換

ByteBuffer bybuf = ByteBuffer.wrap(new byte{0x82, 0xa0, 0x82, 0xa2, 0x82, 0xa4});

Charset charset = Charset.forName("Shift_JIS");
CharsetDecoder decoder = charset.newDecoder();

// Charset#decode を使用
CharBuffer result1 = charset.decode(bybuf);
// CharsetDecoder#decode を使用
CharBuffer result2 = decoder.decode(bybuf);

・リスト 5 byte列からchar列への逐次変換

ByteBuffer bybufs = new ByteBuffer[3] {
ByteBuffer.wrap(new byte{0x82, 0xa0, 0x82, 0xa2, 0x82, 0xa4}),
ByteBuffer.wrap(new byte{0x82, 0xa6, 0x82, 0xa8, 0x82, 0xa9}),
ByteBuffer.wrap(new byte{0x82, 0xab, 0x82, 0xad, 0x82, 0xaf}) };

Charset charset = Charset.forName("Shift_JIS");
CharsetEncoder encoder = charset.newEncoder();

CharBuffer chbuf = CharBuffer.allocate(50);

decoder.reset();
int i;
for (i = 0 ; i < bybufs.length -1 ; i++) {
decoder.decode(bybufs[i], chbuf, false);
}

decoder.decode(bybufs[i], chbuf, true);
decoder.flush(chbuf);