off-sqs-debearloper
v0.1.15
Published
Helper app that manages SQS and RabbitMQ transactions
Downloads
11
Readme
OFF-SQS: Manage Amazon SQS and RabbitMQ on node.js
This easy manager provides the basic functionality to use Amazon SQS in production enviroment and RabbitMQ in development enviroment.
To start using it just clone it or install it via npm npm install off-sqs-debearloper
.
Amazon SQS settings
You only need edit the aws-config.json
adding your own keys:
{
"accessKeyId": "STRING",
"secretAccessKey": "STRING",
"region": "STRING"
}
Note: that every operation checks first if the Queue exists, if not it'll create it.**
RabbitMQ settings
To work with RabbitMQ, you need to install the Server. We recommend you to do it with homebrew, so you dont have to set up the server manually when you are in the development environment.
Before installing make sure you have the latest brews: brew update
Then, install RabbitMQ server with:
brew install rabbitmq
Enviroments
development
is the enviroment by default.
If you want to use production
or qa
execute your node app in this way:
NODE_ENV=production node yourApp.js
//or
NODE_ENV=qa node yourApp.js
Methods
Import and declare
var OffSqs = require('off-sqs-debearloper');
var offSqs = new OffSqs();
## Sender()
- **Params:** the name of the SQS queue and the data you want to send.
- **Returns:** nothing.
**Usage:**
offSqs.sender('myQueueName', ["foo": "bar"]);
##Receiver()
- **Params:** the name of the SQS queue.
- **Return:** A promise which will become a tuple of `receiver` a function and `queueUrl` a string.
**Usage**:
offSqs.receiver('myQueue', yourDataManager);
> **Note:** Where `yourDataManager` is a function that receives every message on the queue, so you can easyly customize your data miner. Something like: `myMiner(messageOfTheQueue);``
###Example
var printData = function(data){
console.log(data)
}
offSqs.receiver("queueName", printData)
##getQueueUrl()
- **Params:** The name of the SQS Queue.
- **Returns:** A promise, which will become the url of the Queue.
**Usage:**
offSqs.getQueueUrl('myQueue').then(function('myQueueURL'){
return myQueueURL;
});
##parseMessage()
- **Params:** Data received by SQS Queues.
- **Returns:** The cleaned data of the `body` as array.
**Usage:**
offSqs.parseMessage(data);