NATS.js - Node.js 客户端使用指南

NATS.js - Node.js 客户端使用指南

nats.node Node.js client for NATS, the cloud native messaging system. 项目地址: https://gitcode.com/gh_mirrors/na/nats.node

1. 项目介绍

NATS.js 是一个为 Node.js 开发的 NATS 消息系统的客户端库。NATS（Networking and Distributed Systems）是一个高性能、轻量级的消息中间件，适用于云原生应用。NATS.js 实现了 NATS 客户端的基本功能，允许 Node.js 应用与 NATS 服务器进行通信。

2. 项目快速启动

首先，确保您的环境中已经安装了 Node.js。接下来，按照以下步骤快速启动 NATS.js。

安装

通过 npm 安装 NATS.js：

npm install nats@latest

连接到 NATS 服务器

以下是一个简单的示例，演示如何连接到 NATS 服务器：

const { connect } = require('nats');

// 连接到本地服务器
const nc = await connect({ port: 4222 });

console.log(`connected to ${nc.getServer()}`);

// 当不再需要连接时，关闭它
await nc.close();

发布和订阅消息

发布消息：

const { StringCodec } = require('nats');
const sc = StringCodec();

nc.publish('hello', sc.encode('world'));

订阅消息并处理：

const sub = nc.subscribe('hello');

async function processMessages() {
  for await (const m of sub) {
    console.log(`[${sub.getProcessed()}]: ${sc.decode(m.data)}`);
  }
  console.log('subscription closed');
}

processMessages();

3. 应用案例和最佳实践

使用 Wildcard 订阅

当需要订阅多个相关主题时，可以使用通配符订阅来简化订阅过程。

const s1 = nc.subscribe('help.*.system');
const s2 = nc.subscribe('help.me.*');
const s3 = nc.subscribe('help.>');

// 处理来自 s1 的消息
async function printMsgs(s) {
  let subj = s.getSubject();
  console.log(`listening for ${subj}`);
  const c = 13 - subj.length;
  const pad = ''.padEnd(c);
  for await (const m of s) {
    console.log(`[${subj]}${pad}#${s.getProcessed()}- ${m.subject} ${m.data ? ' ' + sc.decode(m.data) : ''}`);
  }
}

printMsgs(s1);

重连策略

默认情况下，如果连接断开，NATS.js 客户端会尝试重新连接。可以通过指定重连选项来自定义重连行为。

const options = {
  port: 4222,
  reconnect: {
    maxAttempts: 5,
    delay: 1000,
  },
};

const nc = await connect(options);

4. 典型生态项目

NATS 生态系统中有许多项目和工具，以下是一些典型的例子：

• NATS Streaming Server：为 NATS 提供持久性和流式处理功能。
• NATS JetStream：一个高级消息存储和流式处理系统，构建在 NATS 之上。
• NATS Templates：用于生成和部署 NATS 应用程序的模板。

通过以上指南，您可以开始使用 NATS.js 在 Node.js 中开发高性能的分布式系统。

nats.node Node.js client for NATS, the cloud native messaging system. 项目地址: https://gitcode.com/gh_mirrors/na/nats.node