java.nio.channels

インタフェース WritableByteChannel

すべてのスーパーインタフェース:

AutoCloseable, Channel, Closeable

既知のすべてのサブインタフェース:

ByteChannel, GatheringByteChannel, SeekableByteChannel

既知のすべての実装クラス:

DatagramChannel, FileChannel, Pipe.SinkChannel, SocketChannel

public interface WritableByteChannel
extends Channel

バイトを書き込むことができるチャネルです。

書き込み可能なチャネル上で、並行して複数の書き込み操作を実行することはできません。チャネル上で書き込み操作を開始したスレッドがある場合、新たな書き込み操作を開始しようとするその他のスレッドは、最初の操作が完了するまでブロックされます。書き込み操作とその他の入出力操作を同時並行で実行できるかどうかは、チャネルの種類によって決まります。

導入されたバージョン:

1.4

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
int	write(ByteBuffer src) このチャネルのバイトシーケンスを指定のバッファーから書き出します。

インタフェース java.nio.channels.Channel から継承されたメソッド

close, isOpen

メソッドの詳細

write

int write(ByteBuffer src)
          throws IOException

このチャネルのバイトシーケンスを指定のバッファーから書き出します。

チャネルに最大 r バイトを書き込もうとします。r は、このメソッドを呼び出すときにバッファー内に残っているバイト数、src.remaining() になります。

長さ n (0 <= n <= r) のバイトシーケンスが書き込まれるとします。このバイトシーケンスは、バッファーのインデックス p から転送されます。p は、このメソッドが呼び出されるときのバッファーの位置です。書き込まれる最後のバイトのインデックスは p + n - 1 になります。バッファーの位置は、終了時に p + n に等しくなります。リミットに変化はありません。

特に指定がないかぎり、要求された r バイトがすべて書き込まれると書き込み操作は終了します。チャネルの種類によっては、その状態に応じて、一部のバイトしか書き込まれない場合や、まったく書き込みが行われない場合もあります。たとえば非ブロックモードのソケットチャネルでは、ソケットの出力バッファー内のバイト数が最大書き込みバイト数になります。

このメソッドはいつでも呼び出すことができます。ただし、ほかのスレッドがこのチャネルに対して書き込み操作を開始している場合、このメソッドの呼び出しは最初の操作が終わるまでブロックされます。

パラメータ:

src - バイトの取得先バッファー

戻り値:

書き込まれるバイト数。ゼロの場合もある

例外:

NonWritableChannelException - このチャネルが書き込み可能でない場合

ClosedChannelException - このチャネルがクローズしている場合

AsynchronousCloseException - 書き込み操作の進行中に別のスレッドによってこのチャネルがクローズされた場合

ClosedByInterruptException - 書き込み中に別のスレッドからの割り込みがあったためにチャネルがクローズし、現在のスレッドの割り込みステータスが設定された場合

IOException - その他の入出力エラーが発生した場合