klasse ara::diag::DynamicAccessListDiagServiceBuilder

Gebruik

De synchrone methode Add van de klasse ara::diag::DynamicAccessListDiagServiceBuilder dient ertoe om een enkele byte (Byte value) toe te voegen aan een DynamicAccessListPattern [SWS_DM_01175]. De overgedragen bytewaarde wordt bij de evaluatie van de toegangsrechten voor diagnoseservices gecontroleerd op exacte overeenstemming [SWS_DM_01175]. Door het retourneren van een referentie naar de instantie van hetzelfde object (DynamicAccessListDiagServiceBuilder&) ondersteunt de functie de aanroep als Fluent-API [SWS_DM_01175].

Foutafhandeling en exception-veiligheid

De operatie is gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig (exception safe) [SWS_DM_01175]. Er worden noch foutcodes noch retourwaarden van het type ara::core::Result geretourneerd; specifieke DET- of DEM-meldingen zijn in de payload voor deze functie niet aangegeven.

Gelijktijdigheid en beperkingen

De methode is gespecificeerd als niet-draadveilig (not thread-safe) [SWS_DM_01175]. Interpretatie: Aanroepen op dezelfde builder-instantie vinden daarom typisch sequentieel plaats binnen een enkele thread, voordat het aangemaakte toegangspatroon in de diagnoseserver wordt geëvalueerd. Vraag Q-69d895fc6bf90cb4 (open)

Samenspel

Binnen de interface DynamicAccessListDiagServiceBuilder vult deze methode verwante overbelastingen van Add aan, waarmee bytereeksen via ByteString [SWS_DM_01176] of waardebereiken via ByteRange [SWS_DM_01177] kunnen worden toegevoegd aan een DynamicAccessListPattern.

De elementfunctie Add van de klasse ara::diag::DynamicAccessListDiagServiceBuilder dient voor het toevoegen van een bytereeks aan een DynamicAccessListPattern [SWS_DM_01176]. Via de invoerparameter values van het type ByteString wordt een bytesequentie overgedragen die bij de latere evaluatie van toegangsrechten voor diagnoseservices op een exacte overeenstemming wordt gecontroleerd [SWS_DM_01176]. Als retourwaarde levert de methode een referentie op naar dezelfde builder-instantie (DynamicAccessListDiagServiceBuilder&), wat een vloeiend interfacegebruik (Fluent API) door aaneenschakeling van meerdere aanroepen mogelijk maakt [SWS_DM_01176].

Wat betreft foutafhandeling is de functie gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig (exception safe) [SWS_DM_01176]. Er worden noch foutcodes noch C++-uitzonderingen teruggemeld.

Wat betreft gelijktijdigheid is de methode gedefinieerd als niet-thread-safe (not thread-safe) [SWS_DM_01176]. Als meerdere threads gelijktijdig toegang hebben tot dezelfde builder-instantie, moeten de aanroepen aan de applicatiezijde worden gesynchroniseerd. Interpretatie: De aanroep zal vermoedelijk synchroon in de uitvoeringscontext van de configurerende applicatie-thread plaatsvinden, aangezien er geen asynchrone mechanismen zijn gespecificeerd. Vraag Q-d93498e82292a88e (open)

In het samenspel van het diagnosebeheer vult deze methode verwante builder-functies aan voor het definiëren van dynamische toegangspatronen: terwijl met deze functie volledige bytereeksen worden geregistreerd, kunnen als alternatief via overladen Add-functies ook afzonderlijke bytes ([SWS_DM_01175]) of waardebereiken ([SWS_DM_01177]) aan het patroon worden toegevoegd.

De functie Add van de klasse ara::diag::DynamicAccessListDiagServiceBuilder stelt applicaties in staat om aan een DynamicAccessListPattern een bereik van bytewaarden toe te voegen [SWS_DM_01177]. De meegegeven parameter range van het type ByteRange definieert een waarde-interval dat tijdens de evaluatie van toegangsrechten voor diagnosediensten op overeenstemming wordt gecontroleerd [SWS_DM_01177].

Voor de aanroep en de integratie in het diagnosemanagement gelden de volgende eigenschappen:

• Aanroepcontext en semantiek: De aanroep geschiedt synchroon. Als retourwaarde levert de functie een objectreferentie naar dezelfde builder-instantie (DynamicAccessListDiagServiceBuilder&) op om een vloeiend interfacegebruik (Fluent API) door methodeketening te ondersteunen [SWS_DM_01177].
• Foutafhandeling: De bewerking is gedeclareerd als noexcept en heeft de specificatie-eigenschap exception safe [SWS_DM_01177]. Er worden geen specifieke foutcodes geretourneerd en er worden geen uitzonderingen gegenereerd.
• Gelijktijdigheid: De functie is expliciet gespecificeerd als not thread-safe [SWS_DM_01177]. Interpretatie: Als meerdere executiedraden toegang hebben tot dezelfde builder-instantie, moet de aanroepende applicatie de toegang extern synchroniseren. Vraag Q-c51760a8fe29bd5f (open)
• Samenspel: De methode vult verwante functies van de builder-klasse aan voor het toevoegen van afzonderlijke bytewaarden via [SWS_DM_01175] en voor het definiëren van bytereeksen met behulp van [SWS_DM_01176], om flexibele toegangspatronen te configureren.

Gebruik

De methode ara::diag::DynamicAccessListDiagServiceBuilder::Any dient ervoor dat de applicatiesoftware wildcards definieert in een toegangspatroon ([SWS_DM_01178]). De synchrone aanroep vindt plaats op een instantie van de builder. Via parameter numberOfBytesToIgnore wordt vastgelegd hoeveel opeenvolgende bytes weliswaar in het toegangspatroon worden opgenomen, maar bij latere patroonvergelijking (pattern matching) met binnenkomende diagnoseverzoeken worden genegeerd ([SWS_DM_01220]). Door het retourneren van een objectreferentie naar dezelfde builder wordt een vloeiende API-aanroepstijl (fluent API) mogelijk gemaakt (AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.4 “Any”).

Foutafhandeling en uitzonderingsgedrag

De functie is gespecificeerd als noexcept en uitzonderingsveilig (exception safe) ([SWS_DM_01178]). Er zijn noch foutcodes noch terugkoppelingen aan DET of DEM voorzien. Interpretatie: Bij het doorgeven van de waarde 0 voor numberOfBytesToIgnore keert de aanroep vermoedelijk zonder fouten terug en registreert deze geen wildcard-bytes in het patroon. Vraag Q-e372cda9f8840893 (open)

Gelijktijdigheid en beperkingen

De interface is expliciet aangemerkt als niet thread-safe (not thread-safe) ([SWS_DM_01178]). Meerdere builder-aanroepen op dezelfde instantie van DynamicAccessListDiagServiceBuilder moeten daarom verplicht sequentieel verlopen of door de aanroeper worden gesynchroniseerd.

Samenspel

Wildcard-definities via Any worden doorgaans gecombineerd met patronen zoals EndsWith ([SWS_DM_01221]). Na het samenstellen van alle patroonbestanddelen moet de configuratie met de methode Build worden gefinaliseerd ([SWS_DM_01222]), voordat de resulterende toegangslijst beschikbaar is voor verificaties (AUTOSAR_AP_SWS_Diagnostics §7.3.2 “Adding wildcards to a DynamicAccessList”).

Gebruik

De synchrone methode Build van de klasse ara::diag::DynamicAccessListDiagServiceBuilder ([SWS_DM_01166]) voltooit het aanmaken van een dynamische toegangslijst ([SWS_DM_01181]). De functie accepteert geen overdrachtsparameters en heeft geen retourwaarde ([SWS_DM_01181]). Door de aanroep neemt de bevoegde Diagnostic Server-instantie de samengestelde toegangsregels over ([SWS_DM_01222]).

Foutafhandeling

De operatie is gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig (exception safe) ([SWS_DM_01181]). Er worden noch foutcodes geretourneerd noch uitzonderingen gegenereerd.

Gelijktijdigheid en beperkingen

De methode is geclassificeerd als niet thread-safe (not thread-safe) ([SWS_DM_01181]). Gelijktijdige toegang tot hetzelfde builder-object vanuit meerdere uitvoeringscontexten moet daarom extern worden beveiligd. Bovendien geldt een strikte volgordevoorwaarde: Build moet verplicht worden aangeroepen voordat het service-builder-object wordt vernietigd ([SWS_DM_01181]). Interpretatie: Blijft deze aanroep achterwege vóór het einde van de levensduur van het object, dan komen de eerder geconfigureerde patronen vermoedelijk te vervallen en worden ze niet van kracht voor de autorisatie. Vraag Q-445ea33ece339d42 (open)

Samenspel

In het kader van het opstellen van de lijst worden vooraf dienst- en verzoekpatronen gedefinieerd, bijvoorbeeld door wildcards via Any ([SWS_DM_01220]) of eindpatronen via EndsWith ([SWS_DM_01221]), zoals beschreven in SWS Diagnostics §7.3.2.3.4 “DynamicAccessList Creation and Update”. Build finaliseert dit constructieproces en draagt de lijst over aan de server ([SWS_DM_01222]).

De synchrone methode EndsWith van de klasse ara::diag::DynamicAccessListDiagServiceBuilder stelt applicaties in staat om één enkele byte (Byte value) in te stellen als afsluitpatroon van een dynamische toegangslijst [SWS_DM_01179]. Bij aanroep wijst de Diagnostic Server-instantie dit patroon toe aan het einde van de DynamicAccessList om het bij de evaluatie van diagnostische servicerechten te controleren op exacte overeenstemming [SWS_DM_01221]. De functie levert geen retourwaarde op.

Wat betreft foutafhandeling is de functie gespecificeerd als uitzonderingsveilig (exception safe) en gedeclareerd met noexcept [SWS_DM_01179]. Specifieke foutcodes, DET- of DEM-meldingen zijn binnen de specificatieomvang voor deze methode-aanroep niet voorzien.

Met betrekking tot gelijktijdigheid is de methode aangeduid als niet threadveilig (not thread-safe) [SWS_DM_01179]. Bij gelijktijdige toegang tot dezelfde builder-instantie is externe synchronisatie door de applicatie vereist. Interpretatie: het vastleggen van het eindpatroon moet vermoedelijk plaatsvinden vóór de aanroep van Build [SWS_DM_01222], aangezien de Diagnostic Server de DynamicAccessList met Build finaliseert. Vraag Q-a0afa7deaafa306b (open)

In samenhang met verwante requirements bestaat er naast deze variant met één enkele waarde een overload EndsWith(ByteRange range) [SWS_DM_01180], die het opgeven van een gesloten byte-waardebereik als afsluitpatroon mogelijk maakt SWS Diagnostics §8.15.1.2.3.6 “EndsWith(ByteRange)”. Beide varianten configureren het eindpatroon van dezelfde toegangslijst vóór het gebruik ervan [SWS_DM_01221].

Gebruik

De methode EndsWith van de klasse ara::diag::DynamicAccessListDiagServiceBuilder dient ertoe een gesloten byte-interval (ByteRange range) aan het einde van het zoekpatroon van een dynamische toegangslijst (DynamicAccessList) vast te leggen [SWS_DM_01180]. Bij de methode-aanroep voegt de instantie van de Diagnostic Server het opgegeven patroon toe aan het einde van de DynamicAccessList [SWS_DM_01221]. Dit waardebereik wordt vervolgens gebruikt bij de evaluatie van de toegangsrechten voor diagnosediensten AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.6 “EndsWith(ByteRange)”. De aanroep vindt synchroon plaats en levert geen retourwaarde op (void) [SWS_DM_01180].

Foutafhandeling en gelijktijdigheid

De operatie is gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig (exception safe); specifieke foutcodes of uitzonderingsafhandelingen bestaan niet [SWS_DM_01180]. Wat betreft gelijktijdigheid is de methode geclassificeerd als niet-thread-safe (not thread-safe) [SWS_DM_01180]. Gelijktijdige toegang tot dezelfde builder-instantie vanuit meerdere threads is ontoelaatbaar zonder externe synchronisatie.

Zusammenspiel en levenscyclus

In het kader van patrooncreatie bestaat er naast deze variant voor waardebereiken een alternatieve overbelasting van EndsWith, die één enkele byte (Byte value) definieert voor de exacte patroonvergelijking aan het einde [SWS_DM_01179]. Na het configureren van het patroon moet de lijst worden gefinaliseerd door het aanroepen van Build [SWS_DM_01222], voordat de applicatie de gegenereerde DynamicAccessList kan inzetten voor autorisatiecontroles AUTOSAR_AP_SWS_Diagnostics §7.3.2 “End patterns of a DynamicAccessList”.