org.apache.wicket.protocol.ws

Class WebSocketSettings

java.lang.Object

org.apache.wicket.protocol.ws.WebSocketSettings

public class WebSocketSettings
extends Object

Web Socket related settings. More documentation is available about each setting in the setter method for the property.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	WebSocketSettings.Holder Holds this WebSocketSettings in the Application's metadata.
static class	WebSocketSettings.SameThreadExecutor Simple executor that runs the tasks in the caller thread.

Constructor Summary

Constructors

Constructor and Description
WebSocketSettings()

Method Summary

Methods

Modifier and Type	Method and Description
CharSequence	getBaseUrl()
IWebSocketConnectionFilter	getConnectionFilter()
IWebSocketConnectionRegistry	getConnectionRegistry()
CharSequence	getContextPath()
CharSequence	getFilterPrefix()
Executor	getSendPayloadExecutor() The executor that broadcasts the WebSocketPayload via Wicket's event bus.
Executor	getWebSocketPushMessageExecutor()
org.apache.wicket.request.http.WebRequest	newWebSocketRequest(javax.servlet.http.HttpServletRequest request, String filterPath) A factory method for the WebRequest that should be used in the WebSocket processing request cycle
WebSocketRequestHandler	newWebSocketRequestHandler(Page page, IWebSocketConnection connection) A factory method for creating instances of WebSocketRequestHandler for processing a web socket request
org.apache.wicket.request.http.WebResponse	newWebSocketResponse(IWebSocketConnection connection) A factory method for the WebResponse that should be used to write the response back to the client/browser
void	setBaseUrl(CharSequence baseUrl)
void	setConnectionFilter(IWebSocketConnectionFilter connectionFilter) Sets the filter for checking the incoming connections
WebSocketSettings	setConnectionRegistry(IWebSocketConnectionRegistry connectionRegistry) Sets the connection registry
void	setContextPath(CharSequence contextPath)
void	setFilterPrefix(CharSequence filterPrefix)
WebSocketSettings	setSendPayloadExecutor(Executor sendPayloadExecutor) The executor that broadcasts the WebSocketPayload via Wicket's event bus.
WebSocketSettings	setWebSocketPushMessageExecutor(Executor executor) Set the executor for processing websocket push messages broadcasted to all sessions.

Methods inherited from class java.lang.Object

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

Constructor Detail

WebSocketSettings

public WebSocketSettings()

Method Detail

setWebSocketPushMessageExecutor

public WebSocketSettings setWebSocketPushMessageExecutor(Executor executor)

Set the executor for processing websocket push messages broadcasted to all sessions. Default executor does all the processing in the caller thread. Using a proper thread pool is adviced for applications that send push events from ajax calls to avoid page level deadlocks.

Parameters:

executor - The executor used for processing push messages.

getWebSocketPushMessageExecutor

public Executor getWebSocketPushMessageExecutor()

Returns:

the executor for processing websocket push messages broadcasted to all sessions.

getConnectionRegistry

public IWebSocketConnectionRegistry getConnectionRegistry()

Returns:

The registry that tracks all currently connected WebSocket clients

setConnectionRegistry

public WebSocketSettings setConnectionRegistry(IWebSocketConnectionRegistry connectionRegistry)

Sets the connection registry

Parameters:

connectionRegistry - The registry that tracks all currently connected WebSocket clients

Returns:

this, for method chaining

setSendPayloadExecutor

public WebSocketSettings setSendPayloadExecutor(Executor sendPayloadExecutor)

The executor that broadcasts the WebSocketPayload via Wicket's event bus. Default executor does all the processing in the caller thread.

Parameters:

sendPayloadExecutor - The executor used for broadcasting the events with web socket payloads to WebSocketBehaviors and WebSocketResources.

getSendPayloadExecutor

public Executor getSendPayloadExecutor()

The executor that broadcasts the WebSocketPayload via Wicket's event bus.

Returns:

The executor used for broadcasting the events with web socket payloads to WebSocketBehaviors and WebSocketResources.

setConnectionFilter

public void setConnectionFilter(IWebSocketConnectionFilter connectionFilter)

Sets the filter for checking the incoming connections

Parameters:

connectionFilter - the filter for checking the incoming connections

See Also:

WebSocketConnectionFilterCollection

getConnectionFilter

public IWebSocketConnectionFilter getConnectionFilter()

Returns:

the filter for checking the incoming connections

See Also:

WebSocketConnectionFilterCollection

newWebSocketResponse

public org.apache.wicket.request.http.WebResponse newWebSocketResponse(IWebSocketConnection connection)

A factory method for the WebResponse that should be used to write the response back to the client/browser

Parameters:

connection - The active web socket connection

Returns:

the response object that should be used to write the response back to the client

newWebSocketRequestHandler

public WebSocketRequestHandler newWebSocketRequestHandler(Page page,
                                                 IWebSocketConnection connection)

A factory method for creating instances of WebSocketRequestHandler for processing a web socket request

Parameters:

page - The page with the web socket client. A dummy page in case of usage of WebSocketResource

connection - The active web socket connection

Returns:

a new instance of WebSocketRequestHandler for processing a web socket request

newWebSocketRequest

public org.apache.wicket.request.http.WebRequest newWebSocketRequest(javax.servlet.http.HttpServletRequest request,
                                                            String filterPath)

A factory method for the WebRequest that should be used in the WebSocket processing request cycle

Parameters:

request - The upgraded http request

filterPath - The configured filter path of WicketFilter in web.xml

Returns:

the request object that should be used in the WebSocket processing request cycle

setFilterPrefix

public void setFilterPrefix(CharSequence filterPrefix)

getFilterPrefix

public CharSequence getFilterPrefix()

setContextPath

public void setContextPath(CharSequence contextPath)

getContextPath

public CharSequence getContextPath()

setBaseUrl

public void setBaseUrl(CharSequence baseUrl)

getBaseUrl

public CharSequence getBaseUrl()