Введение в WebSocket в Java

Онлайн-чат и живой счётчик посетителей обновляют экран без нового HTTP-запроса на каждую цифру: после рукопожатия остаётся один TCP-канал, по которому стороны шлют текстовые кадры в любой момент.

На JVM для учебных примеров удобна библиотека Java-WebSocket: классы WebSocketServer и WebSocketClient из пакета org.java_websocket. Сервер слушает адрес с портом 0, после start номер порта читают у запущенного экземпляра. Клиент подключается к ws://127.0.0.1 и этому порту, шлёт строку на английском; сервер в onMessage может ответить тем же текстом.

Оба конца часто живут в одном main: сервер в фоне, клиент ждёт ответ через CountDownLatch, затем соединение закрывают и вызывают stop у сервера:

import java.net.InetSocketAddress;
import java.net.URI;
import java.util.concurrent.CountDownLatch;
import org.java_websocket.WebSocket;
import org.java_websocket.client.WebSocketClient;
import org.java_websocket.handshake.ClientHandshake;
import org.java_websocket.handshake.ServerHandshake;
import org.java_websocket.server.WebSocketServer;

public class Main {
	public static void main(String[] args) throws Exception {
		CountDownLatch ready = new CountDownLatch(1);
		CountDownLatch done = new CountDownLatch(1);
		WebSocketServer server = new WebSocketServer(
			new InetSocketAddress(0)
		) {
			@Override
			public void onStart() {
				ready.countDown();
			}
			@Override
			public void onOpen(
				WebSocket conn,
				ClientHandshake handshake
			) {}
			@Override
			public void onClose(
				WebSocket conn,
				int code,
				String reason,
				boolean remote
			) {}
			@Override
			public void onMessage(WebSocket conn, String message) {
				conn.send(message);
			}
			@Override
			public void onError(WebSocket conn, Exception ex) {}
		};
		server.start();
		ready.await();
		int port = server.getPort();
		URI uri = URI.create("ws://127.0.0.1:" + port);
		WebSocketClient client = new WebSocketClient(uri) {
			@Override
			public void onOpen(ServerHandshake handshakedata) {}
			@Override
			public void onMessage(String message) {
				System.out.println(message);
				done.countDown();
			}
			@Override
			public void onClose(
				int code,
				String reason,
				boolean remote
			) {}
			@Override
			public void onError(Exception ex) {}
		};
		client.connectBlocking();
		client.send("hello ws");
		done.await();
		client.close();
		server.stop();
	}
}

В консоли появится строка hello ws - это ответ сервера на одно отправленное сообщение. Соединение при этом оставалось открытым между отправкой и приёмом, что и отличает WebSocket от разовых HTTP-запросов.