org.springframework.web.socket.server.standard

Class ServerEndpointRegistration

java.lang.Object

javax.websocket.server.ServerEndpointConfig.Configurator

org.springframework.web.socket.server.standard.ServerEndpointRegistration

All Implemented Interfaces:

javax.websocket.EndpointConfig, javax.websocket.server.ServerEndpointConfig, Aware, BeanFactoryAware

public class ServerEndpointRegistration
extends javax.websocket.server.ServerEndpointConfig.Configurator
implements javax.websocket.server.ServerEndpointConfig, BeanFactoryAware

An implementation of ServerEndpointConfig for use in Spring applications. A ServerEndpointRegistration bean is detected by ServerEndpointExporter and registered with a Java WebSocket runtime at startup.

Class constructors accept a singleton Endpoint instance or an Endpoint specified by type Class. When specified by type, the endpoint will be instantiated and initialized through the Spring ApplicationContext before each client WebSocket connection.

This class also extends ServerEndpointConfig.Configurator to make it easier to override methods for customizing the handshake process.

Since:

4.0

Author:

Rossen Stoyanchev

See Also:

ServerEndpointExporter

Nested Class Summary

Nested classes/interfaces inherited from interface javax.websocket.server.ServerEndpointConfig

javax.websocket.server.ServerEndpointConfig.Builder, javax.websocket.server.ServerEndpointConfig.Configurator

Constructor Summary

Constructors

Constructor and Description
ServerEndpointRegistration(String path, Class<? extends javax.websocket.Endpoint> endpointClass) Create a new ServerEndpointRegistration instance from an javax.webscoket.Endpoint class.
ServerEndpointRegistration(String path, javax.websocket.Endpoint endpoint) Create a new ServerEndpointRegistration instance from an javax.websocket.Endpoint instance.

Method Summary

Modifier and Type	Method and Description
boolean	checkOrigin(String originHeaderValue)
javax.websocket.server.ServerEndpointConfig.Configurator	getConfigurator()
List<Class<? extends javax.websocket.Decoder>>	getDecoders()
List<Class<? extends javax.websocket.Encoder>>	getEncoders()
javax.websocket.Endpoint	getEndpoint()
Class<? extends javax.websocket.Endpoint>	getEndpointClass()
<T> T	getEndpointInstance(Class<T> clazz)
List<javax.websocket.Extension>	getExtensions()
List<javax.websocket.Extension>	getNegotiatedExtensions(List<javax.websocket.Extension> installed, List<javax.websocket.Extension> requested)
String	getNegotiatedSubprotocol(List<String> supported, List<String> requested)
String	getPath()
List<String>	getSubprotocols()
Map<String,Object>	getUserProperties()
void	modifyHandshake(javax.websocket.server.ServerEndpointConfig sec, javax.websocket.server.HandshakeRequest request, javax.websocket.HandshakeResponse response)
void	setBeanFactory(BeanFactory beanFactory) Callback that supplies the owning factory to a bean instance.
void	setDecoders(List<Class<? extends javax.websocket.Decoder>> decoders)
void	setEncoders(List<Class<? extends javax.websocket.Encoder>> encoders)
void	setExtensions(List<javax.websocket.Extension> extensions)
void	setSubprotocols(List<String> protocols)
void	setUserProperties(Map<String,Object> userProperties)

Methods inherited from class java.lang.Object

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

Constructor Detail

ServerEndpointRegistration

public ServerEndpointRegistration(String path,
                                  Class<? extends javax.websocket.Endpoint> endpointClass)

Create a new ServerEndpointRegistration instance from an javax.webscoket.Endpoint class.

Parameters:

path - the endpoint path

endpointClass - the endpoint class

ServerEndpointRegistration

public ServerEndpointRegistration(String path,
                                  javax.websocket.Endpoint endpoint)

Create a new ServerEndpointRegistration instance from an javax.websocket.Endpoint instance.

Parameters:

path - the endpoint path

endpoint - the endpoint instance

Method Detail

getPath

public String getPath()

Specified by:

getPath in interface javax.websocket.server.ServerEndpointConfig

getEndpointClass

public Class<? extends javax.websocket.Endpoint> getEndpointClass()

Specified by:

getEndpointClass in interface javax.websocket.server.ServerEndpointConfig

getEndpoint

public javax.websocket.Endpoint getEndpoint()

setSubprotocols

public void setSubprotocols(List<String> protocols)

getSubprotocols

public List<String> getSubprotocols()

Specified by:

getSubprotocols in interface javax.websocket.server.ServerEndpointConfig

setExtensions

public void setExtensions(List<javax.websocket.Extension> extensions)

getExtensions

public List<javax.websocket.Extension> getExtensions()

Specified by:

getExtensions in interface javax.websocket.server.ServerEndpointConfig

setUserProperties

public void setUserProperties(Map<String,Object> userProperties)

getUserProperties

public Map<String,Object> getUserProperties()

Specified by:

getUserProperties in interface javax.websocket.EndpointConfig

setEncoders

public void setEncoders(List<Class<? extends javax.websocket.Encoder>> encoders)

getEncoders

public List<Class<? extends javax.websocket.Encoder>> getEncoders()

Specified by:

getEncoders in interface javax.websocket.EndpointConfig

setDecoders

public void setDecoders(List<Class<? extends javax.websocket.Decoder>> decoders)

getDecoders

public List<Class<? extends javax.websocket.Decoder>> getDecoders()

Specified by:

getDecoders in interface javax.websocket.EndpointConfig

getConfigurator

public javax.websocket.server.ServerEndpointConfig.Configurator getConfigurator()

Specified by:

getConfigurator in interface javax.websocket.server.ServerEndpointConfig

setBeanFactory

public void setBeanFactory(BeanFactory beanFactory)
                    throws BeansException

Description copied from interface: BeanFactoryAware

Callback that supplies the owning factory to a bean instance.

Invoked after the population of normal bean properties but before an initialization callback such as InitializingBean.afterPropertiesSet() or a custom init-method.

Specified by:

setBeanFactory in interface BeanFactoryAware

Parameters:

beanFactory - owning BeanFactory (never null). The bean can immediately call methods on the factory.

Throws:

BeansException - in case of initialization errors

See Also:

BeanInitializationException

getEndpointInstance

public final <T> T getEndpointInstance(Class<T> clazz)
                                throws InstantiationException

Overrides:

getEndpointInstance in class javax.websocket.server.ServerEndpointConfig.Configurator

Throws:

InstantiationException

modifyHandshake

public void modifyHandshake(javax.websocket.server.ServerEndpointConfig sec,
                            javax.websocket.server.HandshakeRequest request,
                            javax.websocket.HandshakeResponse response)

Overrides:

modifyHandshake in class javax.websocket.server.ServerEndpointConfig.Configurator

checkOrigin

public boolean checkOrigin(String originHeaderValue)

Overrides:

checkOrigin in class javax.websocket.server.ServerEndpointConfig.Configurator

getNegotiatedSubprotocol

public String getNegotiatedSubprotocol(List<String> supported,
                                       List<String> requested)

Overrides:

getNegotiatedSubprotocol in class javax.websocket.server.ServerEndpointConfig.Configurator

getNegotiatedExtensions

public List<javax.websocket.Extension> getNegotiatedExtensions(List<javax.websocket.Extension> installed,
                                                               List<javax.websocket.Extension> requested)

Overrides:

getNegotiatedExtensions in class javax.websocket.server.ServerEndpointConfig.Configurator