|
JavaTM 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.nio.channels.Channels
チャネルとストリームのためのユーティリティメソッドです。
このクラスは、java.io パッケージのストリームクラスとこのパッケージのチャネルクラスの連携をサポートする静的メソッドを定義します。
メソッドの概要 | |
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)
結果として得られるチャネルはバッファされず、指定されたストリームに入出力操作をリダイレクトします。チャネルをクローズするとストリームもクローズします。
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 2 Platform Std. Ed. v1.4.0 |
||||||||||
前のクラス 次のクラス | フレームあり フレームなし | ||||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.