org.springframework.web.socket.adapter.standard

Class StandardWebSocketSession

java.lang.Object

org.springframework.web.socket.adapter.AbstractWebSocketSession<Session>

org.springframework.web.socket.adapter.standard.StandardWebSocketSession

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, NativeWebSocketSession, WebSocketSession

public class StandardWebSocketSession
extends AbstractWebSocketSession<Session>

A WebSocketSession for use with the standard WebSocket for Java API.

Since:

4.0

Author:

Rossen Stoyanchev

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	acceptedProtocol
private java.util.List<WebSocketExtension>	extensions
private HttpHeaders	handshakeHeaders
private java.lang.String	id
private java.net.InetSocketAddress	localAddress
private java.net.InetSocketAddress	remoteAddress
private java.net.URI	uri
private java.security.Principal	user

Fields inherited from class org.springframework.web.socket.adapter.AbstractWebSocketSession

logger

Constructor Summary

Constructors

Constructor and Description
StandardWebSocketSession(HttpHeaders headers, java.util.Map<java.lang.String,java.lang.Object> attributes, java.net.InetSocketAddress localAddress, java.net.InetSocketAddress remoteAddress) Class constructor.
StandardWebSocketSession(HttpHeaders headers, java.util.Map<java.lang.String,java.lang.Object> attributes, java.net.InetSocketAddress localAddress, java.net.InetSocketAddress remoteAddress, java.security.Principal user) Class constructor that associates a user with the WebSocket session.

Method Summary

Modifier and Type	Method and Description
protected void	closeInternal(CloseStatus status)
java.lang.String	getAcceptedProtocol() Return the negotiated sub-protocol or null if none was specified or negotiated successfully.
int	getBinaryMessageSizeLimit() Get the configured maximum size for an incoming binary message.
java.util.List<WebSocketExtension>	getExtensions() Return the negotiated extensions or null if none was specified or negotiated successfully.
HttpHeaders	getHandshakeHeaders() Return the headers used in the handshake request.
java.lang.String	getId() Return a unique session identifier.
java.net.InetSocketAddress	getLocalAddress() Return the address on which the request was received.
java.security.Principal	getPrincipal() Return a Principal instance containing the name of the authenticated user.
java.net.InetSocketAddress	getRemoteAddress() Return the address of the remote client.
int	getTextMessageSizeLimit() Get the configured maximum size for an incoming text message.
java.net.URI	getUri() Return the URI used to open the WebSocket connection.
void	initializeNativeSession(Session session)
boolean	isOpen() Return whether the connection is still open.
protected void	sendBinaryMessage(BinaryMessage message)
protected void	sendPingMessage(PingMessage message)
protected void	sendPongMessage(PongMessage message)
protected void	sendTextMessage(TextMessage message)
void	setBinaryMessageSizeLimit(int messageSizeLimit) Configure the maximum size for an incoming binary message.
void	setTextMessageSizeLimit(int messageSizeLimit) Configure the maximum size for an incoming text message.

Methods inherited from class org.springframework.web.socket.adapter.AbstractWebSocketSession

checkNativeSessionInitialized, close, close, getAttributes, getNativeSession, getNativeSession, sendMessage, toString

Methods inherited from class java.lang.Object

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

Field Detail

id

private java.lang.String id

uri

private java.net.URI uri

handshakeHeaders

private final HttpHeaders handshakeHeaders

acceptedProtocol

private java.lang.String acceptedProtocol

extensions

private java.util.List<WebSocketExtension> extensions

user

private java.security.Principal user

localAddress

private final java.net.InetSocketAddress localAddress

remoteAddress

private final java.net.InetSocketAddress remoteAddress

Constructor Detail

StandardWebSocketSession

public StandardWebSocketSession(HttpHeaders headers,
                                java.util.Map<java.lang.String,java.lang.Object> attributes,
                                java.net.InetSocketAddress localAddress,
                                java.net.InetSocketAddress remoteAddress)

Class constructor.

Parameters:

headers - the headers of the handshake request

attributes - attributes from the HTTP handshake to associate with the WebSocket session; the provided attributes are copied, the original map is not used.

localAddress - the address on which the request was received

remoteAddress - the address of the remote client

StandardWebSocketSession

public StandardWebSocketSession(HttpHeaders headers,
                                java.util.Map<java.lang.String,java.lang.Object> attributes,
                                java.net.InetSocketAddress localAddress,
                                java.net.InetSocketAddress remoteAddress,
                                java.security.Principal user)

Class constructor that associates a user with the WebSocket session.

Parameters:

headers - the headers of the handshake request

attributes - attributes from the HTTP handshake to associate with the WebSocket session

localAddress - the address on which the request was received

remoteAddress - the address of the remote client

user - the user associated with the session; if null we'll fallback on the user available in the underlying WebSocket session

Method Detail

getId

public java.lang.String getId()

Description copied from interface: WebSocketSession

Return a unique session identifier.

getUri

public java.net.URI getUri()

Description copied from interface: WebSocketSession

Return the URI used to open the WebSocket connection.

getHandshakeHeaders

public HttpHeaders getHandshakeHeaders()

Description copied from interface: WebSocketSession

Return the headers used in the handshake request.

getAcceptedProtocol

public java.lang.String getAcceptedProtocol()

Description copied from interface: WebSocketSession

Return the negotiated sub-protocol or null if none was specified or negotiated successfully.

getExtensions

public java.util.List<WebSocketExtension> getExtensions()

Description copied from interface: WebSocketSession

Return the negotiated extensions or null if none was specified or negotiated successfully.

getPrincipal

public java.security.Principal getPrincipal()

Description copied from interface: WebSocketSession

Return a Principal instance containing the name of the authenticated user.

If the user has not been authenticated, the method returns null.

getLocalAddress

public java.net.InetSocketAddress getLocalAddress()

Description copied from interface: WebSocketSession

Return the address on which the request was received.

getRemoteAddress

public java.net.InetSocketAddress getRemoteAddress()

Description copied from interface: WebSocketSession

Return the address of the remote client.

setTextMessageSizeLimit

public void setTextMessageSizeLimit(int messageSizeLimit)

Description copied from interface: WebSocketSession

Configure the maximum size for an incoming text message.

getTextMessageSizeLimit

public int getTextMessageSizeLimit()

Description copied from interface: WebSocketSession

Get the configured maximum size for an incoming text message.

setBinaryMessageSizeLimit

public void setBinaryMessageSizeLimit(int messageSizeLimit)

Description copied from interface: WebSocketSession

Configure the maximum size for an incoming binary message.

getBinaryMessageSizeLimit

public int getBinaryMessageSizeLimit()

Description copied from interface: WebSocketSession

Get the configured maximum size for an incoming binary message.

isOpen

public boolean isOpen()

Description copied from interface: WebSocketSession

Return whether the connection is still open.

initializeNativeSession

public void initializeNativeSession(Session session)

Overrides:

initializeNativeSession in class AbstractWebSocketSession<Session>

sendTextMessage

protected void sendTextMessage(TextMessage message)
                        throws java.io.IOException

Specified by:

sendTextMessage in class AbstractWebSocketSession<Session>

Throws:

java.io.IOException

sendBinaryMessage

protected void sendBinaryMessage(BinaryMessage message)
                          throws java.io.IOException

Specified by:

sendBinaryMessage in class AbstractWebSocketSession<Session>

Throws:

java.io.IOException

sendPingMessage

protected void sendPingMessage(PingMessage message)
                        throws java.io.IOException

Specified by:

sendPingMessage in class AbstractWebSocketSession<Session>

Throws:

java.io.IOException

sendPongMessage

protected void sendPongMessage(PongMessage message)
                        throws java.io.IOException

Specified by:

sendPongMessage in class AbstractWebSocketSession<Session>

Throws:

java.io.IOException

closeInternal

protected void closeInternal(CloseStatus status)
                      throws java.io.IOException

Specified by:

closeInternal in class AbstractWebSocketSession<Session>

Throws:

java.io.IOException