struct ara::diag::SovdBulkData::DeletionError

De structuur [SWS_DM_01844] representeert het foutresultaat bij een mislukte verwijderingsprocedure van een individueel bulkgegevensobject in de SOVD-diagnosemodule (AUTOSAR_AP_SWS_Diagnostics §8.53.4 “Struct: DeletionError”). Deze koppelt de metadata van het niet-verwijderde gegevenselement item aan de opgetreden foutcode error [SWS_DM_01845], [SWS_DM_01846]. Als zuiver waarde-object dient het de aanroeper voor gerichte identificatie en oorzaakanalyse van mislukte opschoonacties.

meer ›

Context

De gegevensstructuur [SWS_DM_01844] beschrijft een individuele fout die optreedt tijdens het verwijderen van bulkgegevens (bulk data) binnen het SOVD-framework (Service-Oriented Vehicle Diagnostics) van AUTOSAR Adaptive (AUTOSAR_AP_SWS_Diagnostics §8.53.4 “Struct: DeletionError”). Als onderdeel van de interface ara::diag::SovdBulkData dient de structuur om bij mislukte opschoon- of verwijderingsacties een nauwkeurige toewijzing tot stand te brengen tussen het betrokken gegevenselement en de foutoorzaak. Deze verbindt daarbij de metadatadescriptor van het niet-verwijderbare bestand met een gestandaardiseerde AUTOSAR-foutcode.

De interactie vindt primair plaats tussen de diagnoseserver resp. de component ara::diag::SovdBulkData die de verwijdering uitvoert, en de aanroepende diagnose- of applicatielogica. Laatstgenoemde verzoekt om het opschonen van bulkdata en ontvangt bij fouten terugkoppeling om vast te stellen welke specifieke records niet konden worden verwijderd en waarom. Het samenspel van de betrokken componenten en het retourneren van het foutobject bij een verwijderingspoging worden weergegeven in het volgende sequentiediagram.

Sequentiediagram: typisch verloop van een mislukte bulkdataverwijdering met retournering van DeletionError. Bronnen: [SWS_DM_01844], [SWS_DM_01845], [SWS_DM_01846], AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 “Public Member Variables”

Levenscyclus

De structuur [SWS_DM_01844] is ontworpen als zuiver waarde-object (Plain Old Data / waardetype). De instantiëring ervan vindt plaats aan de zijde van de diagnose-infrastructuur precies wanneer bij de afhandeling van een verwijderingsopdracht voor een bepaald bulkgegevenselement een fout wordt vastgesteld. Daarbij worden het veld item met de bijbehorende BulkDataMetaDataDescriptor [SWS_DM_01845] en het veld error met de specifieke foutcode ara::core::ErrorCode [SWS_DM_01846] geïnitialiseerd.

Wat betreft de eigendomsrechten gaat de instantie (of een verzameling van dergelijke instanties) doorgaans als retourwaarde of binnen een foutcontainer over in het bezit van de aanroeper. Interpretatie: de structuur bezit geen eigen langlevende resources of actieve threads; de levenscyclus ervan is direct gebonden aan de scope van het aanroepende foutafhandelingsblok resp. van de resultaatcontainer. Vraag Q-60f135b9e36d7083 (open) Na evaluatie door de applicatie wordt de structuur samen met haar lidvariabelen standaard op de stack of in de heap vernietigd. Aangezien het om een passief datapakket gaat, treden er binnen de structuur geen interne toestandsovergangen of vereisten voor gelijktijdige synchronisatie op.

Gebruikspad

In het reguliere toepassingsgeval initieert een diagnosecomponent of een SOVD-client het verwijderen van een of meer bulkgegevensobjecten via de interface SovdBulkData. Slaagt het verwijderen van ten minste één element niet, dan genereert het platform een instantie van DeletionError [SWS_DM_01844].

De aanroeper ontvangt het foutobject en evalueert de twee publieke variabelen (AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 “Public Member Variables”):

• item: via de BulkDataMetaDataDescriptor identificeert de applicatie het concrete gegevenselement waarvan de verwijdering is mislukt [SWS_DM_01845].
• error: aan de hand van de ara::core::ErrorCode bepaalt de applicatie de exacte oorzaak voor het mislukken van het verwijderingsproces [SWS_DM_01846].

Op basis van deze informatie kan de aanroepende logica gedifferentieerd reageren, bijvoorbeeld de fout loggen, een alternatieve opschoonstrategie kiezen of de gedetailleerde foutoorzaak melden aan een bovenliggende SOVD-client.

Foutscenario's

De structuur DeletionError genereert zelf geen excepties en meldt geen eigen foutcodes, maar dient uitsluitend als informatiedrager voor het inkapselen van fouten van voorafgaande verwijderingsbewerkingen. De centrale foutsemantiek wordt geleverd via de variabele error van het type ara::core::ErrorCode [SWS_DM_01846]. Deze code specificeert in detail om welke reden het door item gerefereerde bulkgegevensobject [SWS_DM_01845] niet kon worden verwijderd (bijvoorbeeld toegangsweigering, vergrendelde resources of bestandssysteemfouten).

Als voorwaarde voor een zinvolle evaluatie geldt dat de variabelen item en error door de genererende SovdBulkData-runtimeomgeving zijn voorzien van geldige contextgegevens. Na voltooiing van de inspectie vereist de structuur geen opschoonacties door de ontwikkelaar.