Class WebSocketHttpRequestHandler
- java.lang.Object
- org.springframework.web.socket.server.support.WebSocketHttpRequestHandler
- All Implemented Interfaces:
Aware,Lifecycle,ServletContextAware,HttpRequestHandler
public class WebSocketHttpRequestHandler extends Object implements HttpRequestHandler, Lifecycle, ServletContextAware
AHttpRequestHandlerfor processing WebSocket handshake requests.This is the main class to use when configuring a server WebSocket at a specific URL. It is a very thin wrapper around a
WebSocketHandlerand aHandshakeHandler, also adapting theHttpServletRequestandHttpServletResponsetoServerHttpRequestandServerHttpResponse, respectively.- Since:
- 4.0
- Author:
- Rossen Stoyanchev
Constructor Summary
Constructors Constructor Description WebSocketHttpRequestHandler(WebSocketHandler wsHandler)WebSocketHttpRequestHandler(WebSocketHandler wsHandler, HandshakeHandler handshakeHandler)
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description HandshakeHandlergetHandshakeHandler()Return the HandshakeHandler.List<HandshakeInterceptor>getHandshakeInterceptors()Return the configured WebSocket handshake request interceptors.WebSocketHandlergetWebSocketHandler()Return the WebSocketHandler.voidhandleRequest(HttpServletRequest servletRequest, HttpServletResponse servletResponse)Process the given request, generating a response.booleanisRunning()Check whether this component is currently running.voidsetHandshakeInterceptors(List<HandshakeInterceptor> interceptors)Configure one or more WebSocket handshake request interceptors.voidsetServletContext(ServletContext servletContext)Set theServletContextthat this object runs in.voidstart()Start this component.voidstop()Stop this component, typically in a synchronous fashion, such that the component is fully stopped upon return of this method.
Constructor Detail
WebSocketHttpRequestHandler
public WebSocketHttpRequestHandler(WebSocketHandler wsHandler)
WebSocketHttpRequestHandler
public WebSocketHttpRequestHandler(WebSocketHandler wsHandler, HandshakeHandler handshakeHandler)
Method Detail
getWebSocketHandler
public WebSocketHandler getWebSocketHandler()
Return the WebSocketHandler.
getHandshakeHandler
public HandshakeHandler getHandshakeHandler()
Return the HandshakeHandler.
setHandshakeInterceptors
public void setHandshakeInterceptors(List<HandshakeInterceptor> interceptors)
Configure one or more WebSocket handshake request interceptors.
getHandshakeInterceptors
public List<HandshakeInterceptor> getHandshakeInterceptors()
Return the configured WebSocket handshake request interceptors.
setServletContext
public void setServletContext(ServletContext servletContext)
Description copied from interface:ServletContextAwareSet theServletContextthat this object runs in.Invoked after population of normal bean properties but before an init callback like InitializingBean's
afterPropertiesSetor a custom init-method. Invoked after ApplicationContextAware'ssetApplicationContext.- Specified by:
setServletContextin interfaceServletContextAware- Parameters:
servletContext- ServletContext object to be used by this object- See Also:
InitializingBean.afterPropertiesSet(),ApplicationContextAware.setApplicationContext(org.springframework.context.ApplicationContext)
start
public void start()
Description copied from interface:LifecycleStart 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:
startin interfaceLifecycle- See Also:
SmartLifecycle.isAutoStartup()
stop
public void stop()
Description copied from interface:LifecycleStop this component, typically in a synchronous fashion, such that the component is fully stopped upon return of this method. Consider implementingSmartLifecycleand itsstop(Runnable)variant when asynchronous stop behavior is necessary.Note that this stop notification is not guaranteed to come before destruction: On regular shutdown,
Lifecyclebeans 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, a given bean's destroy method will be called without any consideration of stop signals upfront.Should not throw an exception if the component is not running (not started yet).
In the case of a container, this will propagate the stop signal to all components that apply.
- Specified by:
stopin interfaceLifecycle- See Also:
SmartLifecycle.stop(Runnable),DisposableBean.destroy()
isRunning
public boolean isRunning()
Description copied from interface:LifecycleCheck whether this component is currently running.In the case of a container, this will return
trueonly if all components that apply are currently running.
handleRequest
public void handleRequest(HttpServletRequest servletRequest, HttpServletResponse servletResponse) throws ServletException, IOException
Description copied from interface:HttpRequestHandlerProcess the given request, generating a response.- Specified by:
handleRequestin interfaceHttpRequestHandler- Parameters:
servletRequest- current HTTP requestservletResponse- current HTTP response- Throws:
ServletException- in case of general errorsIOException- in case of I/O errors