org.eclipse.jetty.io

Class ChannelEndPoint

java.lang.Object

org.eclipse.jetty.io.IdleTimeout

org.eclipse.jetty.io.AbstractEndPoint

org.eclipse.jetty.io.ChannelEndPoint

All Implemented Interfaces:

Closeable, AutoCloseable, EndPoint, SocketBased

Direct Known Subclasses:

SelectChannelEndPoint

public class ChannelEndPoint
extends AbstractEndPoint
implements SocketBased

Channel End Point.

Holds the channel and socket for an NIO endpoint.

Constructor Summary

Constructors

Constructor and Description
ChannelEndPoint(Scheduler scheduler, SocketChannel channel)

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Close any backing stream associated with the endpoint
int	fill(ByteBuffer buffer) Fill the passed buffer with data from this endpoint.
boolean	flush(ByteBuffer... buffers) Flush data from the passed header/buffer to this endpoint.
ByteChannel	getChannel()
Socket	getSocket()
Object	getTransport()
boolean	isInputShutdown() Test if the input is shutdown.
boolean	isOpen() This abstract method should be called to check if idle timeouts should still be checked.
boolean	isOutputShutdown() Test if output is shutdown.
protected boolean	needsFill()
protected void	onIncompleteFlush()
protected void	shutdownInput()
void	shutdownOutput() Shutdown the output.

Methods inherited from class org.eclipse.jetty.io.AbstractEndPoint

fillInterested, getConnection, getCreatedTimeStamp, getFillInterest, getLocalAddress, getRemoteAddress, getWriteFlusher, onClose, onIdleExpired, onOpen, setConnection, toString, write

Methods inherited from class org.eclipse.jetty.io.IdleTimeout

checkIdleTimeout, getIdleTimeout, getIdleTimestamp, notIdle, setIdleTimeout

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.io.EndPoint

getIdleTimeout, setIdleTimeout

Constructor Detail

ChannelEndPoint

public ChannelEndPoint(Scheduler scheduler,
               SocketChannel channel)

Method Detail

isOpen

public boolean isOpen()

Description copied from class: IdleTimeout

This abstract method should be called to check if idle timeouts should still be checked.

Specified by:

isOpen in interface EndPoint

Specified by:

isOpen in class IdleTimeout

Returns:

True if the entity monitored should still be checked for idle timeouts

shutdownInput

protected void shutdownInput()

shutdownOutput

public void shutdownOutput()

Description copied from interface: EndPoint

Shutdown the output.

This call indicates that no more data will be sent on this endpoint that that the remote end should read an EOF once all previously sent data has been consumed. Shutdown may be done either at the TCP/IP level, as a protocol exchange (Eg TLS close handshake) or both.

If the endpoint has EndPoint.isInputShutdown() true, then this call has the same effect as EndPoint.close().

Specified by:

shutdownOutput in interface EndPoint

isOutputShutdown

public boolean isOutputShutdown()

Description copied from interface: EndPoint

Test if output is shutdown. The output is shutdown by a call to EndPoint.shutdownOutput() or EndPoint.close().

Specified by:

isOutputShutdown in interface EndPoint

Returns:

true if the output is shutdown or the endpoint is closed.

isInputShutdown

public boolean isInputShutdown()

Description copied from interface: EndPoint

Test if the input is shutdown. The input is shutdown if an EOF has been read while doing a EndPoint.fill(ByteBuffer). Once the input is shutdown, all calls to EndPoint.fill(ByteBuffer) will return -1, until such time as the end point is close, when they will return EofException.

Specified by:

isInputShutdown in interface EndPoint

Returns:

True if the input is shutdown or the endpoint is closed.

close

public void close()

Description copied from interface: EndPoint

Close any backing stream associated with the endpoint

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface EndPoint

Overrides:

close in class AbstractEndPoint

fill

public int fill(ByteBuffer buffer)
         throws IOException

Description copied from interface: EndPoint

Fill the passed buffer with data from this endpoint. The bytes are appended to any data already in the buffer by writing from the buffers limit up to it's capacity. The limit is updated to include the filled bytes.

Specified by:

fill in interface EndPoint

Parameters:

buffer - The buffer to fill. The position and limit are modified during the fill. After the operation, the position is unchanged and the limit is increased to reflect the new data filled.

Returns:

an int value indicating the number of bytes filled or -1 if EOF is read or the input is shutdown.

Throws:

EofException - If the endpoint is closed.

IOException

flush

public boolean flush(ByteBuffer... buffers)
              throws IOException

Description copied from interface: EndPoint

Flush data from the passed header/buffer to this endpoint. As many bytes as can be consumed are taken from the header/buffer position up until the buffer limit. The header/buffers position is updated to indicate how many bytes have been consumed.

Specified by:

flush in interface EndPoint

Returns:

True IFF all the buffers have been consumed and the endpoint has flushed the data to its destination (ie is not buffering any data).

Throws:

EofException - If the endpoint is closed or output is shutdown.

IOException

getChannel

public ByteChannel getChannel()

getTransport

public Object getTransport()

Specified by:

getTransport in interface EndPoint

Returns:

The underlying transport object (socket, channel, etc.)

getSocket

public Socket getSocket()

Specified by:

getSocket in interface SocketBased

onIncompleteFlush

protected void onIncompleteFlush()

Specified by:

onIncompleteFlush in class AbstractEndPoint

needsFill

protected boolean needsFill()
                     throws IOException

Specified by:

needsFill in class AbstractEndPoint

Throws:

IOException