org.springframework.web.socket.sockjs.support

Class SockJsHttpRequestHandler

java.lang.Object

org.springframework.web.socket.sockjs.support.SockJsHttpRequestHandler

All Implemented Interfaces:

Aware, Lifecycle, ServletContextAware, CorsConfigurationSource, HttpRequestHandler

public class SockJsHttpRequestHandler
extends java.lang.Object
implements HttpRequestHandler, CorsConfigurationSource, Lifecycle, ServletContextAware

An HttpRequestHandler that allows mapping a SockJsService to requests in a Servlet container.

Since:

4.0

Author:

Rossen Stoyanchev, Sebastien Deleuze

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	running
private SockJsService	sockJsService
private WebSocketHandler	webSocketHandler

Constructor Summary

Constructors

Constructor and Description
SockJsHttpRequestHandler(SockJsService sockJsService, WebSocketHandler webSocketHandler) Create a new SockJsHttpRequestHandler.

Method Summary

Modifier and Type	Method and Description
CorsConfiguration	getCorsConfiguration(HttpServletRequest request) Return a CorsConfiguration based on the incoming request.
private java.lang.String	getSockJsPath(HttpServletRequest servletRequest)
SockJsService	getSockJsService() Return the SockJsService.
WebSocketHandler	getWebSocketHandler() Return the WebSocketHandler.
void	handleRequest(HttpServletRequest servletRequest, HttpServletResponse servletResponse) Process the given request, generating a response.
boolean	isRunning() Check whether this component is currently running.
void	setServletContext(ServletContext servletContext) Set the ServletContext that this object runs in.
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

sockJsService

private final SockJsService sockJsService

webSocketHandler

private final WebSocketHandler webSocketHandler

running

private volatile boolean running

Constructor Detail

SockJsHttpRequestHandler

public SockJsHttpRequestHandler(SockJsService sockJsService,
                                WebSocketHandler webSocketHandler)

Create a new SockJsHttpRequestHandler.

Parameters:

sockJsService - the SockJS service

webSocketHandler - the websocket handler

Method Detail

getSockJsService

public SockJsService getSockJsService()

Return the SockJsService.

getWebSocketHandler

public WebSocketHandler getWebSocketHandler()

Return the WebSocketHandler.

setServletContext

public void setServletContext(ServletContext servletContext)

Description copied from interface: ServletContextAware

Set the ServletContext that this object runs in.

Invoked after population of normal bean properties but before an init callback like InitializingBean's afterPropertiesSet or a custom init-method. Invoked after ApplicationContextAware's setApplicationContext.

Specified by:

setServletContext in interface ServletContextAware

Parameters:

servletContext - ServletContext object to be used by this object

See Also:

InitializingBean.afterPropertiesSet(), ApplicationContextAware.setApplicationContext(org.springframework.context.ApplicationContext)

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

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()

handleRequest

public void handleRequest(HttpServletRequest servletRequest,
                          HttpServletResponse servletResponse)
                   throws ServletException,
                          java.io.IOException

Description copied from interface: HttpRequestHandler

Process the given request, generating a response.

Specified by:

handleRequest in interface HttpRequestHandler

Parameters:

servletRequest - current HTTP request

servletResponse - current HTTP response

Throws:

ServletException - in case of general errors

java.io.IOException - in case of I/O errors

getSockJsPath

private java.lang.String getSockJsPath(HttpServletRequest servletRequest)

getCorsConfiguration

public CorsConfiguration getCorsConfiguration(HttpServletRequest request)

Description copied from interface: CorsConfigurationSource

Return a CorsConfiguration based on the incoming request.

Specified by:

getCorsConfiguration in interface CorsConfigurationSource