org.springframework.web.socket.sockjs.client

Class SockJsClient

java.lang.Object

org.springframework.web.socket.sockjs.client.SockJsClient

All Implemented Interfaces:

Lifecycle, WebSocketClient

public class SockJsClient
extends java.lang.Object
implements WebSocketClient, Lifecycle

A SockJS implementation of WebSocketClient with fallback alternatives that simulate a WebSocket interaction through plain HTTP streaming and long polling techniques..

Implements Lifecycle in order to propagate lifecycle events to the transports it is configured with.

Since:

4.1

Author:

Rossen Stoyanchev

See Also:

http://sockjs.org, Transport

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	SockJsClient.ServerInfo A simple value object holding the result from a SockJS "Info" request.

Field Summary

Fields

Modifier and Type	Field and Description
private TaskScheduler	connectTimeoutScheduler
private InfoReceiver	infoReceiver
private static boolean	jackson2Present
private static Log	logger
private SockJsMessageCodec	messageCodec
private boolean	running
private java.util.Map<java.net.URI,SockJsClient.ServerInfo>	serverInfoCache
private static java.util.Set<java.lang.String>	supportedProtocols
private java.util.List<Transport>	transports

Constructor Summary

Constructors

Constructor and Description
SockJsClient(java.util.List<Transport> transports) Create a SockJsClient with the given transports.

Method Summary

Modifier and Type	Method and Description
void	clearServerInfoCache() By default the result of a SockJS "Info" request, including whether the server has WebSocket disabled and how long the request took (used for calculating transport timeout time) is cached.
private DefaultTransportRequest	createRequest(SockJsUrlInfo urlInfo, HttpHeaders headers, SockJsClient.ServerInfo serverInfo)
ListenableFuture<WebSocketSession>	doHandshake(WebSocketHandler handler, java.lang.String uriTemplate, java.lang.Object... uriVars)
ListenableFuture<WebSocketSession>	doHandshake(WebSocketHandler handler, WebSocketHttpHeaders headers, java.net.URI url)
InfoReceiver	getInfoReceiver() Return the configured InfoReceiver (never null).
SockJsMessageCodec	getMessageCodec() Return the SockJsMessageCodec to use.
private SockJsClient.ServerInfo	getServerInfo(SockJsUrlInfo sockJsUrlInfo)
protected java.security.Principal	getUser() Return the user to associate with the SockJS session and make available via WebSocketSession.getPrincipal().
private static InfoReceiver	initInfoReceiver(java.util.List<Transport> transports)
boolean	isRunning() Check whether this component is currently running.
void	setConnectTimeoutScheduler(TaskScheduler connectTimeoutScheduler) Configure a TaskScheduler for scheduling a connect timeout task where the timeout value is calculated based on the duration of the initial SockJS "Info" request.
void	setInfoReceiver(InfoReceiver infoReceiver) Configure the InfoReceiver to use to perform the SockJS "Info" request before the SockJS session starts.
void	setMessageCodec(SockJsMessageCodec messageCodec) Set the SockJsMessageCodec to use.
void	start() Start this component.
void	stop() Stop this component, typically in a synchronous fashion, such that the component is fully stopped upon return of this method.

Methods inherited from class java.lang.Object

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

Field Detail

jackson2Present

private static final boolean jackson2Present

logger

private static final Log logger

supportedProtocols

private static final java.util.Set<java.lang.String> supportedProtocols

transports

private final java.util.List<Transport> transports

infoReceiver

private InfoReceiver infoReceiver

messageCodec

private SockJsMessageCodec messageCodec

connectTimeoutScheduler

private TaskScheduler connectTimeoutScheduler

running

private volatile boolean running

serverInfoCache

private final java.util.Map<java.net.URI,SockJsClient.ServerInfo> serverInfoCache

Constructor Detail

SockJsClient

public SockJsClient(java.util.List<Transport> transports)

Create a SockJsClient with the given transports.

If the list includes an XhrTransport (or more specifically an implementation of InfoReceiver) the instance is used to initialize the infoReceiver property, or otherwise is defaulted to RestTemplateXhrTransport.

Parameters:

transports - the (non-empty) list of transports to use

Method Detail

initInfoReceiver

private static InfoReceiver initInfoReceiver(java.util.List<Transport> transports)

setInfoReceiver

public void setInfoReceiver(InfoReceiver infoReceiver)

Configure the InfoReceiver to use to perform the SockJS "Info" request before the SockJS session starts.

If the list of transports provided to the constructor contained an XhrTransport or an implementation of InfoReceiver that instance would have been used to initialize this property, or otherwise it defaults to RestTemplateXhrTransport.

Parameters:

infoReceiver - the transport to use for the SockJS "Info" request

getInfoReceiver

public InfoReceiver getInfoReceiver()

Return the configured InfoReceiver (never null).

setMessageCodec

public void setMessageCodec(SockJsMessageCodec messageCodec)

Set the SockJsMessageCodec to use.

By default Jackson2SockJsMessageCodec is used if Jackson is on the classpath.

getMessageCodec

public SockJsMessageCodec getMessageCodec()

Return the SockJsMessageCodec to use.

setConnectTimeoutScheduler

public void setConnectTimeoutScheduler(TaskScheduler connectTimeoutScheduler)

Configure a TaskScheduler for scheduling a connect timeout task where the timeout value is calculated based on the duration of the initial SockJS "Info" request. The connect timeout task ensures a more timely fallback but is otherwise entirely optional.

By default this is not configured in which case a fallback may take longer.

Parameters:

connectTimeoutScheduler - the task scheduler to use

start

public void start()

Description copied from interface: Lifecycle

Start this component.

Should not throw an exception if the component is already running.

In the case of a container, this will propagate the start signal to all components that apply.

Specified by:

start in interface Lifecycle

See Also:

SmartLifecycle.isAutoStartup()

stop

public void stop()

Description copied from interface: Lifecycle

Stop this component, typically in a synchronous fashion, such that the component is fully stopped upon return of this method. Consider implementing SmartLifecycle and its stop(Runnable) variant when asynchronous stop behavior is necessary.

Note that this stop notification is not guaranteed to come before destruction: On regular shutdown, Lifecycle beans will first receive a stop notification before the general destruction callbacks are being propagated; however, on hot refresh during a context's lifetime or on aborted refresh attempts, only destroy methods will be called.

Should not throw an exception if the component isn't started yet.

In the case of a container, this will propagate the stop signal to all components that apply.

Specified by:

stop in interface Lifecycle

See Also:

SmartLifecycle.stop(Runnable), DisposableBean.destroy()

isRunning

public boolean isRunning()

Description copied from interface: Lifecycle

Check whether this component is currently running.

In the case of a container, this will return true only if all components that apply are currently running.

Specified by:

isRunning in interface Lifecycle

Returns:

whether the component is currently running

doHandshake

public ListenableFuture<WebSocketSession> doHandshake(WebSocketHandler handler,
                                                      java.lang.String uriTemplate,
                                                      java.lang.Object... uriVars)

Specified by:

doHandshake in interface WebSocketClient

doHandshake

public final ListenableFuture<WebSocketSession> doHandshake(WebSocketHandler handler,
                                                            WebSocketHttpHeaders headers,
                                                            java.net.URI url)

Specified by:

doHandshake in interface WebSocketClient

getServerInfo

private SockJsClient.ServerInfo getServerInfo(SockJsUrlInfo sockJsUrlInfo)

createRequest

private DefaultTransportRequest createRequest(SockJsUrlInfo urlInfo,
                                              HttpHeaders headers,
                                              SockJsClient.ServerInfo serverInfo)

getUser

protected java.security.Principal getUser()

Return the user to associate with the SockJS session and make available via WebSocketSession.getPrincipal().

By default this method returns null.

Returns:

the user to associate with the session (possibly null)

clearServerInfoCache

public void clearServerInfoCache()

By default the result of a SockJS "Info" request, including whether the server has WebSocket disabled and how long the request took (used for calculating transport timeout time) is cached. This method can be used to clear that cache hence causing it to re-populate.