NodeJS StompBroker

This is simple NodeJs STOMP 1.1 broker for embedded usage.

• Destination wildcards
  • . is used to separate names in a path
  • * is used to mach any name in a path
  • ** is used to recursively match path names

#TODO

• Authorization
• Heartbeat
• Acknowledgment
• Async send messages
• Transactions
• Composite Destinations
• Message selectors

#Changelog

• 0.1.0 First working version.
• 0.1.1 Added wildcards to destination, change subscribe method [no backward compatibility]
• 0.1.2 Bug fixes, changed websocket library, updated documentation.
• 0.1.3 Unsubscribe on server, updated documentation, added events.

#Example

var http = require("http");
var StompServer = require('stompServer');

var server = http.createServer();
var stompServer = new StompServer({server: server});

server.listen(61614);

stompServer.subscribe("/**", function(msg, headers) {
  var topic = headers.destination;
  console.log(topic, "->", msg);
});

stompServer.send('/test', {}, 'testMsg');

#Documentation

StompServer ⇐ EventEmitter

ServerConfig : object

STOMP Server configuration

OnSubscribedMessageCallback : function

Subscription callback method

MsgFrame : object

Message frame

Kind: global class
Extends: EventEmitter

• StompServer ⇐ EventEmitter
  • new StompServer(config)
  • .onUnsubscribe() ⇒ boolean
  • .subscribe(topic, [callback]) ⇒ string
  • .unsubscribe(id) ⇒ boolean
  • .send(topic, headers, body)
  • .frameSerializer(frame) ⇒ MsgFrame
  • .frameParser(frame) ⇒ MsgFrame
  • "error"
  • "connecting"
  • "connected"
  • "disconnected"
  • "send"
  • "subscribe"
  • "unsubscribe"

Kind: instance method of StompServer

Subsribe topic

Kind: instance method of StompServer
Returns: string - Subscription id, when message is received event with this id is emitted

Example

stompServer.subscribe("/test.data", function(msg, headers) {});
//or alternative
var subs_id = stompServer.subscribe("/test.data");
stompServer.on(subs_id, function(msg, headers) {});

Unsubscribe topic with subscription id

Kind: instance method of StompServer
Returns: boolean - Subscription is deleted

Send message to topic

Kind: instance method of StompServer

Serialize frame to string for send

Kind: instance method of StompServer
Returns: MsgFrame - modified frame

Parse frame to object for reading

Kind: instance method of StompServer
Returns: MsgFrame - modified frame

Client error event

Kind: event emitted by StompServer

Client connecting event, emitted after socket is opened.

Kind: event emitted by StompServer
Properties

Client connected event, emitted after connection established and negotiated

Kind: event emitted by StompServer
Properties

Client disconnected event

Kind: event emitted by StompServer
Properties

Event emitted when broker send message to subscribers

Kind: event emitted by StompServer
Properties

Client subscribe event, emitted when client subscribe topic

Kind: event emitted by StompServer
Properties

Client subscribe event, emitted when client unsubscribe topic

Kind: event emitted by StompServer
Properties

STOMP Server configuration

Kind: global typedef

Subscription callback method

Kind: global typedef

Message frame

Kind: global typedef