io.netty.handler.codec.http.websocketx

Class WebSocketServerHandshaker

java.lang.Object

io.netty.handler.codec.http.websocketx.WebSocketServerHandshaker

Direct Known Subclasses:

WebSocketServerHandshaker00, WebSocketServerHandshaker08, WebSocketServerHandshaker13

public abstract class WebSocketServerHandshaker
extends Object

Base class for server side web socket opening and closing handshakes

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	WebSocketServerHandshaker(WebSocketVersion version, String webSocketUrl, String subprotocols, int maxFramePayloadLength) Constructor specifying the destination web socket location

Method Summary

Methods

Modifier and Type	Method and Description
abstract io.netty.channel.ChannelFuture	close(io.netty.channel.Channel channel, CloseWebSocketFrame frame) Performs the closing handshake
int	getMaxFramePayloadLength() Gets the maximum length for any frame's payload.
String	getSelectedSubprotocol() Returns the selected subprotocol.
Set<String>	getSubprotocols() Returns the CSV of supported sub protocols
WebSocketVersion	getVersion() Returns the version of the specification being supported
String	getWebSocketUrl() Returns the URL of the web socket
abstract io.netty.channel.ChannelFuture	handshake(io.netty.channel.Channel channel, HttpRequest req) Performs the opening handshake
protected String	selectSubprotocol(String requestedSubprotocols) Selects the first matching supported sub protocol
protected void	setSelectedSubprotocol(String value)

Methods inherited from class java.lang.Object

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

Constructor Detail

WebSocketServerHandshaker

protected WebSocketServerHandshaker(WebSocketVersion version,
                         String webSocketUrl,
                         String subprotocols,
                         int maxFramePayloadLength)

Constructor specifying the destination web socket location

Parameters:

version - the protocol version

webSocketUrl - URL for web socket communications. e.g "ws://myhost.com/mypath". Subsequent web socket frames will be sent to this URL.

subprotocols - CSV of supported protocols. Null if sub protocols not supported.

maxFramePayloadLength - Maximum length of a frame's payload

Method Detail

getWebSocketUrl

public String getWebSocketUrl()

Returns the URL of the web socket

getSubprotocols

public Set<String> getSubprotocols()

Returns the CSV of supported sub protocols

getVersion

public WebSocketVersion getVersion()

Returns the version of the specification being supported

getMaxFramePayloadLength

public int getMaxFramePayloadLength()

Gets the maximum length for any frame's payload.

Returns:

The maximum length for a frame's payload

handshake

public abstract io.netty.channel.ChannelFuture handshake(io.netty.channel.Channel channel,
                                       HttpRequest req)

Performs the opening handshake

Parameters:

channel - Channel

req - HTTP Request

close

public abstract io.netty.channel.ChannelFuture close(io.netty.channel.Channel channel,
                                   CloseWebSocketFrame frame)

Performs the closing handshake

Parameters:

channel - Channel

frame - Closing Frame that was received

selectSubprotocol

protected String selectSubprotocol(String requestedSubprotocols)

Selects the first matching supported sub protocol

Parameters:

requestedSubprotocols - CSV of protocols to be supported. e.g. "chat, superchat"

Returns:

First matching supported sub protocol. Null if not found.

getSelectedSubprotocol

public String getSelectedSubprotocol()

Returns the selected subprotocol. Null if no subprotocol has been selected.

This is only available AFTER handshake() has been called.

setSelectedSubprotocol

protected void setSelectedSubprotocol(String value)