클래스 ara::rds::ReadDataResult

ara::rds::ReadDataResult 구조체는 AUTOSAR Adaptive Platform의 원시 데이터 스트림(AUTOSAR_AP_SWS_RawDataStream, 1쪽)에서 수행된 읽기 작업의 결과를 캡슐화합니다. 이 구조체는 ReadData 메서드에 의해 생성되며, 실제 바이트 수 numberOfBytes와(과) 함께 버퍼 data의 읽은 바이너리 데이터를 제공합니다 [SWS_RDS_11301]. 버퍼가 std::unique_ptr(으)로 관리되므로 구조체는 아마도 호출자에게 독점 소유권을 이전하고 복사를 배제할 것입니다. 질문 (열림) 오류는 이를 감싸는 ara::core::Result을(를) 통해 보고되므로 데이터에 접근하기 전에 결과의 유효성을 검사해야 합니다.

자세히 ›

컨텍스트

ara::rds::ReadDataResult 클래스는 AUTOSAR Adaptive Platform의 rds(RawDataStream) 모듈에서 데이터 스트림(AUTOSAR_AP_SWS_RawDataStream, 1쪽)의 데이터 조회 작업을 위한 구조화된 결과 컨테이너 역할을 합니다. 주된 책임은 원시 데이터 스트림에서 읽은 원시 데이터 바이트를 실제로 전송된 바이트 수와 함께 호출 애플리케이션에 전달하는 것입니다. 시스템 구성 내의 상호작용 파트너로는 읽기 메서드 ReadData을(를) 제공하는 스트림 인스턴스와 데이터 스트림을 평가하고 데이터를 추가 처리하는 각 애플리케이션 컴포넌트가 있습니다 [SWS_RDS_10486], [SWS_RDS_11322].

수명 주기

ara::rds::ReadDataResult의 인스턴스는 동기식 또는 시간 제한식 읽기 작업 중에 생성됩니다. 생성은 호출자가 ReadData(std::size_t maxLength) [SWS_RDS_10486], [SWS_RDS_11322] 메서드 또는 시간 모니터링이 포함된 오버로드 ReadData(std::size_t maxLength, std::chrono::milliseconds timeout) [SWS_RDS_11309], [SWS_RDS_11323]을(를) 호출할 때 시작됩니다.

소유권과 메모리 수명 주기는 std::unique_ptr<ara::core::Byte[]>(으)로 선언된 포함 데이터 요소 data에 의해 결정적으로 좌우됩니다 [SWS_RDS_11301]. 이는 일반적인 C++ 해석에 따르면 ReadDataResult이(가) 이동 전용 타입으로 설계되어 복사할 수 없고 배타적으로 이동만 가능함을 의미할 것으로 추정됩니다. 질문 Q-fe4b113c5852b5aa (열림) 호출 프로그램은 객체를 수신함으로써 할당된 데이터 버퍼에 대한 단독 소유권을 인수합니다. 포인터가 이전에 객체에서 명시적으로 추출되지 않은 경우 인스턴스가 소멸되면 바이트 배열의 예약된 힙 메모리가 자동으로 해제됩니다. 동시성과 관련하여 내부 동기화는 존재하지 않으며, 외부 잠금 없이 여러 스레드에서 인스턴스에 동시 접근하는 것은 스레드 안전하지 않습니다.

사용 경로

ara::rds::ReadDataResult을(를) 사용하기 위한 정규 흐름은 다음 세부 단계로 나뉩니다:

• 읽기 작업 요청: 애플리케이션은 스트림에서 원하는 최대 데이터 양 maxLength을(를) 지정하여 ReadData을(를) 호출하며 [SWS_RDS_10486], [SWS_RDS_11322], 선택적으로 타임아웃 값 [SWS_RDS_11309], [SWS_RDS_11323]이(가) 추가될 수 있습니다.
• 결과 컨테이너 반환: 스트림은 채널에서 바이너리 데이터를 읽고 성공 시 ara::core::Result<ReadDataResult> 타입의 채워진 객체를 반환합니다 (AUTOSAR_AP_SWS_RawDataStream, 1쪽).
• 크기 확인: 애플리케이션이 numberOfBytes 필드를 읽습니다 [SWS_RDS_11302]. 해석: 이 값은 버퍼에 실제로 제공된 바이트 양을 나타낼 것으로 추정되며, 요청된 maxLength보다 작거나 같을 수 있습니다. 질문 Q-12bde8c67452a632 (열림)
• 데이터 처리: 버퍼 data이(가) 역참조되어 [SWS_RDS_11301] 수신된 바이트를 처리하거나 이동 시맨틱을 통해 애플리케이션 자체 구조체로 전송합니다.

시퀀스 다이어그램: ReadDataResult의 수신 및 평가를 포함한 읽기 작업의 전형적인 흐름. 출처: [SWS_RDS_10486], [SWS_RDS_11301], [SWS_RDS_11302], AUTOSAR_AP_SWS_RawDataStream, 1쪽

오류 시나리오

ReadDataResult을(를) 생성하는 메서드는 noexcept(으)로 선언되어 있어 [SWS_RDS_10486], [SWS_RDS_11309], [SWS_RDS_11322], [SWS_RDS_11323] 오류 발생 시 C++ 예외가 발생하지 않습니다. 대신 오류 처리는 반환 객체 ara::core::Result을(를) 통해 완전히 처리됩니다 (AUTOSAR_AP_SWS_RawDataStream, 1쪽).

전형적인 오류 시나리오로는 스트림 중단, 유효하지 않은 읽기 요청, 또는 시간 모니터링 방식의 읽기 호출 시 대기 시간 초과 등이 있습니다 [SWS_RDS_11309], [SWS_RDS_11323]. 해석: 이러한 실패 시 ara::core::Result에는 유효한 ReadDataResult 객체가 포함되지 않고 대신 해당 오류 코드가 포함될 것으로 추정됩니다. 질문 Q-f3f971c4789fe8e7 (열림) 애플리케이션의 경우 이는 초기화되지 않은 포인터나 유효하지 않은 메모리 영역에 접근하는 것을 방지하기 위해 data [SWS_RDS_11301] 및 numberOfBytes [SWS_RDS_11302]에 접근하기 위한 사전 조건으로서 항상 먼저 상위 Result 객체의 성공 상태를 확인해야 함을 의미합니다.