Перейти к содержанию

Запросы и ответы gRPC на основе HTTP/2

Давайте рассмотрим, как gRPC работает через фреймы HTTP/2.
Мы уже знаем, что gRPC работает следующим образом:

  • использует классические заголовки запроса HTTP;
  • использует специальные заголовки, называемыет трейлерами;
  • ответ содержит указанный в трейлерах gRPC-статус, информирующий клиента о результатах запроса;
  • ответ закодирован (encoded) в бинарном виде.

Однако, gRPC также отправляет на сервер HTTP-запрос следующим образом:

  • используется TLS (другими словами, HTTPS). Также он может работать без HTTPS, но это НЕ рекомендуется;
  • используется исключительно POST;
  • тип содержимого (Content-Type) будет либо "application/grpc", либо "application/grpc+proto", либо "application/grpc+json";
  • используется заголовок Authority с доменным именем сервера;
  • используется заголовок Path с RPC URI;
  • статус HTTP всегда 200 OK с момента начала обработки запроса сервером. Однако, если сервер не может обработать запрос в силу недоступности, может вернуться статус 503 Unavailable.

Полное описание того, как gRPC работает поверх фреймов HTTP/2 здесь
Рассмотрим, как наш запрос к сервису CountryService выполняется в терминах фреймов HTTP/2. CountryService расположен по адресу localhost:5001, используется Дедлайн размером в 5 секунд, и используется токен JWT. Включено сжатие gzip. Запрос завершается успешно.
В запросе, во фрейме DATA стоит флаг END_STREAM (EOS, end of stream), означающий, что больше данных не предполагается. В случае потока, этот флаг будет стоять в последнем сообщении потока. Во фрейме HEADERS флаг END_HEADERS (EOH, end of headers) означает, что переданы все заголовки.
gRPC Request

flowchart LR
C(gRPC Client)
S(gRPC Server)
RD("DATA(flags = END_STREAM)
< Length-Prefixed Message >")
RH("HEADERS(flags = END_HEADERS)
:method = POST
:scheme = https
:path = /CountryService/GetById
:authority = localhost:5001
grpc-timeout =5S
content-type = application/grpc+proto
grpc-encoding = gzip
authorization = Bearer eyJhbG...
&nbsp;")
C === RD === RH ===> S

В ответе сперва, во фрейме HEADERS передаются заголовки с флагом EOH, потом фрейм DATA, потом снова фрейм HEADERS с трейлерами, в котором указано, что более данных и заголовков не будет, а также со статусом.
gRPC Response
flowchart RL
C(gRPC Client)
S(gRPC Server)
RPH("HEADERS(flags = END_HEADERS)
:status = 200
grpc-encoding = gzip
content-type = application/grpc+proto
&nbsp;")
RPD("DATA
< Length-Prefixed Message >")
RPT("HEADERS(flags = END_STREAM,END_HEADERS)
grpc-status = 0")
S === RPT === RPD === RPH ===> C

Последнее обновление : 6 сентября 2023 г.
Дата создания : 6 апреля 2023 г.

Комментарии

Комментарии