klasse ara::rds::RdsErrorDomain

Het foutdomein ara::rds::RdsErrorDomain identificeert en categoriseert specifieke fouttoestanden van de module Raw Data Stream conform AUTOSAR_AP_SWS_RawDataStream §1 “Raw Data Stream”. Het stelt bijbehorende foutmeldingsteksten beschikbaar en maakt het mogelijk fouten als excepties te werpen [SWS_RDS_11296]. Omdat de standaardconstructor is verwijderd [SWS_RDS_11294], benaderen applicaties de centrale instantie via de vrije functie GetRdsErrorDomain() [SWS_RDS_11298].

meer ›

Context

De klasse ara::rds::RdsErrorDomain representeert het specifieke foutdomein voor het functionele cluster van de Raw Data Stream (RDS) op het Adaptive Platform AUTOSAR_AP_SWS_RawDataStream §1 “Raw Data Stream”. Als specialisatie van de basisklasse ara::core::ErrorDomain bindt zij streamgerelateerde fouttoestanden in het platformbrede foutafhandelingsmodel van AUTOSAR in. Tot de centrale taken van de klasse behoren het beschikbaar stellen van een unieke domeinnaam via de methode Name() [SWS_RDS_11295] evenals de toewijzing van foutcodes aan betekenisvolle diagnosemeldingen door middel van Message() [SWS_RDS_11296].

Voor een consistente hantering in clientcode definieert het domein gestandaardiseerde type-aliassen: de alias Errc verwijst naar de enumeratie RdsErrc [SWS_RDS_11326], terwijl de type-alias Exception aan het exceptietype RdsException is gekoppeld [SWS_RDS_11327]. Interactiepartners zijn vooral applicatiecomponenten, streaming-eindpunten en de infrastructuurtypen ara::core::ErrorCode en ara::core::Result, die het foutdomein gebruiken om opgetreden fouten te identificeren.

Levenscyclus

Instanties van ara::rds::RdsErrorDomain zijn onderworpen aan een strikt gecontroleerde levenscyclus. Directe instantiëring door clientcode is expliciet verhinderd, omdat de standaardconstructor is verwijderd (=delete) [SWS_RDS_11294]. In plaats daarvan wordt de toegang gerealiseerd via de globale hulpfunctie GetRdsErrorDomain(), die een constante referentie naar het domein retourneert [SWS_RDS_11298].

Interpretatie: het foutdomein is vermoedelijk geïmplementeerd als langlevende singleton, die gedurende de gehele uitvoeringsperiode van het proces bestaat. Vraag (open) Aangezien alle opvragende interfaces zoals Name() [SWS_RDS_11295] en Message() [SWS_RDS_11296] als const en noexcept zijn gedeclareerd, is een thread-safe, gelijktijdige leestoegang door meerdere threads zonder synchronisatie-overhead mogelijk.

Gebruikspad

Het typische gebruikspad treedt op zodra een bewerking van de Raw Data Stream mislukt en een bijbehorend foutobject moet worden geanalyseerd of gepropageerd. Een applicatie of middleware-laag ontvangt doorgaans een foutobject dat aan het domein is gebonden, of refereert direct aan het domein via GetRdsErrorDomain() [SWS_RDS_11298]. Via de methode Message() kan de bijbehorende tekst van de foutcode tijdens runtime worden opgevraagd en in log-uitvoer worden vastgelegd [SWS_RDS_11296].

Indien de foutafhandelingsstrategie van de applicatie is gebaseerd op C++-excepties, wordt de methode ThrowAsException() aangeroepen [SWS_RDS_11297]. Dit transformeert de meegegeven ara::core::ErrorCode in een exceptie van het type RdsException, die via de type-alias Exception is gespecificeerd [SWS_RDS_11327].

Sequentiediagram: typisch verloop van de foutafhandeling en het genereren van excepties via het foutdomein van de Raw Data Stream. Bronnen: [SWS_RDS_11296], [SWS_RDS_11297], [SWS_RDS_11298]

Foutscenario's

In de context van het foutdomein zelf treden er geen uitzonderingen op tijdens reguliere opvragingen: de identificatie- en lokalisatiemethoden Name() [SWS_RDS_11295] en Message() [SWS_RDS_11296] garanderen foutloosheid door hun noexcept-specificatie. Ook de toegangsfunctie GetRdsErrorDomain() faalt nooit [SWS_RDS_11298].

Het primaire foutscenario heeft betrekking op exceptieafhandeling: roept een aanroeper ThrowAsException() aan met een geldige ara::core::ErrorCode, dan eindigt de methode niet regulier, maar werpt deze verplicht een exceptie (noexcept(false)) van het type RdsException [SWS_RDS_11297]. Voorwaarde voor deze aanroep is de overdracht van een consistente foutcode uit het domein; na-conditie is het genereren van de exceptie in de context van de aanroeper voor verdere verwerking in het desbetreffende catch-blok.