allran / stomp-client-ng

STOMP Test Client

StompClientNg

This project was generated with Angular CLI version 11.0.4.

Hosted on GitHub Pages - https://rishabhhanday.github.io/stomp-client-ng/

Development server

Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Introduction

STOMP is a subprotocol operating on top of the lower-level WebSocket.

Stomp-Client

If you are unclear about stomp protocols, please refer to the next section .

Stomp client will help you to connect to any stomp based application. It is quite generic and can be used to perform all the below operation regarding stomp/websocket protocol .

1. Connect to any running stomp based application
2. Send connect headers in CONNECT frame
3. Subscribe to n number of endpoint.
4. Publish a MESSAGE frame with n number of headers in MESSAGE frame.
5. Debug section will help you identify the problems with connection, it'll display all the frames sent and recieved.
6. Share and import STOMP collection with teams mates for collobration.

Why STOMP when we already have WebSocket?

The WebSocket protocol allows you to implement bidirectional communication between applications. It is important to know that HTTP is used only for the initial handshake. After it happens, the HTTP connection is upgraded to a newly opened TCP/IP connection that is used by a WebSocket.

The WebSocket protocol is a rather low-level protocol. It defines how a stream of bytes is transformed into frames. A frame may contain a text or a binary message. Because the message itself does not provide any additional information on how to route or process it, It is difficult to implement more complex applications without writing additional code. Fortunately, the WebSocket specification allows using of sub-protocols that operate on a higher, application level. One of them, supported by the Spring Framework, is STOMP.

STOMPS defines a handful of frame types that are mapped onto WebSockets frames, e.g., CONNECT, SUBSCRIBE, UNSUBSCRIBE, ACK, or SEND. On one hand, these commands are very handy to manage communication while, on the other, they allow us to implement solutions with more sophisticated features like message acknowledgment.

Frames

Client frames

1. SEND - The SEND frame sends a message to a destination in the messaging system. It has one REQUIRED header, destination, which indicates where to send the message. The body of the SEND frame is the message to be sent.

2. SUBSCRIBE - The SUBSCRIBE frame is used to register to listen to a given destination. Like the SEND frame, the SUBSCRIBE frame requires a destination header indicating the destination to which the client wants to subscribe. Any messages received on the subscribed destination will henceforth be delivered as MESSAGE frames from the server to the client.

3. UNSUBSCRIBE - The UNSUBSCRIBE frame is used to remove an existing subscription. Once the subscription is removed the STOMP connections will no longer receive messages from that destination.

4. DISCONNECT - A client can disconnect from the server at anytime by closing the socket

Server frames

1. MESSAGE - MESSAGE frames are used to convey messages from subscriptions to the client. The MESSAGE frame will include a destination header indicating the destination the message was sent to. It will also contain a message-id header with a unique identifier for that message. The subscription header will be set to match the id header of the subscription that is receiving the message. The frame body contains the contents of the message

2. ERROR -the server can send the client an ERROR frame and disconnect the client for any specific reason.

Below are the references .

1. https://www.notion.so/HTTPS-for-Spring-boot-application-d729e13114374922af9693cd17ebccee
2. https://www.notion.so/STOMP-3b52b0d3f43b4785884997caddedfd8b
3. https://stomp.github.io/stomp-specification-1.1.html#DISCONNECT
4. https://spring.io/guides/gs/messaging-stomp-websocket/
5. https://www.baeldung.com/websockets-spring
6. https://www.toptal.com/java/stomp-spring-boot-websocket
7. https://www.dariawan.com/tutorials/spring/spring-boot-websocket-stomp-tutorial/
8. https://docs.spring.io/spring-security/site/docs/4.2.x/reference/html/websocket.html
9. https://www.baeldung.com/spring-security-websockets
10. https://www.toptal.com/java/stomp-spring-boot-websocket