0Pricing
WebSockets & Real-Time Systems with Spring · Lesson

Introducing STOMP Protocol

Understand the benefits of STOMP over raw WebSockets for structured message routing and subscription.

Introducing STOMP Protocol is a free WebSockets & Real-Time Systems with Spring lesson on CoddyKit — lesson 1 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the WebSockets & Real-Time Systems with Spring learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Meet STOMP: Structured Messaging

Welcome to STOMP! When building real-time apps with WebSockets, you often need more than just raw data transfer. You need structure, routing, and a way to subscribe to specific messages.

STOMP (Simple Text Oriented Messaging Protocol) provides this structure. Think of it as a higher-level protocol that sits on top of WebSockets.

Raw WebSockets: Limitations

With raw WebSockets, clients and servers send arbitrary bytes or strings. If you want to send a "chat message" or a "user joined" event, you have to define your own rules:

  • How do I know what kind of message it is?
  • Who should receive this message?
  • What if I want to send data in a specific format like JSON?

Without a protocol, you'd implement all this manually.

STOMP: A Common Language

STOMP solves these problems by defining a standard way to send and receive messages. It's like agreeing on a common language for your real-time communication.

  • It's text-based, making it easy to debug.
  • It uses a simple frame format for all communication.
  • It supports common messaging patterns like publish-subscribe.

Understanding STOMP Frames

All communication in STOMP happens via "frames." A STOMP frame consists of three main parts:

  • COMMAND: What action is being performed (e.g., SEND, SUBSCRIBE, CONNECT).
  • HEADERS: Key-value pairs providing additional info (e.g., destination, content-type).
  • BODY: The actual message payload.

These parts are separated by newlines.

First Frame: CONNECT

When a client wants to establish a STOMP connection over a WebSocket, it sends a CONNECT frame. This tells the server it wants to speak STOMP. Note the empty line before the null byte (^@) which terminates the frame.

Here's what a simple CONNECT frame looks like:

CONNECT
accept-version:1.2
host:localhost

Server's Reply: CONNECTED

If the server accepts the connection, it responds with a CONNECTED frame. This confirms the STOMP session is ready. It also includes headers like the server's version and session ID. Remember, frames end with a null byte (^@).

CONNECTED
version:1.2
session:session-1234
server:Spring

Sending Messages: The SEND Frame

To send a message, clients use the SEND command. This frame requires a destination header, which tells the STOMP broker where to route the message. The message body contains the actual data, often JSON. Don't forget the null byte (^@) terminator!

SEND
destination:/app/chat
content-type:application/json

{"user":"Alice","message":"Hello, everyone!"}

Receiving Messages: SUBSCRIBE

Clients receive messages by using the SUBSCRIBE command. They specify a destination to listen to and an id for their subscription. The server then sends MESSAGE frames to this client when new data arrives for that destination. Frames are always null-byte (^@) terminated.

SUBSCRIBE
id:sub-0
destination:/topic/public

STOMP Destinations: Routing

STOMP uses destinations to route messages. These are like addresses. The most common types are:

  • Topics (/topic/...): For broadcast messages, where all subscribers receive a copy. Great for chat rooms.
  • Queues (/queue/...): For point-to-point messages, typically handled by one consumer. Useful for private messages or task queues.

This built-in routing is a major advantage over raw WebSockets.

Why Use STOMP?

STOMP provides significant benefits for real-time applications:

  • Structured Messaging: Standardized frame format.
  • Message Routing: Built-in support for topics and queues.
  • Subscription Model: Easy for clients to listen to specific events.
  • Simpler Client-Side: Many client libraries exist that handle STOMP frames, simplifying development.

It adds a robust layer for complex messaging patterns.

Check Your Understanding

Which of the following is a primary benefit of using STOMP over raw WebSockets?

Lesson Recap: Introducing STOMP

In this lesson, you learned about the STOMP protocol and why it's essential for structured real-time communication over WebSockets.

  • Raw WebSockets lack built-in message structure and routing.
  • STOMP provides a simple, text-based frame format (COMMAND, HEADERS, BODY).
  • Key STOMP commands include CONNECT, CONNECTED, SEND, and SUBSCRIBE.
  • It enables powerful features like topic-based broadcasting and queue-based point-to-point messaging.

Next, we'll see how to integrate STOMP with Spring Boot!

Frequently asked questions

Is the “Introducing STOMP Protocol” lesson free?

Yes — the full text of “Introducing STOMP Protocol” is free to read here on the web, and the WebSockets & Real-Time Systems with Spring course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the WebSockets & Real-Time Systems with Spring course, upgrade to CoddyKit PRO.

What will I learn in “Introducing STOMP Protocol”?

Understand the benefits of STOMP over raw WebSockets for structured message routing and subscription. You practise WebSockets & Real-Time Systems with Spring with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start WebSockets & Real-Time Systems with Spring?

No prior experience is required. WebSockets & Real-Time Systems with Spring on CoddyKit is structured for beginners through advanced learners; this is — lesson 1 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Introducing STOMP Protocol” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this WebSockets & Real-Time Systems with Spring lesson?

Yes. Every WebSockets & Real-Time Systems with Spring lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

  1. Introducing STOMP Protocol
  2. Configuring STOMP with Spring
  3. Sending and Receiving STOMP Messages
  4. Securing STOMP Endpoints with Spring Security
← Back to WebSockets & Real-Time Systems with Spring