структура ara::diag::HttpRedirect

Структура ara::diag::HttpRedirect служит SOVD-серверу для сообщения SOVD-клиенту нового адреса перемещенного или доступного по другому пути ресурса SOVD [SWS_DM_01828]. Для этого она предоставляет открытый атрибут url, который определяет целевой URL перенаправления в виде строки символов [SWS_DM_01829]. Являясь чистым объектом-значением, структура инстанцируется по мере необходимости и инкапсулирует адресную информацию для вышестоящего протокола ответов HTTP.

больше ›

Контекст

Структура ara::diag::HttpRedirect является частью модуля диагностики (diag) в AUTOSAR Adaptive Platform и объявляется через заголовочный файл ara/diag/sovd_http_redirect.h AUTOSAR_AP_SWS_Diagnostics §8.55 «Header: ara/diag/sovd_http_redirect.h». Она служит для стандартизированного представления HTTP-перенаправления в рамках SOVD (Service-Oriented Vehicle Diagnostics) согласно [SWS_DM_01828]. Если диагностический ресурс внутри транспортного средства был перемещён либо временно или постоянно доступен по другому адресу, SOVD-сервер сообщает запрашивающему SOVD-клиенту новое местоположение с помощью этого типа.

Структура представляет собой элементарный носитель данных, единственным открытым элементом которого является переменная url типа ara::core::String [SWS_DM_01829]. Через это поле задаётся полный или относительный целевой адрес, на который клиент должен перенаправить свой исходный запрос AUTOSAR_AP_SWS_Diagnostics §8.55.1.1 «Public Member Variables». Таким образом, ara::diag::HttpRedirect выступает в качестве стандартизированного связующего звена между внутренним управлением ресурсами диагностического сервера и внешней обработкой протокола при взаимодействии с клиентом.

Жизненный цикл

Являясь чисто пассивной структурой данных (struct), ara::diag::HttpRedirect согласно [SWS_DM_01828] обладает привязанным к контексту выполнения, транзиентным жизненным циклом. Интерпретация: инстанцирование выполняется по мере необходимости SOVD-сервером или подключённым диагностическим приложением в тот момент, когда возникает необходимость перенаправления запроса. Вопрос (открытый) При этом целевой URL сохраняется в поле url непосредственно при конструировании или сразу после него [SWS_DM_01829].

Структура обладает регулярной семантикой значений C++; выделение и освобождение памяти полностью определяются временем жизни инкапсулирующего экземпляра, а также встроенного ara::core::String. Интерпретация: создание, присваивание и уничтожение структуры не имеют побочных эффектов и не требуют регистрации или дерегистрации в центральных экземплярах службы диагностики. Вопрос (открытый) С точки зрения параллелизма отдельный экземпляр ara::diag::HttpRedirect не является потокобезопасным при операциях записи; однако, поскольку экземпляры обычно создаются изолированно для каждого клиентского запроса и передаются в качестве возвращаемого значения, конфликты синхронизации не возникают.

Путь использования

Типичное использование ara::diag::HttpRedirect происходит в рамках трёхэтапного взаимодействия между SOVD-клиентом, SOVD-сервером и перемещённым целевым ресурсом. Сначала SOVD-клиент отправляет HTTP-вызов по известному URI ресурса. Если сервер не может обработать запрос напрямую, так как ресурс был перемещён на новую конечную точку, он создаёт экземпляр ara::diag::HttpRedirect согласно [SWS_DM_01828] и присваивает члену url новый целевой адрес [SWS_DM_01829].

Интерпретация: перенос содержимого структуры в поток HTTP-ответа (например, в сочетании со статусом HTTP-перенаправления и соответствующим заголовком Location) выполняется базовым стеком коммуникации SOVD. Вопрос Q-e68bb7696aa291c0 (открытый) Как только SOVD-клиент получает перенаправление, он прозрачно направляет свой диагностический запрос по переданному целевому URL для выполнения непосредственной операции диагностики.

Диаграмма последовательности: перенаправление SOVD-клиента SOVD-сервером с помощью HttpRedirect. Источники: [SWS_DM_01828], [SWS_DM_01829]