DEENESPTFRRUARHIKOZHNL

struct ara::diag::HttpRedirect

[SWS_DM_01828] Upstream: RS_Diag_04266, RS_Diag_04256

struct HttpRedirect {...};

Definition of HTTP-Redirect. In case a SOVD resource has been moved and/or is available under another URI, the SOVD server shall use this type to indicate the new location of the redirected SOVD resource to the SOVD client.

Header-Datei#include "ara/diag/sovd_http_redirect.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

User GuideKI-GENERIERT

Ermöglicht einem SOVD-Server die strukturierte Übergabe einer neuen Ziel-URL zur Weiterleitung von Diagnoseanfragen.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 9bc6ec8deebc Herkunft Offene Fragen (2)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Ermöglicht einem SOVD-Server die strukturierte Übergabe einer neuen Ziel-URL zur Weiterleitung von Diagnoseanfragen.

Die Struktur ara::diag::HttpRedirect dient einem SOVD-Server dazu, einem SOVD-Client die neue Adresse einer verschobenen oder unter einem anderen Pfad verfügbaren SOVD-Ressource mitzuteilen [SWS_DM_01828]. Hierzu stellt sie das öffentliche Attribut url bereit, welches die Ziel-URL der Weiterleitung als Zeichenkette definiert [SWS_DM_01829]. Als reines Wertobjekt wird die Struktur bei Bedarf instanziiert und kapselt die Adressinformation für das übergeordnete HTTP-Antwortprotokoll.

Kontext

Die Struktur ara::diag::HttpRedirect ist Teil des Diagnosemoduls (diag) der AUTOSAR Adaptive Platform und wird über die Header-Datei ara/diag/sovd_http_redirect.h deklariert AUTOSAR_AP_SWS_Diagnostics §8.55 „Header: ara/diag/sovd_http_redirect.h“. Sie dient der standardisierten Repräsentation einer HTTP-Weiterleitung im Rahmen von SOVD (Service-Oriented Vehicle Diagnostics) gemäß [SWS_DM_01828]. Wenn eine Diagnose-Ressource innerhalb des Fahrzeugs verlegt wurde oder temporär bzw. dauerhaft unter einer anderen Adresse erreichbar ist, signalisiert der SOVD-Server dem anfragenden SOVD-Client über diesen Typ den neuen Ablageort.

Die Struktur stellt einen elementaren Datenträger dar, dessen einziges öffentliches Element die Variable url vom Typ ara::core::String ist [SWS_DM_01829]. Über dieses Feld wird die vollständige oder relative Zieladresse spezifiziert, an die der Client seine ursprüngliche Anfrage umleiten soll AUTOSAR_AP_SWS_Diagnostics §8.55.1.1 „Public Member Variables“. ara::diag::HttpRedirect fungiert somit als standardisiertes Bindeglied zwischen der internen Ressourcenverwaltung des Diagnose-Servers und dem externen Protokoll-Handling gegenüber dem Client.

Lebenszyklus

Als rein passive Datenstruktur (struct) besitzt ara::diag::HttpRedirect gemäß [SWS_DM_01828] einen an den Ausführungskontext gebundenen, transienten Lebenszyklus. Interpretation: Die Instanziierung erfolgt bedarfsgesteuert durch den SOVD-Server oder eine angebundene Diagnoseapplikation in dem Moment, in dem die Umleitung einer Anfrage notwendig wird. Frage (offen) Dabei wird die Ziel-URL direkt bei der Konstruktion oder unmittelbar danach im Feld url abgelegt [SWS_DM_01829].

Die Struktur besitzt reguläre C++-Wertsemantik; Speicherreservierung und -freigabe richten sich vollständig nach der Lebensdauer der kapselnden Instanz sowie des eingebetteten ara::core::String. Interpretation: Das Erzeugen, Zuweisen und Zerstören der Struktur ist nebenwirkungsfrei und erfordert keine Registrierung oder Deregistrierung bei zentralen Instanzen des Diagnose-Dienstes. Frage (offen) Hinsichtlich der Nebenläufigkeit ist ein einzelnes Exemplar von ara::diag::HttpRedirect bei schreibendem Zugriff nicht threadsicher; da Instanzen jedoch üblicherweise isoliert pro Client-Anfrage erzeugt und als Rückgabewert transportiert werden, treten keine Synchronisationskonflikte auf.

Nutzungspfad

Der typische Einsatz von ara::diag::HttpRedirect vollzieht sich in einem dreistufigen Zusammenspiel zwischen SOVD-Client, SOVD-Server und der verlagerten Ziel-Ressource. Zunächst sendet der SOVD-Client einen HTTP-Aufruf an eine bekannte Ressourcen-URI. Kann der Server die Anfrage nicht direkt bedienen, weil die Ressource an einen neuen Endpunkt verschoben wurde, erzeugt er eine Instanz von ara::diag::HttpRedirect gemäß [SWS_DM_01828] und weist dem Member url die neue Zieladresse zu [SWS_DM_01829].

Interpretation: Die Überführung des Strukturinhalts in den HTTP-Antwortstrom (beispielsweise in Verbindung mit einem HTTP-Redirect-Statuscode und dem entsprechenden Location-Header) wird durch den zugrunde liegenden SOVD-Kommunikationsstack vorgenommen. Frage Q-e68bb7696aa291c0 (offen) Sobald der SOVD-Client die Weiterleitung empfängt, richtet er seine Diagnoseanfrage transparent an die übermittelte Ziel-URL, um die eigentliche Diagnoseoperation auszuführen.

SOVD HTTP-Weiterleitung mit HttpRedirectSOVD-ClientSOVD-ServerZiel-RessourceHTTP-Anfrage an ursprüngliche URIRessourcenverlagerung erkanntErzeuge HttpRedirect (url)HTTP-Weiterleitung mit neuer URLHTTP-Anfrage an Ziel-URLAntwort der Ziel-Ressource

Sequenzdiagramm: Weiterleitung eines SOVD-Clients durch den SOVD-Server mittels HttpRedirect. Quellen: [SWS_DM_01828], [SWS_DM_01829]

Dieser Leitfaden basiert auf der Spezifikation AUTOSAR Adaptive Platform R25-11 (Modul diag) und wurde automatisiert erstellt.

UML-Klassendiagramm

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__diag__HttpRedirect903 «struct» HttpRedirect + url

Konstanten

url variable

Specifies the URL where the request shall be redirected.

Dokumentation der Konstanten / Variablen

variable url [SWS_DM_01829] Upstream: RS_Diag_04266, RS_Diag_04256

ara::core::String url;

Specifies the URL where the request shall be redirected.

Header-Datei#include "ara/diag/sovd_http_redirect.h"
Scopestruct ara::diag::HttpRedirect
Symbolurl
Typara::core::String

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_DM_01829
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01829@rel:R25-11#2c63e212
Content hash
2c63e212
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01829
Status: valid/unmigrated Version: rel:R25-11#13045042 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_DM_01829@rel:R25-11#13045042
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#2c63e2122026-09-30
  • R23-11rel:R23-11#7468bf292026-10-14
  • R24-11rel:R24-11#7468bf292026-10-14
  • R25-11rel:R25-11#130450422026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill