구조체 ara::com::FindServiceHandle

[SWS_CM_00303] Upstream: RS_CM_00102

struct FindServiceHandle {...};

The exact definition of ara::com::FindServiceHandle is Communication Management implementation specific. ara::com::FindServiceHandle satisfies the [equalitycomparable] and [lessthancomparable] requirements as per [30] to allow storing and managing ara::com::FindServiceHandles by the application.

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei	#include "ara/com/service/find_service_handle.h"
Forwarding-Header	#include "ara/com/com_fwd.h"
Scope	namespace ara::com

사용자 가이드AI 생성

진행 중인 비동기 백그라운드 서비스 인스턴스 검색을 관리하고 중지하기 위한 제어 토큰 역할을 합니다.

AI 생성 미검증 모델: gemini-3.8-flash-medium · 노력: medium · 온도: 제어 불가 · 프롬프트: eb9ee1985b4b 출처 열린 질문 (1)

독일어 가이드에서 번역됨gemini-3.8-flash-low · 2026-10-13 · 독일어 원문

진행 중인 비동기 백그라운드 서비스 인스턴스 검색을 관리하고 중지하기 위한 제어 토큰 역할을 합니다.

구조체 ara::com::FindServiceHandle은(는) 백그라운드에서 실행되는 서비스 모니터링을 제어하기 위한 고유한 제어 토큰 역할을 합니다(AUTOSAR_AP_EXP_ARAComAPI 34쪽). 기본 생성자가 삭제되었으므로([SWS_CM_00353]), 핸들은 StartFindService에 의해서만 생성되며, 비동기 상태 콜백을 수신한 후 StopFindService을(를) 통해 검색을 의도적으로 중지할 수 있도록 합니다(AUTOSAR_AP_EXP_ARAComAPI 30쪽). 또한 지원되는 비교 연산자를 통해 표준 컨테이너에서 여러 검색 요청을 저장하여 관리할 수 있습니다([SWS_CM_11526], [SWS_CM_11527]).

컨텍스트

구조체 ara::com::FindServiceHandle은(는) Adaptive Platform의 com 모듈에서 비동기적이고 지속적인 서비스 검색을 위한 고유 식별자이자 제어 토큰으로 기능합니다. FindService을(를) 통한 동기 쿼리가 일치하는 서비스 인스턴스를 한 번 확인하고 핸들 컨테이너를 직접 반환하는 반면, StartFindService은(는) 백그라운드에서 서비스 가용성에 대한 지속적인 모니터링을 시작합니다(AUTOSAR_AP_EXP_ARAComAPI 34쪽). 이 프로세스에는 일반적으로 애플리케이션 인스턴스, 타입별 프록시 클래스(예: RadarServiceProxy) 및 FindServiceHandler 타입의 사용자 정의 콜백 함수가 참여합니다(AUTOSAR_AP_EXP_ARAComAPI 30쪽). ara::com::FindServiceHandle의 구체적인 내부 표현은 각 Communication Management에 맞춰 구현별로 설계되지만, 처리를 위한 표준화된 C++ 인터페이스를 제공합니다.

수명 주기

ara::com::FindServiceHandle의 수명 주기는 Communication Management의 활성 검색 작업과 밀접하게 결합되어 있습니다:

생성: 기본 생성자는 명시적으로 삭제되었습니다([SWS_CM_00353]). 따라서 애플리케이션은 핸들 인스턴스를 초기화되지 않은 상태로 생성하거나 임의로 생성할 수 없습니다. 대신 유효한 핸들은 정적 메서드 StartFindService에 의해 ara::core::Result의 페이로드로서만 생성됩니다(AUTOSAR_AP_EXP_ARAComAPI 30쪽).
관리 및 소유권: 핸들은 복사 할당 연산자 [SWS_CM_11528]을(를) 통한 할당을 지원합니다. 애플리케이션이 표준 컨테이너(예: 정렬된 집합 또는 연관 메모리)에 여러 검색 작업을 저장하고 구성할 수 있도록, 이 타입은 연산자 operator==([SWS_CM_11526]) 및 operator<([SWS_CM_11527])을(를) 통해 C++ 개념 [equalitycomparable] 및 [lessthancomparable]을(를) 충족합니다.
종료 및 소멸: 핸들은 백그라운드 모니터링이 활성 상태인 동안 유효성을 유지합니다. 검색 종료는 핸들을 StopFindService에 전달하여 수행됩니다(AUTOSAR_AP_EXP_ARAComAPI 30쪽, AUTOSAR_AP_EXP_ARAComAPI 34쪽). 이 호출 이후 핸들은 더 이상 실행 중인 검색 프로세스를 나타내지 않습니다.

사용 경로

정상적인 흐름에는 검색 작업 등록, 지속적인 가용성 업데이트 수신 및 모니터링 프로세스의 질서 있는 정지가 포함됩니다:

검색 시작: 애플리케이션은 새로 사용 가능해지거나 제거되는 서비스 인스턴스에 대한 정보를 받기 위해 StartFindService을(를) 통해 FindServiceHandler을(를) 등록합니다(AUTOSAR_AP_EXP_ARAComAPI 30쪽, AUTOSAR_AP_EXP_ARAComAPI 34쪽).
핸들 획득: 성공적으로 시작되면 호출은 FindServiceHandle이(가) 포함된 ara::core::Result을(를) 반환하며(AUTOSAR_AP_EXP_ARAComAPI 30쪽), 애플리케이션은 이후의 제어 호출을 위해 이를 보관합니다.
비동기 알림: Communication Management는 백그라운드 검색을 수행하고 상태 변경 시 제공된 핸들러를 호출합니다(AUTOSAR_AP_EXP_ARAComAPI 34쪽).
검색 정지: 인스턴스를 찾았거나 모니터링이 더 이상 필요하지 않으면 애플리케이션은 핸들을 StopFindService에 전달합니다(AUTOSAR_AP_EXP_ARAComAPI 30쪽, AUTOSAR_AP_EXP_ARAComAPI 34쪽).

시퀀스 다이어그램: 등록부터 알림을 거쳐 FindServiceHandle을 통한 종료까지의 일반적인 비동기 서비스 검색 흐름. 출처: AUTOSAR_AP_EXP_ARAComAPI 30쪽, AUTOSAR_AP_EXP_ARAComAPI 34쪽.

오류 시나리오

ara::com::FindServiceHandle 사용 시 다음과 같은 시스템별 제약 조건에 유의해야 합니다:

검색 시작 실패: 기술적 바인딩을 사용할 수 없거나 서비스 배포 구성에 오류가 있는 경우(AUTOSAR_AP_EXP_ARAComAPI 34쪽), StartFindService이(가) 실패합니다. 이 경우 반환된 ara::core::Result에는 유효한 핸들 대신 오류 코드가 포함됩니다(AUTOSAR_AP_EXP_ARAComAPI 30쪽).
예외 안전성: 구현된 비교 및 할당 연산자 operator==([SWS_CM_11526]), operator<([SWS_CM_11527]) 및 operator=([SWS_CM_11528])은(는) 명세에서 명시적으로 예외 안전하지 않은 것(not exception safe)으로 선언되어 있습니다.
다중 정지: 동일한 핸들로 StopFindService을(를) 반복 호출하는 것은 기본 모니터링 활동이 이미 제거되었으므로 아무런 효과가 없거나 런타임 오류를 유발할 것으로 추정됩니다. 질문 Q-f44130c33fa1caea (열림)

이 가이드는 Adaptive Platform용 AUTOSAR 명세(Release R25-11)를 기반으로 합니다. 제시된 인터페이스 및 동작은 참조된 SWS 요구사항 및 API 설명을 기반으로 합니다.

멤버 맵

생성자 및 소멸자

FindServiceHandle

연산자

operator<operator=operator==

클래스 다이어그램

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

상세 보기

개요에서 항목을 선택하세요.

이 릴리스에 대한 요소 데이터가 없습니다

생성자 및 소멸자

FindServiceHandle 함수

Default constructor deletion

FindServiceHandle ()=delete;

연산자

operator< 함수

LessThan operator as per [lessthancomparable] in [30]

bool operator< (const FindServiceHandle &other) const;

operator= 함수

Copy assignment constructor

FindServiceHandle & operator= (const FindServiceHandle &other);

operator== 함수

Equality operator as per [equalitycomparable] in [30]

bool operator== (const FindServiceHandle &other) const;

항목을 클릭하면 관계가 표시됩니다.

메서드 문서

함수 FindServiceHandle [SWS_CM_00353] Upstream: RS_AP_00146

FindServiceHandle ()=delete;

Default constructor deletion

Header-Datei	#include "ara/com/service/find_service_handle.h"
Scope	struct ara::com::FindServiceHandle

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

Record: AUTOSAR/AP/record/SWS_CM_00353
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_00353@rel:R25-11#63f665a4
Content hash: 63f665a4
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00353

Status: valid/unmigrated Version: rel:R25-11#8a450052 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_00353@rel:R25-11#8a450052

Recorded Revisions (4):

R25-11rel:R25-11#b1f430d12026-09-30
R23-11rel:R23-11#604163032026-10-14
R24-11rel:R24-11#8a4500522026-10-14
R25-11rel:R25-11#8a4500522026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 operator< [SWS_CM_11527]

bool operator< (const FindServiceHandle &other) const;

LessThan operator as per [lessthancomparable] in [30]

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei	#include "ara/com/service/find_service_handle.h"
Scope	struct ara::com::FindServiceHandle
Exception-Sicherheit	not exception safe

Parameter (in)

Parameter	Beschreibung
other	Other ara::com::FindServiceHandle to compare

Rückgabewert

Typ	Beschreibung
bool	TRUE if other is less than *this, FALSE otherwise.

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

Record: AUTOSAR/AP/record/SWS_CM_11527
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11527@rel:R25-11#12af7c38
Content hash: 12af7c38
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11527

Status: valid/unmigrated Version: rel:R25-11#b1ec1ec0 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_11527@rel:R25-11#b1ec1ec0

Recorded Revisions (3):

R25-11rel:R25-11#9b3fc18e2026-09-30
R24-11rel:R24-11#2bb55cbe2026-10-14
R25-11rel:R25-11#b1ec1ec02026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 operator= [SWS_CM_11528]

FindServiceHandle & operator= (const FindServiceHandle &other);

Copy assignment constructor

Header-Datei	#include "ara/com/service/find_service_handle.h"
Scope	struct ara::com::FindServiceHandle
Exception-Sicherheit	not exception safe

Parameter (in)

Parameter	Beschreibung
other	Other ara::com::FindServiceHandle to copy

Rückgabewert

Typ	Beschreibung
FindServiceHandle &	New ara::com::FindServiceHandle

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

Record: AUTOSAR/AP/record/SWS_CM_11528
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11528@rel:R25-11#d64f4240
Content hash: d64f4240
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11528

Status: valid/unmigrated Version: rel:R25-11#847556b4 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_11528@rel:R25-11#847556b4

Recorded Revisions (3):

R25-11rel:R25-11#414d7a6c2026-09-30
R24-11rel:R24-11#f73bf3482026-10-14
R25-11rel:R25-11#847556b42026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

함수 operator== [SWS_CM_11526]

bool operator== (const FindServiceHandle &other) const;

Equality operator as per [equalitycomparable] in [30]

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei	#include "ara/com/service/find_service_handle.h"
Scope	struct ara::com::FindServiceHandle
Exception-Sicherheit	not exception safe

Parameter (in)

Parameter	Beschreibung
other	Other ara::com::FindServiceHandle to compare

Rückgabewert

Typ	Beschreibung
bool	TRUE if other is equal to *this, FALSE otherwise.

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

Record: AUTOSAR/AP/record/SWS_CM_11526
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CM_11526@rel:R25-11#8878d763
Content hash: 8878d763
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11526

Status: valid/unmigrated Version: rel:R25-11#d2ea98ee 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_11526@rel:R25-11#d2ea98ee

Recorded Revisions (3):

R25-11rel:R25-11#d9c8643c2026-09-30
R24-11rel:R24-11#491d93d72026-10-14
R25-11rel:R25-11#d2ea98ee2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

구조체 ara::com::FindServiceHandle

사용자 가이드AI 생성

컨텍스트

수명 주기

사용 경로

오류 시나리오

멤버 맵

생성자 및 소멸자

연산자

클래스 다이어그램

상세 보기

생성자 및 소멸자

연산자

메서드 문서

함수 FindServiceHandle [SWS_CM_00353] Upstream: RS_AP_00146

Recorded Revisions (4):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 operator< [SWS_CM_11527]

Parameter (in)

Rückgabewert

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 operator= [SWS_CM_11528]

Parameter (in)

Rückgabewert

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 operator== [SWS_CM_11526]

Parameter (in)

Rückgabewert

Recorded Revisions (3):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: