/*
* 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;
import io.undertow.server.HttpHandler;
import io.undertow.server.HttpServerExchange;
import io.undertow.server.HttpUpgradeListener;
import io.undertow.server.handlers.ResponseCodeHandler;
import io.undertow.util.Methods;
import io.undertow.websockets.core.WebSocketChannel;
import io.undertow.websockets.core.WebSocketLogger;
import io.undertow.websockets.core.protocol.Handshake;
import io.undertow.websockets.core.protocol.version07.Hybi07Handshake;
import io.undertow.websockets.core.protocol.version08.Hybi08Handshake;
import io.undertow.websockets.core.protocol.version13.Hybi13Handshake;
import io.undertow.websockets.extensions.ExtensionHandshake;
import io.undertow.websockets.spi.AsyncWebSocketHttpServerExchange;
import org.xnio.StreamConnection;
import java.util.Collection;
import java.util.Collections;
import java.util.HashSet;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
HttpHandler
which will process the HttpServerExchange
and do the actual handshake/upgrade to WebSocket. Author: Norman Maurer
/**
* {@link HttpHandler} which will process the {@link HttpServerExchange} and do the actual handshake/upgrade
* to WebSocket.
*
* @author <a href="mailto:nmaurer@redhat.com">Norman Maurer</a>
*/
public class WebSocketProtocolHandshakeHandler implements HttpHandler {
private final Set<Handshake> handshakes;
The upgrade listener. This will only be used if another web socket implementation is being layered on top.
/**
* The upgrade listener. This will only be used if another web socket implementation is being layered on top.
*/
private final HttpUpgradeListener upgradeListener;
private final WebSocketConnectionCallback callback;
private final Set<WebSocketChannel> peerConnections = Collections.newSetFromMap(new ConcurrentHashMap<WebSocketChannel, Boolean>());
The handler that is invoked if there are no web socket headers
/**
* The handler that is invoked if there are no web socket headers
*/
private final HttpHandler next;
Create a new WebSocketProtocolHandshakeHandler
Params: - callback – The
WebSocketConnectionCallback
which will be executed once the handshake was established
/**
* Create a new {@link WebSocketProtocolHandshakeHandler}
*
* @param callback The {@link WebSocketConnectionCallback} which will be executed once the handshake was
* established
*/
public WebSocketProtocolHandshakeHandler(final WebSocketConnectionCallback callback) {
this(callback, ResponseCodeHandler.HANDLE_404);
}
Create a new WebSocketProtocolHandshakeHandler
Params: - callback – The
WebSocketConnectionCallback
which will be executed once the handshake was established
/**
* Create a new {@link WebSocketProtocolHandshakeHandler}
*
* @param callback The {@link WebSocketConnectionCallback} which will be executed once the handshake was
* established
*/
public WebSocketProtocolHandshakeHandler(final WebSocketConnectionCallback callback, final HttpHandler next) {
this.callback = callback;
Set<Handshake> handshakes = new HashSet<>();
handshakes.add(new Hybi13Handshake());
handshakes.add(new Hybi08Handshake());
handshakes.add(new Hybi07Handshake());
this.handshakes = handshakes;
this.next = next;
this.upgradeListener = null;
}
Create a new WebSocketProtocolHandshakeHandler
Params: - handshakes – The supported handshake methods
- callback – The
WebSocketConnectionCallback
which will be executed once the handshake was established
/**
* Create a new {@link WebSocketProtocolHandshakeHandler}
*
* @param handshakes The supported handshake methods
* @param callback The {@link WebSocketConnectionCallback} which will be executed once the handshake was
* established
*/
public WebSocketProtocolHandshakeHandler(Collection<Handshake> handshakes, final WebSocketConnectionCallback callback) {
this(handshakes, callback, ResponseCodeHandler.HANDLE_404);
}
Create a new WebSocketProtocolHandshakeHandler
Params: - handshakes – The supported handshake methods
- callback – The
WebSocketConnectionCallback
which will be executed once the handshake was established
/**
* Create a new {@link WebSocketProtocolHandshakeHandler}
*
* @param handshakes The supported handshake methods
* @param callback The {@link WebSocketConnectionCallback} which will be executed once the handshake was
* established
*/
public WebSocketProtocolHandshakeHandler(Collection<Handshake> handshakes, final WebSocketConnectionCallback callback, final HttpHandler next) {
this.callback = callback;
this.handshakes = new HashSet<>(handshakes);
this.next = next;
this.upgradeListener = null;
}
Create a new WebSocketProtocolHandshakeHandler
Params: - callback – The
WebSocketConnectionCallback
which will be executed once the handshake was established
/**
* Create a new {@link WebSocketProtocolHandshakeHandler}
*
* @param callback The {@link WebSocketConnectionCallback} which will be executed once the handshake was
* established
*/
public WebSocketProtocolHandshakeHandler(final HttpUpgradeListener callback) {
this(callback, ResponseCodeHandler.HANDLE_404);
}
Create a new WebSocketProtocolHandshakeHandler
Params: - callback – The
WebSocketConnectionCallback
which will be executed once the handshake was established
/**
* Create a new {@link WebSocketProtocolHandshakeHandler}
*
* @param callback The {@link WebSocketConnectionCallback} which will be executed once the handshake was
* established
*/
public WebSocketProtocolHandshakeHandler(final HttpUpgradeListener callback, final HttpHandler next) {
this.callback = null;
Set<Handshake> handshakes = new HashSet<>();
handshakes.add(new Hybi13Handshake());
handshakes.add(new Hybi08Handshake());
handshakes.add(new Hybi07Handshake());
this.handshakes = handshakes;
this.next = next;
this.upgradeListener = callback;
}
Create a new WebSocketProtocolHandshakeHandler
Params: - handshakes – The supported handshake methods
- callback – The
WebSocketConnectionCallback
which will be executed once the handshake was established
/**
* Create a new {@link WebSocketProtocolHandshakeHandler}
*
* @param handshakes The supported handshake methods
* @param callback The {@link WebSocketConnectionCallback} which will be executed once the handshake was
* established
*/
public WebSocketProtocolHandshakeHandler(Collection<Handshake> handshakes, final HttpUpgradeListener callback) {
this(handshakes, callback, ResponseCodeHandler.HANDLE_404);
}
Create a new WebSocketProtocolHandshakeHandler
Params: - handshakes – The supported handshake methods
- callback – The
WebSocketConnectionCallback
which will be executed once the handshake was established
/**
* Create a new {@link WebSocketProtocolHandshakeHandler}
*
* @param handshakes The supported handshake methods
* @param callback The {@link WebSocketConnectionCallback} which will be executed once the handshake was
* established
*/
public WebSocketProtocolHandshakeHandler(Collection<Handshake> handshakes, final HttpUpgradeListener callback, final HttpHandler next) {
this.callback = null;
this.handshakes = new HashSet<>(handshakes);
this.next = next;
this.upgradeListener = callback;
}
@Override
public void handleRequest(final HttpServerExchange exchange) throws Exception {
if (!exchange.getRequestMethod().equals(Methods.GET)) {
// Only GET is supported to start the handshake
next.handleRequest(exchange);
return;
}
final AsyncWebSocketHttpServerExchange facade = new AsyncWebSocketHttpServerExchange(exchange, peerConnections);
Handshake handshaker = null;
for (Handshake method : handshakes) {
if (method.matches(facade)) {
handshaker = method;
break;
}
}
if (handshaker == null) {
next.handleRequest(exchange);
} else {
WebSocketLogger.REQUEST_LOGGER.debugf("Attempting websocket handshake with %s on %s", handshaker, exchange);
final Handshake selected = handshaker;
if (upgradeListener == null) {
exchange.upgradeChannel(new HttpUpgradeListener() {
@Override
public void handleUpgrade(StreamConnection streamConnection, HttpServerExchange exchange) {
WebSocketChannel channel = selected.createChannel(facade, streamConnection, facade.getBufferPool());
peerConnections.add(channel);
callback.onConnect(facade, channel);
}
});
} else {
exchange.upgradeChannel(upgradeListener);
}
handshaker.handshake(facade);
}
}
public Set<WebSocketChannel> getPeerConnections() {
return peerConnections;
}
Add a new WebSocket Extension into the handshakes defined in this handler.
Params: - extension – a new
ExtensionHandshake
instance
Returns: current handler
/**
* Add a new WebSocket Extension into the handshakes defined in this handler.
*
* @param extension a new {@code ExtensionHandshake} instance
* @return current handler
*/
public WebSocketProtocolHandshakeHandler addExtension(ExtensionHandshake extension) {
if (extension != null) {
for (Handshake handshake : handshakes) {
handshake.addExtension(extension);
}
}
return this;
}
}