com.sun.grizzly.util
Class InputReader

java.lang.Object
  java.io.InputStream
      com.sun.grizzly.util.InputReader

All Implemented Interfaces:

java.io.Closeable

Direct Known Subclasses:

ByteBufferInputStream

public class InputReader
extends java.io.InputStream

This class implement IO stream operations on top of a ByteBuffer. Under the hood, this class use a temporary Selector pool for reading bytes when the client ask for more and the current Selector is not yet ready.

Author:

Jeanfrancois Arcand

Nested Class Summary

static class

InputReader.ChannelType The Channel type is used to avoid invoking the instanceof operation when registering the Socket|Datagram Channel to the Selector.

Field Summary

protected java.nio.ByteBuffer	byteBuffer The wrapped ByteBuffer
protected java.nio.ByteBuffer	inputBB The encrypted ByteBuffer
java.nio.channels.SelectionKey	key The SelectionKey used by this stream.
protected int	readTimeout The time to wait before timing out when reading bytes
protected javax.net.ssl.SSLEngine	sslEngine The SSLEngine to use for unwrapping bytes.

Constructor Summary

InputReader()

InputReader(java.nio.ByteBuffer byteBuffer)

Method Summary

int	available() Return the available bytes
void	close() Close this stream.
protected int	doClearRead()
protected int	doRead() Read bytes using the read ReadSelector
protected int	doSecureRead() Read and decrypt bytes from the underlying SSL connections.
java.nio.ByteBuffer	getByteBuffer() Get the wrapped ByteBuffer
InputReader.ChannelType	getChannelType() Return the Channel type.
static int	getDefaultReadTimeout() Return the Selector.select() default time out.
java.nio.ByteBuffer	getInputBB()
int	getReadTimeout() Return the timeout between two consecutives Selector.select() when a temporary Selector is used.
javax.net.ssl.SSLEngine	getSslEngine()
boolean	isSecure() Is this Stream secure.
boolean	markSupported() Return true if mark is supported.
int	read() Read the first byte from the wrapped ByteBuffer.
int	read(byte[] b) Read the bytes from the wrapped ByteBuffer.
int	read(byte[] b, int offset, int length) Read the first byte of the wrapped ByteBuffer.
int	read(java.nio.ByteBuffer bb) Read the bytes of the wrapped ByteBuffer.
void	recycle() Recycle this object.
void	setByteBuffer(java.nio.ByteBuffer byteBuffer) Set the wrapped ByteBuffer
void	setChannelType(InputReader.ChannelType channelType) Set the Channel type, which is ocketChannel or DatagramChannel.
static void	setDefaultReadTimeout(int aDefaultReadTimeout) Set the default Selector.select() time out.
void	setInputBB(java.nio.ByteBuffer inputBB)
void	setReadTimeout(int rt) Set the timeout between two consecutives Selector.select() when a temporary Selector is used.
void	setSecure(boolean secure) Set this stream secure.
void	setSelectionKey(java.nio.channels.SelectionKey key) Set the SelectionKey used to reads bytes.
void	setSslEngine(javax.net.ssl.SSLEngine sslEngine)

Methods inherited from class java.io.InputStream

mark, reset, skip

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

byteBuffer

protected java.nio.ByteBuffer byteBuffer

The wrapped ByteBuffer

inputBB

protected java.nio.ByteBuffer inputBB

The encrypted ByteBuffer

key

public java.nio.channels.SelectionKey key

The SelectionKey used by this stream.

readTimeout

protected int readTimeout

The time to wait before timing out when reading bytes

sslEngine

protected javax.net.ssl.SSLEngine sslEngine

The SSLEngine to use for unwrapping bytes.

Constructor Detail

InputReader

public InputReader()

InputReader

public InputReader(java.nio.ByteBuffer byteBuffer)

Method Detail

setByteBuffer

public void setByteBuffer(java.nio.ByteBuffer byteBuffer)

Set the wrapped ByteBuffer

Parameters:

byteBuffer - The wrapped byteBuffer

getByteBuffer

public java.nio.ByteBuffer getByteBuffer()

Get the wrapped ByteBuffer

Returns:

ByteBuffer

available

public int available()

Return the available bytes

Overrides:

available in class java.io.InputStream

Returns:

the wrapped byteBuffer.remaining()

close

public void close()

Close this stream.

Specified by:

close in interface java.io.Closeable

Overrides:

close in class java.io.InputStream

markSupported

public boolean markSupported()

Return true if mark is supported.

Overrides:

markSupported in class java.io.InputStream

read

public int read()
         throws java.io.IOException

Read the first byte from the wrapped ByteBuffer.

Specified by:

read in class java.io.InputStream

Throws:

java.io.IOException

read

public int read(byte[] b)
         throws java.io.IOException

Read the bytes from the wrapped ByteBuffer.

Overrides:

read in class java.io.InputStream

Throws:

java.io.IOException

read

public int read(byte[] b,
                int offset,
                int length)
         throws java.io.IOException

Read the first byte of the wrapped ByteBuffer.

Overrides:

read in class java.io.InputStream

Parameters:

offset -

length -

Throws:

java.io.IOException

read

public int read(java.nio.ByteBuffer bb)
         throws java.io.IOException

Read the bytes of the wrapped ByteBuffer.

Parameters:

bb - ByteBuffer

Returns:

- number of bytes read

Throws:

java.io.IOException

recycle

public void recycle()

Recycle this object.

setSelectionKey

public void setSelectionKey(java.nio.channels.SelectionKey key)

Set the SelectionKey used to reads bytes.

Parameters:

key - SelectionKey

doRead

protected int doRead()
              throws java.io.IOException

Read bytes using the read ReadSelector

Returns:

- number of bytes read

Throws:

java.io.IOException

doSecureRead

protected int doSecureRead()
                    throws java.io.IOException

Read and decrypt bytes from the underlying SSL connections. All the SSLEngine operations are delegated to class SSLUtils.

Returns:

number of bytes read

Throws:

java.io.IOException

doClearRead

protected int doClearRead()
                   throws java.io.IOException

Throws:

java.io.IOException

getReadTimeout

public int getReadTimeout()

Return the timeout between two consecutives Selector.select() when a temporary Selector is used.

Returns:

read timeout being used

setReadTimeout

public void setReadTimeout(int rt)

Set the timeout between two consecutives Selector.select() when a temporary Selector is used.

Parameters:

rt - - read timeout

getDefaultReadTimeout

public static int getDefaultReadTimeout()

Return the Selector.select() default time out.

Returns:

default time out

setDefaultReadTimeout

public static void setDefaultReadTimeout(int aDefaultReadTimeout)

Set the default Selector.select() time out.

Parameters:

aDefaultReadTimeout - time out value

getChannelType

public InputReader.ChannelType getChannelType()

Return the Channel type. The return value is SocketChannel or DatagramChannel.

Returns:

Channel being used

setChannelType

public void setChannelType(InputReader.ChannelType channelType)

Set the Channel type, which is ocketChannel or DatagramChannel.

Parameters:

channelType - Channel to use

isSecure

public boolean isSecure()

Is this Stream secure.

Returns:

true is stream is secure, otherwise false

setSecure

public void setSecure(boolean secure)

Set this stream secure.

Parameters:

secure - true to set stream secure, otherwise false

getSslEngine

public javax.net.ssl.SSLEngine getSslEngine()

setSslEngine

public void setSslEngine(javax.net.ssl.SSLEngine sslEngine)

getInputBB

public java.nio.ByteBuffer getInputBB()

setInputBB

public void setInputBB(java.nio.ByteBuffer inputBB)