# Stomp WebSockets Example

    To run the example, simply type mvn verify from this directory,
    or mvn -PnoServer verify if you want to start and create the server manually.

This example shows you how to configure ActiveMQ Artemis to send and receive Stomp messages from modern web browser using Web Sockets.

The example will start a ActiveMQ Artemis server configured with Stomp over Web Sockets and JMS. Web browsers clients and Java application will exchange message using a JMS Topic.

    <acceptor name="stomp-websocket">tcp://localhost:61614</acceptor>

## Example step-by-step

To run the example, simply type `mvn verify -Pexample` from this directory

To subscribe to the topic from your web browser, open the Chat Example or the JBoss AeroGear STOMP notifier Chat Example from another tab. The chat example is preconfigured to connect to the ActiveMQ Artemis server with the URL `ws://localhost:61614/stomp` and subscribe to the JMS Topic (through its core address `jms.topic.chat`).

You can open as many Web clients as you want and they will all exchange messages through the topic

If you run again the Java application (with `./build.sh`), the web clients will also receive its message

## Documentation

A JavaScript library is used on the browser side to be able to use Stomp Over Web Sockets (please see its documentation for a complete description).

The JBoss AeroGear STOMP notifier Chat Example is using the AeroGear Notifier which is a collection of adapters that provide a unified or similar API for interacting with different messaging services and protocols. The STOMP adapter is used for communicating with STOMP over WebSockets. See more at: JBoss aerogear-js