Channels

newChannel

public static ReadableByteChannel newChannel (InputStream in)

Constructs a channel that reads bytes from the given stream.

The resulting channel will not be buffered; it will simply redirect its I/O operations to the given stream. Closing the channel will in turn cause the stream to be closed.

newChannel

public static WritableByteChannel newChannel (OutputStream out)

Constructs a channel that writes bytes to the given stream.

The resulting channel will not be buffered; it will simply redirect its I/O operations to the given stream. Closing the channel will in turn cause the stream to be closed.

newInputStream

public static InputStream newInputStream (ReadableByteChannel ch)

Constructs a stream that reads bytes from the given channel.

The read methods of the resulting stream will throw an IllegalBlockingModeException if invoked while the underlying channel is in non-blocking mode. The stream will not be buffered, and it will not support the mark or reset methods. The stream will be safe for access by multiple concurrent threads. Closing the stream will in turn cause the channel to be closed.

newInputStream

public static InputStream newInputStream (AsynchronousByteChannel ch)

Constructs a stream that reads bytes from the given channel.

The stream will not be buffered, and it will not support the mark or reset methods. The stream will be safe for access by multiple concurrent threads. Closing the stream will in turn cause the channel to be closed.

newOutputStream

public static OutputStream newOutputStream (AsynchronousByteChannel ch)

Constructs a stream that writes bytes to the given channel.

The stream will not be buffered. The stream will be safe for access by multiple concurrent threads. Closing the stream will in turn cause the channel to be closed.

newOutputStream

public static OutputStream newOutputStream (WritableByteChannel ch)

Constructs a stream that writes bytes to the given channel.

The write methods of the resulting stream will throw an IllegalBlockingModeException if invoked while the underlying channel is in non-blocking mode. The stream will not be buffered. The stream will be safe for access by multiple concurrent threads. Closing the stream will in turn cause the channel to be closed.

newReader

public static Reader newReader (ReadableByteChannel ch, 
                Charset charset)

Constructs a reader that decodes bytes from the given channel according to the given charset.

An invocation of this method of the form

 Channels.newReader(ch, charset)
  

 Channels.newReader(ch, Charset.forName(csName).newDecoder(), -1)
  

The reader's default action for malformed-input and unmappable-character errors is to report them. When more control over the error handling is required, the constructor that takes a CharsetDecoder should be used.

newReader

public static Reader newReader (ReadableByteChannel ch, 
                CharsetDecoder dec, 
                int minBufferCap)

Constructs a reader that decodes bytes from the given channel using the given decoder.

The resulting stream will contain an internal input buffer of at least minBufferCap bytes. The stream's read methods will, as needed, fill the buffer by reading bytes from the underlying channel; if the channel is in non-blocking mode when bytes are to be read then an IllegalBlockingModeException will be thrown. The resulting stream will not otherwise be buffered, and it will not support the mark or reset methods. Closing the stream will in turn cause the channel to be closed.

newReader

public static Reader newReader (ReadableByteChannel ch, 
                String csName)

Constructs a reader that decodes bytes from the given channel according to the named charset.

An invocation of this method of the form

 Channels.newReader(ch, csname)
  

 Channels.newReader(ch, Charset.forName(csName))
  

newWriter

public static Writer newWriter (WritableByteChannel ch, 
                CharsetEncoder enc, 
                int minBufferCap)

Constructs a writer that encodes characters using the given encoder and writes the resulting bytes to the given channel.

The resulting stream will contain an internal output buffer of at least minBufferCap bytes. The stream's write methods will, as needed, flush the buffer by writing bytes to the underlying channel; if the channel is in non-blocking mode when bytes are to be written then an IllegalBlockingModeException will be thrown. The resulting stream will not otherwise be buffered. Closing the stream will in turn cause the channel to be closed.

newWriter

public static Writer newWriter (WritableByteChannel ch, 
                Charset charset)

Constructs a writer that encodes characters according to the given charset and writes the resulting bytes to the given channel.

An invocation of this method of the form

 Channels.newWriter(ch, charset)
  

 Channels.newWriter(ch, Charset.forName(csName).newEncoder(), -1)
  

The writer's default action for malformed-input and unmappable-character errors is to report them. When more control over the error handling is required, the constructor that takes a CharsetEncoder should be used.

newWriter

public static Writer newWriter (WritableByteChannel ch, 
                String csName)

Constructs a writer that encodes characters according to the named charset and writes the resulting bytes to the given channel.

An invocation of this method of the form

 Channels.newWriter(ch, csname)
  

 Channels.newWriter(ch, Charset.forName(csName))