Package org.apache.tomcat.websocket.server

Class WsHttpUpgradeHandler

java.lang.Object

org.apache.tomcat.websocket.server.WsHttpUpgradeHandler

All Implemented Interfaces:

HttpUpgradeHandler, InternalHttpUpgradeHandler

public class WsHttpUpgradeHandler
extends java.lang.Object
implements InternalHttpUpgradeHandler

Servlet 3.1 HTTP upgrade handler for WebSocket connections.

Constructor Summary

Constructors

Constructor	Description
WsHttpUpgradeHandler()

Method Summary

Modifier and Type	Method	Description
void	destroy()	This method is called after the upgraded connection has been closed.
UpgradeInfo	getUpgradeInfo()
void	init(WebConnection connection)	This method is called once the request/response pair where HttpServletRequest.upgrade(Class) is called has completed processing and is the point where control of the connection passes from the container to the HttpUpgradeHandler.
void	pause()	Pause processing for the connection.
void	preInit(ServerEndpointConfig serverEndpointConfig, WsServerContainer wsc, WsHandshakeRequest handshakeRequest, java.util.List<Extension> negotiatedExtensionsPhase2, java.lang.String subProtocol, Transformation transformation, java.util.Map<java.lang.String,java.lang.String> pathParameters, boolean secure)
void	setSocketWrapper(SocketWrapperBase<?> socketWrapper)	Associate with the specified socket.
void	setSslSupport(SSLSupport sslSupport)	Associate with the specified SSL support.
void	timeoutAsync(long now)	Check for a possible timeout.
AbstractEndpoint.Handler.SocketState	upgradeDispatch(SocketEvent status)	Process the specified event.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.coyote.http11.upgrade.InternalHttpUpgradeHandler

hasAsyncIO

Constructor Detail

WsHttpUpgradeHandler

public WsHttpUpgradeHandler()

Method Detail

setSocketWrapper

public void setSocketWrapper(SocketWrapperBase<?> socketWrapper)

Description copied from interface: InternalHttpUpgradeHandler

Associate with the specified socket.

Specified by:

setSocketWrapper in interface InternalHttpUpgradeHandler

Parameters:

socketWrapper - the socket

preInit

public void preInit(ServerEndpointConfig serverEndpointConfig,
                    WsServerContainer wsc,
                    WsHandshakeRequest handshakeRequest,
                    java.util.List<Extension> negotiatedExtensionsPhase2,
                    java.lang.String subProtocol,
                    Transformation transformation,
                    java.util.Map<java.lang.String,java.lang.String> pathParameters,
                    boolean secure)

init

public void init(WebConnection connection)

Description copied from interface: jakarta.servlet.http.HttpUpgradeHandler

This method is called once the request/response pair where HttpServletRequest.upgrade(Class) is called has completed processing and is the point where control of the connection passes from the container to the HttpUpgradeHandler.

Specified by:

init in interface HttpUpgradeHandler

Parameters:

connection - The connection that has been upgraded

getUpgradeInfo

public UpgradeInfo getUpgradeInfo()

Specified by:

getUpgradeInfo in interface InternalHttpUpgradeHandler

Returns:

the associated upgrade information used to collect statistics for the connection

upgradeDispatch

public AbstractEndpoint.Handler.SocketState upgradeDispatch(SocketEvent status)

Description copied from interface: InternalHttpUpgradeHandler

Process the specified event.

Specified by:

upgradeDispatch in interface InternalHttpUpgradeHandler

Parameters:

status - the event

Returns:

the status following the event

timeoutAsync

public void timeoutAsync(long now)

Description copied from interface: InternalHttpUpgradeHandler

Check for a possible timeout.

Specified by:

timeoutAsync in interface InternalHttpUpgradeHandler

Parameters:

now - the time to use for the timeout check

pause

public void pause()

Description copied from interface: InternalHttpUpgradeHandler

Pause processing for the connection.

Specified by:

pause in interface InternalHttpUpgradeHandler

destroy

public void destroy()

Description copied from interface: jakarta.servlet.http.HttpUpgradeHandler

This method is called after the upgraded connection has been closed.

Specified by:

destroy in interface HttpUpgradeHandler

setSslSupport

public void setSslSupport(SSLSupport sslSupport)

Description copied from interface: InternalHttpUpgradeHandler

Associate with the specified SSL support.

Specified by:

setSslSupport in interface InternalHttpUpgradeHandler

Parameters:

sslSupport - the SSL support