io.netty.handler.codec.http.websocketx

Class WebSocketServerHandshakerFactory

java.lang.Object

io.netty.handler.codec.http.websocketx.WebSocketServerHandshakerFactory

public class WebSocketServerHandshakerFactory
extends Object

Auto-detects the version of the Web Socket protocol in use and creates a new proper WebSocketServerHandshaker.

Constructor Summary

Constructors

Constructor and Description
WebSocketServerHandshakerFactory(String webSocketURL, String subprotocols, boolean allowExtensions) Constructor specifying the destination web socket location
WebSocketServerHandshakerFactory(String webSocketURL, String subprotocols, boolean allowExtensions, int maxFramePayloadLength) Constructor specifying the destination web socket location
WebSocketServerHandshakerFactory(String webSocketURL, String subprotocols, boolean allowExtensions, int maxFramePayloadLength, boolean allowMaskMismatch) Constructor specifying the destination web socket location

Method Summary

Methods

Modifier and Type	Method and Description
WebSocketServerHandshaker	newHandshaker(HttpRequest req) Instances a new handshaker
static ChannelFuture	sendUnsupportedVersionResponse(Channel channel) Return that we need cannot not support the web socket version
static ChannelFuture	sendUnsupportedVersionResponse(Channel channel, ChannelPromise promise) Return that we need cannot not support the web socket version

Methods inherited from class java.lang.Object

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

Constructor Detail

WebSocketServerHandshakerFactory

public WebSocketServerHandshakerFactory(String webSocketURL,
                                String subprotocols,
                                boolean allowExtensions)

Constructor specifying the destination web socket location

Parameters:

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.

allowExtensions - Allow extensions to be used in the reserved bits of the web socket frame

WebSocketServerHandshakerFactory

public WebSocketServerHandshakerFactory(String webSocketURL,
                                String subprotocols,
                                boolean allowExtensions,
                                int maxFramePayloadLength)

Constructor specifying the destination web socket location

Parameters:

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.

allowExtensions - Allow extensions to be used in the reserved bits of the web socket frame

maxFramePayloadLength - Maximum allowable frame payload length. Setting this value to your application's requirement may reduce denial of service attacks using long data frames.

WebSocketServerHandshakerFactory

public WebSocketServerHandshakerFactory(String webSocketURL,
                                String subprotocols,
                                boolean allowExtensions,
                                int maxFramePayloadLength,
                                boolean allowMaskMismatch)

Constructor specifying the destination web socket location

Parameters:

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.

allowExtensions - Allow extensions to be used in the reserved bits of the web socket frame

maxFramePayloadLength - Maximum allowable frame payload length. Setting this value to your application's requirement may reduce denial of service attacks using long data frames.

allowMaskMismatch - Allows to loosen the masking requirement on received frames. When this is set to false then also frames which are not masked properly according to the standard will still be accepted.

Method Detail

newHandshaker

public WebSocketServerHandshaker newHandshaker(HttpRequest req)

Instances a new handshaker

Returns:

A new WebSocketServerHandshaker for the requested web socket version. Null if web socket version is not supported.

sendUnsupportedVersionResponse

public static ChannelFuture sendUnsupportedVersionResponse(Channel channel)

Return that we need cannot not support the web socket version

sendUnsupportedVersionResponse

public static ChannelFuture sendUnsupportedVersionResponse(Channel channel,
                                           ChannelPromise promise)

Return that we need cannot not support the web socket version