Перейти к основному содержимому

2. Запрос и ответ

В руководстве Привет, NATS издатель отправлял сообщение без ответа. Теперь вы создадите двусторонний обмен: небольшой отвечающий сервис, который отвечает на вопросы в теме, и запрос, который обращается к нему и получает ровно один ответ. В результате вы запустите сервис time в одном терминале и спросите у него время из другого.

Что понадобится​

  • CLI nats и работающий nats-server из руководства Привет, NATS. Если сервер не работает, запустите его:

    nats-server
  • Два терминала: один для сервиса, другой для запроса.

Шаг 1: запустите отвечающий сервис​

В первом терминале запустите сервис на теме time. Флаг --command указывает команде nats reply запускать программу для каждого запроса и отправлять её вывод в качестве ответа.

#!/bin/bash
# Запустите отвечающий сервис в теме "time". `nats reply` подписывается на
# тему и для каждого запроса выполняет команду, отправляя её
# вывод в отдельную тему ответа запроса. Оставьте сервис работать.
nats reply time --command "date"

Сервис должен запуститься и перейти в ожидание:

17:42:10 Listening on "time" in group "NATS-RPLY-22"

Оставьте этот терминал работающим. Сервис готов отвечать на запросы.

Шаг 2: отправьте запрос​

Откройте второй терминал и вызовите сервис. Команда nats request публикует одно сообщение в time и ожидает один ответ в течение глобального --timeout (по умолчанию пять секунд).

#!/bin/bash
# Отправьте один запрос сервису. `nats request` создаёт отдельный inbox, подписывается
# на него, публикует пустой запрос в "time" с адресом inbox для ответа и
# выводит первый полученный ответ. --timeout задаёт максимальное время ожидания.
nats request time "" --timeout 2s

Должен появиться один ответ — текущие дата и время от сервиса:

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, тайм-ауты и сигнал отсутствия отвечающих сервисов.
  • Превратите отвечающие приложения в обнаруживаемые сервисы со статистикой и схемами: Изучение → Сервисы.