클래스 ara::diag::MultipleCondition

ara::diag::MultipleCondition 클래스는 숫자 핸들([SWS_DM_01730])을 사용하여 공통 포트 인터페이스를 통해 여러 진단 조건을 일괄적으로 쿼리하고 업데이트하는 데 사용됩니다. 애플리케이션은 InstanceSpecifier를 통해 객체를 인스턴스화하고 SetCondition 및 GetCondition([SWS_DM_01729])를 사용하여 조건을 목표에 맞게 제어합니다. 중요한 제약 조건으로 클래스는 복사 및 이동할 수 없으며 소멸자는 스레드 안전하지 않습니다. 또한 초기화 및 런타임 오류를 방지하기 위해 모델의 포트 매핑을 통해 주소 지정된 모든 조건이 일관되게 구성되어야 합니다.

자세히 ›

컨텍스트

ara::diag::MultipleCondition 클래스를 통해 어댑티브 애플리케이션은 공통 인터페이스([SWS_DM_01730])를 통해 여러 진단 조건을 일괄 관리하고 수정할 수 있습니다. 기능적 및 의미론적으로 개별 조건과 동일한 기능을 제공하지만, 식별 핸들(AUTOSAR_AP_SWS_Diagnostics 237쪽)을 통한 목표 지정 주소 지정을 포함하도록 작업을 확장합니다. 관리되는 각 진단 조건(DiagnosticCondition)은 모델에서 적절한 타입의 포트([SWS_DM_01727], AUTOSAR_AP_SWS_Diagnostics 237쪽)를 사용하는 DiagnosticMultipleConditionPortMapping를 통한 링크가 필요합니다. 주소 지정은 ConditionHandleType 타입을 통해 수행됩니다. 명시적인 overrideId 값이 없는 경우 Diagnostic Management(DM)는 짧은 이름([SWS_DM_01735])의 알파벳 순서로 0x010000부터 시작하여 오름차순 숫자 값을 할당합니다.

컨텍스트 다이어그램: 어댑티브 애플리케이션과 Diagnostic Management 간의 ara::diag::MultipleCondition 임베딩. 출처: [SWS_DM_01727], [SWS_DM_01728], AUTOSAR_AP_SWS_Diagnostics 237쪽

수명 주기

인스턴스는 ara::core::InstanceSpecifier를 전달하여 생성자 MultipleCondition를 통해 생성됩니다([SWS_DM_01727]). 생성은 스레드 안전하며 noexcept로 선언되어 있습니다([SWS_DM_01727]). 객체는 로컬 유효 범위에 엄격하게 바인딩됩니다. 복사 및 이동 작업이 모두 삭제되어 복사 생성자([SWS_DM_02072]), 이동 생성자([SWS_DM_02071]), 복사 대입 연산자([SWS_DM_02073]) 및 이동 대입 연산자([SWS_DM_02074])를 사용할 수 없습니다(=delete).

소멸자 ~MultipleCondition()는 명시적으로 스레드 안전하지 않은 것으로 지정되어 있습니다([SWS_DM_01737]). 따라서 애플리케이션은 파괴 전에 객체에 대한 모든 동시 액세스가 완료되었는지 확인해야 합니다. 일반 메서드 호출의 경우 조건부 스레드 안전성이 적용됩니다([SWS_DM_01728], [SWS_DM_01729]). 해석: [SWS_DM_01727]에 따른 생성자 시그니처가 명시적인 동시성 매개변수를 허용하지 않으므로, 요구되는 ConcurrencyType는 매니페스트의 기본 포트 모델을 통해 결정될 것으로 추정됩니다. 질문 Q-f29def512a68aae9 (열림)

사용 경로

진단 조건과의 상호 작용 시 일반적인 워크플로는 다음 단계로 구성됩니다:

1. 초기화: 애플리케이션은 대상 포트를 지정하여 클래스를 인스턴스화합니다([SWS_DM_01727]).
2. 상태 설정: SetCondition(conditionHandle, condition)를 사용하여 애플리케이션은 지정된 조건에 대한 상태 변경을 전송하고 결과 ara::core::Result<void>를 확인합니다([SWS_DM_01729]).
3. 상태 조회: GetCondition(conditionHandle)를 통해 주소 지정된 조건의 현재 상태가 ara::core::Future<ConditionType>로 비동기 요청됩니다([SWS_DM_01728]).
4. 리소스 해제: 유효 범위를 벗어날 때 소멸자가 인터페이스를 질서 있게 해제합니다([SWS_DM_01737]).

시퀀스 다이어그램: MultipleCondition을 통한 조건 관리 시 호출 및 응답 패턴. 출처: [SWS_DM_01727], [SWS_DM_01728], [SWS_DM_01729], [SWS_DM_01737]

오류 시나리오

사용 시 모델링으로 인한 구성 오류와 기능적 런타임 오류를 구별해야 합니다:

• 생성 위반 ([SWS_DM_01727]): InstanceSpecifier 해석에 실패하거나 이것이 PortPrototype(을)를 가리키지 않는 경우 InstanceSpecifierMappingIntegrityViolation(이)가 보고됩니다. 포트가 DiagnosticMultipleConditionInterface(으)로 유형화되지 않은 경우 PortInterfaceMappingViolation(이)가 발생합니다. 프로세스에 모델링된 대응 항목이 없는 경우 ProcessMappingViolation(이)가 발생합니다. 동일한 InstanceSpecifier(이)가 프로세스 내에서 여러 번 인스턴스화되면 InstanceSpecifierAlreadyInUseViolation(이)가 발생합니다.
• 메서드 호출 시 런타임 오류:\n SetCondition([SWS_DM_01729]) 또는 GetCondition([SWS_DM_01728])에 유효하지 않은 매개변수나 유효하지 않은 핸들이 전달되면 메서드는 오류 DiagErrc::kInvalidArgument를 반환합니다. Diagnostic Management의 기본 기능에 일시적으로 연결할 수 없는 경우 GetCondition는 호출을 DiagErrc::kServiceNotAvailable로 확인합니다([SWS_DM_01728]).