This interface extends WritableByteChannel and adds two additional write( ) methods that can "gather" bytes from one or more buffers and write them out to the channel. These methods are passed an array of ByteBuffer objects, and, optionally, an offset and length that define the relevant sub-array to be used. The write( ) method attempts to write all the remaining bytes from all the specified buffers (in the order in which they appear in the buffer array) to the channel. The return value of the method is the number of bytes actually written. See WritableByteChannel for a discussion of exceptions and thread-safety that apply to these write( ) methods as well.

Figure 13-25. java.nio.channels.GatheringByteChannel

public interface GatheringByteChannel extends WritableByteChannel {
// Public Instance Methods
     long write(java.nio.ByteBuffer[ ] srcs) throws java.io.IOException;  
     long write(java.nio.ByteBuffer[ ] srcs, int offset, int length) 
        throws java.io.IOException;  
}

Implementations

DatagramChannel, FileChannel, Pipe.SinkChannel, SocketChannel