Package org.eclipse.jetty.websocket.common.extensions

Class AbstractExtension

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.websocket.common.extensions.AbstractExtension

All Implemented Interfaces:

LifeCycle, Extension, IncomingFrames, OutgoingFrames

Direct Known Subclasses:

CompressExtension, FragmentExtension, FrameCaptureExtension, IdentityExtension

@ManagedObject("Abstract Extension")
public abstract class AbstractExtension
extends AbstractLifeCycle
implements Extension

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor	Description
AbstractExtension()

Method Summary

Modifier and Type	Method	Description
ByteBufferPool	getBufferPool()
ExtensionConfig	getConfig()	The active configuration for this extension.
LogicalConnection	getConnection()
java.lang.String	getName()	The Sec-WebSocket-Extensions name for this extension.
IncomingFrames	getNextIncoming()
OutgoingFrames	getNextOutgoing()
WebSocketPolicy	getPolicy()
void	init(WebSocketPolicy policy, ByteBufferPool bufferPool)
void	init(WebSocketContainerScope container)	Deprecated.
boolean	isRsv1User()	Used to indicate that the extension makes use of the RSV1 bit of the base websocket framing.
boolean	isRsv2User()	Used to indicate that the extension makes use of the RSV2 bit of the base websocket framing.
boolean	isRsv3User()	Used to indicate that the extension makes use of the RSV3 bit of the base websocket framing.
protected void	nextIncomingFrame(Frame frame)
protected void	nextOutgoingFrame(Frame frame, WriteCallback callback, BatchMode batchMode)
void	setBufferPool(ByteBufferPool bufferPool)
void	setConfig(ExtensionConfig config)
void	setConnection(LogicalConnection connection)
void	setNextIncomingFrames(IncomingFrames nextIncoming)	Set the next IncomingFrames to call in the chain.
void	setNextOutgoingFrames(OutgoingFrames nextOutgoing)	Set the next OutgoingFrames to call in the chain.
void	setPolicy(WebSocketPolicy policy)
java.lang.String	toString()

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, doStart, doStop, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, setStopTimeout, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.websocket.api.extensions.IncomingFrames

incomingFrame

Methods inherited from interface org.eclipse.jetty.websocket.api.extensions.OutgoingFrames

outgoingFrame

Constructor Detail

AbstractExtension

public AbstractExtension()

Method Detail

init

@Deprecated
public void init(WebSocketContainerScope container)

Deprecated.

init

public void init(WebSocketPolicy policy,
                 ByteBufferPool bufferPool)

getBufferPool

public ByteBufferPool getBufferPool()

getConfig

public ExtensionConfig getConfig()

Description copied from interface: Extension

The active configuration for this extension.

Specified by:

getConfig in interface Extension

Returns:

the configuration for this extension. never null.

getConnection

public LogicalConnection getConnection()

getName

public java.lang.String getName()

Description copied from interface: Extension

The Sec-WebSocket-Extensions name for this extension.

Also known as the extension-token per Section 9.1. Negotiating Extensions.

Specified by:

getName in interface Extension

Returns:

the name of the extension

getNextIncoming

@ManagedAttribute(name="Next Incoming Frame Handler",
                  readonly=true)
public IncomingFrames getNextIncoming()

getNextOutgoing

@ManagedAttribute(name="Next Outgoing Frame Handler",
                  readonly=true)
public OutgoingFrames getNextOutgoing()

getPolicy

public WebSocketPolicy getPolicy()

isRsv1User

public boolean isRsv1User()

Used to indicate that the extension makes use of the RSV1 bit of the base websocket framing.

This is used to adjust validation during parsing, as well as a checkpoint against 2 or more extensions all simultaneously claiming ownership of RSV1.

Specified by:

isRsv1User in interface Extension

Returns:

true if extension uses RSV1 for its own purposes.

isRsv2User

public boolean isRsv2User()

Used to indicate that the extension makes use of the RSV2 bit of the base websocket framing.

This is used to adjust validation during parsing, as well as a checkpoint against 2 or more extensions all simultaneously claiming ownership of RSV2.

Specified by:

isRsv2User in interface Extension

Returns:

true if extension uses RSV2 for its own purposes.

isRsv3User

public boolean isRsv3User()

Used to indicate that the extension makes use of the RSV3 bit of the base websocket framing.

This is used to adjust validation during parsing, as well as a checkpoint against 2 or more extensions all simultaneously claiming ownership of RSV3.

Specified by:

isRsv3User in interface Extension

Returns:

true if extension uses RSV3 for its own purposes.

nextIncomingFrame

protected void nextIncomingFrame(Frame frame)

nextOutgoingFrame

protected void nextOutgoingFrame(Frame frame,
                                 WriteCallback callback,
                                 BatchMode batchMode)

setBufferPool

public void setBufferPool(ByteBufferPool bufferPool)

setConfig

public void setConfig(ExtensionConfig config)

setConnection

public void setConnection(LogicalConnection connection)

setNextIncomingFrames

public void setNextIncomingFrames(IncomingFrames nextIncoming)

Description copied from interface: Extension

Set the next IncomingFrames to call in the chain.

Specified by:

setNextIncomingFrames in interface Extension

Parameters:

nextIncoming - the next incoming extension

setNextOutgoingFrames

public void setNextOutgoingFrames(OutgoingFrames nextOutgoing)

Description copied from interface: Extension

Set the next OutgoingFrames to call in the chain.

Specified by:

setNextOutgoingFrames in interface Extension

Parameters:

nextOutgoing - the next outgoing extension

setPolicy

public void setPolicy(WebSocketPolicy policy)

toString

public java.lang.String toString()

Overrides:

toString in class AbstractLifeCycle