struct ara::diag::SovdBulkData::DeleteByCategoryResult

De structuur ara::diag::SovdBulkData::DeleteByCategoryResult levert het geaggregeerde resultaat bij het verwijderen van alle bulkgegevens van een categorie in de SOVD-diagnosemodule ([SWS_DM_01926]). Deze scheidt de resultaten in succesvol verwijderde items (deleted_items) en foutieve instanties inclusief foutoorzaak (failed_items) ([SWS_DM_01842], [SWS_DM_01843]). Aanroepers moeten beide lijsten evalueren om gedeeltelijk succes deterministisch af te handelen.

meer ›

Context

De structuur ara::diag::SovdBulkData::DeleteByCategoryResult fungeert als gestandaardiseerd resultaattype voor de methode „Delete All Bulk Data Defined by Category” op het gebied van Service-Oriented Vehicle Diagnostics (SOVD) bulkgegevensbeheer ([SWS_DM_01926], AUTOSAR_AP_SWS_Diagnostics §8.53.3 “Struct: DeleteByCategoryResult”). In de AUTOSAR Adaptive-diagnosemodule (diag) kunnen bulkgegevens zoals logbestanden, trace-opnamen of meetreeksen worden toegewezen aan semantische categorieën. Wanneer een diagnoseclient via de interface ara::diag::SovdBulkData verzoekt om verwijdering van alle instanties van een categorie, vat deze gegevensstructuur de algehele status van de bewerking samen (AUTOSAR_AP_SWS_Diagnostics §8.53.3 “Definition of API class ara::diag::SovdBulkData::DeleteByCategoryResult”).

Als interactiepartners treden doorgaans een externe SOVD-client resp. een diagnosetoepassing, de functionele diagnose-interface ara::diag::SovdBulkData en het interne persistente subsysteem voor bulkgegevens op. Het resultaatobject overbrugt de grens tussen de synchrone of asynchrone uitvoeringseenheid en de evaluerende client door de status van alle betrokken gegevensobjecten te aggregeren.

Levenscyclus

Volgens de klassedefinitie in de header #include "ara/diag/sovd_bulk_data.h" betreft het een passieve gegevensstructuur (struct) zonder eigen complexe toestandslogica ([SWS_DM_01842], [SWS_DM_01843]). De aanmaak ervan vindt plaats aan de serverzijde door de diagnose-runtimeomgeving direct na voltooiing van het categoriegerelateerde verwijderen van bulkgegevens. Daarbij worden de lidvariabelen deleted_items en failed_items gevuld met de respectieve descriptors en foutobjecten.

Aangezien het om een zuivere gegevensoverdrachtsstructuur gaat, zal de overdracht aan de aanroepende instantie in de context van het Adaptive Platform vermoedelijk plaatsvinden via waarde (value) of move-semantiek – bijvoorbeeld verpakt in een asynchrone resultaatcontainer. Vraag Q-bafa9fbd3ae683c1 (open) De eigendomsrechten gaan daarbij volledig over naar de aanroeper. De vernietiging van het object en de vrijgave van het geheugen van de opgenomen ara::core::Vector-instanties vinden deterministisch plaats bij het verlaten van de scope van de aanroeper. Op instantieniveau bestaat er geen gedeelde gelijktijdigheid; parallelle verwijderingsverzoeken voor verschillende categorieën genereren van elkaar onafhankelijke instanties.

Gebruikspad

Het typische gebruiksverloop omvat de initiatie van de verwijdering, de uitvoering door de diagnosedienst en de afzonderlijke evaluatie van het resulterende object door de aanroeper:

1. Een diagnoseclient verzoekt via de methode voor het verwijderen per categorie om de verwijdering van alle bijbehorende bulkgegevens.
2. De server itereert over de instanties van de opgegeven categorie en voert de verwijderingsbewerkingen uit.
3. Succesvol verwijderde items worden geregistreerd in de lijst deleted_items ([SWS_DM_01842]).
4. Mislukte instanties worden met hun respectieve foutoorzaak verzameld in failed_items ([SWS_DM_01843]).
5. De geaggregeerde DeleteByCategoryResult wordt geretourneerd aan de aanroeper ([SWS_DM_01926]), die de succesvolle verwijderingen bevestigt en eventuele fouten evalueert.

Sequentiediagram: verloop van het verwijderen van bulkgegevens per categorie van het verzoek via de aggregatie tot de evaluatie. Bronnen: [SWS_DM_01926], [SWS_DM_01842], [SWS_DM_01843], AUTOSAR_AP_SWS_Diagnostics §8.53.3 “Struct: DeleteByCategoryResult”.

Foutscenario's

Een centraal kenmerk van het verwijderen van bulkgegevens is de mogelijkheid van een gedeeltelijk succes. Omdat een categorie een groot aantal onafhankelijke records kan bundelen, mislukt de gehele bewerking bij individuele fouten niet noodzakelijkerwijs. Voor de aanroeper betekent de opsplitsing in twee afzonderlijke vectoren vermoedelijk dat er een partiële afhandeling zonder atomaire rollback plaatsvindt. Vraag Q-35307a7eccf0afa9 (open)

Foutieve verwijderingen van individuele records worden getransporteerd via het element failed_items, dat getypeerd is als ara::core::Vector<DeletionError> ([SWS_DM_01843], AUTOSAR_AP_SWS_Diagnostics §8.53.3.1.2 “failed_items”). Aanroepers moeten als voorwaarde voor een volledige succesmelding controleren of failed_items.empty() van toepassing is. Bevat de lijst elementen, dan kan voor elke betrokken bulkgegevensinstantie de specifieke verwijderingsfout (bijvoorbeeld vergrendeling door een actieve leestoegang of onvoldoende rechten) worden geanalyseerd. Tegelijkertijd documenteert deleted_items betrouwbaar alle records die ondanks aanwezige individuele fouten konden worden verwijderd ([SWS_DM_01842]).