klasse apext::tsync::TsyncFvmErrorDomain

De lidfunctie [SWS_TS_14210] behoort tot de klasse apext::tsync::TsyncFvmErrorDomain en wordt via het headerbestand apext/tsync/fvm_error_domain.h geïncludeerd. Ze dient voor het synchroon bepalen van de tekstuele beschrijving bij een opgetreden foutcode. Als invoerparameter accepteert de functie de numerieke foutcode errorCode van het type CodeType en retourneert de daaraan gekoppelde foutmelding als pointer naar een constante tekenreeks (const char *).

Met betrekking tot gelijktijdigheid en fouttolerantie waarborgt de specificatie omvangrijke garanties: De methode is geclassificeerd als thread-safe en kan zodoende zonder aanvullende synchronisatiemaatregelen worden aangeroepen vanuit gelijktijdige threads [SWS_TS_14210]. Bovendien is de functie ingeschaald als exception safe en voorzien van de identifier noexcept, waardoor het genereren van uitzonderingen tijdens de uitvoering uitgesloten is.

Binnen de module ts bestaat een nauwe samenhang met het specificatie-element [SWS_TS_00907]. Dit definieert de analoge functie Message voor het foutdomein ara::tsync::TsyncErrorDomain in de header ara/tsync/tsync_error_domain.h. Beide interfaces vertonen dezelfde signatuur alsmede identieke toezeggingen met betrekking tot thread-safety en uitzonderingsveiligheid en waarborgen een uniforme bevraging van foutteksten over verschillende domeinen heen.

De constante lidfunctie Name() van de klasse apext::tsync::TsyncFvmErrorDomain levert een pointer op naar een onveranderlijke tekenreeks (const char*), die de naam van het foutdomein voor de Time-Synchronization-FVM representeert [SWS_TS_14209]. De functie dient ertoe de identifier van het foutdomein tijdens runtime op te vragen. De aanroep wordt synchroon en parameterloos uitgevoerd en vereist het includeren van het headerbestand apext/tsync/fvm_error_domain.h [SWS_TS_14209].

Wat betreft het foutgedrag is de interface gedeclareerd als noexcept en geldt ze als uitzonderingsveilig (exception safe) [SWS_TS_14209]. Omdat ze louter verwijst naar een vast vastgelegde tekenreeksconstante, worden er geen specifieke foutcodes geretourneerd en treden er geen foutgevallen op. Met betrekking tot gelijktijdigheid is de methode uitdrukkelijk geclassificeerd als thread-safe (thread-safe) [SWS_TS_14209]. Parallelle aanroepen vanuit meerdere threads zijn daarom vermoedelijk te allen tijde toegestaan zonder aanvullende externe synchronisatie of beveiligingsmechanismen. Vraag Q-6664ffba9d211592 (open)

In het architectonische samenspel overschrijft (override) de functie de interface voor foutdomein-identificatie en vult ze de analoge functie uit [SWS_TS_00906] aan. Terwijl [SWS_TS_00906] via ara/tsync/tsync_error_domain.h de naam van het foutdomein ara::tsync::TsyncErrorDomain voor de fundamentele tijdsynchronisatie levert, dient [SWS_TS_14209] voor de aanduiding van het gespecialiseerde foutdomein apext::tsync::TsyncFvmErrorDomain. Beide methoden volgen daarmee het uniforme foutmodel van AUTOSAR Adaptive.

De elementfunctie ThrowAsException van het foutdomein apext::tsync::TsyncFvmErrorDomain dient voor het synchroon activeren van een C++-exceptie op basis van een foutcode ([SWS_TS_14211]). De declaratie is beschikbaar via de header apext/tsync/fvm_error_domain.h. De methode accepteert de invoerparameter errorCode (const ara::core::ErrorCode &), instantieert op basis daarvan een specifieke apext::tsync::TsyncFvmException en werpt deze direct ([SWS_TS_14211]). Dienovereenkomstig heeft de met noexcept(false) gespecificeerde functie geen retourwaarde.

Voor de aanroepcontext is de functie als thread-safe (thread-safe) gespecificeerd, maar aangeduid als niet exceptieveilig (not exception safe) ([SWS_TS_14211]). Interpretatie: Deze classificatie als niet exceptieveilig is er vermoedelijk aan toe te schrijven dat het gericht werpen van een exceptie de reguliere control flow beëindigt. Vraag Q-4d1dbde678635320 (open) Een centrale compilerbeperking definieert [SWS_CORE_10304]: als C++-exceptions in de toolchain zijn uitgeschakeld, neemt de functie niet deel aan de overload resolution.

In het totale systeem vult de functie de foutafhandeling aan analoog aan [SWS_TS_00908] uit ara::tsync::TsyncErrorDomain. Waar daar een TsyncException wordt geworpen, maakt ThrowAsException in het FVM-foutdomein de uniforme transformatie van een ara::core::ErrorCode naar een C++-exception mogelijk ([SWS_TS_14211]).

Gebruik

De parameterloze standaardconstructor TsyncFvmErrorDomain() creëert synchroon een nieuwe instantie van het foutdomein apext::tsync::TsyncFvmErrorDomain [SWS_TS_14208]. Deze verwacht geen overdrachtsparameters en is gedeclareerd als constexpr en noexcept. Voor integratie moet het headerbestand apext/tsync/fvm_error_domain.h worden ingevoegd [SWS_TS_14208].

Foutafhandeling en gelijktijdigheid

Aangezien de constructor als noexcept is gespecificeerd, treden er bij de instantiëring geen uitzonderingen op; de uitvoering geldt als thread-safe en uitzonderingsveilig [SWS_TS_14208]. Het gecreëerde object beheert en vertaalt foutcodes van de enumeratie TsyncFvmErrc [SWS_TS_14202] (type-alias Errc [SWS_TS_14206]), die de specifieke fouten kFVNotAvailable en kFVInitializeFailed omvat [SWS_TS_14202].

Zusammenspiel en levenscyclus

De domeininstantie stelt interfaces beschikbaar voor naam- en berichtresolutie via Name() [SWS_TS_14209] en Message() [SWS_TS_14210], alsook voor het triggeren van typespecifieke uitzonderingen via ThrowAsException() [SWS_TS_14211] met gebruikmaking van Exception [SWS_TS_14207]. De vernietiging vindt plaats via de virtuele destructor ~TsyncFvmErrorDomain() [SWS_TS_14201]. In applicatiecode zal een directe handmatige constructie zelden noodzakelijk zijn; vermoedelijk wordt in plaats daarvan de globale singleton-instantie verkregen via GetTsyncFvmErrorDomain() [SWS_TS_14212]. Vraag Q-411a136f0129313a (open)