org.springframework.web.socket

Interface WebSocketSession

All Known Subinterfaces:

NativeWebSocketSession

All Known Implementing Classes:

AbstractHttpSockJsSession, AbstractSockJsSession, AbstractWebSocketSesssion, EventSourceTransportHandler.EventSourceStreamingSockJsSession, HtmlFileTransportHandler.HtmlFileStreamingSockJsSession, JettyWebSocketSession, PollingSockJsSession, StandardWebSocketSession, StreamingSockJsSession, WebSocketServerSockJsSession, XhrStreamingTransportHandler.XhrStreamingSockJsSession

public interface WebSocketSession

A WebSocket session abstraction. Allows sending messages over a WebSocket connection and closing it.

Since:

4.0

Author:

Rossen Stoyanchev

Method Summary

Modifier and Type	Method and Description
void	close() Close the WebSocket connection with status 1000, i.e.
void	close(CloseStatus status) Close the WebSocket connection with the given close status.
java.lang.String	getAcceptedProtocol() Return the negotiated sub-protocol or null if none was specified or negotiated successfully.
java.util.Map<java.lang.String,java.lang.Object>	getHandshakeAttributes() Handshake request specific attributes.
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 <code>Principal</code> instance containing the name of the authenticated user.
java.net.InetSocketAddress	getRemoteAddress() Return the address of the remote client.
java.net.URI	getUri() Return the URI used to open the WebSocket connection.
boolean	isOpen() Return whether the connection is still open.
void	sendMessage(WebSocketMessage<?> message) Send a WebSocket message either TextMessage or BinaryMessage.

Method Detail

getId

java.lang.String getId()

Return a unique session identifier.

getUri

java.net.URI getUri()

Return the URI used to open the WebSocket connection.

getHandshakeHeaders

HttpHeaders getHandshakeHeaders()

Return the headers used in the handshake request.

getHandshakeAttributes

java.util.Map<java.lang.String,java.lang.Object> getHandshakeAttributes()

Handshake request specific attributes. To add attributes to a server-side WebSocket session see HandshakeInterceptor.

getPrincipal

java.security.Principal getPrincipal()

Return a <code>Principal</code> instance containing the name of the authenticated user. If the user has not been authenticated, the method returns null.

getLocalAddress

java.net.InetSocketAddress getLocalAddress()

Return the address on which the request was received.

getRemoteAddress

java.net.InetSocketAddress getRemoteAddress()

Return the address of the remote client.

getAcceptedProtocol

java.lang.String getAcceptedProtocol()

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

isOpen

boolean isOpen()

Return whether the connection is still open.

sendMessage

void sendMessage(WebSocketMessage<?> message)
          throws java.io.IOException

Send a WebSocket message either TextMessage or BinaryMessage.

Throws:

java.io.IOException

close

void close()
    throws java.io.IOException

Close the WebSocket connection with status 1000, i.e. equivalent to:

 session.close(CloseStatus.NORMAL);
 

Throws:

java.io.IOException

close

void close(CloseStatus status)
    throws java.io.IOException

Close the WebSocket connection with the given close status.

Throws:

java.io.IOException