https://github.com/strongloop/strong-mq
MQ API with cluster integration, implemented over various message queues.
https://github.com/strongloop/strong-mq
Last synced: 3 months ago
JSON representation
MQ API with cluster integration, implemented over various message queues.
- Host: GitHub
- URL: https://github.com/strongloop/strong-mq
- Owner: strongloop
- License: other
- Created: 2013-04-23T18:09:02.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2019-02-05T06:00:43.000Z (almost 7 years ago)
- Last Synced: 2025-05-02T10:50:43.128Z (9 months ago)
- Language: JavaScript
- Size: 190 KB
- Stars: 56
- Watchers: 27
- Forks: 12
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGES.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# strong-mq: Clustering of Applications on Top of Message Queues
***DO NOT USE THIS:*** This code is an attempt to build a common API over
multiple message queues so as to allow deploy time selection of the MQ to use.
In practice, no one does this, they always know the MQ they are going to use.
Also, this module by necessity exposes a subset of the underlying MQ libraries
capabilities, so it is perpetually not working as desired.
Use one of these directly:
- https://www.npmjs.com/package/stomp-client
- https://www.npmjs.com/package/amqp
## Overview
[strong-mq](https://github.com/strongloop/strong-mq) is an abstraction layer
over common message distribution patterns, and several different message queue
implementations, including cluster-native messaging.
It allows applications to be written against a single message queue style API,
and then deployed either singly, or as a cluster, with deploy-time configuration
of the messaging provider. Providers include native node clustering, allowing
no-dependency deployment during test and development. Support for other
providers is on-going, and 3rd parties will be able to add pluggable support for
new message queue platforms.
## Installation
% npm install strong-mq
% npm test
### Multiple Versions of strong-mq Being Initialized
If you get an assert during require of strong-mq about multiple versions being
initialized, then some of the modules you are depending on use strong-mq, but do
not specify it as a peerDependency. See
[strongloop/strong-cluster-connect-store](https://github.com/strongloop/strong-cluster-connect-store/commit/dd00ed6978a676725c863e4ce0473bc8d2997d2f)
as an example of how to correctly specify a dependency on strong-mq in a module.
An application can depend on strong-mq with a normal dependency.
## Synopsis
An example of connecting to a server and listening on a work queue:
```javascript
var connection = require('strong-mq')
.create('amqp://localhost')
.open();
var push = connection.createPushQueue('todo-items');
push.publish({job: 'clean pool'});
var pull = connection.createPullQueue('todo-items');
pull.subscribe(function(msg) {
console.log('TODO:', msg);
connection.close();
});
```
## Documentation
- See [API](api.md) and [StrongLoop](http://docs.strongloop.com/display/NODE/Strong+MQ)