How To Build A WebSocket Server In Java

Java is a high-level, class-based, object-oriented programming language that aims to have as few implementation dependencies as feasible. Because Java is a general-purpose programming language, compiled Java code can run on all platforms that accept Java without the need to recompile. This is what is meant by the phrase “write once, run anywhere.”

Regardless of the underlying computer architecture, Java applications are often compiled to bytecode that can run on any Java virtual machine (JVM). Although Java has fewer low-level features than either C or C++, it has syntax that is similar to each of them. Unlike most traditional compiled languages, the Java runtime has dynamic capabilities (such as reflection and runtime code change).

The Java language project was launched in June 1991 by Patrick Naughton, Mike Sheridan, and James Gosling. Although Java was initially intended for interactive television, the digital cable television market at the time found it to be too sophisticated. The name “Oak” for the language came from an oak tree that was outside Gosling’s office.


WebSockets enable real-time communication on the web. ws:// or wss:// protocol is an upgraded version of the http:// protocol. Unlike HTTP, WS is long-lived and can receive messages from the server as they occur in real-time.

A two-way interactive communication session can be started between a user’s browser and a server using the WebSocket API, a cutting-edge technology. Without needing to poll the server for a response, you may use this API to send messages to a server and receive event-driven responses.

The HTML5 specification first used WebSocket as a placeholder for a TCP-based socket API under the name TCP connection. Michael Carter facilitated a series of discussions that led to the creation of the initial iteration of the WebSocket protocol in June 2008.

Soon after, through collaboration on the #whatwg IRC chat room, Ian Hickson and Michael Carter came up with the name “WebSocket,” which was later written by Ian Hickson for inclusion in the HTML5 specification.

In today’s post, we will see how to build a WebSocket server in Java and test it using PieSocket’s online websocket client.

Prepare Environment

You need the following installed on your system to follow this tutorial

Please note that we are using Ubuntu for the purpose of demonstration you can use any operating system and the process should be similar.

You may use any text editor of your choice, however, we are using VScode along with the following 3 plugins to make it easy to code in Java.

Helpful VScode extensions for Java

Create Project

Run the following commands to create a directory for your project and switch the current working directory

Open the directory in VS Code

It is an empty directory so far, initialize grade to create the required project structure with the following command

Few prompts will appear.

Select Groovy as build script DSL.

Then, JUnit Jupiter as a testing framework

Leave default selected for the rest i.e., Project name and Source package.

Gradle should initialize the project with following output:

Java Code For WebSocket Server

Add the following dependency in the dependencies block of app/build.gradle file

When you save this file, VS Code will show a prompt to update the classpath configuration, select yes as shown below.

Create a file app/src/main/java/java/websocket/ and add the following to it.

Create an HTML file app/src/main/webapp/index.html to serve as the root for the WebSocket server and add the following content to it

You will have to create the webapp directory first in app/src/main.

Add Gretty Plugin

We need to use Tomcat Servlet to serve the WebSocket server code, and for this, we need to add Gretty to our project.

Add the following to plugins section of the app/build.gradle file

And finally, add the following at the very bottom of the same build.gradle file.

Your complete app/build.gradle the file should look like following

Running the server

It’s time to test the WebSocket server.

To do so, we need to first run the WebSocket server in a terminal and leave it running.

Run the command given above from the project directory and you should see an output similar to the following.

Open http://localhost:8080 in your browser and you should see a “Hello From WebSocket” message.

This means the WebSocket server is running and we can test it with PieSocket’s WebSocket Client Extension.

Open the extension and enter http://localhost:8080/socket as WebSocket URL and click Connect.

WebSocket Client Extension

You should be now able to send and receive messages from your Java WebSocket server.


We learned how to build a WebSocket server with Java without Springboot, Spark, or any other framework. We also learned how to test a WebSocket server with PieSocket’s WebSocket tester extension.

WebSockets are easy to build, but difficult to scale, and maintain, we recommend using PieSocket’s Managed WebSocket API for all your production WebSocket use-cases.