DEENESPTFRRUARHIKOZHNL

klasse <SI-Namespace>::proxy::<SI>Proxy

[SWS_CM_00004] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00122

class <SI>Proxy final {...};

Service Interface Proxy

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Forwarding-Header#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy/<SiShortname>_proxy_fwd.h"
Scopenamespace <SI-Namespace>::proxy

User GuideAI-GEGENEREERD

Dient clientapplicaties als getypeerde plaatsvervanger voor het zoeken naar services en de interactie met een service-instantie.
DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: cc07b1e12dfe Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Dient clientapplicaties als getypeerde plaatsvervanger voor het zoeken naar services en de interactie met een service-instantie.

De klasse <SI>Proxy dient clientapplicaties als getypeerde plaatsvervanger voor een Service Interface voor de overdracht van methode-aanroepen, events en velden [SWS_CM_99447]. Na succesvol zoeken naar services wordt de instantie bij voorkeur aangemaakt via de uitzonderingsvrije factory-methode Create() [SWS_CM_10438]. De klasse bezit move-only-semantiek en vereist vóór haar vernietiging de volledige vrijgave van alle gereferentieerde data-samples om schendingen van precondities te voorkomen [SWS_CM_99444].

Context

De gegenereerde klasse <SI>Proxy fungeert binnen de communicatie-architectuur van het AUTOSAR Adaptive Platform als getypeerd client-eindpunt voor een gedefinieerde Service Interface. Deze kapselt de interactie van een clientapplicatie met een externe of lokale instantie van deze service in. Tot de interactiepartners behoren de toepassende softwarecomponent, de proxy-instantie zelf en het onderliggende communicatiebeheer (ara::com), dat de netwerk-binding en de berichtenoverdracht bestuurt. Via de speciale data-elementen events::<Event> [SWS_CM_99445], fields::<Field> [SWS_CM_99446] en methods::<Method> [SWS_CM_99447] biedt de proxy directe toegang tot events, velden en methoden van de service-interface.

client Client-Anwendung proxy <SI>Proxy (events, methods, fields) client->proxy Methodenaufrufe, Ereignisabonnement proxy->client Ergebnisse, Callbacks runtime Communication Management (ara::com / Binding) proxy->runtime Dienstsuche, Nachrichtenversand runtime->proxy Zustands- & Ereignisdaten

Contextdiagram: integratie van de Service Interface-proxy tussen clientapplicatie en communicatiebeheer. Bronnen: [SWS_CM_99445], [SWS_CM_99446], [SWS_CM_99447].

Levenscyclus

Het aanmaken van een proxy-instantie vereist een vooraf succesvol uitgevoerde zoekactie naar services die een geldige handle-instantie (HandleType) oplevert. Het aanmaken gebeurt bij voorkeur uitzonderingsvrij via de statische factory-methode Create() conform het named-constructor-idioom [SWS_CM_10438], die een ara::core::Result met de proxy of een foutcode retourneert. Als alternatief bestaat er een expliciete constructor <SI>Proxy(handle), die als niet uitzonderingsveilig is gespecificeerd en in geval van een fout een ara::com::ComException kan werpen [SWS_CM_00131]. De voor initialisatie gebruikte handle kan te allen tijde via GetHandle() worden opgevraagd [SWS_CM_10383].

Wat de eigendomsverhoudingen betreft, heeft de proxy move-only-semantiek: de copy-constructor [SWS_CM_00136] en de copy-assignment-operator [SWS_CM_11551] zijn expliciet verwijderd. Een overdracht van de instantie is uitsluitend toegestaan via de move-constructor [SWS_CM_00137] of de uitzonderingsveilige move-assignment-operator [SWS_CM_11552]. Tijdens de levensduur kan de beschikbaarheidsstatus van de service actief worden bepaald middels GetServiceState() [SWS_CM_01073]. Als alternatief maakt SetServiceStateChangeHandler() de registratie van een callback-functie bij statuswijzigingen mogelijk [SWS_CM_01074], die naar keuze via een ExecutorT aan een gebruikersgedefinieerde context kan worden gekoppeld [SWS_CM_01076]. De handler-registratie kan via UnsetServiceStateChangeHandler() worden geannuleerd [SWS_CM_01075].

De vernietiging vindt plaats via de destructor ~<SI>Proxy() [SWS_CM_99444]. Deze is niet uitzonderingsveilig gedeclareerd en vereist als dwingende preconditie dat vóór de vernietiging geen openstaande data-samples meer door de client worden vastgehouden om schendingen te voorkomen [SWS_CM_99444].

Gebruikspad

Het typische gebruikstraject is onderverdeeld in vier fasen:

  1. Zoeken naar services: De client zoekt naar instanties van de service hetzij synchroon via FindService() met een InstanceIdentifier [SWS_CM_00122] resp. een modelgebaseerde InstanceSpecifier [SWS_CM_00622] EXP ARAComAPI §2 “Service Interface Proxy”, hetzij asynchroon via StartFindService() [SWS_CM_00123] [SWS_CM_00623]. Voor asynchrone zoekacties kan aanvullend een ExecutorT worden doorgegeven [SWS_CM_11352] [SWS_CM_11365] EXP ARAComAPI §2 “Service Interface Proxy”. Asynchrone zoekacties moeten na het vinden van de gewenste instantie via StopFindService() worden gestopt [SWS_CM_00125] EXP ARAComAPI §2 “Service Interface Proxy”.
  2. Instantiatie: Uit de vastgestelde ServiceHandleContainer wordt een handle geselecteerd en voor het aanmaken van de proxy-instantie aan Create() overgedragen [SWS_CM_10438]. Interpretatie: De factory-methode Create() zal vermoedelijk ten opzichte van de werpende constructor het primaire instantiatietraject zijn. Vraag Q-cf53ee7076736baf (open)
  3. Interactie: De applicatie communiceert met de service via methode-aanroepen (methods::<Method>) [SWS_CM_99447], eventbewaking (events::<Event>) [SWS_CM_99445] of veldtoegangen (fields::<Field>) [SWS_CM_99446].
  4. Opschoning: Na afronding van de interacties wordt de proxy-instantie vernietigd, waarbij gewaarborgd moet zijn dat er geen ongeldige sample-referenties achterblijven [SWS_CM_99444].
Verloop van het zoeken naar diensten en proxy-interactieClient<SI>ProxyCommunicationManagementUse Case: 1. DienstsucheFindService(instance)Dienstinstanzen ermittelnServiceHandleContainerResult<ServiceHandleContainer>Use Case: 2. InstanziierungCreate(handle)Result<<SI>Proxy>Use Case: 3. Dienstnutzungmethods::<Method>()Methode-aanroep verzendenAntwortdatenRetourwaardeUse Case: 4. Vernietiging~<SI>Proxy()

Sequentiediagram: typisch verloop van het zoeken naar services, proxy-instantiatie en methode-interactie. Bronnen: [SWS_CM_00122], [SWS_CM_10438], [SWS_CM_99447], [SWS_CM_99444].

Foutscenario's

Fouten worden primair via het fouttype ara::com::ComErrc in de ara::core::Result teruggemeld:

  • ComErrc::kServiceNotAvailable: Treedt op bij Create() wanneer een eerder aangeboden service niet meer beschikbaar is [SWS_CM_10438]. Bij directe aanroep van de constructor resulteert dit daarentegen in een ara::com::ComException [SWS_CM_00131].
  • ComErrc::kCommunicationFailure: Wordt door FindService() [SWS_CM_00122] [SWS_CM_00622], StartFindService() [SWS_CM_00123] [SWS_CM_00623], Create() [SWS_CM_10438] en GetServiceState() [SWS_CM_01073] gemeld wanneer de netwerk-binding een herstelbare communicatiefout of een fout bij de beveiligde communicatie vaststelt.

Aanvullend zijn de volgende schendingen (violations) gespecificeerd:

  • ErroneousServiceHandleViolation: De aan Create() of de constructor doorgegeven handle is ongeldig of corrupt [SWS_CM_10438] [SWS_CM_00131].
  • InsufficientPermissionsViolation: Weigering van toegang bij het zoeken naar services of instantiatie door grant enforcement [SWS_CM_00122] [SWS_CM_10438].
  • InvalidHandlerViolation: Doorgifte van een ongeldige of lege callback aan StartFindService() [SWS_CM_00123] of SetServiceStateChangeHandler() [SWS_CM_01074].
  • InstanceSpecifierMappingIntegrityViolation, PortInterfaceMappingViolation, ProcessMappingViolation, InstanceSpecifierAlreadyInUseViolation: Treden op bij modelgebaseerde zoekaanroepen wanneer de toewijzing van de InstanceSpecifier foutief of al in gebruik is [SWS_CM_00622] [SWS_CM_00623].
  • DanglingSamplesViolation: Vernietiging van de proxy terwijl er nog referenties naar data-samples bestaan [SWS_CM_99444].

Deze handleiding is gebaseerd op de AUTOSAR-specificaties voor Adaptive Platform-release R25-11 en vat de communicatiemechanismen van de Service Interface-proxy samen.

Ledenkaart

Klassendiagram

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G n_SI_Namespace___proxy___SI_Proxy329 <SI>Proxy + <Event> + <Field> + <Method> + operator=() + Proxy() + Create() + FindService() + GetHandle() + GetServiceState() + SetServiceStateChangeHandler() + Service() + StartFindService() + StopFindService() + UnsetServiceStateChangeHandler()

Detailweergave

Kies een item in de inhoudsopgave.

Methoden

Create functie

Exception-less construction of a Proxy from a HandleType using the Named Constructor idiom.

static ara::core::Result< <SI>Proxy > Create (const <SI-Namespace>::proxy:: <SI>Proxy::HandleType &handle) noexcept;
FindService functie 2

Find a service using an ara::com::InstanceIdentifier, with immediately returned request

Overloads FindService 2
GetHandle functie

Return the handle used to create the proxy instance

HandleType GetHandle () const noexcept;

Returns the state of the service

ara::core::Result< ara::com::ServiceState > GetServiceState () noexcept;
Proxy functie 4

Construction of the service proxy from the found handles (from any of the FindService()/ StartFindService() methods)

Overloads Proxy 4
explicit <SI>Proxy (const HandleType &handle); SWS_CM_00131
<SI>Proxy (const <SI-Namespace>::proxy:: <SI>Proxy &other)=delete; SWS_CM_00136
<SI>Proxy ( <SI-Namespace>::proxy:: <SI>Proxy &&other); SWS_CM_00137
Service functie 2

Find a service using an ara::com::InstanceIdentifier, with handler registration

Overloads Service 2
static ara::core::Result< ara::com::FindServiceHandle > StartFind Service (ara::com::FindServiceHandler< <SI-Namespace>::proxy:: <SI>Proxy::HandleType > handler, ara::com::InstanceIdentifier instance) noexcept; SWS_CM_00123
static ara::core::Result< ara::com::FindServiceHandle > StartFind Service (ara::com::FindServiceHandler< <SI-Namespace>::proxy:: <SI>Proxy::HandleType > handler, ara::core::InstanceSpecifier instance) noexcept; SWS_CM_00623

Register a service state change handler. This handler shall be called by the Communication Management implementation as soon as the service availability state has changed. The Handler may be overwritten during runtime.

Overloads SetServiceStateChangeHandler 2
void SetServiceStateChangeHandler (ara::com::ServiceStateHandler handler) noexcept; SWS_CM_01074
template <typename ExecutorT> void SetServiceStateChangeHandler (ara::com::ServiceStateHandler handler, ExecutorT &&executor) noexcept; SWS_CM_01076

Find a service using an ara::com::InstanceIdentifier, with handler registration, - in a provided execution context

Overloads StartFindService 2
template <typename ExecutorT> static ara::com::FindServiceHandle StartFindService (ara::com::FindServiceHandler< <SI-Namespace>::proxy:: <SI>Proxy::HandleType > handler, ara::com::InstanceIdentifier instance, ExecutorT &&executor) noexcept; SWS_CM_11352
template <typename ExecutorT> static ara::com::FindServiceHandle StartFindService (ara::com::FindServiceHandler< <SI-Namespace>::proxy:: <SI>Proxy::HandleType > handler, ara::core::InstanceSpecifier instance, ExecutorT &&executor) noexcept; SWS_CM_11365

Stop an ongoing StartFindService() - Stops receiving further notifications for the provided ara::com::FindServiceHandle

void StopFindService (ara::com::FindServiceHandle handle) noexcept;

As per [SWS_CM_01074]

void UnsetServiceStateChangeHandler () noexcept;

Operatoren

operator= functie 2

Copy assignment constructor deletion

Overloads = 2
<SI>Proxy & operator= (const <SI-Namespace>::proxy:: <SI>Proxy &other)=delete; SWS_CM_11551
<SI-Namespace>::proxy:: <SI>Proxy & operator= ( <SI-Namespace>::proxy:: <SI>Proxy &&other) noexcept; SWS_CM_11552

Constanten

<Event> variabele

Event member, one for each VariableDataPrototype defined in the ServiceInterface in the role event.

events::<Event> <Event>;
<Field> variabele

Field member, one for each Field defined in the ServiceInterface in the role field.

fields::<Field> <Field>;
<Method> variabele

Method member, one for each ClientServerOperation defined in the ServiceInterface in the role method.

methods::<Method> <Method>;

Geneste typen

HandleType klasse

Documentatie van de methoden

functie Create [SWS_CM_10438] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00139

static ara::core::Result< <SI>Proxy > Create (const <SI-Namespace>::proxy:: <SI>Proxy::HandleType &handle) noexcept;

Exception-less construction of a Proxy from a HandleType using the Named Constructor idiom.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 7ecc1087a58a Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik en semantiek

De statische factory-methode Create dient conform [SWS_CM_10438] voor het exceptievrij creëren van een proxy-instantie (<SI>Proxy) volgens het named-constructor-idioom. Deze vereist als parameter handle een eerder vastgesteld service-handle conform [SWS_CM_00131]. De aanroep vindt synchroon plaats en is gedeclareerd als noexcept. Het resultaat wordt geretourneerd in een ara::core::Result, dat bij succes de gebruiksklare proxy-instantie bevat.

Foutafhandeling

Treedt er tijdens de instantiëring een fout op, dan levert Create via de ara::core::Result een foutcode van het type ara::com::ComErrc op [SWS_CM_10438]:

  • ComErrc::kServiceNotAvailable: De dienst is na eerdere aanbieding via OfferService() niet meer beschikbaar.
  • ComErrc::kCommunicationFailure: De netwerk-binding meldt een herstelbare communicatiefout of het mislukken van een beveiligde verbinding.

Beide fouten vertonen een rollback-semantiek [SWS_CM_10438]. Bij structurele of beveiligingsgerelateerde fouten treden gespecificeerde overtredingen (violations) in werking: Als het overgedragen handle null of gecorrumpeerd is, is er sprake van een ErroneousServiceHandleViolation. Ontbreken bij het aanroepende proces in het kader van Grant Enforcement de vereiste bevoegdheden voor de instantie, dan wordt het verzoek afgewezen en als InsufficientPermissionsViolation behandeld (SWS CommunicationManagement §8 “Security”, [SWS_CM_10438]).

Gelijktijdigheid en randvoorwaarden

Interpretatie: Aangezien Create synchroon werkt en communicatieresources bindt, zal de aanroep voor verschillende handles vermoedelijk re-entrant zijn, maar deze dient vanwege mogelijke netwerkinitialisaties niet in tijdkritische hard-realtime-lussen te worden uitgevoerd. Vraag Q-f7ba23670f562788 (open)

Deze tekst is gegenereerd door een AI-systeem op basis van de specificatie AUTOSAR R25-11.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe
Verletzungen (Violations)ErroneousService- Provided HandleType is null or corrupt HandleViolation InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

ParameterBeschreibung
handleAs per [SWS_CM_00131]

Rückgabewert

TypBeschreibung
ara::core::Result< {<service-interface-name> }Proxy >• If successful: an ara::core::Result containing a ara:: core::Result::value_type containing a Proxy • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
ComErrc::kServiceNotAvailablerollback_semantics Service is not available after being previously offered via Offer Service()
ComErrc::kCommunicationFailurerollback_semantics The network binding reported a recoverable communications error or a secure communication failure

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_10438
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_10438@rel:R25-11#7b05f2dd
Content hash
7b05f2dd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_10438
Status: valid/unmigrated Version: rel:R25-11#cfeddea9 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_10438@rel:R25-11#cfeddea9
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#b417ae7a2026-09-30
  • R19-11rel:R19-11#7e4e18b92026-10-14
  • R20-11rel:R20-11#f1232f7e2026-10-14
  • R21-11rel:R21-11#f1232f7e2026-10-14
  • R22-11rel:R22-11#38bf837e2026-10-14
  • R23-11rel:R23-11#38bf837e2026-10-14
  • R24-11rel:R24-11#08265d1c2026-10-14
  • R25-11rel:R25-11#cfeddea92026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie FindService [SWS_CM_00122] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00115, RS_AP_00119, RS_AP_00120, RS_AP_00121

static ara::core::Result< ara::com::ServiceHandleContainer< HandleType > > FindService (ara::com::InstanceIdentifier instance) noexcept;

Find a service using an ara::com::InstanceIdentifier, with immediately returned request

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 1c6c926e4b24 Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De statische methode FindService van de proxy-klasse dient voor het synchroon vinden van beschikbare service-instanties aan de hand van een ara::com::InstanceIdentifier ([SWS_CM_00122]). De aanroep retourneert het resultaat onmiddellijk als ara::core::Result, dat bij succesvolle uitvoering een ara::com::ServiceHandleContainer bevat ([SWS_CM_00122]). Deze container – typisch geïmplementeerd als ara::core::Vector ([SWS_CM_00304]) – kan afhankelijk van de actuele deployment-toestand leeg zijn, één enkele instantie-handle bevatten of meerdere handles omvatten (ARAComAPI §6.5 “Service Discovery”).

In geval van een fout levert de ara::core::Result een foutcode uit ara::com::ComErrc op, namelijk ComErrc::kCommunicationFailure, wanneer de netwerk-binding een herstelbare overdrachtsfout of een probleem bij de veilige communicatie meldt ([SWS_CM_00122]). Bovendien is de toegang onderhevig aan rechtencontrole; onvoldoende rechten leiden tot een InsufficientPermissionsViolation ([SWS_CM_00122]).

Met betrekking tot het verloop en de gelijktijdigheid gelden de volgende voorwaarden:

  • Aanroepcontext en synchroniciteit: Omdat het zoeken direct wordt uitgevoerd, worden alleen die instanties gevonden waarvoor vooraf serverzijdig OfferService() is aangeroepen (ARAComAPI §6.5 “Service Discovery”).
  • Uitzonderingsveiligheid en re-entrantie: De functie is gespecificeerd als noexcept en is exception-safe ([SWS_CM_00122]). Omdat de methode statisch is en geen veranderlijke objectstatus vereist, is deze vermoedelijk re-entrant en thread-safe aanroepbaar. Vraag Q-3228cc998c4a737e (open)
  • Verdere verwerking: Gevonden handles dienen voor het instantiëren van proxy-objecten via de constructor Proxy(const HandleType &handle) ([SWS_CM_00131]). Voor een modelgebaseerde zoekopdracht staat als alternatief de overbelasting met ara::core::InstanceSpecifier gereed ([SWS_CM_00622]).

Deze gebruiksinstructie is door een AI gegenereerd op basis van de AUTOSAR R25-11-specificatie.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe
Verletzungen (Violations)InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

ParameterBeschreibung
instanceara::com::InstanceIdentifier qualifying the wanted instance of the service

Rückgabewert

TypBeschreibung
ara::core::Result<ara::com::ServiceHandleContainer< {<hierarchical-namespace-list-lower-proxy> }::proxy::{<service-interface-name> }Proxy::HandleType > >• If successful: an ara::core::Result containing a ara:: core::Result::value_type containing a ara::com:: ServiceHandleContainer further containing HandleTypes for all matching services • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
ComErrc::kCommunicationFailurerollback_semantics The network binding reported a recoverable communications error or a secure communication failure

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00122
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00122@rel:R25-11#1e2ef9e0
Content hash
1e2ef9e0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00122
Status: valid/unmigrated Version: rel:R25-11#6f2101ad Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00122@rel:R25-11#6f2101ad
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#bcc92a852026-09-30
  • R19-11rel:R19-11#088b9ecc2026-10-14
  • R20-11rel:R20-11#d4d640972026-10-14
  • R21-11rel:R21-11#746c23552026-10-14
  • R22-11rel:R22-11#2b7e51e42026-10-14
  • R23-11rel:R23-11#2b7e51e42026-10-14
  • R24-11rel:R24-11#12aa77e32026-10-14
  • R25-11rel:R25-11#6f2101ad2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie FindService [SWS_CM_00622] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00115, RS_AP_00119, RS_AP_00121, RS_AP_00127, RS_AP_00137

static ara::core::Result< ara::com::ServiceHandleContainer< HandleType > > FindService (ara::core::InstanceSpecifier instance) noexcept;

Find a service using an ara::core::InstanceSpecifier, with immediately returned request

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 4b1386a8f38a Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De statische functie FindService van de proxy-klasse dient conform [SWS_CM_00622] voor het synchroon vinden van beschikbare service-instanties aan de hand van een ara::core::InstanceSpecifier met onmiddellijke teruggave („immediately returned request”). Voorwaarde voor het vinden is dat de betreffende service-skeleton-instantie vooraf middels OfferService() beschikbaar is gesteld (ARAComAPI p. 103 “Figure 6.5: Service Discovery”).

Retourwaarden en interactie

Als resultaat levert de aanroep een ara::core::Result met een ara::com::ServiceHandleContainer conform [SWS_CM_00622] op, die standaard op ara::core::Vector is gebaseerd [SWS_CM_00304]. Deze container kan leeg zijn, een enkele handle of meerdere gevonden instanties bevatten (ARAComAPI p. 103 “Figure 6.5: Service Discovery”). De vastgestelde service-handles worden vervolgens voor de instantiëring van het proxy-object aan de constructor doorgegeven [SWS_CM_00131]. Voor een gebeurtenisgestuurde, asynchrone zoekopdracht met notificatie is als alternatief StartFindService beschikbaar [SWS_CM_00623], terwijl voor instantie-aanduidingen de overbelasting uit [SWS_CM_00122] wordt gebruikt.

Foutafhandeling en randvoorwaarden

De functie is als noexcept gedeclareerd en geldt als uitzonderingsveilig („exception safe”) conform [SWS_CM_00622]. In geval van een fout bevat het Result-object de foutcode ComErrc::kCommunicationFailure, bijvoorbeeld bij communicatiestoringen van de netwerk-binding [SWS_CM_00622]. Daarnaast definieert [SWS_CM_00622] model- en permissieschendingen zoals InstanceSpecifierMappingIntegrityViolation, PortInterfaceMappingViolation, ProcessMappingViolation, InstanceSpecifierAlreadyInUseViolation en InsufficientPermissionsViolation.

Interpretatie: Vanwege de synchrone en onmiddellijke teruggave is de methode vermoedelijk hoofdzakelijk geschikt voor initiële initialisatiefasen of gericht pollen, voor zover geen continue observatie via callback vereist is. Vraag Q-ea5b242a6fe41d20 (open)

Deze gebruiksinstructie is door een AI gegenereerd op basis van de specificatiegegevens uit AUTOSAR Adaptive R25-11.

Implementer's Guide volgt (complexiteit I3)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe
Verletzungen (Violations)InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of the executable, or it refers to a model element other than tegrityViolation a PortPrototype. PortInterfaceMap- The type of mapping does not match the expected type of Port pingViolation Interface: ServiceInterface referenced by a ServiceInstanceToPortPrototypeMapping. ProcessMappingVio- The type of mapping does not match the expected type of Port lation Interface InstanceSpecifier- The constructor was called with an Instance Specifier already AlreadyInUseViola- tion InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

ParameterBeschreibung
instanceara::core::InstanceSpecifier qualifying the wanted instance of the service

Rückgabewert

TypBeschreibung
ara::core::Result<ara::com::ServiceHandleContainer< {<hierarchical-namespace-list-lower-proxy>}::proxy::{<service-interface-name> }Proxy::HandleType > >As per [SWS_CM_00122]

Fehler

FehlercodeBeschreibung
ComErrc::kCommunicationFailurerollback_semantics The network binding reported a recoverable communications error or a secure communication failure

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00622
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00622@rel:R25-11#8791e9e0
Content hash
8791e9e0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00622
Status: valid/unmigrated Version: rel:R25-11#b658bb0b Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00622@rel:R25-11#b658bb0b
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#06c9698f2026-09-30
  • R19-11rel:R19-11#9aca721e2026-10-14
  • R20-11rel:R20-11#a72540782026-10-14
  • R21-11rel:R21-11#ddb1520c2026-10-14
  • R22-11rel:R22-11#93fa43952026-10-14
  • R23-11rel:R23-11#72729ae82026-10-14
  • R24-11rel:R24-11#d99b30fa2026-10-14
  • R25-11rel:R25-11#b658bb0b2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie GetHandle [SWS_CM_10383] Upstream: RS_CM_00107, RS_AP_00114, RS_AP_00119

HandleType GetHandle () const noexcept;

Return the handle used to create the proxy instance

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
<SI-Namespace>::proxy::<SI>Proxy::HandleTypeAs per [SWS_CM_00312]

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_10383
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_10383@rel:R25-11#ca75ee20
Content hash
ca75ee20
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_10383
Status: valid/unmigrated Version: rel:R25-11#281a2b71 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_10383@rel:R25-11#281a2b71
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#ec2e1e0d2026-09-30
  • R19-11rel:R19-11#b30af83b2026-10-14
  • R20-11rel:R20-11#b30af83b2026-10-14
  • R21-11rel:R21-11#b30af83b2026-10-14
  • R22-11rel:R22-11#b30af83b2026-10-14
  • R23-11rel:R23-11#b30af83b2026-10-14
  • R24-11rel:R24-11#ded2435a2026-10-14
  • R25-11rel:R25-11#281a2b712026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie GetServiceState [SWS_CM_01073]

ara::core::Result< ara::com::ServiceState > GetServiceState () noexcept;

Returns the state of the service

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
ara::core::Result<ara::com::ServiceState >• If successful: an ara::core::Result containing a ara:: core::Result::value_type i.e. a ara::com:: ServiceState giving the service state • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
ComErrc::kCommunicationFailurerollback_semantics The network binding reported a recoverable communications error or a secure communication failure

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_01073
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01073@rel:R25-11#91d3ab4d
Content hash
91d3ab4d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01073
Status: valid/unmigrated Version: rel:R25-11#6c74cf42 Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_01073@rel:R25-11#6c74cf42
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#3f41673b2026-09-30
  • R22-11rel:R22-11#dd9d89292026-10-14
  • R23-11rel:R23-11#ba4457f52026-10-14
  • R24-11rel:R24-11#3f9e72502026-10-14
  • R25-11rel:R25-11#6c74cf422026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie Proxy [SWS_CM_00131] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00121

explicit <SI>Proxy (const HandleType &handle);

Construction of the service proxy from the found handles (from any of the FindService()/ StartFindService() methods)

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 664b77b81789 Herkomst
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik

De expliciete constructor <SI>Proxy instantieert de typespecifieke service-proxyklasse in de namespace <SI-Namespace>::proxy [SWS_CM_00131]. In het kader van het proxy-skeletonpatroon dient dit gegenereerde object aan de zijde van de serviceconsument als lokale façade, die methode-aanroepen doorstuurt naar de daadwerkelijke service-implementatie ARAComAPI Figure 5.1 “Proxy Skeleton Pattern”.

Voor de constructie wordt als parameter een referentie naar een geldige HandleType meegegeven [SWS_CM_00131]. Deze identifier moet eerder via Service Discovery-mechanismen zijn verkregen – hetzij synchroon via FindService() [SWS_CM_00122], hetzij asynchroon via de geregistreerde callback van StartFindService() [SWS_CM_00123].

Foutafhandeling

De constructie is niet uitzonderingsveilig (not exception safe) [SWS_CM_00131]. Kan de gerefereerde service niet worden bereikt, dan wordt conform ara::com::ComErrc::kServiceNotAvailable een ara::com::ComException geworpen [SWS_CM_00131]. Daarnaast zijn de volgende schendingen gedefinieerd:

  • ErroneousServiceHandleViolation: Treedt op wanneer het meegegeven HandleType-object null of beschadigd is [SWS_CM_00131].
  • InsufficientPermissionsViolation: Treedt op wanneer de aanmaak wordt geweigerd door de rechtencontrole (Grant Enforcement) [SWS_CM_00131].

Beperkingen en levenscyclus

Voor de proxyklasse is de copy-constructor expliciet verwijderd (=delete) [SWS_CM_00136]. Doorgifte van de instantie is uitsluitend toegestaan via de move-constructor, die eveneens als niet-uitzonderingsveilig is gespecificeerd [SWS_CM_00137]. Tijdens runtime actualiseert het communicatiebeheer na succesvolle aanmaak bij tijdelijke uitval en hernieuwde beschikbaarheid van de doelservice de transportlaagadressering van de bestaande proxy-instantie automatisch op de achtergrond ARAComAPI Figure 6.1 “Auto Updating of Proxy Instance”.

Deze gebruiksinstructie is geautomatiseerd gegenereerd op basis van de AUTOSAR-specificatie R25-11.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitnot exception safe
Verletzungen (Violations)ErroneousService- Provided HandleType is null or corrupt HandleViolation InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

ParameterBeschreibung
handleA found FindServiceHandle returned by any of the FindService() methods: • [SWS_CM_00122] • [SWS_CM_00622] or a FindServiceHandle found and sent to the assigned FindServiceHandler callback, by any of the StartFindService() methods: • [SWS_CM_00123] • [SWS_CM_00623] • [SWS_CM_11352] • [SWS_CM_11365]

Exceptions

ara::com:: As per ara::com::ComErrc::kServiceNotAvailable ComException

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00131
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00131@rel:R25-11#443d74cb
Content hash
443d74cb
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00131
Status: valid/unmigrated Version: rel:R25-11#ee74be81 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00131@rel:R25-11#ee74be81
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#1a6321992026-09-30
  • R19-11rel:R19-11#592e8f7d2026-10-14
  • R20-11rel:R20-11#592e8f7d2026-10-14
  • R21-11rel:R21-11#592e8f7d2026-10-14
  • R22-11rel:R22-11#592e8f7d2026-10-14
  • R23-11rel:R23-11#592e8f7d2026-10-14
  • R24-11rel:R24-11#0ab8e3252026-10-14
  • R25-11rel:R25-11#ee74be812026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie Proxy [SWS_CM_00136] Upstream: RS_CM_00102, RS_AP_00114

<SI>Proxy (const <SI-Namespace>::proxy:: <SI>Proxy &other)=delete;

Copy Constructor deletion

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00136
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00136@rel:R25-11#e454d4e0
Content hash
e454d4e0
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00136
Status: valid/unmigrated Version: rel:R25-11#95fda097 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00136@rel:R25-11#95fda097
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#72db3c3c2026-09-30
  • R19-11rel:R19-11#f2cf188a2026-10-14
  • R20-11rel:R20-11#aeb5fe302026-10-14
  • R21-11rel:R21-11#f2cf188a2026-10-14
  • R22-11rel:R22-11#f2cf188a2026-10-14
  • R23-11rel:R23-11#f2cf188a2026-10-14
  • R24-11rel:R24-11#a2c02d102026-10-14
  • R25-11rel:R25-11#95fda0972026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie Proxy [SWS_CM_00137] Upstream: RS_CM_00102, RS_AP_00114

<SI>Proxy ( <SI-Namespace>::proxy:: <SI>Proxy &&other);

Move constructor

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
otherOther object to move

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00137
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00137@rel:R25-11#d2baf40a
Content hash
d2baf40a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00137
Status: valid/unmigrated Version: rel:R25-11#a6236489 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00137@rel:R25-11#a6236489
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#8fb3b8362026-09-30
  • R19-11rel:R19-11#820da2b22026-10-14
  • R20-11rel:R20-11#820da2b22026-10-14
  • R21-11rel:R21-11#820da2b22026-10-14
  • R22-11rel:R22-11#820da2b22026-10-14
  • R23-11rel:R23-11#820da2b22026-10-14
  • R24-11rel:R24-11#466610572026-10-14
  • R25-11rel:R25-11#a62364892026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie Proxy [SWS_CM_99444] Upstream: RS_CM_00102, RS_AP_00114

~<SI>Proxy ();

Destruction of a Proxy

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: c536b9aecd57 Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De destructor ~<SI>Proxy () sluit de levenscyclus van een serviceproxy-instantie af en geeft de bijbehorende lokale bronnen vrij [SWS_CM_99444]. Een serviceproxy dient aan de consumentzijde als een lokale façade voor interactie met een potentieel externe service-implementatie en stuurt aanroepen door ARAComAPI §5.1 “Proxy Skeleton Pattern”. Het proxy-object wordt vooraf geïnstantieerd via een vastgestelde service-handle [SWS_CM_00131], die via service-discoveryfuncties zoals FindService beschikbaar is gesteld [SWS_CM_00122].

Voor de vernietiging en het runtime-gedrag gelden de volgende voorschriften en randvoorwaarden:

  • Levenscyclus en semantiek: De vernietiging vindt synchroon plaats bij het verlaten van de scope of bij het expliciet verwijderen van de instantie. Terwijl de copy constructor van de proxy-klasse is verwijderd [SWS_CM_00136], kan het object vóór de vernietiging ervan worden verplaatst via move-semantiek [SWS_CM_00137].
  • Exceptieveiligheid: De destructor is gespecificeerd als not exception safe [SWS_CM_99444].
  • Precondities en foutgedrag: Als de preconditie [SWS_CM_00087] wordt geschonden, resulteert dit in een DanglingSamplesViolation [SWS_CM_99444]. (Interpretatie: Vóór de aanroep van de destructor moeten vermoedelijk alle door de consument vastgehouden sample-referenties respectievelijk datapoointers worden vrijgegeven om ongeldige referenties te voorkomen.) Vraag Q-5488797b732d9be6 (open)
  • Interactie: Indien asynchrone servicezoekopdrachten worden gebruikt, moeten deze desgewenst vóór het vrijgeven van de gebruikscontext via StopFindService worden beëindigd [SWS_CM_00125]. Bovendien kunnen voor events, triggers en fields geregistreerde foutafhandelingshandlers vooraf worden gereset [SWS_CM_00105] [SWS_CM_00108] [SWS_CM_00126].

Deze gebruiksinstructie is geautomatiseerd opgesteld op basis van de specificatiegegevens.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitnot exception safe
Verletzungen (Violations)DanglingSamplesVi- Precondition [SWS_CM_00087] has been violated. olation

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_99444
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_99444@rel:R25-11#761da691
Content hash
761da691
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_99444
Status: valid/unmigrated Version: rel:R25-11#75a7089c Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_99444@rel:R25-11#75a7089c
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#83fb25582026-09-30
  • R24-11rel:R24-11#9caace202026-10-14
  • R25-11rel:R25-11#75a7089c2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie Service [SWS_CM_00123] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00115, RS_AP_00119, RS_AP_00120, RS_AP_00121

static ara::core::Result< ara::com::FindServiceHandle > StartFind Service (ara::com::FindServiceHandler< <SI-Namespace>::proxy:: <SI>Proxy::HandleType > handler, ara::com::InstanceIdentifier instance) noexcept;

Find a service using an ara::com::InstanceIdentifier, with handler registration

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 0c76c8d95c3b Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De statische methode StartFindService [SWS_CM_00123] van de proxy-klasse start de asynchrone zoekopdracht naar service-instanties aan de hand van een ara::com::InstanceIdentifier onder registratie van een callback-handler (ARAComAPI §6.5 “Service Discovery”). Aan de aanroep worden een ara::com::FindServiceHandler en de gezochte ara::com::InstanceIdentifier meegegeven [SWS_CM_00123].

Bij succes retourneert de functie een ara::core::Result met een ara::com::FindServiceHandle [SWS_CM_00123]. Deze identifier vertegenwoordigt de actieve zoekopdracht en is dwingend vereist om de monitoring van de servicebeschikbaarheid en daaropvolgende handler-aanroepen later door middel van StopFindService [SWS_CM_00125] weer te beëindigen.

Treedt er bij het opbouwen van de verbinding een communicatieprobleem op, dan retourneert de methode in de ara::core::Result de foutcode ComErrc::kCommunicationFailure [SWS_CM_00123]. Is de overgedragen callable-instantie ongeldig of null, dan wordt dit beschouwd als een InvalidHandlerViolation; ontbrekende toegangsrechten leiden tot een InsufficientPermissionsViolation [SWS_CM_00123].

Zodra een passende service-instantie in het systeem beschikbaar komt, roept het communicatiemanagement de geregistreerde handler aan met de bijbehorende service-handles [SWS_CM_00123]. Aan de hand van een gemelde HandleType kan de applicatie via de named-constructor-methode Create [SWS_CM_10438] een concrete proxy-instantie aanmaken. Interpretatie: de handler wordt vermoedelijk asynchroon uitgevoerd in een thread van het communicatiemanagement, waardoor de toegang tot gedeelde bronnen in de handler thread-safe moet plaatsvinden. Vraag Q-9dc570d7e65fc808 (open) Voor het zoeken via een modelgebaseerde identifier staat als alternatief StartFindService met InstanceSpecifier ter beschikking [SWS_CM_00623].

Deze gebruiksinstructie is gebaseerd op de bepalingen van de AUTOSAR Adaptive-specificatie en is redactioneel geverifieerd.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

ParameterBeschreibung
handlerA ara::com::FindServiceHandler for the corresponding ServiceProxy class, which gets called any time a AdaptivePlatformServiceInstance matching the given instance criteria is found.
instanceAs per [SWS_CM_00122]

Rückgabewert

TypBeschreibung
ara::core::Result<ara::com::FindServiceHandle >• If successful: an ara::core::Result containing a ara:: core::Result::value_type containing a ara::com:: FindServiceHandle for this search/find request which is needed to stop the service availability monitoring and related firing of the given handler. • If unsuccessful: an ara::core::Result containing an ara:: core::Result::error_type i.e. a corresponding ara:: com::ComErrc

Fehler

FehlercodeBeschreibung
ComErrc::kCommunicationFailurerollback_semantics The network binding reported a recoverable communications error or a secure communication failure

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00123
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00123@rel:R25-11#002349c9
Content hash
002349c9
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00123
Status: valid/unmigrated Version: rel:R25-11#5fed703f Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00123@rel:R25-11#5fed703f
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#288570952026-09-30
  • R19-11rel:R19-11#8b0f8dc42026-10-14
  • R20-11rel:R20-11#2e9f704d2026-10-14
  • R21-11rel:R21-11#f14ee6512026-10-14
  • R22-11rel:R22-11#c12cd1af2026-10-14
  • R23-11rel:R23-11#a53126272026-10-14
  • R24-11rel:R24-11#cef155e52026-10-14
  • R25-11rel:R25-11#5fed703f2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie Service [SWS_CM_00623] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00115, RS_AP_00119, RS_AP_00121, RS_AP_00127, RS_AP_00137

static ara::core::Result< ara::com::FindServiceHandle > StartFind Service (ara::com::FindServiceHandler< <SI-Namespace>::proxy:: <SI>Proxy::HandleType > handler, ara::core::InstanceSpecifier instance) noexcept;

Find a service using an ara::core::InstanceSpecifier, with handler registration

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 40cd4cda442b Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De statische methode StartFindService van de proxy-klasse start het continu zoeken naar service-instanties aan de hand van een gemodelleerde ara::core::InstanceSpecifier [SWS_CM_00623]. Bij de aanroep worden de InstanceSpecifier en een callbackfunctie van het type ara::com::FindServiceHandler meegegeven [SWS_CM_00623]. Als retourwaarde levert de functie een ara::core::Result<ara::com::FindServiceHandle> [SWS_CM_00623] op, die bij succesvolle registratie een zoek-handle voor het beheer van de zoekopdracht ter beschikking stelt.

De foutafhandeling geschiedt via de geretourneerde ara::core::Result. Treedt er bij de netwerk-binding een herstelbare communicatiefout of een fout van de veilige communicatie op, dan bevat het resultaat de foutcode ComErrc::kCommunicationFailure [SWS_CM_00623]. Bovendien zijn specifieke violations gespecificeerd: InvalidHandlerViolation indien de meegegeven handler ongeldig of null is, InsufficientPermissionsViolation bij ontbrekende rechten door grant enforcement, evenals modelleringsschendingen zoals InstanceSpecifierMappingIntegrityViolation of PortInterfaceMappingViolation [SWS_CM_00623].

Wat betreft gelijktijdigheid en randvoorwaarden is de functie gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig [SWS_CM_00623]. De uitvoering van de geregistreerde handler zal vermoedelijk asynchroon door het communicatiebeheer plaatsvinden zodra passende service-instanties in het systeem worden gedetecteerd. Vraag Q-79fb3ff78d517714 (open)

In de interactie met verwante interfaces gelden de volgende punten:

  • De geretourneerde ara::com::FindServiceHandle moet worden bewaard om de lopende zoekopdracht via StopFindService [SWS_CM_00125] te beëindigen en de ontvangst van verdere notificaties te stoppen.
  • De via de callback ter beschikking gestelde handles (HandleType) dienen doorgaans voor de instantiëring van het proxy-object via de factory-methode Create [SWS_CM_10438].
  • Als alternatief voor het zoeken via een InstanceSpecifier kan een zoekopdracht ook met een ara::com::InstanceIdentifier worden geïnitieerd [SWS_CM_00123].

Deze tekst is opgesteld door een AI en is gebaseerd op de specificatiestand van AUTOSAR R25-11.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe
Verletzungen (Violations)InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of the executable, or it refers to a model element other than tegrityViolation a PortPrototype. PortInterfaceMap- The type of mapping does not match the expected type of Port pingViolation Interface: ServiceInterface referenced by a ServiceInstanceToPortPrototypeMapping. ProcessMappingVio- The type of mapping does not match the expected type of Port lation Interface InstanceSpecifier- The constructor was called with an Instance Specifier already AlreadyInUseViola- tion InvalidHandlerVio- Provided Callable handler does not exist or is null lation InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_00123]
instanceAs per [SWS_CM_00622]

Rückgabewert

TypBeschreibung
ara::core::Result<ara::com::FindServiceHandle >As per [SWS_CM_00123]

Fehler

FehlercodeBeschreibung
ComErrc::kCommunicationFailurerollback_semantics The network binding reported a recoverable communications error or a secure communication failure

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00623
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00623@rel:R25-11#211778dd
Content hash
211778dd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00623
Status: valid/unmigrated Version: rel:R25-11#53a828a4 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00623@rel:R25-11#53a828a4
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#71acdb2b2026-09-30
  • R19-11rel:R19-11#74bab8b92026-10-14
  • R20-11rel:R20-11#d103521b2026-10-14
  • R21-11rel:R21-11#cf6bd2292026-10-14
  • R22-11rel:R22-11#e4c0996e2026-10-14
  • R23-11rel:R23-11#4ffba6b82026-10-14
  • R24-11rel:R24-11#810427ab2026-10-14
  • R25-11rel:R25-11#53a828a42026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie SetServiceStateChangeHandler [SWS_CM_01074]

void SetServiceStateChangeHandler (ara::com::ServiceStateHandler handler) noexcept;

Register a service state change handler. This handler shall be called by the Communication Management implementation as soon as the service availability state has changed. The Handler may be overwritten during runtime.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 186ab9eb37c5 Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De methode SetServiceStateChangeHandler dient er op een proxy-instantie voor om een callback-functie te registreren voor de bewaking van beschikbaarheidswijzigingen van de betreffende service ([SWS_CM_01074], SWS CommunicationManagement §8.3.8.2.4.6 “SetServiceStateChangeHandler(ara::com::ServiceStateHandler)”). Het communicatiebeheer roept deze handler aan zodra de toestand van de service-beschikbaarheid (ServiceState) verandert ([SWS_CM_01074]).

Als parameter wordt een functie-object van het type ara::com::ServiceStateHandler doorgegeven, dat als std::function<void(ServiceState)> is gespecificeerd ([SWS_CM_01072]). De functie heeft geen retourwaarde. Een reeds geregistreerde handler mag tijdens runtime door een hernieuwde aanroep worden overschreven ([SWS_CM_01074]).

Wat betreft de foutafhandeling is de functie als uitzonderingsveilig (noexcept) gedeclareerd ([SWS_CM_01074]). Indien het doorgegeven callable niet bestaat of null is, doet de schending InvalidHandlerViolation zich voor ([SWS_CM_01074]).

Met betrekking tot de uitvoeringsomgeving vormt [SWS_CM_01074] de basisinterface. Aangezien hier geen executor kan worden doorgegeven, wordt de callback vermoedelijk in de interne thread-context van het communicatiebeheer uitgevoerd. Vraag Q-7833435e7aa1da9f (open) Voor zover uitvoering in een specifieke applicatiecontext vereist is, staat als alternatief de overbelaste template-variant met een executor conform [SWS_CM_01076] ter beschikking (SWS CommunicationManagement §8.3.8.2.4.5 “SetServiceStateChangeHandler(ara::com::ServiceStateHandler, ExecutorT&&)”).

Deze tekst is opgesteld door een AI. Deze vervangt niet de controle van de onderliggende AUTOSAR-specificaties.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerThe callback for service state change handler

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_01074
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01074@rel:R25-11#ac94fdde
Content hash
ac94fdde
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01074
Status: valid/unmigrated Version: rel:R25-11#a6d97b14 Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_01074@rel:R25-11#a6d97b14
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#1277a2d02026-09-30
  • R22-11rel:R22-11#91401b222026-10-14
  • R23-11rel:R23-11#fec38b202026-10-14
  • R24-11rel:R24-11#12032ba22026-10-14
  • R25-11rel:R25-11#a6d97b142026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie SetServiceStateChangeHandler [SWS_CM_01076]

template <typename ExecutorT> void SetServiceStateChangeHandler (ara::com::ServiceStateHandler handler, ExecutorT &&executor) noexcept;

As per [SWS_CM_01074] but the method shall execute in a provided context.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 7e2d99ac7d24 Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik en aanroepcontext

De template-methode SetServiceStateChangeHandler dient op de gegenereerde proxy-klasse <SI-Namespace>::proxy::<SI>Proxy voor de registratie van een callback ter bewaking van de servicebeschikbaarheid [SWS_CM_01076]. De functie accepteert twee parameters AUTOSAR_AP_SWS_CommunicationManagement §8.3.8.2.4.5 “SetServiceStateChangeHandler(ara::com::ServiceStateHandler, ExecutorT&&)”:

  • handler: Een functor van het type ara::com::ServiceStateHandler (gedefinieerd als std::function<void(ServiceState)>), die bij elke wijziging van de beschikbaarheidsstatus wordt aangeroepen [SWS_CM_01072], [SWS_CM_01074].
  • executor: Een uitvoeringscontext van het template-type ExecutorT conform [SWS_CM_11360], waarin de geregistreerde handler wordt uitgevoerd [SWS_CM_01076].

De functie heeft geen retourwaarde (void) [SWS_CM_01076].

Foutafhandeling en exception-veiligheid

De functie is gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig (exception safe) [SWS_CM_01076]. Indien de doorgegeven callable-handler niet bestaat of null is, wordt een InvalidHandlerViolation geactiveerd [SWS_CM_01076].

Gelijktijdigheid en beperkingen

Een geregistreerde handler kan tijdens runtime worden overschreven [SWS_CM_01074]. Aangezien de uitvoering via het doorgegeven executor-object plaatsvindt [SWS_CM_01076], wordt de notificatie vermoedelijk asynchroon verwerkt in de door de gebruiker bereitgestelde thread- of dispatch-context. Vraag Q-349c5224c3b9cc20 (open)

Samenspel

De methode breidt de basisvariant [SWS_CM_01074] uit met de expliciete specificatie van de uitvoeringscontext [SWS_CM_01076]. Voor insluiting is de header <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h vereist, terwijl het handler-type afkomstig is uit ara/com/types.h [SWS_CM_01072].

Deze gebruiksinstructie is geautomatiseerd opgesteld op basis van de specificatie AUTOSAR AP Release R25-11.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Template-Parameter

ParameterBeschreibung
ExecutorTAs per [SWS_CM_11360]

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_01074]
executorAs per [SWS_CM_11360]

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_01076
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01076@rel:R25-11#638ce15d
Content hash
638ce15d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01076
Status: valid/unmigrated Version: rel:R25-11#42c2fc88 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_01076@rel:R25-11#42c2fc88
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#364c6b732026-09-30
  • R23-11rel:R23-11#00e316b22026-10-14
  • R24-11rel:R24-11#bc0c225f2026-10-14
  • R25-11rel:R25-11#42c2fc882026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie StartFindService [SWS_CM_11352] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00115, RS_AP_00119, RS_AP_00120, RS_AP_00121

template <typename ExecutorT> static ara::com::FindServiceHandle StartFindService (ara::com::FindServiceHandler< <SI-Namespace>::proxy:: <SI>Proxy::HandleType > handler, ara::com::InstanceIdentifier instance, ExecutorT &&executor) noexcept;

Find a service using an ara::com::InstanceIdentifier, with handler registration, - in a provided execution context

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 966a42ce08ac Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De statische template-methode StartFindService start de asynchrone achtergrondbewaking voor het vinden van instanties van een service aan de hand van een ara::com::InstanceIdentifier ([SWS_CM_11352], EXP_ARAComAPI §5.3.3 “Proxy Class API’s”). Naast de doelinstantie (instance conform [SWS_CM_00122]) worden een callback-functie (handler conform [SWS_CM_00123]) en een uitvoeringscontext (executor van het template-type ExecutorT conform [SWS_CM_11360]) geregistreerd ([SWS_CM_11352]). De callback-meldingen worden daarbij vermoedelijk in de thread- respectievelijk taakcontext van de overgedragen executor verwerkt ([SWS_CM_11352]). Vraag Q-1db520123c1e49a4 (open)

Als retourwaarde levert de aanroep een ara::com::FindServiceHandle ([SWS_CM_11352]). Deze handle identificeert de lopende zoekactiviteit en is vereist om de achtergrondactiviteit later via [SWS_CM_00125] (StopFindService) expliciet te beëindigen (EXP_ARAComAPI §5.3.3 “Proxy Class API’s”). Via de geregistreerde callback verkregen service-handles (HandleType) dienen vervolgens voor de constructie van de bijbehorende proxy-instanties ([SWS_CM_00131]).

De functie is gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig (exception safe) ([SWS_CM_11352]). De volgende runtime-schendingen (Violations) zijn gedefinieerd:

  • InvalidHandlerViolation: Treedt op wanneer de doorgegeven handler-functie ongeldig is of overeenkomt met null ([SWS_CM_11352]).
  • InsufficientPermissionsViolation: Treedt op wanneer de toegang door het autorisatiesysteem (Grant Enforcement) wordt geweigerd ([SWS_CM_11352]).

Indien een service in plaats daarvan via een modelgebaseerde ara::core::InstanceSpecifier moet worden gezocht, staat als alternatief de functievariant [SWS_CM_11365] ter beschikking.

Deze tekst is opgesteld en gecureerd door een AI. Alle gegevens zijn gebaseerd op AUTOSAR Adaptive R25-11.

Implementer's Guide volgt (complexiteit I3)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation InsufficientPer- Refused by Grant Enforcement missionsViolation

Template-Parameter

ParameterBeschreibung
ExecutorTAs per [SWS_CM_11360]

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_00123]
instanceAs per [SWS_CM_00122]
executorAs per [SWS_CM_11360]

Rückgabewert

TypBeschreibung
ara::com::FindServiceHandleAs per [SWS_CM_00123]

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11352
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11352@rel:R25-11#af66d1c2
Content hash
af66d1c2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11352
Status: valid/unmigrated Version: rel:R25-11#a0653886 Versionshistorie & Revisions (1 transition, 7 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11352@rel:R25-11#a0653886
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#b506106e2026-09-30
  • R20-11rel:R20-11#1e2172bd2026-10-14
  • R21-11rel:R21-11#3fa9f7922026-10-14
  • R22-11rel:R22-11#3fa9f7922026-10-14
  • R23-11rel:R23-11#72eaa22f2026-10-14
  • R24-11rel:R24-11#749e20a42026-10-14
  • R25-11rel:R25-11#a06538862026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie StartFindService [SWS_CM_11365] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00115, RS_AP_00119, RS_AP_00120, RS_AP_00121

template <typename ExecutorT> static ara::com::FindServiceHandle StartFindService (ara::com::FindServiceHandler< <SI-Namespace>::proxy:: <SI>Proxy::HandleType > handler, ara::core::InstanceSpecifier instance, ExecutorT &&executor) noexcept;

Find a service using an ara::core::InstanceSpecifier, with handler registration, in a provided context

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: cdf801d69b3d Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De statische template-functie StartFindService start de continue, asynchrone zoektocht naar service-instanties aan de hand van een ara::core::InstanceSpecifier onder registratie van een meldingshandler in een doorgegeven uitvoeringscontext [SWS_CM_11365]. In tegenstelling tot synchrone eenmalige zoekopdrachten initieert deze een achtergrondactiviteit voor het bewaken van de servicebeschikbaarheid en geeft een ara::com::FindServiceHandle terug EXP_ARAComAPI §5.3 “Proxy Class APIs”.

Parameters en uitvoering

De functie accepteert drie parameters [SWS_CM_11365]:

  • handler: Callback-functie van het type ara::com::FindServiceHandler conform [SWS_CM_00123], die bij wijzigingen in de beschikbaarheid van instanties wordt aangeroepen.
  • instance: De te zoeken ara::core::InstanceSpecifier conform [SWS_CM_00123].
  • executor: Een uitvoeringscontext van het template-type ExecutorT conform [SWS_CM_11360]. Interpretatie: het template-argument ExecutorT bepaalt vermoedelijk in welke thread- of taakcontext de geregistreerde callback wordt uitgevoerd. Vraag Q-6d46f67d536a391e (open)

Foutafhandeling en randvoorwaarden

De signatuur is gedeclareerd als noexcept en gespecificeerd als exception safe [SWS_CM_11365]. Volgens de specificatie zijn functionele schendingen (Violations) gedefinieerd: InstanceSpecifierMappingIntegrityViolation (resolutie in executable-context mislukt of geen PortPrototype), PortInterfaceMappingViolation en ProcessMappingViolation (niet-overeenkomende PortInterface-mappings), InstanceSpecifierAlreadyInUseViolation, InvalidHandlerViolation (ongeldige of ontbrekende handler) evenals InsufficientPermissionsViolation bij ontbrekende toegangsrechten [SWS_CM_11365].

Samenspel

De verkregen FindServiceHandle dient om de lopende achtergrondbewaking door overdracht aan StopFindService gecontroleerd te beëindigen [SWS_CM_00125]. De aan de handler gemelde handles worden gebruikt om concrete service-proxy's middels Proxy(handle) te instantiëren [SWS_CM_00131]. Voor zoekopdrachten middels ara::com::InstanceIdentifier bestaat een alternatieve overload [SWS_CM_11352].

Deze tekst is opgesteld door een AI; deze vervangt niet de bestudering van de onderliggende AUTOSAR-specificatie.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe
Verletzungen (Violations)InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of the executable, or it refers to a model element other than tegrityViolation a PortPrototype. PortInterfaceMap- The type of mapping does not match the expected type of Port pingViolation Interface: ServiceInterface referenced by a ServiceInstanceToPortPrototypeMapping. ProcessMappingVio- The type of mapping does not match the expected type of Port lation Interface InstanceSpecifier- The constructor was called with an Instance Specifier already AlreadyInUseViola- tion InvalidHandlerVio- Provided Callable handler does not exist or is null lation InsufficientPer- Refused by Grant Enforcement missionsViolation

Template-Parameter

ParameterBeschreibung
ExecutorTAs per [SWS_CM_11360]

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_00123]
instanceAs per [SWS_CM_00123]
executorAs per [SWS_CM_11360]

Rückgabewert

TypBeschreibung
ara::com::FindServiceHandleAs per [SWS_CM_00123]

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11365
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11365@rel:R25-11#535b8411
Content hash
535b8411
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11365
Status: valid/unmigrated Version: rel:R25-11#53bcbb23 Versionshistorie & Revisions (1 transition, 4 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11365@rel:R25-11#53bcbb23
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#c0c22af02026-09-30
  • R23-11rel:R23-11#ef07eadd2026-10-14
  • R24-11rel:R24-11#203448af2026-10-14
  • R25-11rel:R25-11#53bcbb232026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie StopFindService [SWS_CM_00125] Upstream: RS_CM_00102, RS_AP_00114, RS_AP_00120, RS_AP_00121

void StopFindService (ara::com::FindServiceHandle handle) noexcept;

Stop an ongoing StartFindService() - Stops receiving further notifications for the provided ara::com::FindServiceHandle

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 5a542928a936 Herkomst
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De statische functie StopFindService van de proxy-klasse beëindigt een eerder met StartFindService gestarte asynchrone servicezoekopdracht en stopt de ontvangst van verdere meldingen voor de meegegeven handle [SWS_CM_00125]. Daarmee wordt de actieve achtergrondactiviteit voor het bewaken van de servicebeschikbaarheid door de technische binding beëindigd AP EXP ARAComAPI §5.3 “Proxy Class API’s”.

Gebruik en semantiek

Deze gebruiksinstructie is gegenereerd door een AI op basis van de specificatiedocumenten voor AUTOSAR Adaptive R25-11.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
handleThe ara::com::FindServiceHandle returned by StartFind Service methods: • [SWS_CM_00123] • [SWS_CM_00623] • [SWS_CM_11352] • [SWS_CM_11365]

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_00125
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00125@rel:R25-11#a47e2369
Content hash
a47e2369
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00125
Status: valid/unmigrated Version: rel:R25-11#e35ad180 Versionshistorie & Revisions (1 transition, 8 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_00125@rel:R25-11#e35ad180
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#a95890d12026-09-30
  • R19-11rel:R19-11#ceab02e62026-10-14
  • R20-11rel:R20-11#ceab02e62026-10-14
  • R21-11rel:R21-11#ceab02e62026-10-14
  • R22-11rel:R22-11#ceab02e62026-10-14
  • R23-11rel:R23-11#ceab02e62026-10-14
  • R24-11rel:R24-11#d8b592732026-10-14
  • R25-11rel:R25-11#e35ad1802026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie UnsetServiceStateChangeHandler [SWS_CM_01075]

void UnsetServiceStateChangeHandler () noexcept;
DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: bd7a765f57bb Herkomst Open vragen (2)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De lidfunctie UnsetServiceStateChangeHandler maakt deel uit van de gegenereerde proxy-klasse in de namespace <SI-Namespace>::proxy::<SI>Proxy conform [SWS_CM_01075] (AUTOSAR_AP_SWS_CommunicationManagement §8.3.8.2.4.12 “UnsetServiceStateChangeHandler”). Deze wordt via de header #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" ingevoegd.

Met betrekking tot gebruik, gedrag en gelijktijdigheid gelden de volgende bepalingen:

  • Gebruik: De methode heeft de signatuur void UnsetServiceStateChangeHandler() noexcept;. Deze accepteert geen parameters en levert geen retourwaarde op. Interpretatie: Volgens de identifier en de verwijzing naar [SWS_CM_01074] dient de aanroep voor het resetten respectievelijk afmelden van een eerder geregistreerde callback-handler voor servicetoestandswijzigingen op de proxy-instantie. Vraag Q-6eb71298a6f37ad9 (open)
  • Foutafhandeling en exception-veiligheid: De operatie is gedeclareerd als noexcept en gespecificeerd als exception safe ([SWS_CM_01075]). Deze werpt geen excepties op en meldt geen foutcodes terug aan de aanroeper.
  • Interactie en randvoorwaarden: De functionele semantiek verwijst naar de definitie in [SWS_CM_01074]. Interpretatie: De deregistratie zal vermoedelijk synchroon van kracht worden, zodat na terugkeer van de functieaanroep geen verdere toestandswisselingen via de eerdere callback worden afgeleverd. Vraag Q-31348a50d9be537d (open)

Deze gebruiksinstructie is door een AI gegenereerd op basis van de AUTOSAR-specificatie.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_01075
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_01075@rel:R25-11#8eac1b93
Content hash
8eac1b93
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_01075
Status: valid/unmigrated Version: rel:R25-11#9a8d00b1 Versionshistorie & Revisions (1 transition, 5 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_01075@rel:R25-11#9a8d00b1
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#acd5afba2026-09-30
  • R22-11rel:R22-11#266981b82026-10-14
  • R23-11rel:R23-11#7fa74f802026-10-14
  • R24-11rel:R24-11#0398d0122026-10-14
  • R25-11rel:R25-11#9a8d00b12026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie operator= [SWS_CM_11551] Upstream: RS_CM_00102, RS_AP_00114

<SI>Proxy & operator= (const <SI-Namespace>::proxy:: <SI>Proxy &other)=delete;

Copy assignment constructor deletion

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11551
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11551@rel:R25-11#ffb2076a
Content hash
ffb2076a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11551
Status: valid/unmigrated Version: rel:R25-11#d1bb516a Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11551@rel:R25-11#d1bb516a
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#48b1d1052026-09-30
  • R24-11rel:R24-11#53d4fe222026-10-14
  • R25-11rel:R25-11#d1bb516a2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

functie operator= [SWS_CM_11552] Upstream: RS_CM_00102, RS_AP_00114

<SI-Namespace>::proxy:: <SI>Proxy & operator= ( <SI-Namespace>::proxy:: <SI>Proxy &&other) noexcept;

Move assignment constructor

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
otherOther object to move

Rückgabewert

TypBeschreibung
<SI-Namespace>::proxy::{<service-interface-name> }Proxy &The moved object

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_11552
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11552@rel:R25-11#43d225c5
Content hash
43d225c5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11552
Status: valid/unmigrated Version: rel:R25-11#d00c3051 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_11552@rel:R25-11#d00c3051
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#e1e91d572026-09-30
  • R24-11rel:R24-11#743e1f3d2026-10-14
  • R25-11rel:R25-11#d00c30512026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

Documentatie van constanten / variabelen

variabele <Event> [SWS_CM_99445] Upstream: RS_CM_00201, RS_AP_00114

events::<Event> <Event>;

Event member, one for each VariableDataPrototype defined in the ServiceInterface in the role event.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Symbol<Event>
Typevents::<Event>

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_99445
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_99445@rel:R25-11#5a14e5b8
Content hash
5a14e5b8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_99445
Status: valid/unmigrated Version: rel:R25-11#9c64ddce Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_99445@rel:R25-11#9c64ddce
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#af3ce7b82026-09-30
  • R24-11rel:R24-11#fcd66cc52026-10-14
  • R25-11rel:R25-11#9c64ddce2026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variabele <Field> [SWS_CM_99446] Upstream: RS_CM_00216, RS_AP_00114

fields::<Field> <Field>;

Field member, one for each Field defined in the ServiceInterface in the role field.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Symbol<Field>
Typfields::<Field>

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_99446
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_99446@rel:R25-11#99cc6741
Content hash
99cc6741
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_99446
Status: valid/unmigrated Version: rel:R25-11#7b384735 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_99446@rel:R25-11#7b384735
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#44127f5b2026-09-30
  • R24-11rel:R24-11#f92e65aa2026-10-14
  • R25-11rel:R25-11#7b3847352026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

variabele <Method> [SWS_CM_99447] Upstream: RS_CM_00212, RS_CM_00213, RS_AP_00114

methods::<Method> <Method>;

Method member, one for each ClientServerOperation defined in the ServiceInterface in the role method.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::<SI>Proxy
Symbol<Method>
Typmethods::<Method>

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CM_99447
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_99447@rel:R25-11#5633fc41
Content hash
5633fc41
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_99447
Status: valid/unmigrated Version: rel:R25-11#798a90d2 Versionshistorie & Revisions (1 transition, 3 revision)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CM_99447@rel:R25-11#798a90d2
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#1d379a322026-09-30
  • R24-11rel:R24-11#a0578b1e2026-10-14
  • R25-11rel:R25-11#798a90d22026-10-14 active
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill