2. Запрос и ответ
В руководстве Привет, NATS издатель отправлял сообщение без ответа. Теперь вы создадите двусторонний обмен: небольшой отвечающий сервис, который отвечает на вопросы в теме, и запрос, который обращается к нему и получает ровно один ответ. В результате вы запустите сервис time в одном терминале и спросите у него время из другого.
Что понадобится
-
CLI
natsи работающийnats-serverиз руководства Привет, NATS. Если сервер не работает, запустите его:nats-server -
Два терминала: один для сервиса, другой для запроса.
Шаг 1: запустите отвечающий сервис
В первом терминале запустите сервис на теме time. Флаг --command указывает команде nats reply запускать программу для каждого запроса и отправлять её вывод в качестве ответа.
- CLI
- C
#!/bin/bash
# Запустите отвечающий сервис в теме "time". `nats reply` подписывается на
# тему и для каждого запроса выполняет команду, отправляя её
# вывод в отдельную тему ответа запроса. Оставьте сервис работать.
nats reply time --command "date"
// Answer every request on "time" with the current date and time, sent
// back on the request's private reply subject.
static void
onRequest(natsConnection *nc, natsSubscription *sub, natsMsg *msg, void *closure)
{
char now[64];
time_t t = time(NULL);
strftime(now, sizeof(now), "%a %b %e %H:%M:%S %Z %Y", localtime(&t));
if (natsMsg_GetReply(msg) != NULL)
natsConnection_PublishString(nc, natsMsg_GetReply(msg), now);
natsMsg_Destroy(msg);
}
// Subscribe on "time" and leave the responder running; Ctrl-C to stop.
if (s == NATS_OK)
s = natsConnection_Subscribe(&sub, conn, "time", onRequest, NULL);
Сервис должен запуститься и перейти в ожидание:
17:42:10 Listening on "time" in group "NATS-RPLY-22"
Оставьте этот терминал работающим. Сервис готов отвечать на запросы.
Шаг 2: отправьте запрос
Откройте второй терминал и вызовите сервис. Команда nats request публикует одно сообщение в time и ожидает один ответ в течение глобального --timeout (по умолчанию пять секунд).
- CLI
- C
#!/bin/bash
# Отправьте один запрос сервису. `nats request` создаёт отдельный inbox, подписывается
# на него, публикует пустой запрос в "time" с адресом inbox для ответа и
# выводит первый полученный ответ. --timeout задаёт максимальное время ожидания.
nats request time "" --timeout 2s
// Call the responder once. The client creates a private inbox,
// publishes an empty request on "time" with the inbox attached, and
// waits up to two seconds for the first reply.
natsMsg *reply = NULL;
s = natsConnection_RequestString(&reply, conn, "time", "", 2000);
if (s == NATS_OK)
{
printf("received: %.*s\n",
natsMsg_GetDataLength(reply), natsMsg_GetData(reply));
natsMsg_Destroy(reply);
}
else if (s == NATS_NO_RESPONDERS)
{
// Nobody is subscribed to "time": the server says so right away
// instead of letting the request wait out the timeout.
printf("no responders are available\n");
}
Должен появиться один ответ — текущие дата и время от сервиса:
17:42:31 Sending request on "time"
17:42:31 Received with rtt 612µs
Mon Jun 9 17:42:31 CEST 2026
Эта дата получена от команды date, запущенной сервисом, и отправлена обратно в ответ на ваш запрос.
Шаг 3: проверьте запись вызова в журнале сервиса
Вернитесь к первому терминалу. Вы должны увидеть запись вызова:
17:42:31 [#0] Received on subject "time":
При каждом повторном запросе из второго терминала счётчик увеличивается на единицу ([#1], [#2], …), и приходит новый ответ. Повторите запрос несколько раз.
Шаг 4: проверьте поведение без отвечающего сервиса
Остановите сервис в первом терминале с помощью Ctrl+C, затем снова отправьте запрос из второго:
nats request time "" --timeout 2s
Запрос завершится сразу, не дожидаясь тайм-аута: сервер знает, что на time никто не подписан:
17:43:02 No responders are available
Запустите сервис снова — тот же запрос выполнится успешно.
Что вы создали
Вы запустили отвечающий сервис time и обратились к нему через запрос, получая ровно один ответ на каждый вызов. Всё взаимодействие идёт через NATS, и сторонам не нужно знать адреса друг друга.
Дальше
- Следующее руководство: 3. Очередь заданий — распределите работу между несколькими обработчиками так, чтобы каждое сообщение получал только один.
- Как это работает: Core NATS → Запрос-ответ объясняет inbox, тайм-ауты и сигнал отсутствия отвечающих сервисов.
- Превратите отвечающие приложения в обнаруживаемые сервисы со статистикой и схемами: Изучение → Сервисы.