DEENESPTFRRUARHIKOZHNL

struct ara::diag::SovdConfiguration::SovdConfigurationMetaInfo

[SWS_DM_01861] Upstream: RS_Diag_04261

struct SovdConfigurationMetaInfo {...};

MetaInfo for Transfer of SOVD Configurations.

Header-Datei#include "ara/diag/sovd_configuration.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopeclass ara::diag::SovdConfiguration

User GuideKI-GENERIERT

Stellt Metainformationen wie MIME-Typ und Datengröße für den Transfer von SOVD-Konfigurationen bereit.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 487f6d360b41 Herkunft Offene Fragen (3)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Stellt Metainformationen wie MIME-Typ und Datengröße für den Transfer von SOVD-Konfigurationen bereit.

Die Struktur ara::diag::SovdConfiguration::SovdConfigurationMetaInfo dient als Datenübertragungsobjekt für Metainformationen beim Transfer von SOVD-Konfigurationsdaten in AUTOSAR Adaptive [SWS_DM_01861]. Sie bündelt den MIME-Typ in mimetype sowie optional die Gesamtlänge der Konfigurationsdaten in size, die vor der Übergabe an die Transfermethoden von der Anwendung belegt werden [SWS_DM_01863]. Als passive C++-Datenstruktur ohne eigene Methoden besitzt sie weder Thread-Sicherheit noch Validierungslogik, sodass Konsistenzprüfungen erst durch die verarbeitenden Plattformdienste erfolgen.

Kontext

Die Struktur ara::diag::SovdConfiguration::SovdConfigurationMetaInfo dient als standardisierter Metadaten-Container für den Transfer von SOVD-Konfigurationsdaten (Service-Oriented Vehicle Diagnostics) in der AUTOSAR Adaptive Platform [SWS_DM_01861]. Sie ist im Header ara/diag/sovd_configuration.h deklariert und organisatorisch direkt der Schnittstellenklasse ara::diag::SovdConfiguration zugeordnet AUTOSAR_AP_SWS_Diagnostics §8.54.2 „Struct: SovdConfigurationMetaInfo“. Ihre Kernverantwortung besteht darin, die für den diagnostischen Konfigurationstransfer erforderlichen Metainformationen wie den Inhaltstyp und den Umfang der Daten bereitzustellen [SWS_DM_01862], [SWS_DM_01863].

Zu den primären Interaktionspartnern gehört einerseits die anwendende Diagnose-Applikation, welche Konfigurationsdaten erzeugt, modifiziert oder verarbeitet, und andererseits das diagnostische Managementsystem von AUTOSAR Adaptive. Die Struktur fungiert als Datenübertragungsobjekt (Data Transfer Object, DTO), das zwischen der anwendungsspezifischen Logik und den standardisierten Transferdiensten der Diagnoseplattform vermittelt. Über die bereitgestellten Felder können Sender und Empfänger vereinbaren, in welchem Format die Konfigurationsdaten vorliegen und wie viele Bytes im Übertragungskanal erwartet werden.

Lebenszyklus

Als rein passiver C++-Datentyp (struct) unterliegt SovdConfigurationMetaInfo keinen komplexen plattformgesteuerten Lebenszyklusphasen [SWS_DM_01861]. Die Erzeugung erfolgt üblicherweise direkt durch die Adaptive Application auf dem Stack oder auf dem Heap, unmittelbar bevor ein Konfigurationstransfer initiiert oder ein empfangener Metadatensatz ausgewertet wird. Die Struktur folgt der regulären Wertsemantik von C++; die besitzende Komponente trägt die Verantwortung für Instanziierung und Lebensdauer.

Hinsichtlich des internen Zustands besitzt die Struktur keine Zustandsmaschine und keine diskreten Betriebsmodi. Nach der Initialisierung der öffentlichen Variablen verbleiben die Daten bis zur Zerstörung der Instanz unverändert im Speicher, es sei denn, sie werden durch die besitzende Anwendung explizit überschrieben. Die Freigabe der Instanz erfolgt automatisch gemäß dem RAII-Muster beim Verlassen des Gültigkeitsbereichs, wobei der dynamisch allokierte Speicher des enthaltenen Strings freigegeben wird [SWS_DM_01863].

Bezüglich der Nebenläufigkeit bietet SovdConfigurationMetaInfo keine integrierte Thread-Sicherheit. Mehrere Threads dürfen eine Instanz simultan lesend verarbeiten, beispielsweise zur Inspektion der Konfigurationsparameter. Gleichzeitige schreibende Zugriffe auf dieselbe Instanz erfordern jedoch externe Synchronisationsmaßnahmen, da konkurrierende Modifikationen an den Mitgliedsvariablen zu Dateninkonsistenzen führen.

Nutzungspfad

Ein typischer Anwendungsfall besteht in der Vorbereitung und Bereitstellung von Metadaten vor dem eigentlichen Konfigurationstransfer. Die Anwendung instanziiert zunächst die Struktur und weist dem Feld mimetype eine Zeichenkette zu, die den Medientyp der Konfigurationsdatei beschreibt [SWS_DM_01863], AUTOSAR_AP_SWS_Diagnostics §8.54.2.1.1 „mimetype“. Dies ermöglicht dem Empfänger die Zuordnung zu einem Parser oder Schema, beispielsweise für JSON- oder XML-basierte Konfigurationen.

Im nächsten Schritt wird überprüft, ob die exakte Dateigröße der Nutzdaten vorab ermittelt werden kann. Ist dies der Fall, wird das Attribut size mit dem entsprechenden ganzzahligen Bytewert belegt [SWS_DM_01862], AUTOSAR_AP_SWS_Diagnostics §8.54.2.1.2 „size“. Ist die Größe vor Beginn der Übertragung unbekannt, bleibt die Variable ungesetzt. Anschließend wird das vorbereitete Objekt als Argument an die Transferfunktion der Klasse ara::diag::SovdConfiguration übergeben.

Ablauf der Metadaten-Bereitstellung beim SOVD-KonfigurationstransferAnwendungSovdConfigurationMetaInfoSovdConfigurationErzeugung der InstanzBelegung von mimetype und optional sizeÜbergabe der Konfiguration samt MetaInfoRückmeldung über Transferstatus

Sequenzdiagramm: Typischer Ablauf der Initialisierung und Übergabe von SovdConfigurationMetaInfo im Rahmen des Konfigurationstransfers. Quellen: [SWS_DM_01861], [SWS_DM_01862], [SWS_DM_01863], AUTOSAR_AP_SWS_Diagnostics §8.54.2 „Struct: SovdConfigurationMetaInfo“.

Fehlerszenarien

Da SovdConfigurationMetaInfo als reine Datenstruktur ohne Member-Funktionen ausgelegt ist, definiert sie keine eigenen Rückgabewerte, Fehlercodes oder Ausnahmen [SWS_DM_01861]. Mögliche Fehlerbedingungen entstehen primär aus unvollständigen oder inkonsistenten Datenbelegungen, die von den verarbeitenden Plattformdiensten in ara::diag::SovdConfiguration erkannt werden.

Interpretation: Ein erstes Fehlerszenario betrifft unzulässige MIME-Types. Frage (offen) Wird in mimetype eine leere Zeichenkette oder ein nicht unterstützter Formatbezeichner hinterlegt, dürfte der aufgerufene Transferdienst die Verarbeitung ablehnen und einen entsprechenden Fehlercode an die Anwendung zurückmelden. Ein zweites Fehlerszenario liegt in einer Diskrepanz der Datengröße: Weicht die tatsächlich übertragene Datenmenge von dem in size deklarierten Bytewert ab, bricht die Diagnoseinfrastruktur den Transfer vermutlich wegen Inkonsistenz ab. Zudem dürfte ein ungesetztes size-Feld zu Übertragungsfehlern führen, falls der gewählte Transportkanal eine vorab bekannte Gesamtlänge zwingend voraussetzt.

Dieser Leitfaden basiert auf der Spezifikation AUTOSAR Adaptive Platform Release R25-11.

UML-Klassendiagramm

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

G nara__diag__SovdConfiguration__SovdConfigurationMetaInfo383 «struct» SovdConfigurationMetaInfo + mimetype + size

Konstanten

mimetype variable

Specifies the configuration mimetype .

size variable

Specifies the size of the configuration data .

Dokumentation der Konstanten / Variablen

variable mimetype [SWS_DM_01863] Upstream: RS_Diag_04261

ara::core::String mimetype;

Specifies the configuration mimetype .

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopestruct ara::diag::SovdConfiguration::SovdConfigurationMetaInfo
Symbolmimetype
Typara::core::String

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

Record
AUTOSAR/AP/record/SWS_DM_01863
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01863@rel:R25-11#5fa2a001
Content hash
5fa2a001
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01863
Status: valid/unmigrated Version: rel:R25-11#65d44bcf 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_01863@rel:R25-11#65d44bcf
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#5fa2a0012026-09-30
  • R23-11rel:R23-11#65d44bcf2026-10-14
  • R24-11rel:R24-11#65d44bcf2026-10-14
  • R25-11rel:R25-11#65d44bcf2026-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

variable size [SWS_DM_01862] Upstream: RS_Diag_04261

ara::core::Optional<std::uint64_t> size;

Specifies the size of the configuration data .

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopestruct ara::diag::SovdConfiguration::SovdConfigurationMetaInfo
Symbolsize
Typara::core::Optional< std::uint64_t >

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

Record
AUTOSAR/AP/record/SWS_DM_01862
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01862@rel:R25-11#6b9b42d2
Content hash
6b9b42d2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01862
Status: valid/unmigrated Version: rel:R25-11#25ab5cd6 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_01862@rel:R25-11#25ab5cd6
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#6b9b42d22026-09-30
  • R23-11rel:R23-11#25ab5cd62026-10-14
  • R24-11rel:R24-11#25ab5cd62026-10-14
  • R25-11rel:R25-11#25ab5cd62026-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