private class AsynchronousSocketChannelStream.AsyncWritableByteChannelAdapter extends java.lang.Object implements AsyncWritableByteChannel
Modifier and Type | Class and Description |
---|---|
private class |
AsynchronousSocketChannelStream.AsyncWritableByteChannelAdapter.WriteCompletionHandler |
Modifier | Constructor and Description |
---|---|
private |
AsyncWritableByteChannelAdapter() |
Modifier and Type | Method and Description |
---|---|
void |
write(java.nio.ByteBuffer src,
AsyncCompletionHandler<java.lang.Void> handler)
Writes a sequence of bytes to this channel from the given buffer.
|
public void write(java.nio.ByteBuffer src, AsyncCompletionHandler<java.lang.Void> handler)
AsyncWritableByteChannel
This method initiates an asynchronous write operation to write a
sequence of bytes to this channel from the given buffer. The handler
parameter is a completion handler that is invoked when the write
operation completes (or fails). The result passed to the completion
handler is the number of bytes written.
The write operation may write up to r bytes to the channel,
where r is the number of bytes remaining in the buffer, that is,
src.remaining()
at the time that the write is attempted. Where
r is 0, the write operation completes immediately with a result of
0
without initiating an I/O operation.
Suppose that a byte sequence of length n is written, where 0 < n <= r. This byte sequence will be transferred from the buffer starting at index p, where p is the buffer's position at the moment the write is performed; the index of the last byte written will be p + n - 1. Upon completion the buffer's position will be equal to p + n; its limit will not have changed.
Buffers are not safe for use by multiple concurrent threads so care should be taken to not access the buffer until the operation has completed.
This method may be invoked at any time. Some channel types may not
allow more than one write to be outstanding at any given time. If a thread
initiates a write operation before a previous write operation has
completed then a WritePendingException
will be thrown.
write
in interface AsyncWritableByteChannel
src
- The buffer from which bytes are to be retrievedhandler
- The completion handler object