io.netty.handler.codec.http.websocketx

Class WebSocketServerHandshakerFactory

java.lang.Object

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

public class WebSocketServerHandshakerFactory
extends java.lang.Object

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

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	allowExtensions
private int	maxFramePayloadLength
private java.lang.String	subprotocols
private java.lang.String	webSocketURL

Constructor Summary

Constructors

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

Method Summary

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
static void	sendUnsupportedWebSocketVersionResponse(Channel channel) Deprecated. use sendUnsupportedVersionResponse(Channel)

Methods inherited from class java.lang.Object

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

Field Detail

webSocketURL

private final java.lang.String webSocketURL

subprotocols

private final java.lang.String subprotocols

allowExtensions

private final boolean allowExtensions

maxFramePayloadLength

private final int maxFramePayloadLength

Constructor Detail

WebSocketServerHandshakerFactory

public WebSocketServerHandshakerFactory(java.lang.String webSocketURL,
                                        java.lang.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(java.lang.String webSocketURL,
                                        java.lang.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.

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.

sendUnsupportedWebSocketVersionResponse

@Deprecated
public static void sendUnsupportedWebSocketVersionResponse(Channel channel)

Deprecated. use sendUnsupportedVersionResponse(Channel)

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