The WebSocket class is demonstrated in the [Build the Java API Client Demo](#Walkthrough) example, but there are some additional elements to be aware of such as methods for text and/or binary WebSocket messages. These methods are described in [Methods for Text and Binary Messages](#Binary).

**Note:** In UI-based Java clients, receiving messages should be done on a separate thread to avoid blocking the java.awt [EventDispatchThread](http://docs.oracle.com/javase/tutorial/uiswing/concurrency/dispatch.html). Review the example in [Build the Java API Client Demo](http://localhost:8001/documentation/dev-java/p_dev_java_websocket.html#Walkthrough) to see a demonstration.