Package io.netty.handler.codec.http.websocketx.extensions.compression

Class PerMessageDeflateServerExtensionHandshaker

java.lang.Object

io.netty.handler.codec.http.websocketx.extensions.compression.PerMessageDeflateServerExtensionHandshaker

All Implemented Interfaces:

WebSocketServerExtensionHandshaker

public final class PerMessageDeflateServerExtensionHandshaker
extends java.lang.Object
implements WebSocketServerExtensionHandshaker

permessage-deflate handshake implementation.

Field Summary

Fields

Modifier and Type	Field	Description
static int	MAX_WINDOW_SIZE
static int	MIN_WINDOW_SIZE

Constructor Summary

Constructors

Constructor	Description
PerMessageDeflateServerExtensionHandshaker()	Deprecated. Use {@link PerMessageDeflateServerExtensionHandshaker# PerMessageDeflateServerExtensionHandshaker(int)}.
PerMessageDeflateServerExtensionHandshaker(int maxAllocation)	Constructor with default configuration.
PerMessageDeflateServerExtensionHandshaker(int compressionLevel, boolean allowServerWindowSize, int preferredClientWindowSize, boolean allowServerNoContext, boolean preferredClientNoContext)	Deprecated. Use PerMessageDeflateServerExtensionHandshaker( int, boolean, int, boolean, boolean, int).
PerMessageDeflateServerExtensionHandshaker(int compressionLevel, boolean allowServerWindowSize, int preferredClientWindowSize, boolean allowServerNoContext, boolean preferredClientNoContext, int maxAllocation)	Constructor with custom configuration.
PerMessageDeflateServerExtensionHandshaker(int compressionLevel, boolean allowServerWindowSize, int preferredClientWindowSize, boolean allowServerNoContext, boolean preferredClientNoContext, WebSocketExtensionFilterProvider extensionFilterProvider)	Deprecated. Use PerMessageDeflateServerExtensionHandshaker( int, boolean, int, boolean, boolean, WebSocketExtensionFilterProvider, int).
PerMessageDeflateServerExtensionHandshaker(int compressionLevel, boolean allowServerWindowSize, int preferredClientWindowSize, boolean allowServerNoContext, boolean preferredClientNoContext, WebSocketExtensionFilterProvider extensionFilterProvider, int maxAllocation)	Constructor with custom configuration.

Method Summary

Modifier and Type	Method	Description
WebSocketServerExtension	handshakeExtension(WebSocketExtensionData extensionData)	Handshake based on client request.

Methods inherited from class java.lang.Object

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

Field Detail

MIN_WINDOW_SIZE

public static final int MIN_WINDOW_SIZE

See Also:

Constant Field Values

MAX_WINDOW_SIZE

public static final int MAX_WINDOW_SIZE

See Also:

Constant Field Values

Constructor Detail

PerMessageDeflateServerExtensionHandshaker

@Deprecated
public PerMessageDeflateServerExtensionHandshaker()

Deprecated.

Use {@link PerMessageDeflateServerExtensionHandshaker# PerMessageDeflateServerExtensionHandshaker(int)}.

Constructor with default configuration.

PerMessageDeflateServerExtensionHandshaker

public PerMessageDeflateServerExtensionHandshaker(int maxAllocation)

Constructor with default configuration.

Parameters:

maxAllocation - Maximum size of the decompression buffer. Must be >= 0. If zero, maximum size is not limited.

PerMessageDeflateServerExtensionHandshaker

@Deprecated
public PerMessageDeflateServerExtensionHandshaker(int compressionLevel,
                                                  boolean allowServerWindowSize,
                                                  int preferredClientWindowSize,
                                                  boolean allowServerNoContext,
                                                  boolean preferredClientNoContext)

Deprecated.

Use PerMessageDeflateServerExtensionHandshaker( int, boolean, int, boolean, boolean, int).

Constructor with custom configuration.

Parameters:

compressionLevel - Compression level between 0 and 9 (default is 6).

allowServerWindowSize - allows WebSocket client to customize the server inflater window size (default is false).

preferredClientWindowSize - indicates the preferred client window size to use if client inflater is customizable.

allowServerNoContext - allows WebSocket client to activate server_no_context_takeover (default is false).

preferredClientNoContext - indicates if server prefers to activate client_no_context_takeover if client is compatible with (default is false).

PerMessageDeflateServerExtensionHandshaker

public PerMessageDeflateServerExtensionHandshaker(int compressionLevel,
                                                  boolean allowServerWindowSize,
                                                  int preferredClientWindowSize,
                                                  boolean allowServerNoContext,
                                                  boolean preferredClientNoContext,
                                                  int maxAllocation)

Constructor with custom configuration.

Parameters:

compressionLevel - Compression level between 0 and 9 (default is 6).

allowServerWindowSize - allows WebSocket client to customize the server inflater window size (default is false).

preferredClientWindowSize - indicates the preferred client window size to use if client inflater is customizable.

allowServerNoContext - allows WebSocket client to activate server_no_context_takeover (default is false).

preferredClientNoContext - indicates if server prefers to activate client_no_context_takeover if client is compatible with (default is false).

maxAllocation - Maximum size of the decompression buffer. Must be >= 0. If zero, maximum size is not limited.

PerMessageDeflateServerExtensionHandshaker

@Deprecated
public PerMessageDeflateServerExtensionHandshaker(int compressionLevel,
                                                  boolean allowServerWindowSize,
                                                  int preferredClientWindowSize,
                                                  boolean allowServerNoContext,
                                                  boolean preferredClientNoContext,
                                                  WebSocketExtensionFilterProvider extensionFilterProvider)

Deprecated.

Use PerMessageDeflateServerExtensionHandshaker( int, boolean, int, boolean, boolean, WebSocketExtensionFilterProvider, int).

Constructor with custom configuration.

Parameters:

compressionLevel - Compression level between 0 and 9 (default is 6).

allowServerWindowSize - allows WebSocket client to customize the server inflater window size (default is false).

preferredClientWindowSize - indicates the preferred client window size to use if client inflater is customizable.

allowServerNoContext - allows WebSocket client to activate server_no_context_takeover (default is false).

preferredClientNoContext - indicates if server prefers to activate client_no_context_takeover if client is compatible with (default is false).

extensionFilterProvider - provides server extension filters for per message deflate encoder and decoder.

PerMessageDeflateServerExtensionHandshaker

public PerMessageDeflateServerExtensionHandshaker(int compressionLevel,
                                                  boolean allowServerWindowSize,
                                                  int preferredClientWindowSize,
                                                  boolean allowServerNoContext,
                                                  boolean preferredClientNoContext,
                                                  WebSocketExtensionFilterProvider extensionFilterProvider,
                                                  int maxAllocation)

Constructor with custom configuration.

Parameters:

compressionLevel - Compression level between 0 and 9 (default is 6).

allowServerWindowSize - allows WebSocket client to customize the server inflater window size (default is false).

preferredClientWindowSize - indicates the preferred client window size to use if client inflater is customizable.

allowServerNoContext - allows WebSocket client to activate server_no_context_takeover (default is false).

preferredClientNoContext - indicates if server prefers to activate client_no_context_takeover if client is compatible with (default is false).

extensionFilterProvider - provides server extension filters for per message deflate encoder and decoder.

maxAllocation - Maximum size of the decompression buffer. Must be >= 0. If zero, maximum size is not limited.

Method Detail

handshakeExtension

public WebSocketServerExtension handshakeExtension(WebSocketExtensionData extensionData)

Description copied from interface: WebSocketServerExtensionHandshaker

Handshake based on client request. It must failed with null if server cannot handle it.

Specified by:

handshakeExtension in interface WebSocketServerExtensionHandshaker

Parameters:

extensionData - the extension configuration sent by the client.

Returns:

an initialized extension if handshake phase succeed or null if failed.