org.eclipse.jetty.io

Class AbstractConnection

java.lang.Object

org.eclipse.jetty.io.AbstractConnection

All Implemented Interfaces:

Closeable, AutoCloseable, Connection

Direct Known Subclasses:

AbstractWebSocketConnection, HttpConnection, HttpConnectionOverHTTP, NegotiatingClientConnection, NegotiatingServerConnection, SslConnection

public abstract class AbstractConnection
extends Object
implements Connection

A convenience base implementation of Connection.

This class uses the capabilities of the EndPoint API to provide a more traditional style of async reading. A call to fillInterested() will schedule a callback to onFillable() or onFillInterestedFailed(Throwable) as appropriate.

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.jetty.io.Connection

Connection.Listener, Connection.UpgradeFrom, Connection.UpgradeTo

Method Summary

Modifier and Type	Method and Description
void	addListener(Connection.Listener listener) Adds a listener of connection events.
void	close() Performs a logical close of this connection.
void	fillInterested() Utility method to be called to register read interest.
long	getBytesIn()
long	getBytesOut()
long	getCreatedTimeStamp()
EndPoint	getEndPoint()
int	getInputBufferSize()
long	getMessagesIn()
long	getMessagesOut()
boolean	isFillInterested()
void	onClose() Callback method invoked when this connection is closed.
abstract void	onFillable() Callback method invoked when the endpoint is ready to be read.
boolean	onIdleExpired() Callback method invoked upon an idle timeout event.
void	onOpen() Callback method invoked when this connection is opened.
void	removeListener(Connection.Listener listener) Removes a listener of connection events.
void	setInputBufferSize(int inputBufferSize)
String	toConnectionString()
String	toString()
void	tryFillInterested()
void	tryFillInterested(Callback callback)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

addListener

public void addListener(Connection.Listener listener)

Description copied from interface: Connection

Adds a listener of connection events.

Specified by:

addListener in interface Connection

Parameters:

listener - the listener to add

removeListener

public void removeListener(Connection.Listener listener)

Description copied from interface: Connection

Removes a listener of connection events.

Specified by:

removeListener in interface Connection

Parameters:

listener - the listener to remove

getInputBufferSize

public int getInputBufferSize()

setInputBufferSize

public void setInputBufferSize(int inputBufferSize)

fillInterested

public void fillInterested()

Utility method to be called to register read interest.

After a call to this method, onFillable() or onFillInterestedFailed(Throwable) will be called back as appropriate.

See Also:

onFillable()

tryFillInterested

public void tryFillInterested()

tryFillInterested

public void tryFillInterested(Callback callback)

isFillInterested

public boolean isFillInterested()

onFillable

public abstract void onFillable()

Callback method invoked when the endpoint is ready to be read.

See Also:

fillInterested()

onOpen

public void onOpen()

Description copied from interface: Connection

Callback method invoked when this connection is opened.

Creators of the connection implementation are responsible for calling this method.

Specified by:

onOpen in interface Connection

onClose

public void onClose()

Description copied from interface: Connection

Callback method invoked when this connection is closed.

Creators of the connection implementation are responsible for calling this method.

Specified by:

onClose in interface Connection

getEndPoint

public EndPoint getEndPoint()

Specified by:

getEndPoint in interface Connection

Returns:

the EndPoint associated with this Connection.

close

public void close()

Description copied from interface: Connection

Performs a logical close of this connection.

For simple connections, this may just mean to delegate the close to the associated EndPoint but, for example, SSL connections should write the SSL close message before closing the associated EndPoint.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Connection

onIdleExpired

public boolean onIdleExpired()

Description copied from interface: Connection

Callback method invoked upon an idle timeout event.

Implementations of this method may return true to indicate that the idle timeout handling should proceed normally, typically failing the EndPoint and causing it to be closed.

When false is returned, the handling of the idle timeout event is halted immediately and the EndPoint left in the state it was before the idle timeout event.

Specified by:

onIdleExpired in interface Connection

Returns:

true to let the EndPoint handle the idle timeout, false to tell the EndPoint to halt the handling of the idle timeout.

getMessagesIn

public long getMessagesIn()

Specified by:

getMessagesIn in interface Connection

getMessagesOut

public long getMessagesOut()

Specified by:

getMessagesOut in interface Connection

getBytesIn

public long getBytesIn()

Specified by:

getBytesIn in interface Connection

getBytesOut

public long getBytesOut()

Specified by:

getBytesOut in interface Connection

getCreatedTimeStamp

public long getCreatedTimeStamp()

Specified by:

getCreatedTimeStamp in interface Connection

toString

public final String toString()

Overrides:

toString in class Object

toConnectionString

public String toConnectionString()