Package io.undertow.websockets.jsr

Class ServerWebSocketContainer

java.lang.Object

io.undertow.websockets.jsr.ServerWebSocketContainer

All Implemented Interfaces:

jakarta.websocket.server.ServerContainer, jakarta.websocket.WebSocketContainer, Closeable, AutoCloseable

public class ServerWebSocketContainer
extends Object
implements jakarta.websocket.server.ServerContainer, Closeable

ServerContainer implementation which allows to deploy endpoints for a server.

Author:

Norman Maurer

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ServerWebSocketContainer.PauseListener

Field Summary

Fields

Modifier and Type	Field	Description
static int	DEFAULT_WEB_SOCKET_TIMEOUT_SECONDS
static String	TIMEOUT

Constructor Summary

Constructors

Constructor	Description
ServerWebSocketContainer(ClassIntrospecter classIntrospecter, ClassLoader classLoader, Supplier<org.xnio.XnioWorker> xnioWorker, ByteBufferPool bufferPool, List<ThreadSetupHandler> threadSetupHandlers, boolean dispatchToWorker)
ServerWebSocketContainer(ClassIntrospecter classIntrospecter, ClassLoader classLoader, Supplier<org.xnio.XnioWorker> xnioWorker, ByteBufferPool bufferPool, List<ThreadSetupHandler> threadSetupHandlers, boolean dispatchToWorker, InetSocketAddress clientBindAddress, WebSocketReconnectHandler reconnectHandler)
ServerWebSocketContainer(ClassIntrospecter classIntrospecter, ClassLoader classLoader, Supplier<org.xnio.XnioWorker> xnioWorker, ByteBufferPool bufferPool, List<ThreadSetupHandler> threadSetupHandlers, boolean dispatchToWorker, InetSocketAddress clientBindAddress, WebSocketReconnectHandler reconnectHandler, List<jakarta.websocket.Extension> installedExtensions)
ServerWebSocketContainer(ClassIntrospecter classIntrospecter, Supplier<org.xnio.XnioWorker> xnioWorker, ByteBufferPool bufferPool, List<ThreadSetupHandler> threadSetupHandlers, boolean dispatchToWorker, boolean clientMode)

Method Summary

Modifier and Type	Method	Description
void	addEndpoint(jakarta.websocket.server.ServerEndpointConfig endpoint)
void	addEndpoint(Class<?> endpoint)
void	close()
void	close(int waitTime)
jakarta.websocket.Session	connectToServer(jakarta.websocket.Endpoint endpointInstance, jakarta.websocket.ClientEndpointConfig config, WebSocketClient.ConnectionBuilder connectionBuilder)
jakarta.websocket.Session	connectToServer(jakarta.websocket.Endpoint endpointInstance, jakarta.websocket.ClientEndpointConfig config, URI path)
jakarta.websocket.Session	connectToServer(Class<?> aClass, WebSocketClient.ConnectionBuilder connectionBuilder)
jakarta.websocket.Session	connectToServer(Class<?> aClass, URI uri)
jakarta.websocket.Session	connectToServer(Class<? extends jakarta.websocket.Endpoint> endpointClass, jakarta.websocket.ClientEndpointConfig cec, URI path)
jakarta.websocket.Session	connectToServer(Object annotatedEndpointInstance, WebSocketClient.ConnectionBuilder connectionBuilder)
jakarta.websocket.Session	connectToServer(Object annotatedEndpointInstance, URI path)
void	deploymentComplete()
void	doUpgrade(jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response, jakarta.websocket.server.ServerEndpointConfig sec, Map<String,String> pathParams)
ByteBufferPool	getBufferPool()
List<ConfiguredServerEndpoint>	getConfiguredServerEndpoints()
ServletContextImpl	getContextToAddFilter()
long	getDefaultAsyncSendTimeout()
int	getDefaultMaxBinaryMessageBufferSize()
long	getDefaultMaxSessionIdleTimeout()
int	getDefaultMaxTextMessageBufferSize()
Set<jakarta.websocket.Extension>	getInstalledExtensions()
WebSocketReconnectHandler	getWebSocketReconnectHandler()
org.xnio.XnioWorker	getXnioWorker()
void	invokeEndpointMethod(Runnable invocation)	Directly invokes an endpoint method, without dispatching to an executor
void	invokeEndpointMethod(Executor executor, Runnable invocation)	Runs a web socket invocation, setting up the threads and dispatching a thread pool
boolean	isClosed()
boolean	isDispatchToWorker()
void	pause(ServerWebSocketContainer.PauseListener listener)	Pauses the container
void	resume()	resumes a paused container
void	setAsyncSendTimeout(long defaultAsyncSendTimeout)
void	setContextToAddFilter(ServletContextImpl contextToAddFilter)
void	setDefaultMaxBinaryMessageBufferSize(int defaultMaxBinaryMessageBufferSize)
void	setDefaultMaxSessionIdleTimeout(long timeout)
void	setDefaultMaxTextMessageBufferSize(int defaultMaxTextMessageBufferSize)
void	upgradeHttpToWebSocket(Object req, Object res, jakarta.websocket.server.ServerEndpointConfig sec, Map<String,String> pathParameters)
void	validateDeployment()

Methods inherited from class java.lang.Object

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

Field Detail

TIMEOUT

public static final String TIMEOUT

See Also:

Constant Field Values

DEFAULT_WEB_SOCKET_TIMEOUT_SECONDS

public static final int DEFAULT_WEB_SOCKET_TIMEOUT_SECONDS

See Also:

Constant Field Values

Constructor Detail

ServerWebSocketContainer

public ServerWebSocketContainer(ClassIntrospecter classIntrospecter,
                                Supplier<org.xnio.XnioWorker> xnioWorker,
                                ByteBufferPool bufferPool,
                                List<ThreadSetupHandler> threadSetupHandlers,
                                boolean dispatchToWorker,
                                boolean clientMode)

ServerWebSocketContainer

public ServerWebSocketContainer(ClassIntrospecter classIntrospecter,
                                ClassLoader classLoader,
                                Supplier<org.xnio.XnioWorker> xnioWorker,
                                ByteBufferPool bufferPool,
                                List<ThreadSetupHandler> threadSetupHandlers,
                                boolean dispatchToWorker)

ServerWebSocketContainer

public ServerWebSocketContainer(ClassIntrospecter classIntrospecter,
                                ClassLoader classLoader,
                                Supplier<org.xnio.XnioWorker> xnioWorker,
                                ByteBufferPool bufferPool,
                                List<ThreadSetupHandler> threadSetupHandlers,
                                boolean dispatchToWorker,
                                InetSocketAddress clientBindAddress,
                                WebSocketReconnectHandler reconnectHandler)

ServerWebSocketContainer

public ServerWebSocketContainer(ClassIntrospecter classIntrospecter,
                                ClassLoader classLoader,
                                Supplier<org.xnio.XnioWorker> xnioWorker,
                                ByteBufferPool bufferPool,
                                List<ThreadSetupHandler> threadSetupHandlers,
                                boolean dispatchToWorker,
                                InetSocketAddress clientBindAddress,
                                WebSocketReconnectHandler reconnectHandler,
                                List<jakarta.websocket.Extension> installedExtensions)

Method Detail

getDefaultAsyncSendTimeout

public long getDefaultAsyncSendTimeout()

Specified by:

getDefaultAsyncSendTimeout in interface jakarta.websocket.WebSocketContainer

setAsyncSendTimeout

public void setAsyncSendTimeout(long defaultAsyncSendTimeout)

Specified by:

setAsyncSendTimeout in interface jakarta.websocket.WebSocketContainer

connectToServer

public jakarta.websocket.Session connectToServer(Object annotatedEndpointInstance,
                                                 WebSocketClient.ConnectionBuilder connectionBuilder)
                                          throws jakarta.websocket.DeploymentException,
                                                 IOException

Throws:

jakarta.websocket.DeploymentException

IOException

connectToServer

public jakarta.websocket.Session connectToServer(Object annotatedEndpointInstance,
                                                 URI path)
                                          throws jakarta.websocket.DeploymentException,
                                                 IOException

Specified by:

connectToServer in interface jakarta.websocket.WebSocketContainer

Throws:

jakarta.websocket.DeploymentException

IOException

connectToServer

public jakarta.websocket.Session connectToServer(Class<?> aClass,
                                                 WebSocketClient.ConnectionBuilder connectionBuilder)
                                          throws jakarta.websocket.DeploymentException,
                                                 IOException

Throws:

jakarta.websocket.DeploymentException

IOException

connectToServer

public jakarta.websocket.Session connectToServer(Class<?> aClass,
                                                 URI uri)
                                          throws jakarta.websocket.DeploymentException,
                                                 IOException

Specified by:

connectToServer in interface jakarta.websocket.WebSocketContainer

Throws:

jakarta.websocket.DeploymentException

IOException

connectToServer

public jakarta.websocket.Session connectToServer(jakarta.websocket.Endpoint endpointInstance,
                                                 jakarta.websocket.ClientEndpointConfig config,
                                                 URI path)
                                          throws jakarta.websocket.DeploymentException,
                                                 IOException

Specified by:

connectToServer in interface jakarta.websocket.WebSocketContainer

Throws:

jakarta.websocket.DeploymentException

IOException

connectToServer

public jakarta.websocket.Session connectToServer(jakarta.websocket.Endpoint endpointInstance,
                                                 jakarta.websocket.ClientEndpointConfig config,
                                                 WebSocketClient.ConnectionBuilder connectionBuilder)
                                          throws jakarta.websocket.DeploymentException,
                                                 IOException

Throws:

jakarta.websocket.DeploymentException

IOException

connectToServer

public jakarta.websocket.Session connectToServer(Class<? extends jakarta.websocket.Endpoint> endpointClass,
                                                 jakarta.websocket.ClientEndpointConfig cec,
                                                 URI path)
                                          throws jakarta.websocket.DeploymentException,
                                                 IOException

Specified by:

connectToServer in interface jakarta.websocket.WebSocketContainer

Throws:

jakarta.websocket.DeploymentException

IOException

upgradeHttpToWebSocket

public void upgradeHttpToWebSocket(Object req,
                                   Object res,
                                   jakarta.websocket.server.ServerEndpointConfig sec,
                                   Map<String,String> pathParameters)
                            throws IOException,
                                   jakarta.websocket.DeploymentException

Specified by:

upgradeHttpToWebSocket in interface jakarta.websocket.server.ServerContainer

Throws:

IOException

jakarta.websocket.DeploymentException

doUpgrade

public void doUpgrade(jakarta.servlet.http.HttpServletRequest request,
                      jakarta.servlet.http.HttpServletResponse response,
                      jakarta.websocket.server.ServerEndpointConfig sec,
                      Map<String,String> pathParams)
               throws jakarta.servlet.ServletException,
                      IOException

Throws:

jakarta.servlet.ServletException

IOException

getDefaultMaxSessionIdleTimeout

public long getDefaultMaxSessionIdleTimeout()

Specified by:

getDefaultMaxSessionIdleTimeout in interface jakarta.websocket.WebSocketContainer

setDefaultMaxSessionIdleTimeout

public void setDefaultMaxSessionIdleTimeout(long timeout)

Specified by:

setDefaultMaxSessionIdleTimeout in interface jakarta.websocket.WebSocketContainer

getDefaultMaxBinaryMessageBufferSize

public int getDefaultMaxBinaryMessageBufferSize()

Specified by:

getDefaultMaxBinaryMessageBufferSize in interface jakarta.websocket.WebSocketContainer

setDefaultMaxBinaryMessageBufferSize

public void setDefaultMaxBinaryMessageBufferSize(int defaultMaxBinaryMessageBufferSize)

Specified by:

setDefaultMaxBinaryMessageBufferSize in interface jakarta.websocket.WebSocketContainer

getDefaultMaxTextMessageBufferSize

public int getDefaultMaxTextMessageBufferSize()

Specified by:

getDefaultMaxTextMessageBufferSize in interface jakarta.websocket.WebSocketContainer

setDefaultMaxTextMessageBufferSize

public void setDefaultMaxTextMessageBufferSize(int defaultMaxTextMessageBufferSize)

Specified by:

setDefaultMaxTextMessageBufferSize in interface jakarta.websocket.WebSocketContainer

getInstalledExtensions

public Set<jakarta.websocket.Extension> getInstalledExtensions()

Specified by:

getInstalledExtensions in interface jakarta.websocket.WebSocketContainer

invokeEndpointMethod

public void invokeEndpointMethod(Executor executor,
                                 Runnable invocation)

Runs a web socket invocation, setting up the threads and dispatching a thread pool

Unfortunately we need to dispatch to a thread pool, because there is a good chance that the endpoint will use blocking IO methods. We suspend recieves while this is in progress, to make sure that we do not have multiple methods invoked at once.

Parameters:

invocation - The task to run

invokeEndpointMethod

public void invokeEndpointMethod(Runnable invocation)

Directly invokes an endpoint method, without dispatching to an executor

Parameters:

invocation - The invocation

addEndpoint

public void addEndpoint(Class<?> endpoint)
                 throws jakarta.websocket.DeploymentException

Specified by:

addEndpoint in interface jakarta.websocket.server.ServerContainer

Throws:

jakarta.websocket.DeploymentException

addEndpoint

public void addEndpoint(jakarta.websocket.server.ServerEndpointConfig endpoint)
                 throws jakarta.websocket.DeploymentException

Specified by:

addEndpoint in interface jakarta.websocket.server.ServerContainer

Throws:

jakarta.websocket.DeploymentException

validateDeployment

public void validateDeployment()

deploymentComplete

public void deploymentComplete()

getConfiguredServerEndpoints

public List<ConfiguredServerEndpoint> getConfiguredServerEndpoints()

getContextToAddFilter

public ServletContextImpl getContextToAddFilter()

setContextToAddFilter

public void setContextToAddFilter(ServletContextImpl contextToAddFilter)

close

public void close(int waitTime)

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

getBufferPool

public ByteBufferPool getBufferPool()

getXnioWorker

public org.xnio.XnioWorker getXnioWorker()

pause

public void pause(ServerWebSocketContainer.PauseListener listener)

Pauses the container

Parameters:

listener -

resume

public void resume()

resumes a paused container

getWebSocketReconnectHandler

public WebSocketReconnectHandler getWebSocketReconnectHandler()

isClosed

public boolean isClosed()

isDispatchToWorker

public boolean isDispatchToWorker()