io.netty.handler.codec.http.websocketx

Class WebSocketClientHandshakerFactory

java.lang.Object

io.netty.handler.codec.http.websocketx.WebSocketClientHandshakerFactory

public final class WebSocketClientHandshakerFactory
extends Object

Creates a new WebSocketClientHandshaker of desired protocol version.

Method Summary

Methods

Modifier and Type	Method and Description
static WebSocketClientHandshaker	newHandshaker(URI webSocketURL, WebSocketVersion version, String subprotocol, boolean allowExtensions, HttpHeaders customHeaders) Creates a new handshaker.
static WebSocketClientHandshaker	newHandshaker(URI webSocketURL, WebSocketVersion version, String subprotocol, boolean allowExtensions, HttpHeaders customHeaders, int maxFramePayloadLength) Creates a new handshaker.
static WebSocketClientHandshaker	newHandshaker(URI webSocketURL, WebSocketVersion version, String subprotocol, boolean allowExtensions, HttpHeaders customHeaders, int maxFramePayloadLength, boolean performMasking, boolean allowMaskMismatch) Creates a new handshaker.

Methods inherited from class java.lang.Object

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

Method Detail

newHandshaker

public static WebSocketClientHandshaker newHandshaker(URI webSocketURL,
                                      WebSocketVersion version,
                                      String subprotocol,
                                      boolean allowExtensions,
                                      HttpHeaders customHeaders)

Creates a new handshaker.

Parameters:

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

version - Version of web socket specification to use to connect to the server

subprotocol - Sub protocol request sent to the server. Null if no sub-protocol support is required.

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

customHeaders - Custom HTTP headers to send during the handshake

newHandshaker

public static WebSocketClientHandshaker newHandshaker(URI webSocketURL,
                                      WebSocketVersion version,
                                      String subprotocol,
                                      boolean allowExtensions,
                                      HttpHeaders customHeaders,
                                      int maxFramePayloadLength)

Creates a new handshaker.

Parameters:

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

version - Version of web socket specification to use to connect to the server

subprotocol - Sub protocol request sent to the server. Null if no sub-protocol support is required.

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

customHeaders - Custom HTTP headers to send during the handshake

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

newHandshaker

public static WebSocketClientHandshaker newHandshaker(URI webSocketURL,
                                      WebSocketVersion version,
                                      String subprotocol,
                                      boolean allowExtensions,
                                      HttpHeaders customHeaders,
                                      int maxFramePayloadLength,
                                      boolean performMasking,
                                      boolean allowMaskMismatch)

Creates a new handshaker.

Parameters:

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

version - Version of web socket specification to use to connect to the server

subprotocol - Sub protocol request sent to the server. Null if no sub-protocol support is required.

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

customHeaders - Custom HTTP headers to send during the handshake

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

performMasking - Whether to mask all written websocket frames. This must be set to true in order to be fully compatible with the websocket specifications. Client applications that communicate with a non-standard server which doesn't require masking might set this to false to achieve a higher performance.

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.