Подключения реле: Как подключить автомобильное реле? Советы специалистов

• 23.06.2020
• 24 минуты, чтобы прочитать

В этой статье

Azure Relay — один из ключевых компонентов функциональной шины Azure. Платформа.Новые возможности гибридных соединений для ретранслятора являются безопасными, эволюция открытого протокола на основе HTTP и WebSockets. Это заменяет первое, BizTalk Services особенность, которая была построена на частной собственности основание протокола. Интеграция гибридных подключений в приложение Azure Сервисы будут продолжать работать как есть.

обеспечивают двустороннюю, двоичную потоковую связь и простой поток дейтаграмм между двумя сетевыми приложениями.Либо или обе стороны могут находиться за NAT или межсетевыми экранами.

В этой статье описывается взаимодействие на стороне клиента с гибридными подключениями. реле для подключения клиентов в роли слушателя и отправителя. Это также описывает, как слушатели принимают новые соединения и запросы.

Модель взаимодействия

Реле гибридных подключений соединяет две стороны, обеспечивая рандеву указать в облаке Azure, что стороны могут обнаружить и подключиться с перспективы их собственной сети.Точка свидания называется «Гибрид» Соединение »в этой и другой документации, в API, а также в Azure портал. Конечная точка службы гибридных соединений называется «служба» для остальной части этой статьи.

Сервис позволяет ретранслировать соединения через Web Socket и HTTP (S) запросы и ответы.

Модель взаимодействия опирается на номенклатуру, установленную многими другими сетевые API. Есть слушатель, который первым указывает на готовность справиться входящие соединения и впоследствии принимает их по мере их поступления.На с другой стороны, клиент подключается к слушателю, ожидая, что соединение быть принятым для установления двунаправленного канала связи. «Connect» «Слушать» и «Принять» — это те же термины, что и в большинстве API-интерфейсов для сокетов.

В любой модели ретрансляции связи любая из сторон устанавливает исходящие соединения. к конечной точке обслуживания. Это делает «слушателя» также «клиентом» в разговорного использования, а также может вызвать перегрузки терминологии. Точный поэтому для гибридных соединений используется следующая терминология:

Программы на обеих сторонах соединения называются «клиентами», так как они клиенты на сервис.Клиент, который ожидает и принимает подключения «слушатель» или, как говорят, в «роли слушателя». Клиент, который инициирует новое подключение к слушателю через службу называется «отправитель» или находится в «роли отправителя».

Взаимодействия с слушателем

Слушатель имеет пять взаимодействий со службой; все детали провода описано далее в этой статье в справочном разделе.

Сообщения Слушания, Принятия и Запроса получены от службы. Операции возобновления и Ping отправляются слушателем.

Прослушать сообщение

Для указания готовности к услуге, которую слушатель готов принять. подключений, он создает исходящее соединение WebSocket. Связь рукопожатие носит название гибридного соединения, настроенного на реле Пространство имен и маркер безопасности, который присваивает «Listen» право на это имя.

Когда WebSocket принят сервисом, регистрация завершена и установленный WebSocket сохраняется в качестве «канала управления» для разрешить все последующие взаимодействия.Услуга позволяет до 25 одновременных слушатели для одного гибридного соединения. Квота на AppHooks должна быть определена.

Для гибридных подключений, если есть два или более активных слушателя, входящие связи между ними сбалансированы в случайном порядке; справедливое распределение пытался с максимальным усилием.

Принять сообщение

Когда отправитель открывает новое соединение в службе, служба выбирает и уведомляет одного из активных слушателей о гибридном соединении. это уведомление отправляется слушателю через открытый канал управления в виде JSON сообщение.Сообщение содержит URL-адрес конечной точки WebSocket, которую слушатель должен подключиться к, чтобы принять соединение.

URL-адрес может и должен использоваться непосредственно слушателем без дополнительной работы. Закодированная информация действительна только в течение короткого периода времени, по существу до тех пор, пока отправитель готов ждать соединения создан сквозной. Максимум предположить составляет 30 секунд. URL может только использоваться для одной успешной попытки подключения. Как только WebSocket соединение с рандеву URL установлено, вся дальнейшая деятельность по этому WebSocket передается от и к отправителю.Это происходит без каких-либо вмешательство или интерпретация службой.

Запросить сообщение

В дополнение к соединениям WebSocket слушатель также может получать HTTP запрашивать кадры у отправителя, если эта возможность явно включена Гибридное соединение.

, которые подключаются к гибридным соединениям с поддержкой HTTP, ДОЛЖНЫ обрабатывать запрос жест. Слушатель, который не обрабатывает , запрос и, следовательно, вызывает повторяющиеся ошибки тайм-аута при подключении МОЖЕТ быть в черном списке сервис в будущем.

HTTP переводятся в JSON для упрощения обработки Структура слушателя, также потому что библиотеки синтаксического анализа заголовка HTTP встречаются реже, чем Парсеры JSON Метаданные HTTP, которые имеют отношение только к отношениям между отправитель и HTTP-шлюз ретрансляции, включая информацию об авторизации, не пересылается Тела HTTP-запроса прозрачно передаются как двоичные Рамки WebSocket.

Слушатель может отвечать на запросы HTTP, используя эквивалентный жест ответа.

Поток запросов / ответов по умолчанию использует канал управления, но может быть «обновлен» до определенного рандеву WebSocket, когда это необходимо. отчетливый Соединения WebSocket повышают пропускную способность для каждого клиентского диалога, но они обременять слушателя большим количеством соединений, которые необходимо обработать, что может Не быть желанным для легких клиентов.

На канале управления тела запросов и ответов ограничены максимум 64 кБ по размеру. Метаданные заголовка HTTP ограничены 32 КБ.Если либо запрос или ответ превышает этот порог, слушатель ДОЛЖЕН обновить к рандеву WebSocket, используя жест, эквивалентный обработке Принять.

Для запросов служба решает, следует ли направлять запросы на контроль канал. Это включает, но не может быть ограничено случаями, когда запрос превышает 64 КБ (заголовки плюс тело) сразу, или если запрос отправлен с «chunked» кодирование передачи и у службы есть основания ожидать, что запрос превысит 64 КБ или прочитает Запрос не мгновенный.Если служба решит доставить запрос через свидание, он только передает адрес свидания слушателю. Затем слушатель ДОЛЖЕН установить WebSocket для рандеву и службы оперативно доставляет полный запрос, в том числе тел на свидание WebSocket. Ответ ДОЛЖЕН также использовать рандеву WebSocket.

Для запросов, поступающих по каналу управления, слушатель решает, отвечать ли по каналу управления или через свидание. Сервис ДОЛЖЕН включайте адрес встречи с каждым запросом, перенаправленным на элемент управления канал.Этот адрес действителен только для обновления с текущего запроса.

Если слушатель выбирает обновление, он подключается и быстро доставляет ответ по установленному гнезду рандеву.

После того, как рандеву WebSocket был установлен, слушатель должен поддерживать его для дальнейшей обработки запросов и ответов от того же клиент. Служба будет поддерживать WebSocket до тех пор, пока сокет HTTPS связь с отправителем сохраняется и будет направлять все последующие запросы от тот отправитель по поддержанному WebSocket.Если слушатель решает отбросить Rendezvous WebSocket со своей стороны, служба также сбросит соединение отправителю, независимо от того, может ли последующий запрос быть уже в ходе выполнения.

Продлить операцию

токен безопасности, который необходимо использовать для регистрации слушателя и поддержки канал управления может истечь, пока слушатель активен. Истечение срока действия токена не влияет на текущие соединения, но это заставляет канал управления быть прекращено службой в момент или вскоре после истечения срока действия.«Обновление» Операция — это сообщение JSON, которое слушатель может отправить для замены токена. связан с каналом управления, так что канал управления может быть поддерживается в течение длительных периодов.

Операция пинга

Если канал управления долго не используется, посредники в пути, такие как балансировщики нагрузки или NAT могут разорвать соединение TCP. «Пинг» операция позволяет избежать этого, посылая небольшое количество данных на канал, который напоминает всем на сетевом маршруте, что соединение должно быть живым, и это также служит «живым» тестом для слушателя.Если пинг не удается, то канал управления следует считать непригодным, а слушатель должен воссоединиться.

Взаимодействие с отправителем

Отправитель имеет два взаимодействия со службой: он подключается к веб-сокету или он отправляет запросы через HTTPS. Запросы не могут быть отправлены через веб-сокет из роль отправителя.

Операция подключения

Операция «подключения» открывает WebSocket службы, предоставляя имя Гибридное соединение и (необязательно, но требуется по умолчанию) безопасность токен, дающий разрешение «Отправить» в строке запроса.Служба тогда взаимодействует со слушателем способом, описанным ранее, и слушателем создает соединение рандеву, которое соединяется с этим WebSocket. После WebSocket был принят, все дальнейшие взаимодействия на этом WebSocket с подключенным слушателем.

Запрос операции

Для гибридных подключений, для которых эта функция включена, отправитель может отправлять в основном неограниченные HTTP-запросы слушателям.

За исключением токена доступа к ретрансляции, который либо встроен в строку запроса или в заголовке HTTP запроса, Реле полностью прозрачно для всех Операции HTTP с адресом реле и всеми суффиксами адреса реле путь, оставляя слушателя полностью под контролем сквозной авторизации и даже функции расширения HTTP, такие как CORS.

Авторизация отправителя с конечной точкой ретрансляции включена по умолчанию, но ПО ЖЕЛАНИЮ. Владелец гибридного подключения может разрешить анонимный доступ отправители. Сервис будет перехватывать, проверять и лишать авторизации информация следующим образом:

1. Если строка запроса содержит выражение sb-hc-token , выражение ВСЕГДА будет удален из строки запроса. Будет оцениваться, если Авторизация реле включена.
2. Если заголовки запроса содержат заголовок ServiceBusAuthorization , выражение заголовка ВСЕГДА будет удалено из коллекции заголовков.Он будет оценен, если включена авторизация Relay.
3. Только если включена авторизация ретрансляции и если заголовки запроса содержит заголовок Авторизация и ни одно из предыдущих выражений присутствует, заголовок будет оценен и удален. В противном случае Авторизация всегда передается как есть.

Если активного слушателя нет, служба вернет 502 «Bad Gateway» код ошибки. Если служба не отображается для обработки запроса, служба вернет 504 «Время ожидания шлюза» через 60 секунд.

Резюме взаимодействия

Результатом этой модели взаимодействия является то, что клиент отправителя выходит из рукопожатие с «чистым» WebSocket, который подключен к слушателю и что не требует никаких преамбул или подготовки. Эта модель позволяет практически любой существующая реализация клиента WebSocket, чтобы легко воспользоваться преимуществами Служба гибридных подключений, предоставляя правильно составленный URL-адрес в свои Уровень клиента WebSocket.

WebSocket соединения рандеву, который слушатель получает через принять взаимодействие также чисто и может быть передано любому существующему WebSocket реализация сервера с минимальной дополнительной абстракцией, которая отличает между «принять» операции на слушателей локальной сети их структуры и Гибридные подключения удаленных «принимающих» операций.

Модель HTTP-запроса / ответа дает отправителю практически неограниченный HTTP площадь поверхности протокола с ДОПОЛНИТЕЛЬНЫМ уровнем авторизации. Слушатель получает предварительно проанализированный раздел заголовка HTTP-запроса, который можно превратить в нисходящий HTTP-запрос или обработанный как есть, с двоичными кадрами, переносящими HTTP тела. Ответы используют тот же формат. Взаимодействия с менее чем 64 КБ тело запроса и ответа может быть обработано через один веб-сокет, который Поделиться для всех отправителей. Большие запросы и ответы могут быть обработаны с помощью модель свиданий.

Ссылка на протокол

В этом разделе описываются подробности описанных протоколов взаимодействия ранее.

Все соединения WebSocket выполняются через порт 443 в качестве обновления HTTPS 1.1, который обычно абстрагируется какой-то платформой WebSocket или API. описание здесь не зависит от реализации, не предлагая фреймворк.

Протокол прослушивателя

Протокол прослушивания состоит из двух жестов подключения и трех сообщений операции.

Прослушивание канала управления соединением

Канал управления открывается с созданием соединения WebSocket с:

wss: // {namespace-address} / $ hc / {path}? Sb-hc-action = ... [& sb-hc-id = ...] & sb-hc-token = ...

Адрес пространства имен — это полное доменное имя ретранслятора Azure. пространство имен, в котором размещается гибридное соединение, обычно в форме {мое имя} .servicebus.windows.net .

Параметры параметра строки запроса следующие.

Если сбой соединения WebSocket из-за отсутствия пути гибридного соединения зарегистрирован или недействительный или отсутствующий токен, или какая-либо другая ошибка, ошибка обратная связь предоставляется с использованием обычного HTTP 1.1 модель обратной связи по статусу. описание состояния содержит идентификатор отслеживания ошибок, который может быть передан Вспомогательный персонал Azure:

Если служба WebSocket намеренно закрывается службой после Первоначально было установлено, причина этого сообщается с помощью соответствующий код ошибки протокола WebSocket вместе с описательной ошибкой сообщение, которое также содержит идентификатор отслеживания.Служба не будет закрывать канал управления без возникновения ошибки. Любое чистое отключение контролируемый клиентом

Принять рукопожатие

Уведомление «принять» отправляется службой слушателю через ранее установленный канал управления в виде сообщения JSON в тексте WebSocket Рамка. На это сообщение нет ответа.

Сообщение содержит объект JSON с именем «accept», который определяет следующее Недвижимость на данный момент:

• адрес — строка URL, которая будет использоваться для установки WebSocket на сервис для приема входящего соединения.
• id — уникальный идентификатор для этого соединения. Если идентификатор был предоставлен клиент отправителя, это предоставленное значение отправителя, в противном случае это система сгенерированное значение.
• connectHeaders — все HTTP-заголовки, которые были переданы на ретранслятор конечная точка отправителя, которая также включает Sec-WebSocket-Protocol и Sec-WebSocket-Extensions заголовки.

  {
    "принять": {
        "адрес": "wss: //dc-node.servicebus.windows.net:443/$hc/{path}? ...»
        "id": "4cb542c3-047a-4d40-a19f-bdc66441e736",
        "connectHeaders": {
            "Хост": "...",
            "Sec-WebSocket-Protocol": "...",
            "Sec-WebSocket-Extensions": "..."
        }
     }
}
  

URL-адрес, указанный в сообщении JSON, используется слушателем для установите WebSocket для принятия или отклонения сокета отправителя.

Прием сокета

Чтобы принять, слушатель устанавливает соединение WebSocket с предоставленным адрес.

Если сообщение «принять» содержит заголовок Sec-WebSocket-Protocol , оно Ожидается, что слушатель принимает WebSocket только если он поддерживает протокол. Кроме того, он устанавливает заголовок при установке WebSocket.

То же относится и к заголовку Sec-WebSocket-Extensions . Если рамки поддерживает расширение, он должен установить заголовок для ответа на стороне сервера требуется Sec-WebSocket-Extensions рукопожатие для расширения.

URL-адрес должен использоваться как есть для установления принимающего сокета, но содержит следующие параметры:

{путь} — это путь к пространству имен в кодировке URL предварительно сконфигурированного гибрида Соединение для регистрации этого слушателя. Это выражение добавляется к фиксированная часть пути $ hc / .

Выражение путь может быть расширен суффиксом и строкой запроса выражение, которое следует за зарегистрированным именем после разделительной косой черты. Это позволяет клиенту отправителя передавать аргументы отправки принимающему слушатель, когда невозможно включить заголовки HTTP.Ожидание что структура слушателя анализирует фиксированную часть пути и зарегистрированное имя из пути и делает остаток, возможно, без каких-либо аргументы строки запроса с префиксом sb-, доступные приложению для решая, принимать ли соединение.

Для получения дополнительной информации см. Следующий раздел «Протокол отправителя».

Если есть ошибка, служба может ответить следующим образом:

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

Отказ от розетки

Отклонение сокета после проверки принять сообщение требует аналогичного рукопожатие, чтобы код состояния и описание статуса сообщали Причина отказа может перетекать обратно к отправителю.

Выбор дизайна протокола здесь заключается в использовании рукопожатия WebSocket (то есть предназначен для завершения в определенном состоянии ошибки), так что клиент слушателя реализации могут по-прежнему полагаться на клиента WebSocket и не должны использовать дополнительный пустой HTTP-клиент.

Чтобы отклонить сокет, клиент берет адрес URI из принять сообщение и добавляет к нему два параметра строки запроса следующим образом:

Полученный URI затем используется для установления соединения WebSocket.

При правильном завершении этого рукопожатия преднамеренно не удается с HTTP код ошибки 410, поскольку WebSocket не был установлен. Если что-то пойдет не так, следующие коды описывают ошибку:

Запросить сообщение

Сообщение запроса отправляется службой слушателю через канал управления. То же сообщение также отправляется через рандеву WebSocket однажды установлен.

Запрос состоит из двух частей: заголовка и двоичных кадров. Если тела нет, рамки тела опускаются.Индикатор для присутствует ли тело, является булевым свойством body в запросе сообщение.

Для запроса с телом запроса структура может выглядеть следующим образом:

  ----- Текстовая рамка Web Socket ----
{
    "запрос" :
    {
        "тело": правда,
        ...
    }
}
----- Web Socket бинарный фрейм ----
FEFEFEFEFEFEFEFEFEFEF ...
----- Web Socket бинарный фрейм ----
FEFEFEFEFEFEFEFEFEFEF ...
----- бинарный фрейм Web Socket -FIN
FEFEFEFEFEFEFEFEFEFEF ...
----------------------------------
  

Слушатель ДОЛЖЕН обрабатывать получение тела запроса, разделенного на несколько бинарные фреймы (см. фрагменты WebSocket).Запрос заканчивается, когда получен двоичный кадр с установленным флагом FIN.

Для запроса без тела есть только один текстовый фрейм.

  ----- Текстовая рамка Web Socket ----
{
    "запрос" :
    {
        "тело": ложь,
        ...
    }
}
----------------------------------
  

Содержание JSON для запроса выглядит следующим образом:

• адрес — строка URI. Это адрес встречи, который будет использоваться для этого запроса.Если входящий запрос больше 64 кБ, остальная часть этого сообщения оставлена пустой, и клиент ДОЛЖЕН инициировать рукопожатие, эквивалентное принять операции, описанные ниже. Служба затем поставит полный запрос на установленный веб-сокет. Если ответ можно ожидать превышать 64 кБ, слушатель ДОЛЖЕН также инициировать рукопожатие, и затем передайте ответ через установленный веб-сокет.

• id — строка.Уникальный идентификатор для этого запроса.

• requestHeaders — этот объект содержит все предоставленные HTTP-заголовки отправителем до конечной точки, за исключением информации об авторизации как выше, и заголовки, которые строго относятся к соединение со шлюзом. В частности, ВСЕ заголовки определены или зарезервированы в RFC7230, за исключением через , лишены и не отправлено:

  • Соединение (RFC7230, раздел 6.1)
  • Контент-длина (RFC7230, раздел 3.3.2)
  • Host (RFC7230, раздел 5.4)
  • TE (RFC7230, раздел 4.3)
  • Трейлер (RFC7230, раздел 4.4)
  • Transfer-Encoding (RFC7230, раздел 3.3.1)
  • Обновление (RFC7230, раздел 6.7)
  • Закрыть (RFC7230, раздел 8.1)

• requestTarget — строка.Это свойство содержит «цель запроса» (RFC7230, раздел 5.3) запроса. Это включает часть строки запроса, которая очищена от ВСЕХ с префиксами sb-hc-.

• метод — строка. Это метод запроса, согласно RFC7231, раздел 4. Метод CONNECT НЕ ДОЛЖЕН использоваться.

• кузов — логическое значение. Указывает, следует ли один или несколько двоичных кадров тела.

  {
    "запрос" : {
        "адрес": "wss: // dc-узел.servicebus.windows.net:443/$hc/{path}? ... ",
        "id": "42c34cb5-7a04-4d40-a19f-bdc66441e736",
        "requestTarget": "/ abc / def? myarg = value & otherarg = ...",
        "method": "GET",
        "requestHeaders": {
            "Хост": "...",
            "Тип содержимого" : "...",
            "Пользователь-Агент": "..."
        },
        "тело": правда
     }
}
  

Отвечая на запросы

Получатель ДОЛЖЕН ответить. Повторный отказ отвечать на запросы во время поддержание соединения может привести к тому, что слушатель попадет в черный список.

Ответы могут быть отправлены в любом порядке, но на каждый запрос необходимо ответить в течение 60 секунд или доставки будет сообщено, что не удалось. 60-секундный срок отсчитывается до тех пор, пока ответ не будет принят кадр по службе. Текущий ответ с несколькими двоичными кадрами не может простаивают более 60 секунд или прекращаются.

Если запрос получен по каналу управления, ответ ДОЛЖЕН либо будет отправлен на канал управления, откуда был получен запрос или оно ДОЛЖНО быть отправлено по каналу рандеву.

Ответ — это объект JSON с именем «response». Правила обращения содержание тела точно так же, как с сообщением запрос и на основе тела собственности.

• requestId — строка. ОБЯЗАТЕЛЬНЫЙ. Значение свойства с идентификатором сообщения с запросом составляет ответил на.
• statusCode — номер. ОБЯЗАТЕЛЬНЫЙ. числовой код состояния HTTP, который указывает результат уведомление. Все коды состояния RFC7231, раздел 6 разрешены, за исключением 502 «Bad Gateway» и 504 «Gateway Timeout».
• statusDescription — строка. ПО ЖЕЛАНИЮ. Фраза кода состояния HTTP-кода согласно RFC7230, раздел 3.1.2
• responseHeaders — HTTP-заголовки, которые должны быть установлены во внешнем HTTP-ответе. Как и в запросе , определенные заголовки RFC7230 НЕ ДОЛЖНЫ использоваться.
• тело — логическое значение. Указывает, следуют ли фреймы двоичного тела.

  ----- Текстовая рамка Web Socket ----
{
    "ответ" : {
        "requestId": "42c34cb5-7a04-4d40-a19f-bdc66441e736",
        «statusCode»: «200»,
        "responseHeaders": {
            «Content-Type»: «application / json»,
            "Content-Encoding": "gzip"
        }
         "тело": правда
     }
}
----- бинарный фрейм Web Socket -FIN
{"эй": "mydata"}
----------------------------------
  

Ответ через свидание

Для ответов, которые превышают 64 кБ, ответ ДОЛЖЕН быть доставлен через гнездо свиданий.Также, если запрос превышает 64 кБ, а запрос - содержит только поле адреса, должен быть установлен сокет рандеву получить запрос . Как только гнездо рандеву было установлено, ответы на соответствующий клиент и последующие запросы от этого соответствующего клиент ДОЛЖЕН быть доставлен через сокет рандеву, пока он сохраняется.

Адрес URL в запросе должен использоваться как есть для установления гнездо рандеву, но содержит следующие параметры:

Если есть ошибка, служба может ответить следующим образом:

После того как соединение установлено, сервер выключает WebSocket. когда HTTP-сокет клиента выключается или имеет следующий статус:

Обновление токена слушателя

Когда срок действия токена слушателя истекает, он может заменить его, отправив текстовое рамочное сообщение в сервис через установленный канал управления. сообщение содержит объект JSON с именем renewToken , который определяет следующее недвижимость на данный момент:

• токен — действительный, закодированный URL-адрес токен общего доступа служебной шины для пространство имен или гибридное соединение, которое придает Listen право.

  {
  "renewToken": {
    «Маркер»:
      "SharedAccessSignature sr = http% 3a% 2f% 2fcontoso.servicebus.windows.net% 2fhyco% 2f & sig = XXXXXXXXXX% 3d & se = 1471633754 & amp; skn = SasKeyName"
  }
}
  

Если проверка токена не удалась, доступ запрещен, и облачная служба закрывается канал управления WebSocket с ошибкой.В противном случае нет ответа.

Протокол веб-сокетов

Протокол отправителя фактически идентичен способу установки слушателя. Целью является максимальная прозрачность для сквозного WebSocket. Адрес для подключиться к так же, как для слушателя, но «действие» отличается и токену нужно другое разрешение:

  wss: // {адрес-пространства имен} / $ hc / {путь}? Sb-hc-action =... & SB-Нс-ID = ... & SBC-Нс-токенов = ...
  

Адрес пространства имен — это полное доменное имя ретранслятора Azure. пространство имен, в котором размещается гибридное соединение, обычно в форме {мое имя} .servicebus.windows.net .

Запрос может содержать произвольные дополнительные заголовки HTTP, в том числе определенные приложением. Все предоставленные заголовки перенаправляются на слушателя и могут быть найдено в объекте connectHeader принять управляющее сообщение .

Параметры параметра строки запроса:

{путь} — это путь к пространству имен в кодировке URL предварительно сконфигурированного гибрида Соединение для регистрации этого слушателя. Выражение путь может быть расширен суффиксом и выражением строки запроса для дальнейшего общения. Если Гибридное соединение зарегистрировано по пути Hyco , по пути выражение может быть hyco / суффикс? param = value &... сопровождается строкой запроса параметры определены здесь. Полное выражение может быть следующим:

  wss: // {адрес-пространства имен} / $ hc / hyco / суффикс? Param = значение & sb-hc-action = ... [& sb-hc-id = ... &] sbc-hc-token = .. ,
  

Выражение пути передается в приемник по адресу URI, содержащемуся в управляющем сообщении «принять».

Если сбой соединения WebSocket из-за отсутствия пути гибридного соединения зарегистрирован, неверный или отсутствующий токен, или какая-то другая ошибка, ошибка обратная связь предоставляется с использованием обычного HTTP 1.1 модель обратной связи по статусу. описание состояния содержит идентификатор отслеживания ошибок, который может быть передан Вспомогательный персонал Azure:

Если служба WebSocket намеренно закрывается службой после изначально был установлен, причина для этого сообщается с помощью соответствующий код ошибки протокола WebSocket вместе с описательной ошибкой сообщение, которое также содержит идентификатор отслеживания.

протокол HTTP-запроса

Протокол HTTP-запросов допускает произвольные HTTP-запросы, кроме обновления протокола.HTTP-запросы направлены на обычный адрес времени выполнения объекта, без $ hc infix, который используется для гибридных подключений клиентов WebSocket.

  https: // {namespace-address} / {путь}? Sbc-hc-token = ...
  

Адрес пространства имен — это полное доменное имя ретранслятора Azure. пространство имен, в котором размещается гибридное соединение, обычно в форме {мое имя} .servicebus.windows.net .

Запрос может содержать произвольные дополнительные заголовки HTTP, в том числе определенные приложением.Все поставляемые заголовки, кроме тех, которые определены напрямую в RFC7230 (см. [сообщение-запрос] (# сообщение-запрос)) передают в слушатель и можно найти в объекте requestHeader сообщения запроса .

Параметры параметра строки запроса:

Маркер также можно переносить в авторизации ServiceBusAuthorization или в авторизации HTTP заголовок. Маркер может быть опущен, если настроено гибридное соединение разрешать анонимные запросы.

Потому что служба эффективно действует как прокси, даже если не как истинный HTTP прокси, он либо добавляет заголовок Via , либо аннотирует существующий заголовок Via в соответствии с RFC7230, раздел 5.7.1. Служба добавляет имя хоста пространства имен Relay к через .

Если есть ошибка, служба может ответить следующим образом. Происходит ли ответ от службы или от слушателя может быть идентифицировано через присутствие через заголовок.Если заголовок присутствует, ответ от слушателя.

Следующие шаги

 Типы классов  :: PostType  

  поле: featured_comments, CommentType.тип соединения
  # Добавить аргумент:
  аргумент: с тех пор, строка, требуется: ложь
конец

def featured_comments (так как: ноль)
  comments = object.comments.featured
  если с
    comments = comments.where ("создал_ =>?", так как)
  конец
  # Вернуть массив или ActiveRecord :: Relation
  Комментарии
конец
  

  поле: featured_comments, CommentType.connection_type, null: false, max_page_size: 50
  

  класс MySchema  

  # Создайте класс ребер для использования в соединении ниже:
Типы классов :: PostEdgeType  

 Типы классов  :: AuthorType  

  {
  автор (id: 1) {
    сообщения {
      totalCount # <= Ваше настраиваемое поле
    }
  }
}
  

 Типы классов  :: BaseConnection <Типы :: BaseObject
  # ... скопируйте и вставьте сюда
конец
  

  # Обязательно ознакомьтесь с GraphQL :: Relay :: Edge -
# здесь вы должны избегать конфликтов имен!
Типы классов :: MembershipSinceEdge  

  # Персона => Членство => Команда
Типы классов :: MembershipSinceEdgeType  

  предметов = [...] # объекты вашей коллекции
args = {} # заглушить аргументы для этого объекта подключения
connection_class = GraphQL :: Relay :: BaseConnection.connection_for_nodes (items)
connection_class.new (элементы, аргументы)