Package org.eclipse.jetty.websocket.javax.common

Class JavaxWebSocketFrameHandler

java.lang.Object

org.eclipse.jetty.websocket.javax.common.JavaxWebSocketFrameHandler

All Implemented Interfaces:

FrameHandler, IncomingFrames

public class JavaxWebSocketFrameHandler
extends Object
implements FrameHandler

Field Summary

Fields

Modifier and Type	Field	Description
protected byte	dataType

Constructor Summary

Constructors

Constructor	Description
JavaxWebSocketFrameHandler(JavaxWebSocketContainer container, UpgradeRequest upgradeRequest, Object endpointInstance, MethodHandle openHandle, MethodHandle closeHandle, MethodHandle errorHandle, JavaxWebSocketMessageMetadata textMetadata, JavaxWebSocketMessageMetadata binaryMetadata, MethodHandle pongHandle, javax.websocket.EndpointConfig endpointConfig)

Method Summary

Modifier and Type	Method	Description
<T> void	addMessageHandler(Class<T> clazz, javax.websocket.MessageHandler.Partial<T> handler)
<T> void	addMessageHandler(Class<T> clazz, javax.websocket.MessageHandler.Whole<T> handler)
JavaxWebSocketMessageMetadata	getBinaryMetadata()
Object	getEndpoint()
javax.websocket.EndpointConfig	getEndpointConfig()
Map<Byte,RegisteredMessageHandler>	getMessageHandlerMap()
Set<javax.websocket.MessageHandler>	getMessageHandlers()
JavaxWebSocketSession	getSession()
JavaxWebSocketMessageMetadata	getTextMetadata()
UpgradeRequest	getUpgradeRequest()
boolean	isDemanding()	Does the FrameHandler manage it's own demand?
void	onBinary(Frame frame, Callback callback)
void	onClose(Frame frame, Callback callback)
void	onClosed(CloseStatus closeStatus, Callback callback)	This is the Close Handshake Complete event.
void	onContinuation(Frame frame, Callback callback)
void	onError(Throwable cause, Callback callback)	An error has occurred or been detected in websocket-core and being reported to FrameHandler.
void	onFrame(Frame frame, Callback callback)	Receiver of all Frames.
void	onOpen(CoreSession coreSession, Callback callback)	Async notification that Connection is being opened.
void	onPing(Frame frame, Callback callback)
void	onPong(Frame frame, Callback callback)
void	onText(Frame frame, Callback callback)
void	removeMessageHandler(javax.websocket.MessageHandler handler)
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

dataType

protected byte dataType

Constructor Details

JavaxWebSocketFrameHandler

public JavaxWebSocketFrameHandler(JavaxWebSocketContainer container,
 UpgradeRequest upgradeRequest,
 Object endpointInstance,
 MethodHandle openHandle,
 MethodHandle closeHandle,
 MethodHandle errorHandle,
 JavaxWebSocketMessageMetadata textMetadata,
 JavaxWebSocketMessageMetadata binaryMetadata,
 MethodHandle pongHandle,
 javax.websocket.EndpointConfig endpointConfig)

Method Details

getEndpoint

public Object getEndpoint()

getEndpointConfig

public javax.websocket.EndpointConfig getEndpointConfig()

getSession

public JavaxWebSocketSession getSession()

onOpen

public void onOpen(CoreSession coreSession,
 Callback callback)

Description copied from interface: FrameHandler

Async notification that Connection is being opened.

FrameHandler can write during this call, but can not receive frames until the callback is succeeded.

If the FrameHandler succeeds the callback we transition to OPEN state and can now receive frames if not demanding, or can now call CoreSession.demand(long) to receive frames if demanding. If the FrameHandler fails the callback a close frame will be sent with CloseStatus.SERVER_ERROR and the connection will be closed.

Specified by:

onOpen in interface FrameHandler

Parameters:

coreSession - the session associated with this connection.

callback - the callback to indicate success in processing (or failure)

onFrame

public void onFrame(Frame frame,
 Callback callback)

Description copied from interface: FrameHandler

Receiver of all Frames. This method will never be called in parallel for the same session and will be called sequentially to satisfy all outstanding demand signaled by calls to CoreSession.demand(long). Control and Data frames are passed to this method. Close frames may be responded to by the handler, but if an appropriate close response is not sent once the callback is succeeded, then a response close will be generated and sent.

Specified by:

onFrame in interface FrameHandler

Specified by:

onFrame in interface IncomingFrames

Parameters:

frame - the raw frame

callback - the callback to indicate success in processing frame (or failure)

onClose

public void onClose(Frame frame,
 Callback callback)

onClosed

public void onClosed(CloseStatus closeStatus,
 Callback callback)

Description copied from interface: FrameHandler

This is the Close Handshake Complete event.

The connection is now closed, no reading or writing is possible anymore. Implementations of FrameHandler can cleanup their resources for this connection now. This method will be called only once.

Specified by:

onClosed in interface FrameHandler

Parameters:

closeStatus - the close status received from remote, or in the case of abnormal closure from local.

callback - the callback to indicate success in processing (or failure)

onError

public void onError(Throwable cause,
 Callback callback)

Description copied from interface: FrameHandler

An error has occurred or been detected in websocket-core and being reported to FrameHandler. A call to onError will be followed by a call to FrameHandler.onClosed(CloseStatus, Callback) giving the close status derived from the error. This will not be called more than once, FrameHandler.onClosed(CloseStatus, Callback) will be called on the callback completion.

Specified by:

onError in interface FrameHandler

Parameters:

cause - the reason for the error

callback - the callback to indicate success in processing (or failure)

isDemanding

public boolean isDemanding()

Description copied from interface: FrameHandler

Does the FrameHandler manage it's own demand?

Specified by:

isDemanding in interface FrameHandler

Returns:

true iff the FrameHandler will manage its own flow control by calling CoreSession.demand(long) when it is willing to receive new Frames. Otherwise the demand will be managed by an automatic call to demand(1) after every succeeded callback passed to FrameHandler.onFrame(Frame, Callback).

getMessageHandlers

public Set<javax.websocket.MessageHandler> getMessageHandlers()

getMessageHandlerMap

public Map<Byte,RegisteredMessageHandler> getMessageHandlerMap()

getBinaryMetadata

public JavaxWebSocketMessageMetadata getBinaryMetadata()

getTextMetadata

public JavaxWebSocketMessageMetadata getTextMetadata()

addMessageHandler

public <T> void addMessageHandler(Class<T> clazz,
 javax.websocket.MessageHandler.Partial<T> handler)

addMessageHandler

public <T> void addMessageHandler(Class<T> clazz,
 javax.websocket.MessageHandler.Whole<T> handler)

removeMessageHandler

public void removeMessageHandler(javax.websocket.MessageHandler handler)

toString

public String toString()

Overrides:

toString in class Object

onPing

public void onPing(Frame frame,
 Callback callback)

onPong

public void onPong(Frame frame,
 Callback callback)

onText

public void onText(Frame frame,
 Callback callback)

onBinary

public void onBinary(Frame frame,
 Callback callback)

onContinuation

public void onContinuation(Frame frame,
 Callback callback)

getUpgradeRequest

public UpgradeRequest getUpgradeRequest()