org.frameworkset.web.socket.endpoint.ServerEndpointRegistration Maven / Gradle / Ivy
Show all versions of bboss-websocket Show documentation
package org.frameworkset.web.socket.endpoint;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import javax.websocket.Decoder;
import javax.websocket.Encoder;
import javax.websocket.Endpoint;
import javax.websocket.Extension;
import javax.websocket.HandshakeResponse;
import javax.websocket.server.HandshakeRequest;
import javax.websocket.server.ServerEndpointConfig;
import org.frameworkset.spi.ApplicationContextAware;
import org.frameworkset.spi.BaseApplicationContext;
import org.frameworkset.util.Assert;
import org.frameworkset.web.socket.handler.BeanCreatingHandlerProvider;
/**
* An implementation of {@link javax.websocket.server.ServerEndpointConfig} for use in
* Spring applications. A {@link ServerEndpointRegistration} bean is detected by
* {@link ServerEndpointExporter} and registered with a Java WebSocket runtime at startup.
*
* Class constructors accept a singleton {@link javax.websocket.Endpoint} instance
* or an Endpoint specified by type {@link 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
* {@link javax.websocket.server.ServerEndpointConfig.Configurator} to make it easier to
* override methods for customizing the handshake process.
*
* @author Rossen Stoyanchev
* @since 4.0
* @see ServerEndpointExporter
*/
public class ServerEndpointRegistration extends ServerEndpointConfig.Configurator
implements ServerEndpointConfig, ApplicationContextAware {
private final String path;
private final BeanCreatingHandlerProvider endpointProvider;
private final Endpoint endpoint;
private List> encoders = new ArrayList>();
private List> decoders = new ArrayList>();
private List protocols = new ArrayList();
private List extensions = new ArrayList();
private final Map userProperties = new HashMap();
/**
* Create a new {@link ServerEndpointRegistration} instance from an
* {@code javax.websocket.Endpoint} class.
* @param path the endpoint path
* @param endpointClass the endpoint class
*/
public ServerEndpointRegistration(String path, Class extends Endpoint> endpointClass) {
Assert.hasText(path, "path must not be empty");
Assert.notNull(endpointClass, "endpointClass must not be null");
this.path = path;
this.endpointProvider = new BeanCreatingHandlerProvider(endpointClass);
this.endpoint = null;
}
/**
* Create a new {@link ServerEndpointRegistration} instance from an
* {@code javax.websocket.Endpoint} instance.
* @param path the endpoint path
* @param endpoint the endpoint instance
*/
public ServerEndpointRegistration(String path, Endpoint endpoint) {
Assert.hasText(path, "path must not be empty");
Assert.notNull(endpoint, "endpoint must not be null");
this.path = path;
this.endpointProvider = null;
this.endpoint = endpoint;
}
@Override
public String getPath() {
return this.path;
}
@Override
public Class extends Endpoint> getEndpointClass() {
return (this.endpoint != null) ?
this.endpoint.getClass() : ((Class extends Endpoint>) this.endpointProvider.getHandlerType());
}
public Endpoint getEndpoint() {
return (this.endpoint != null) ? this.endpoint : this.endpointProvider.getHandler();
}
public void setSubprotocols(List protocols) {
this.protocols = protocols;
}
@Override
public List getSubprotocols() {
return this.protocols;
}
public void setExtensions(List extensions) {
this.extensions = extensions;
}
@Override
public List getExtensions() {
return this.extensions;
}
public void setUserProperties(Map userProperties) {
this.userProperties.clear();
this.userProperties.putAll(userProperties);
}
@Override
public Map getUserProperties() {
return this.userProperties;
}
public void setEncoders(List> encoders) {
this.encoders = encoders;
}
@Override
public List> getEncoders() {
return this.encoders;
}
public void setDecoders(List> decoders) {
this.decoders = decoders;
}
@Override
public List> getDecoders() {
return this.decoders;
}
@Override
public Configurator getConfigurator() {
return this;
}
@Override
public void setApplicationContext(BaseApplicationContext beanFactory){
if (this.endpointProvider != null) {
this.endpointProvider.setApplicationContext(beanFactory);
}
}
// Implementations of ServerEndpointConfig.Configurator
@SuppressWarnings("unchecked")
@Override
public final T getEndpointInstance(Class clazz) throws InstantiationException {
return (T) getEndpoint();
}
@Override
public void modifyHandshake(ServerEndpointConfig sec, HandshakeRequest request, HandshakeResponse response) {
super.modifyHandshake(this, request, response);
}
@Override
public boolean checkOrigin(String originHeaderValue) {
return super.checkOrigin(originHeaderValue);
}
@Override
public String getNegotiatedSubprotocol(List supported, List requested) {
return super.getNegotiatedSubprotocol(supported, requested);
}
@Override
public List getNegotiatedExtensions(List installed, List requested) {
return super.getNegotiatedExtensions(installed, requested);
}
@Override
public String toString() {
return "ServerEndpointRegistration for path '" + getPath() + "': " + getEndpointClass();
}
}