struct ara::diag::HttpRedirect

De structuur ara::diag::HttpRedirect dient ertoe dat een SOVD-server aan een SOVD-client het nieuwe adres van een verplaatste of onder een ander pad beschikbare SOVD-resource kan meedelen [SWS_DM_01828]. Hiertoe stelt zij het openbare attribuut url beschikbaar, dat de doel-URL van de doorverwijzing als tekenreeks definieert [SWS_DM_01829]. Als zuiver waardeobject wordt de structuur naar behoefte geïnstantieerd en kapselt zij de adresinformatie in voor het bovenliggende HTTP-antwoordprotocol.

meer ›

Context

De structuur ara::diag::HttpRedirect maakt deel uit van de diagnosemodule (diag) van het AUTOSAR Adaptive Platform en wordt via het headerbestand ara/diag/sovd_http_redirect.h gedeclareerd AUTOSAR_AP_SWS_Diagnostics §8.55 “Header: ara/diag/sovd_http_redirect.h”. Zij dient voor de gestandaardiseerde representatie van een HTTP-doorverwijzing in het kader van SOVD (Service-Oriented Vehicle Diagnostics) conform [SWS_DM_01828]. Wanneer een diagnoseresource binnen het voertuig is verplaatst of tijdelijk dan wel permanent onder een ander adres bereikbaar is, signaleert de SOVD-server via dit type de nieuwe opslaglocatie aan de verzoekende SOVD-client.

De structuur vormt een elementaire gegevensdrager waarvan het enige openbare element de variabele url van het type ara::core::String is [SWS_DM_01829]. Via dit veld wordt het volledige of relatieve doeladres gespecificeerd waarnaar de client zijn oorspronkelijke verzoek moet omleiden AUTOSAR_AP_SWS_Diagnostics §8.55.1.1 “Public Member Variables”. ara::diag::HttpRedirect fungeert zodoende als gestandaardiseerde schakel tussen het interne resourcebeheer van de diagnoseserver en de externe protocolafhandeling ten opzichte van de client.

Levenscyclus

Als zuiver passieve gegevensstructuur (struct) bezit ara::diag::HttpRedirect conform [SWS_DM_01828] een aan de uitvoeringscontext gebonden, transiënte levenscyclus. Interpretatie: de instantiëring vindt vraaggestuurd plaats door de SOVD-server of een aangesloten diagnoseapplicatie op het moment dat het omleiden van een verzoek noodzakelijk wordt. Vraag (open) Daarbij wordt de doel-URL direct bij de constructie of onmiddellijk daarna in het veld url opgeslagen [SWS_DM_01829].

De structuur bezit reguliere C++-waardesemantiek; geheugenreservering en -vrijgave richten zich volledig naar de levensduur van de inkapselende instantie en de ingebedde ara::core::String. Interpretatie: het aanmaken, toewijzen en vernietigen van de structuur is neveneffectvrij en vereist geen registratie of deregistratie bij centrale instanties van de diagnosedienst. Vraag (open) Met betrekking tot gelijktijdigheid is een afzonderlijk exemplaar van ara::diag::HttpRedirect bij schrijftoegang niet thread-safe; aangezien instanties echter gewoonlijk geïsoleerd per clientverzoek worden aangemaakt en als retourwaarde worden getransporteerd, treden er geen synchronisatieconflicten op.

Gebruikspad

De typische inzet van ara::diag::HttpRedirect voltrekt zich in een drietraps samenspel tussen SOVD-client, SOVD-server en de verplaatste doelresource. Eerst verzendt de SOVD-client een HTTP-aanroep naar een bekende resource-URI. Kan de server het verzoek niet direct afhandelen omdat de resource naar een nieuw eindpunt is verplaatst, dan maakt hij een instantie van ara::diag::HttpRedirect aan conform [SWS_DM_01828] en wijst hij het nieuwe doeladres toe aan lid url [SWS_DM_01829].

Interpretatie: de overdracht van de structuurinhoud naar de HTTP-antwoordstroom (bijvoorbeeld in combinatie met een HTTP-redirect-statuscode en de bijbehorende Location-header) wordt verzorgd door de onderliggende SOVD-communicatiestack. Vraag Q-e68bb7696aa291c0 (open) Zodra de SOVD-client de doorverwijzing ontvangt, richt deze zijn diagnoseverzoek transparant aan de verzonden doel-URL om de eigenlijke diagnoseoperatie uit te voeren.

Sequentiediagram: doorverwijzing van een SOVD-client door de SOVD-server met behulp van HttpRedirect. Bronnen: [SWS_DM_01828], [SWS_DM_01829]