RabbitMQ Node.js 示例

RabbitQM 处理和管理消息队列的中间人（broker）。可简单理解为邮局，你在程序中写好消息，指定好收件人，剩下的事件就是 RabbitMQ 的工作了，它会保证收件人正确收到邮件。 任何发送邮件的程序都是 <code>Producer</code>，消息队列可理解为邮筒，新件将堆积在此处。所有待处理的消息都以队列形式存储，总体上看来就是一个巨大的消息 buffer，至于存储量与设置的内存及硬件有关。任何应用都可以向队列添加消息，也可以多个消费者都在从队列中获取消息。 而 <code>consumer</code> 即是消息队列中消息的应用，其处于等待接收来自 RabbitMQ 发送来的消息。 消息生产者，消费者及 RabbitMQ 这个中间人三者不必同时存在于同一机器上，实际运用时也确实大部分不会部署在同一机器上，比如有专门的机器作为 RabbitMQ 实体，而应用程序会部署在其他的集群。应用程序可以是同时负责生产消息的，也同时是消费者。 <a target="_blank" rel="noopener noreferrer" href="https://camo.githubusercontent.com/45330b63e7453cfb9017628fc29745c89073b097/68747470733a2f2f7777772e7261626269746d712e636f6d2f696d672f7475746f7269616c732f707974686f6e2d6f6e652e706e67"><img alt="来自官方文档中关于 RabbitMQ 消息列队的示意图" src="https://camo.githubusercontent.com/45330b63e7453cfb9017628fc29745c89073b097/68747470733a2f2f7777772e7261626269746d712e636f6d2f696d672f7475746f7269616c732f707974686f6e2d6f6e652e706e67" data-canonical-src="https://www.rabbitmq.com/img/tutorials/python-one.png" style="max-width:100%;"></a> 来自官方文档中关于 RabbitMQ 消息列队的示意图 <h2>安装</h2> 通过<a href="https://www.rabbitmq.com/download.html" rel="nofollow">官网提供的地址</a>下载相应平台的程序进行安装，Mac 可通过 <a href="https://www.rabbitmq.com/install-homebrew.html" rel="nofollow">Homebrew 进行安装</a>： <div class="highlight highlight-source-shell"><pre>$ brew update && brew install rabbitmq</pre></div> <h2>启动</h2> 如果使用 Homebrew 安装，可通过 <code>brew services start rabbitmq</code> 命令来启动 RabbitMQ 服务。 <div class="highlight highlight-source-shell"><pre>$ brew services start rabbitmq ==> Successfully started `rabbitmq` (label: homebrew.mxcl.rabbitmq)</pre></div> 或直接运行 <code>/usr/local/sbin/rabbitmq-server</code>。 启动后，会有一个可视化的管理后台，可通过 <a rel="nofollow" href="http://localhost:15672/">http://localhost:15672/</a> 访问，用户名密码皆为 <code>guest</code>。 <h2>基于 Node.js 的 Hello World 示例</h2> 通过 <a href="https://github.com/squaremo/amqp.node">amqp.node</a> 展示 RabbitMQ 在 Node.js 中应用的一个示例。 RabbmitMQ 支持多种协议进行通信，amqp.node 使用的是 AMQP 0-9-1 这一开源协议，后者专门为处理消息而设计。作为客户端消费消息，使用的是 <a href="http://www.squaremobius.net/amqp.node/" rel="nofollow">amqp.node client</a> 模块，但 RabbitMQ 本身是支持多种<a href="http://rabbitmq.com/devtools.html" rel="nofollow">客户端</a>的。 初始化一个 Node,js 项目然后通过以下命令安装 amqp.node 模块： <div class="highlight highlight-source-shell"><pre>$ mkdir rabbitmq-demo && yarn init -y $ yarn add amqplib</pre></div> <h3>发送消息</h3> 创建 <code>send.js</code> 文件，在其中编写发送消息的逻辑，它将连接到 RabbitMQ 发送消息然后退出。 首先建立到 RabbitMQ 服务的连接， <div class="highlight highlight-source-js"><pre>#!/usr/bin/env node

var amqp = require('amqplib/callback_api'); amqp.connect('amqp://localhost', function(error0, connection) {});</pre></div>

连接建立成功后，创建一个通道（channel），具体的发送将会在这个通道中进行。 <div class="highlight highlight-source-js"><pre>amqp.connect('amqp://localhost', function(error0, connection) { if (error0) { throw error0; } connection.createChannel(function(error1, channel) {}); });</pre></div> 发送消息前，需要先声明一个队列，然后将消息发送到该队列： <div class="highlight highlight-source-js"><pre>amqp.connect('amqp://localhost', function(error0, connection) { if (error0) { throw error0; } connection.createChannel(function(error1, channel) { if (error1) { throw error1; } var queue = 'hello'; var msg = 'Hello world';

<span class="pl-smi">channel</span>.<span class="pl-en">assertQueue</span>(queue, {
  durable<span class="pl-k">:</span> <span class="pl-c1">false</span>
});

<span class="pl-smi">channel</span>.<span class="pl-en">sendToQueue</span>(queue, <span class="pl-smi">Buffer</span>.<span class="pl-en">from</span>(msg));
<span class="pl-en">console</span>.<span class="pl-c1">log</span>(<span class="pl-s"><span class="pl-pds">"</span> [x] Sent %s<span class="pl-pds">"</span></span>, msg);

}); });</pre></div>

队列的创建是一个<a href="https://stackoverflow.com/questions/1077412/what-is-an-idempotent-operation" rel="nofollow">幂等操作</a>，只该队列不存在的情况才会新建。 最后关闭连接并退出。 <div class="highlight highlight-source-js"><pre>setTimeout(function() { connection.close(); process.exit(0); }, 500);</pre></div> <details> <summary> 完整的 send.js </summary> <div class="highlight highlight-source-js"><pre>#!/usr/bin/env node

amqp.connect('amqp://localhost', function(error0, connection) { if (error0) { throw error0; } connection.createChannel(function(error1, channel) { if (error1) { throw error1; }

    <span class="pl-k">var</span> queue <span class="pl-k">=</span> <span class="pl-s"><span class="pl-pds">'</span>hello<span class="pl-pds">'</span></span>;
    <span class="pl-k">var</span> msg <span class="pl-k">=</span> <span class="pl-s"><span class="pl-pds">'</span>Hello World!<span class="pl-pds">'</span></span>;

    <span class="pl-smi">channel</span>.<span class="pl-en">assertQueue</span>(queue, {
        durable<span class="pl-k">:</span> <span class="pl-c1">false</span>
    });
    <span class="pl-smi">channel</span>.<span class="pl-en">sendToQueue</span>(queue, <span class="pl-smi">Buffer</span>.<span class="pl-en">from</span>(msg));

    <span class="pl-en">console</span>.<span class="pl-c1">log</span>(<span class="pl-s"><span class="pl-pds">"</span> [x] Sent %s<span class="pl-pds">"</span></span>, msg);
});
<span class="pl-c1">setTimeout</span>(<span class="pl-k">function</span>() {
    <span class="pl-smi">connection</span>.<span class="pl-c1">close</span>();
    <span class="pl-c1">process</span>.<span class="pl-en">exit</span>(<span class="pl-c1">0</span>);
}, <span class="pl-c1">500</span>);

});</pre></div>

</details> <h3>接收消息</h3> 下面开始编写消费者，消费者做的事情是监听来自 RabbitMQ 的消息并处理。 创建 <code>receive.js</code>，引入 amqp.node 模块，流程和发送者一样，也是先创建连接，然后创建通道，在通道中声明需要监听的队列： <div class="highlight highlight-source-js"><pre>#!/usr/bin/env node

<span class="pl-smi">channel</span>.<span class="pl-en">assertQueue</span>(queue, {
  durable<span class="pl-k">:</span> <span class="pl-c1">false</span>
});

}); });</pre></div>

这里的队列声明不会与发送者那边的冲突，因为上面提到过，队列只在不存在的情况下才会重新生成。这里再次声明可以保证监听前队列已经存在。并且实际场景下，消费者有可能是在发送者之前启动的。 然后添加监听的逻辑： <div class="highlight highlight-source-js"><pre> console.log(" [*] Waiting for messages in %s. To exit press CTRL+C", queue);

channel.consume(queue, function(msg) { console.log(" [x] Received %s", msg.content.toString()); }, { noAck: true });</pre></div>

<details> <summary> 完整的 receive.js </summary> <div class="highlight highlight-source-js"><pre>#!/usr/bin/env node

    <span class="pl-k">var</span> queue <span class="pl-k">=</span> <span class="pl-s"><span class="pl-pds">'</span>hello<span class="pl-pds">'</span></span>;

    <span class="pl-smi">channel</span>.<span class="pl-en">assertQueue</span>(queue, {
        durable<span class="pl-k">:</span> <span class="pl-c1">false</span>
    });

    <span class="pl-en">console</span>.<span class="pl-c1">log</span>(<span class="pl-s"><span class="pl-pds">"</span> [*] Waiting for messages in %s. To exit press CTRL+C<span class="pl-pds">"</span></span>, queue);

    <span class="pl-smi">channel</span>.<span class="pl-en">consume</span>(queue, <span class="pl-k">function</span>(<span class="pl-smi">msg</span>) {
        <span class="pl-en">console</span>.<span class="pl-c1">log</span>(<span class="pl-s"><span class="pl-pds">"</span> [x] Received %s<span class="pl-pds">"</span></span>, <span class="pl-smi">msg</span>.<span class="pl-c1">content</span>.<span class="pl-c1">toString</span>());
    }, {
        noAck<span class="pl-k">:</span> <span class="pl-c1">true</span>
    });
});

});</pre></div>

</details> <h3>运行</h3> 分别在命令行启动上面两个程序，查看打印的信息。 <div class="highlight highlight-source-shell"><pre>$ node send.js [x] Sent Hello World!

$ node receive.js [*] Waiting for messages in hello. To exit press CTRL+C [x] Received Hello World!</pre></div>

另外，可通过 <code>sudo rabbitmqctl list_queues</code> 手动查看 RabbitMQ 中的消息。 <div class="highlight highlight-source-shell"><pre>$ /usr/local/sbin/rabbitmqctl list_queues Timeout: 60.0 seconds ... Listing queues for vhost / ... name messages hello 0</pre></div> 如果发现 <code>rabbitmqctl</code> 命令不可用，需要添加 <code>/usr/local/sbin</code> 到环境变量中， <div class="highlight highlight-source-shell"><pre>export PATH=/usr/local/sbin:$PATH</pre></div> 其中 fish shell 通过添加如下命令到 fish 的配置文件即可： <div class="highlight highlight-source-shell"><pre>set -gx PATH /usr/local/sbin $PATH</pre></div> <h2>相关资源</h2> <ul> <li><a href="https://www.rabbitmq.com/tutorials/tutorial-one-javascript.html" rel="nofollow">RabbitMQ Introduction</a></li> <li><a href="https://github.com/rabbitmq/rabbitmq-tutorials/tree/master/javascript-nodejs">Node.js code for RabbitMQ tutorials</a></li> <li><a href="https://github.com/squaremo/amqp.node">squaremo/amqp.node</a></li> </ul> </td> </tr> </tbody> </table>

原文出处：https://www.cnblogs.com/Wayou/p/rabbitmq_nodejs_example.html

来源：oschina

链接：https://my.oschina.net/u/4311881/blog/3264693

标签

SMI

highlight

amqp

javascript