/*
 * JBoss, Home of Professional Open Source.
 * Copyright 2014 Red Hat, Inc., and individual contributors
 * as indicated by the @author tags.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 */

package io.undertow.websockets.extensions;

import java.util.HashSet;
import java.util.List;
import java.util.Set;
import java.util.zip.Deflater;

import io.undertow.websockets.WebSocketExtension;
import io.undertow.websockets.core.WebSocketLogger;

Implementation of permessage-deflate WebSocket Extension handshake.

This implementation supports parameters: server_no_context_takeover, client_no_context_takeover .

This implementation does not support parameters: server_max_window_bits, client_max_window_bits .

Author:Lucas Ponce
See Also:
/** * Implementation of {@code permessage-deflate} WebSocket Extension handshake. * <p> * This implementation supports parameters: {@code server_no_context_takeover, client_no_context_takeover} . * <p> * This implementation does not support parameters: {@code server_max_window_bits, client_max_window_bits} . * * @see <a href="http://tools.ietf.org/html/draft-ietf-hybi-permessage-compression-18">Compression Extensions for WebSocket</a> * * @author Lucas Ponce */
public class PerMessageDeflateHandshake implements ExtensionHandshake { private static final String PERMESSAGE_DEFLATE = "permessage-deflate"; private static final String SERVER_NO_CONTEXT_TAKEOVER = "server_no_context_takeover"; private static final String CLIENT_NO_CONTEXT_TAKEOVER = "client_no_context_takeover"; private static final String SERVER_MAX_WINDOW_BITS = "server_max_window_bits"; private static final String CLIENT_MAX_WINDOW_BITS = "client_max_window_bits"; private final Set<String> incompatibleExtensions = new HashSet<>(); private boolean compressContextTakeover; private boolean decompressContextTakeover; private final boolean client; private final int deflaterLevel;
Default configuration for DEFLATE algorithm implementation
/** * Default configuration for DEFLATE algorithm implementation */
public static final int DEFAULT_DEFLATER = Deflater.DEFAULT_COMPRESSION; public PerMessageDeflateHandshake() { this(false); }
Create a new PerMessageDeflateHandshake instance.
Params:
  • client – indicate if extension is configured in client (true ) context or server (false ) context.
/** * Create a new {@code PerMessageDeflateHandshake} instance. * * @param client indicate if extension is configured in client ({@code true }) context or server ({@code false }) context. */
public PerMessageDeflateHandshake(final boolean client) { this(client, DEFAULT_DEFLATER); }
Create a new PerMessageDeflateHandshake instance.
Params:
  • client – indicate if extension is configured in client (true ) context or server (false ) context
  • deflaterLevel – the level of configuration of DEFLATE algorithm implementation
/** * Create a new {@code PerMessageDeflateHandshake} instance. * * @param client indicate if extension is configured in client ({@code true }) context or server ({@code false }) context * @param deflaterLevel the level of configuration of DEFLATE algorithm implementation */
public PerMessageDeflateHandshake(final boolean client, final int deflaterLevel) { this(client, deflaterLevel, true, true); }
Create a new PerMessageDeflateHandshake instance.
Params:
  • client – flag for client (true ) context or server (false ) context
  • compressContextTakeover – flag for compressor context takeover or without compressor context
  • decompressContextTakeover – flag for decompressor context takeover or without decompressor context
/** * Create a new {@code PerMessageDeflateHandshake} instance. * * @param client flag for client ({@code true }) context or server ({@code false }) context * @param compressContextTakeover flag for compressor context takeover or without compressor context * @param decompressContextTakeover flag for decompressor context takeover or without decompressor context */
public PerMessageDeflateHandshake(final boolean client, boolean compressContextTakeover, boolean decompressContextTakeover) { this(client, DEFAULT_DEFLATER, compressContextTakeover, decompressContextTakeover); }
Create a new PerMessageDeflateHandshake instance.
Params:
  • client – flag for client (true ) context or server (false ) context
  • deflaterLevel – the level of configuration of DEFLATE algorithm implementation
  • compressContextTakeover – flag for compressor context takeover or without compressor context
  • decompressContextTakeover – flag for decompressor context takeover or without decompressor context
/** * Create a new {@code PerMessageDeflateHandshake} instance. * * @param client flag for client ({@code true }) context or server ({@code false }) context * @param deflaterLevel the level of configuration of DEFLATE algorithm implementation * @param compressContextTakeover flag for compressor context takeover or without compressor context * @param decompressContextTakeover flag for decompressor context takeover or without decompressor context */
public PerMessageDeflateHandshake(final boolean client, final int deflaterLevel, boolean compressContextTakeover, boolean decompressContextTakeover) { this.client = client; this.deflaterLevel = deflaterLevel; /* This extension is incompatible with multiple instances of same extension in the same Endpoint. */ incompatibleExtensions.add(PERMESSAGE_DEFLATE); this.compressContextTakeover = compressContextTakeover; this.decompressContextTakeover = decompressContextTakeover; } @Override public String getName() { return PERMESSAGE_DEFLATE; } @Override public WebSocketExtension accept(final WebSocketExtension extension) { if (extension == null || !extension.getName().equals(getName())) return null; WebSocketExtension negotiated = new WebSocketExtension(extension.getName()); if (extension.getParameters() == null || extension.getParameters().size() == 0) return negotiated; for (WebSocketExtension.Parameter parameter : extension.getParameters()) { if (parameter.getName().equals(SERVER_MAX_WINDOW_BITS)) { /* Not supported */ } else if (parameter.getName().equals(CLIENT_MAX_WINDOW_BITS)) { /* Not supported */ } else if (parameter.getName().equals(SERVER_NO_CONTEXT_TAKEOVER)) { negotiated.getParameters().add(parameter); if (client) { decompressContextTakeover = false; } else { compressContextTakeover = false; } } else if (parameter.getName().equals(CLIENT_NO_CONTEXT_TAKEOVER)) { negotiated.getParameters().add(parameter); if (client) { compressContextTakeover = false; } else { decompressContextTakeover = false; } } else { WebSocketLogger.EXTENSION_LOGGER.incorrectExtensionParameter(parameter); return null; } } WebSocketLogger.EXTENSION_LOGGER.debugf("Negotiated extension %s for handshake %s", negotiated, extension); return negotiated; } @Override public boolean isIncompatible(List<ExtensionHandshake> extensions) { for (ExtensionHandshake extension : extensions) { if (incompatibleExtensions.contains(extension.getName())) { return true; } } return false; } @Override public ExtensionFunction create() { return new PerMessageDeflateFunction(deflaterLevel, compressContextTakeover, decompressContextTakeover); } }