struct ara::diag::SovdBulkData::DeletionError

Die Struktur [SWS_DM_01844] repräsentiert das Fehlerergebnis bei einem fehlgeschlagenen Löschvorgang eines einzelnen Massendaten-Objekts im SOVD-Diagnosemodul (AUTOSAR_AP_SWS_Diagnostics §8.53.4 „Struct: DeletionError“). Sie verknüpft die Metadaten des nicht gelöschten Datenelements item mit dem aufgetretenen Fehlercode error [SWS_DM_01845], [SWS_DM_01846]. Als reines Wertobjekt dient sie dem Aufrufer zur gezielten Identifikation und Ursachenanalyse fehlgeschlagener Bereinigungen.

mehr ›

Kontext

Die Datenstruktur [SWS_DM_01844] beschreibt einen Einzelfehler, der während des Löschvorgangs von Massendaten (Bulk Data) innerhalb des SOVD-Frameworks (Service-Oriented Vehicle Diagnostics) von AUTOSAR Adaptive auftritt (AUTOSAR_AP_SWS_Diagnostics §8.53.4 „Struct: DeletionError“). Als Bestandteil der Schnittstelle ara::diag::SovdBulkData dient die Struktur dazu, bei fehlgeschlagenen Bereinigungs- oder Löschaktionen eine präzise Zuordnung zwischen dem betroffenen Datenelement und der Fehlerursache herzustellen. Sie verbindet dabei den Metadaten-Deskriptor der nicht löschbaren Datei mit einem standardisierten AUTOSAR-Fehlercode.

Die Interaktion erfolgt primär zwischen dem Diagnoseserver bzw. der Komponente ara::diag::SovdBulkData, welche die Löschung ausführt, und der aufrufenden Diagnose- oder Anwendungslogik. Letztere fordert die Bereinigung von Bulk-Daten an und nimmt im Fehlerfall Rückmeldungen entgegen, um festzustellen, welche spezifischen Datensätze nicht entfernt werden konnten und warum. Das Zusammenspiel der beteiligten Komponenten und die Rückgabe des Fehlerobjekts bei einem Löschversuch sind im folgenden Sequenzdiagramm dargestellt.

Sequenzdiagramm: Typischer Ablauf einer fehlgeschlagenen Bulk-Data-Löschung mit Rückgabe von DeletionError. Quellen: [SWS_DM_01844], [SWS_DM_01845], [SWS_DM_01846], AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 „Public Member Variables“

Lebenszyklus

Die Struktur [SWS_DM_01844] ist als reines Wertobjekt (Plain Old Data / Werttyp) konzipiert. Ihre Instanziierung erfolgt auf Seiten der Diagnoseinfrastruktur genau dann, wenn bei der Abarbeitung eines Löschauftrags für ein bestimmtes Massendaten-Element ein Fehler festgestellt wird. Dabei werden das Feld item mit dem entsprechenden BulkDataMetaDataDescriptor [SWS_DM_01845] und das Feld error mit dem spezifischen Fehlercode ara::core::ErrorCode [SWS_DM_01846] initialisiert.

Hinsichtlich der Besitzverhältnisse geht die Instanz (oder eine Sammlung solcher Instanzen) typischerweise als Rückgabewert oder innerhalb eines Fehlercontainers in den Besitz des Aufrufers über. Interpretation: Die Struktur besitzt keine eigenen langlebigen Ressourcen oder aktiven Threads; ihr Lebenszyklus ist direkt an den Gültigkeitsbereich (Scope) des aufrufenden Fehlerbehandlungsblocks bzw. des Ergebnisbehälters gebunden. Frage Q-60f135b9e36d7083 (offen) Nach der Auswertung durch die Anwendung wird die Struktur zusammen mit ihren Member-Variablen standardmäßig auf dem Stack oder im Heap zerstört. Da es sich um ein passives Datenpaket handelt, treten keine internen Zustandsübergänge oder nebenläufige Synchronisationsanforderungen innerhalb der Struktur auf.

Nutzungspfad

Im regulären Anwendungsfall initiiert eine Diagnosekomponente oder ein SOVD-Client das Löschen eines oder mehrerer Massendaten-Objekte über die Schnittstelle SovdBulkData. Gelingt das Löschen mindestens eines Elements nicht, erzeugt die Plattform eine Instanz von DeletionError [SWS_DM_01844].

Der Aufrufer empfängt das Fehlerobjekt und wertet die beiden öffentlichen Variablen aus (AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 „Public Member Variables“):

• item: Über den BulkDataMetaDataDescriptor identifiziert die Anwendung das konkrete Datenelement, dessen Löschung gescheitert ist [SWS_DM_01845].
• error: Anhand des ara::core::ErrorCode ermittelt die Anwendung die genaue Ursache für das Scheitern des Löschvorgangs [SWS_DM_01846].

Auf Basis dieser Informationen kann die aufrufende Logik differenziert reagieren, beispielsweise den Fehler protokollieren, eine alternative Bereinigungsstrategie wählen oder die detaillierte Fehlerursache an einen übergeordneten SOVD-Client melden.

Fehlerszenarien

Die Struktur DeletionError wirft selbst keine Ausnahmen und meldet keine eigenen Fehlercodes, sondern dient ausschließlich als Informationsträger zur Kapselung von Fehlschlägen vorangegangener Löschoperationen. Die zentrale Fehlersemantik wird über die Variable error vom Typ ara::core::ErrorCode bereitgestellt [SWS_DM_01846]. Dieser Code spezifiziert im Detail, aus welchem Grund das durch item referenzierte Massendaten-Objekt [SWS_DM_01845] nicht gelöscht werden konnte (beispielsweise Zugriffsverweigerung, gesperrte Ressourcen oder Dateisystemfehler).

Als Vorbedingung für eine sinnvolle Auswertung gilt, dass die Variablen item und error durch die erzeugende SovdBulkData-Laufzeitumgebung mit gültigen Kontextdaten belegt wurden. Nach Abschluss der Inspektion erfordert die Struktur keine Bereinigungshandlungen durch den Entwickler.