org.atmosphere.websocket

Interface WebSocketProtocol

All Superinterfaces:

AtmosphereConfigAware

All Known Subinterfaces:

WebSocketProtocolStream

All Known Implementing Classes:

EchoProtocol, SimpleHttpProtocol, StreamingHttpProtocol

public interface WebSocketProtocol
extends AtmosphereConfigAware

A WebSocket based protocol implementation. Implement this class to process WebSockets messages and dispatch it to Atmosphere or any consumer of WebSocket message.

Author:

Jeanfrancois Arcand

Method Summary

Modifier and Type	Method and Description
void	onClose(WebSocket webSocket) Invoked when a WebSocket is closed
void	onError(WebSocket webSocket, WebSocketProcessor.WebSocketException t) Invoked when an error occurs.
List<AtmosphereRequest>	onMessage(WebSocket webSocket, byte[] data, int offset, int length) Parse the WebSocket message, and delegate the processing to the AtmosphereFramework.asyncSupport or to any existing technology.
List<AtmosphereRequest>	onMessage(WebSocket webSocket, String data) Parse the WebSocket message, and delegate the processing to the AtmosphereFramework.asyncSupport or to any existing technology.
void	onOpen(WebSocket webSocket) Invoked when a WebSocket is opened

Methods inherited from interface org.atmosphere.inject.AtmosphereConfigAware

configure

Method Detail

onMessage

List<AtmosphereRequest> onMessage(WebSocket webSocket,
                                  String data)

Parse the WebSocket message, and delegate the processing to the AtmosphereFramework.asyncSupport or to any existing technology. Invoking AtmosphereFramework.asyncSupport will delegate the request processing to the AtmosphereHandler implementation. Returning null means this implementation will handle itself the processing/dispatching of the WebSocket's request;
As an example, this is how Websocket messages are delegated to the Jersey runtime.

Parameters:

webSocket - The WebSocket connection

data - The Websocket message

Returns:

a List of AtmosphereRequest

onMessage

List<AtmosphereRequest> onMessage(WebSocket webSocket,
                                  byte[] data,
                                  int offset,
                                  int length)

Parse the WebSocket message, and delegate the processing to the AtmosphereFramework.asyncSupport or to any existing technology. Invoking AtmosphereFramework.asyncSupport will delegate the request processing to the AtmosphereHandler implementation. Returning null means this implementation will handle itself the processing/dispatching of the WebSocket's request;
As an example, this is how Websocket messages are delegated to the Jersey runtime.

Parameters:

webSocket - The WebSocket connection

offset - offset message index

length - length of the message.

Returns:

a List of AtmosphereRequest

onOpen

void onOpen(WebSocket webSocket)

Invoked when a WebSocket is opened

Parameters:

webSocket - WebSocket

onClose

void onClose(WebSocket webSocket)

Invoked when a WebSocket is closed

Parameters:

webSocket - WebSocket

onError

void onError(WebSocket webSocket,
             WebSocketProcessor.WebSocketException t)

Invoked when an error occurs.

Parameters:

webSocket - WebSocket

t - a WebSocketProcessor.WebSocketException