namespace apext::log

De namespace apext::log stelt met het functietemplate TraceArti een interface beschikbaar voor het doorsturen van gemodelleerde trace-berichten naar externe runtime-trace-tools [SWS_LOG_20000]. De functie wordt uitsluitend intern door het logger-framework aangeroepen bij het omschakelen tussen logging en tracing en verwerkt berichtspecifieke identifiers evenals variabele parameters [SWS_LOG_20000]. Als centrale randvoorwaarden gelden een minimale runtime-overhead, volledige thread-safety en een uitzonderingsveilige uitvoering zonder fout- of retourwaarden.

meer ›

Context

De namespace apext::log stelt functionele interfaces voor het logging- en tracing-subsysteem van het AUTOSAR Adaptive Platform beschikbaar. Zijn primaire verantwoordelijkheid ligt in het beschikbaar stellen van een dedicated interface voor externe runtime-trace-tools via het functietemplate TraceArti [SWS_LOG_20000]. De naamgeving met het voorvoegsel apext duidt er als interpretatie vermoedelijk op dat het om een platformuitbreiding (Adaptive Platform Extension) gaat, die specifieke tracingmechanismen zoals de AUTOSAR Run-Time Interface (ARTI) aan het logging-framework koppelt. Vraag Q-325896ce9f6b8e42 (open)

In de systeemarchitectuur fungeert de namespace als schakel tussen de interne logging-infrastructuur en nageschakelde analyse- respectievelijk trace-tools. Daarbij interageren in wezen drie componenten met elkaar: het interne logger-framework, de interfacefunctie TraceArti binnen apext::log en de aangesloten trace-tool [SWS_LOG_20000]. Het logger-framework verwerkt applicatiegebeurtenissen en stuurt gemodelleerde berichten bij overeenkomstige omschakeling door naar TraceArti, die de gegevens aan de fabrikantspecifieke trace-tool overdraagt [SWS_LOG_20000].

Contextdiagram: Inbedding van TraceArti tussen logger-framework en trace-tool. Bronnen: [SWS_LOG_20000]

Levenscyclus

De namespace apext::log kapselt geen langlevende klasse-instanties, sessie-objecten of toestandshoudende entiteiten met een zelfstandige levenscyclus in. Er bestaan in de namespace geen expliciete initialisatie- of beëindigingsroutines; veeleer wordt de functionaliteit uitsluitend gerealiseerd door vrije templatefuncties [SWS_LOG_20000]. De levenscyclus van de tracingfunctionaliteit is zodoende volledig gekoppeld aan de overkoepelende operationele levenscyclus van het logger-framework.

Wat betreft het concurrency-gedrag en de operationele veiligheid gelden strikte garanties: De interface TraceArti is expliciet als thread-safe gespecificeerd [SWS_LOG_20000]. Dit stelt het logger-framework in staat om trace-aanroepen parallel vanuit meerdere uitvoeringscontexten en threads zonder externe synchronisatie naar de namespace te delegeren. Tegelijkertijd is de functie als uitzonderingsveilig (exception safe) en noexcept gedeclareerd [SWS_LOG_20000], zodat er op geen enkel moment resourcelekken of ongecontroleerde stack-unwinding-toestanden tijdens de aanroep kunnen optreden.

Gebruikspad

De functies van de namespace apext::log zijn niet ontworpen voor directe aanroep door algemene applicatiesoftware. In plaats daarvan wordt TraceArti uitsluitend intern door het logger-framework aangeroepen wanneer dit omschakelt tussen klassieke logging en ARTI-gebaseerde tracing [SWS_LOG_20000]. Ontwikkelaars of integrators voegen indien nodig het desbetreffende headerbestand #include "apext/log/trace_arti.h" in om toegang te krijgen tot de declaratie [SWS_LOG_20000].

Bij aanroep verwerkt de functie gemodelleerde berichten (modeled messages) die specifiek zijn voor de telkens gebruikte trace-tool [SWS_LOG_20000]. De interface accepteert hiertoe een berichtidentificerende identifier msg_id van een implementatiedefinieerd type MsgId evenals een variabel parameterpakket params... van willekeurige typen Params... [SWS_LOG_20000]. Om de runtimekosten in het trace-pad zo laag mogelijk te houden, vereist de specificatie een strikte minimalisatie van de runtime-overhead; dit dient bijvoorbeeld te worden bereikt door op maat gemaakte templatespecialisaties op basis van de desbetreffende MsgId [SWS_LOG_20000]. Het is aannemelijk dat dergelijke specialisaties typisch door tool-generatoren in het kader van de toolchain-integratie voor de respectieve doelsystemen worden gegenereerd.

Foutscenario's

Op het gebied van foutafhandeling volgt apext::log een fouttolerant ontwerp zonder signalering van runtimefouten aan de oproeper. De functiesignatuur van TraceArti definieert geen retourwaarde (void) en verbiedt via de noexcept-specificatie het werpen van C++-exceptions volledig [SWS_LOG_20000]. Precondities zoals de geldigheid van bericht-ID's en overgedragen payload moeten daarom dwingend worden gewaarborgd door het aanroepende logger-framework of de overeenkomstige specialisaties, aangezien er in geval van fouten geen foutcodes kunnen worden getransporteerd [SWS_LOG_20000].