|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Objectjava.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 2 Platform Standard Ed. 5.0 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。