7. Итоговая работа: небольшое приложение NATS
Это итоговая работа: небольшое приложение, которое объединяет всё из предыдущих руководств. Оно подключается к NATS, публикует события заказов в поток JetStream и отвечает на запрос о числе учтённых заказов. Запустите его и посмотрите, как вместе работают три шаблона: публикация и подписка, запрос и ответ и поток, сохраняющий ваши сообщения.
Что понадобится
- Установленные
nats-serverи CLInats(Руководство 1: Привет, NATS). - Среда выполнения языка, выбранного во вкладке клиента (Go, Node.js, Python и другие).
- Около 15 минут. Понадобятся три терминала.
Шаг 1: запустите сервер JetStream
В первом терминале запустите сервер с включённым JetStream, чтобы он мог сохранять поток:
nats-server -js
В журнале запуска должна быть строка с упоминанием JetStream:
[INF] Starting nats-server
[INF] Starting JetStream
[INF] Server is ready
Оставьте этот терминал работающим.
Шаг 2: создайте поток
Откройте второй терминал. Создайте поток ORDERS, сохраняющий все сообщения, опубликованные в темы, соответствующие orders.>:
- CLI
- C
#!/bin/bash
# Создайте поток ORDERS, принимающий каждое событие заказа, которое приложение
# публикует. Поток хранит все сообщения в темах orders.>
# и сохраняет их между запусками.
nats stream add ORDERS \
--subjects "orders.>" \
--storage file \
--defaults
// Create the ORDERS stream that captures every order event your app
// publishes. The stream stores every message on subjects under
// orders.> on disk, so nothing is lost between runs.
jsStreamConfig cfg;
const char *subjects[] = {"orders.>"};
jsStreamConfig_Init(&cfg);
cfg.Name = "ORDERS";
cfg.Subjects = subjects;
cfg.SubjectsLen = 1;
cfg.Storage = js_FileStorage;
s = js_AddStream(&si, js, &cfg, NULL, &jerr);
if (s == NATS_OK)
printf("Stream %s was created\n", si->Config->Name);
Должно появиться подтверждение с описанием нового потока:
Stream ORDERS was created
Subjects: orders.>
Storage: File
Шаг 3: напишите и запустите приложение
Теперь напишите само приложение. Оно подключается к NATS, публикует в поток три события заказа, затем подписывается на app.orders.count и отвечает на запросы текущим числом опубликованных заказов. Тема запросов намеренно находится за пределами orders.>: запрос в тему из orders.> сохранился бы в потоке, и подтверждение сохранения от потока пришло бы раньше ответа приложения.
Сохраните код для выбранного языка в одном файле, затем установите зависимости и запустите его во втором терминале:
- Go
- JavaScript/TypeScript
package main
import (
"context"
"fmt"
"time"
"github.com/nats-io/nats.go"
"github.com/nats-io/nats.go/jetstream"
)
func main() {
// Подключиться к серверу, запущенному на шаге 1.
nc, _ := nats.Connect(nats.DefaultURL)
defer nc.Drain()
js, _ := jetstream.New(nc)
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
// Опубликовать три события заказов в поток ORDERS.
orders := []string{"orders.created", "orders.created", "orders.shipped"}
for _, subject := range orders {
js.Publish(ctx, subject, []byte("event"))
}
count := len(orders)
fmt.Printf("published %d order events\n", count)
// Отвечать на запросы app.orders.count текущим общим количеством.
nc.Subscribe("app.orders.count", func(msg *nats.Msg) {
msg.Respond([]byte(fmt.Sprintf("%d orders", count)))
})
fmt.Println("ready: send a request to app.orders.count")
select {} // keep running so it can answer requests
}
Сохраните код как main.go, затем настройте модуль и запустите:
go mod init orders-app
go get github.com/nats-io/nats.go
go run main.go
import { connect } from "@nats-io/transport-node";
import { jetstream } from "@nats-io/jetstream";
(async () => {
// Подключиться к серверу, запущенному на шаге 1.
const nc = await connect({ servers: "nats://localhost:4222" });
const js = jetstream(nc);
// Опубликовать три события заказов в поток ORDERS.
const orders = ["orders.created", "orders.created", "orders.shipped"];
for (const subject of orders) {
await js.publish(subject, "event");
}
const count = orders.length;
console.log(`published ${count} order events`);
// Отвечать на запросы app.orders.count текущим общим количеством.
nc.subscribe("app.orders.count", {
callback: (_err, msg) => {
msg.respond(`${count} orders`);
},
});
console.log("ready: send a request to app.orders.count");
// Продолжить работу, чтобы отвечать на запросы.
await nc.closed();
})();
Сохраните код как app.mjs (расширение .mjs включает синтаксис import), затем установите зависимости и запустите:
npm install @nats-io/transport-node @nats-io/jetstream
node app.mjs
Приложение должно вывести ход выполнения и перейти в ожидание:
published 3 order events
ready: send a request to app.orders.count
Оставьте приложение работающим.
Шаг 4: убедитесь, что события попали в поток
Откройте третий терминал. Прочитайте сообщения, сохранённые приложением в потоке ORDERS:
- CLI
- C
#!/bin/bash
# Покажите сообщения, опубликованные приложением в поток ORDERS. Каждое событие
# заказа сохранено в потоке и доступно для чтения.
nats stream view ORDERS
// Show the messages your app published into the ORDERS stream. An
// ordered consumer reads them back from the first one, oldest first,
// and we stop once nothing is pending.
jsSubOptions so;
jsSubOptions_Init(&so);
so.Stream = "ORDERS";
so.Ordered = true;
s = js_SubscribeSync(&sub, js, "orders.>", NULL, &so, &jerr);
while (s == NATS_OK)
{
natsMsg *msg = NULL;
jsMsgMetaData *meta = NULL;
uint64_t pending = 0;
s = natsSubscription_NextMsg(&msg, sub, 5000);
if (s != NATS_OK)
break;
s = natsMsg_GetMetaData(&meta, msg);
if (s == NATS_OK)
{
pending = meta->NumPending;
printf("[%" PRIu64 "] Subject: %s\n",
meta->Sequence.Stream, natsMsg_GetSubject(msg));
jsMsgMetaData_Destroy(meta);
}
natsMsg_Destroy(msg);
if ((s == NATS_OK) && (pending == 0))
break;
}
// An empty stream simply times out waiting for the first message.
if (s == NATS_TIMEOUT)
s = NATS_OK;
Вы должны увидеть три опубликованных события заказа, каждое в своей теме:
[1] Subject: orders.created
[2] Subject: orders.created
[3] Subject: orders.shipped
Теперь события находятся в потоке и готовы к чтению потребителем:
Шаг 5: задайте приложению вопрос
В том же третьем терминале отправьте приложению запрос в тему app.orders.count:
- CLI
- C
#!/bin/bash
# Запросите у работающего приложения количество полученных заказов. Оно подписано на
# app.orders.count и отвечает текущим общим количеством, поэтому запрос возвращает
# одно ответное сообщение.
nats request app.orders.count ""
// Ask your running app how many orders it has seen. The app subscribes
// to app.orders.count and replies with the current total, so the request
// returns a single reply message.
if (s == NATS_OK)
{
natsMsg *reply = NULL;
s = natsConnection_RequestString(&reply, conn, "app.orders.count", "", 2000);
if (s == NATS_OK)
{
printf("%.*s\n",
natsMsg_GetDataLength(reply), natsMsg_GetData(reply));
natsMsg_Destroy(reply);
}
}
Вы должны сразу получить ответ приложения:
3 orders
Готово: приложение ответило на запрос числом опубликованных им заказов.
Что вы создали
Одно приложение, которое подключается к NATS, публикует события заказов в долговременный поток и отвечает на запрос текущим вычисленным итогом. Публикация и подписка, JetStream и запрос-ответ работают вместе в одной программе.
Дальше
Вы завершили практические руководства. Чтобы понять, почему каждый компонент работает именно так, переходите к углублённым курсам:
- Темы, публикация и подписка, запрос и ответ: углублённый курс Core NATS
- Потоки, потребители и подтверждения: углублённый курс JetStream