io.netty.handler.codec.http.websocketx

Class WebSocketServerHandshaker

java.lang.Object

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

Direct Known Subclasses:

WebSocketServerHandshaker00, WebSocketServerHandshaker07, WebSocketServerHandshaker08, WebSocketServerHandshaker13

public abstract class WebSocketServerHandshaker
extends Object

Base class for server side web socket opening and closing handshakes

Field Summary

Fields

Modifier and Type	Field and Description
protected static io.netty.util.internal.logging.InternalLogger	logger
static String	SUB_PROTOCOL_WILDCARD Use this as wildcard to support all requested sub-protocols

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
io.netty.channel.ChannelFuture	close(io.netty.channel.Channel channel, CloseWebSocketFrame frame) Performs the closing handshake
io.netty.channel.ChannelFuture	close(io.netty.channel.Channel channel, CloseWebSocketFrame frame, io.netty.channel.ChannelPromise promise) Performs the closing handshake
io.netty.channel.ChannelFuture	handshake(io.netty.channel.Channel channel, FullHttpRequest req) Performs the opening handshake
io.netty.channel.ChannelFuture	handshake(io.netty.channel.Channel channel, FullHttpRequest req, HttpHeaders responseHeaders, io.netty.channel.ChannelPromise promise) Performs the opening handshake
int	maxFramePayloadLength() Gets the maximum length for any frame's payload.
protected abstract FullHttpResponse	newHandshakeResponse(FullHttpRequest req, HttpHeaders responseHeaders) Returns a new {@link FullHttpResponse) which will be used for as response to the handshake request.
protected abstract io.netty.channel.ChannelInboundHandler	newWebsocketDecoder() Returns the decoder to use after handshake is complete.
protected abstract io.netty.channel.ChannelOutboundHandler	newWebSocketEncoder() Returns the encoder to use after the handshake is complete.
String	selectedSubprotocol() Returns the selected subprotocol.
protected String	selectSubprotocol(String requestedSubprotocols) Selects the first matching supported sub protocol
protected void	setSelectedSubprotocol(String value) Deprecated.
Set<String>	subprotocols() Returns the CSV of supported sub protocols
String	uri() Returns the URL of the web socket
WebSocketVersion	version() Returns the version of the specification being supported

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected static final io.netty.util.internal.logging.InternalLogger logger

SUB_PROTOCOL_WILDCARD

public static final String SUB_PROTOCOL_WILDCARD

Use this as wildcard to support all requested sub-protocols

See Also:

Constant Field Values

Constructor Detail

WebSocketServerHandshaker

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

Constructor specifying the destination web socket location

Parameters:

version - the protocol version

uri - 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

uri

public String uri()

Returns the URL of the web socket

subprotocols

public Set<String> subprotocols()

Returns the CSV of supported sub protocols

version

public WebSocketVersion version()

Returns the version of the specification being supported

maxFramePayloadLength

public int maxFramePayloadLength()

Gets the maximum length for any frame's payload.

Returns:

The maximum length for a frame's payload

handshake

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

Performs the opening handshake

Parameters:

channel - Channel

req - HTTP Request

handshake

public final io.netty.channel.ChannelFuture handshake(io.netty.channel.Channel channel,
                                       FullHttpRequest req,
                                       HttpHeaders responseHeaders,
                                       io.netty.channel.ChannelPromise promise)

Performs the opening handshake

Parameters:

channel - Channel

req - HTTP Request

responseHeaders - Extra headers to add to the handshake response or null if no extra headers should be added

promise - the ChannelPromise to be notified when the opening handshake is done

newHandshakeResponse

protected abstract FullHttpResponse newHandshakeResponse(FullHttpRequest req,
                                    HttpHeaders responseHeaders)

Returns a new {@link FullHttpResponse) which will be used for as response to the handshake request.

close

public 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

close

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

Performs the closing handshake

Parameters:

channel - Channel

frame - Closing Frame that was received

promise - the ChannelPromise to be notified when the closing handshake is done

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.

selectedSubprotocol

public String selectedSubprotocol()

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

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

setSelectedSubprotocol

@Deprecated
protected void setSelectedSubprotocol(String value)

Deprecated.

newWebsocketDecoder

protected abstract io.netty.channel.ChannelInboundHandler newWebsocketDecoder()

Returns the decoder to use after handshake is complete.

newWebSocketEncoder

protected abstract io.netty.channel.ChannelOutboundHandler newWebSocketEncoder()

Returns the encoder to use after the handshake is complete.