com.netphantom.server.ws

Class WebSocketServer

java.lang.Object

com.netphantom.common.websocket.WebSocket

com.netphantom.server.ws.WebSocketServer

public class WebSocketServer
extends WebSocket

The WebSocket Server pure socket implementation. This implementation is based on the "HyBi Working Group, draft-ietf-hybi-thewebsocketprotocol-03, October 17, 2010, by I. Fette, Google Inc.".

See http://tools.ietf.org/html/draft-ietf-hybi-thewebsocketprotocol-03 for more information.

The WebSocket protocol enables two-way communication between a user agent running untrusted code running in a controlled environment to a remote host that has opted-in to communications from that code. The security model used for this is the Origin-based security model commonly used by Web browsers. The protocol consists of an initial handshake followed by basic message framing, layered over TCP. The goal of this technology is to provide a mechanism for browser-based applications that need two-way communication with servers that does not rely on opening multiple HTTP connections (e.g. using XMLHttpRequest or <iframe>s and long polling).

Author:

Christopher Mindus

Nested Class Summary

Nested classes/interfaces inherited from class com.netphantom.common.websocket.WebSocket

WebSocket.State

Field Summary

Fields inherited from class com.netphantom.common.websocket.WebSocket

ACCEPT_GUID, clientToServerMask, CRLF, CS_FRAME_GUID, input, isSecure, isVerbose, output, protocolVersion, socket, ssubProtocol, state

Constructor Summary

Constructors

Constructor and Description
WebSocketServer(Socket socket, boolean isSecure) Establishes the WebSocket connection using an already connected socket.

Method Summary

Modifier and Type	Method and Description
void	performHandshake(String resource, Map<String,String> headerFields, List<String> subProtocols, boolean doFailForUnsupportedSubProtocol) Performs the Web Socket handshake.

Methods inherited from class com.netphantom.common.websocket.WebSocket

close, closeSocket, closeSocketHard, getBinaryMessage, getOldTextProtocol, getProtocolVersion, getServerSubProtocol, getState, getTextMessage, hasBinaryMessage, hasTextMessage, isVerbose, readMessage, sendBinaryData, sendBinaryData, sendText, setOldTextProtocol, setProtocolVersion, setVerbose

Methods inherited from class java.lang.Object

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

Constructor Detail

WebSocketServer

public WebSocketServer(Socket socket,
                       boolean isSecure)
                throws IOException

Establishes the WebSocket connection using an already connected socket. This socket can be SSL or plain. The socket can also have undergone some kind of proxy such as Socks or HTTP before ending up here.

Parameters:

socket - The established socket.

isSecure - If the connection is secure.

Throws:

IOException - For failures.

Method Detail

performHandshake

public void performHandshake(String resource,
                             Map<String,String> headerFields,
                             List<String> subProtocols,
                             boolean doFailForUnsupportedSubProtocol)
                      throws IOException

Performs the Web Socket handshake.

Parameters:

resource - The URL resource.

headerFields - The header fields of the HTTP request message.

subProtocols - The list of sub-protocols requested, null for none.

doFailForUnsupportedSubProtocol - Flag indicating a WebSocketException is thrown if the server doesn't support request protocols (if any).

Throws:

IOException - For failures.

EOFException - For unexpected closure of the socket.

WebSocketException - For exceptions relating to Web Sockets (protocol, etc).