|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.nio.channels.Channels
public final class Channels
チャネルとストリームのためのユーティリティーメソッドです。
このクラスは、java.io
パッケージのストリームクラスとこのパッケージのチャネルクラスの連携をサポートする static メソッドを定義します。
メソッドの概要 | |
---|---|
static ReadableByteChannel |
newChannel(InputStream in)
指定されたストリームからバイトを読み取るチャネルを構築します。 |
static WritableByteChannel |
newChannel(OutputStream out)
指定されたストリームへバイトを書き込むチャネルを構築します。 |
static InputStream |
newInputStream(ReadableByteChannel ch)
指定されたチャネルからバイトを読み取るストリームを構築します。 |
static OutputStream |
newOutputStream(WritableByteChannel ch)
指定されたチャネルへバイトを書き込むストリームを構築します。 |
static Reader |
newReader(ReadableByteChannel ch,
CharsetDecoder dec,
int minBufferCap)
指定されたデコーダを使って指定されたチャネルバイトをデコードするリーダーを構築します。 |
static Reader |
newReader(ReadableByteChannel ch,
String csName)
指定文字セットに従って指定されたチャネルからバイトをデコードするリーダーを構築します。 |
static Writer |
newWriter(WritableByteChannel ch,
CharsetEncoder enc,
int minBufferCap)
指定されたエンコーダを使って文字をエンコードし、結果として得られたバイトを指定されたチャネルに書き込むライターを構築します。 |
static Writer |
newWriter(WritableByteChannel ch,
String csName)
指定文字セットに従って文字をエンコードし、結果として得られたバイトを指定されたチャネルに書き込むライターを構築します。 |
クラス java.lang.Object から継承されたメソッド |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
メソッドの詳細 |
---|
public static InputStream newInputStream(ReadableByteChannel ch)
結果として得られるストリームの read メソッドは、基本となるチャネルが非ブロックモードである場合に呼び出されると、IllegalBlockingModeException
をスローします。ストリームはバッファーされず、mark
メソッドや reset
メソッドをサポートしません。ストリームは複数の並行スレッドからのアクセスに対して安全です。ストリームをクローズするとチャネルもクローズします。
ch
- バイトが読み込まれるチャネル
public static OutputStream newOutputStream(WritableByteChannel ch)
結果として得られるストリームの write メソッドは、基本となるチャネルが非ブロックモードである場合に呼び出されると、IllegalBlockingModeException
をスローします。ストリームはバッファーに書き込まれません。ストリームは複数の並行スレッドからのアクセスに対して安全です。ストリームをクローズするとチャネルもクローズします。
ch
- バイトが書き込まれるチャネル
public static ReadableByteChannel newChannel(InputStream in)
結果として得られるチャネルはバッファーされず、指定されたストリームに入出力操作をリダイレクトします。チャネルをクローズするとストリームもクローズします。
in
- バイトの読み込み先ストリーム
public static WritableByteChannel newChannel(OutputStream out)
結果として得られるチャネルはバッファーされず、指定されたストリームに入出力操作をリダイレクトします。チャネルをクローズするとストリームもクローズします。
out
- バイトの書き込み先ストリーム
public static Reader newReader(ReadableByteChannel ch, CharsetDecoder dec, int minBufferCap)
結果として得られるストリームには、minBufferCap バイト以上の内部入力バッファーが含まれています。ストリームの read メソッドは、必要に応じて基本となるチャネルからバイトを読み込み、バッファーに入れます。 バイトの読み込み時にチャネルが非ブロックモードになっていると、IllegalBlockingModeException
がスローされます。結果として得られるストリームは、それ以外の点ではバッファーされず、mark
メソッドや reset
メソッドをサポートしません。ストリームをクローズするとチャネルもクローズします。
ch
- バイトが読み込まれるチャネルdec
- 使用する文字セットデコーダminBufferCap
- 内部 byte バッファーの最小容量。または、実装に依存するデフォルトの容量を
使用する場合は -1
public static Reader newReader(ReadableByteChannel ch, String csName)
次のフォームのメソッド呼び出しは、
上記のメソッドは、次の表現と同様に動作します。Channels.newReader(ch, csname)
Channels.newReader(ch, Charset.forName(csName) .newDecoder(), -1);
ch
- バイトが読み込まれるチャネルcsName
- 使用する文字セットの名前
UnsupportedCharsetException
- 指定文字セットが現在の Java 仮想マシンでは利用できない場合public static Writer newWriter(WritableByteChannel ch, CharsetEncoder enc, int minBufferCap)
結果として得られるストリームには、minBufferCap バイト以上の内部出力バッファーが含まれています。ストリームの write メソッドは、必要に応じて基本となるチャネルにバイトを書き込み、バッファーをフラッシュします。 バイトの書き込み時にチャネルが非ブロックモードになっていると、IllegalBlockingModeException
がスローされます。結果として得られるストリームは、それ以外の点ではバッファーされません。ストリームをクローズするとチャネルもクローズします。
ch
- バイトが書き込まれるチャネルenc
- 使用する文字セットエンコーダminBufferCap
- 内部 byte バッファーの最小容量。または、実装に依存するデフォルトの容量を
使用する場合は -1
public static Writer newWriter(WritableByteChannel ch, String csName)
次のフォームのメソッド呼び出しは、
上記のメソッドは、次の表現と同様に動作します。Channels.newWriter(ch, csname)
Channels.newWriter(ch, Charset.forName(csName) .newEncoder(), -1);
ch
- バイトが書き込まれるチャネルcsName
- 使用する文字セットの名前
UnsupportedCharsetException
- 指定文字セットが現在の Java 仮想マシンでは利用できない場合
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。