This repository contains a simple WebSocket server and client implementation in Java. The underlying classes use the Java classes ServerSocketChannel and SocketChannel, to allow for a non-blocking event-driven model (similar to the WebSocket API for web browsers).

There's a simple chat server and client example located in the example folder.

First, start the chat server (a WebSocketServer subclass): cd example/ java ChatServer

Now that the server is started, we need to connect some clients. Run the Java chat client (a WebSocketClient subclass): java ChatClient

The chat client is a simple Swing GUI that allows you to send messages to all other connected clients, and recieve messages from others in a text box.

There's also a simple HTML file chat client chat.html, which can be opened by any browser. If the browser natively supports the WebSocket API, then it will be used, otherwise it will fall back to a Flash-based WebSocket Implementation.

A WebSocket server by itself doesn't do anything except establish socket connections though HTTP. After that it's up to a subclass to add purpose. The WebSocketServer class implements the server-side of the WebSocket Protocol.

The WebSocketClient class can connect to valid WebSocket servers. The constructor expects a valid ws:// URI to connect to. Important events onOpen, onClose, and onMessage get fired throughout the life of the WebSocketClient, and must be implemented in your subclass.

Everything found in this repo is licensed under an MIT license. See the LICENSE file for specifics.