구조체 ara::diag::FileTransferService::FileSizes

구조체 ara::diag::FileTransferService::FileSizes은(는) AUTOSAR Adaptive Platform의 진단 모듈 내에서 파일 크기 정보를 캡슐화하기 위한 표준화된 값 객체(Value Object) 역할을 합니다[SWS_DM_01321]. 이 구조체는 전송 작업의 준비 및 모니터링을 위해 파일의 비압축 및 압축 바이트 크기를 두 개의 퍼블릭 64비트 정수 변수로 묶습니다[SWS_DM_01322]. 수동적인 레코드로서 이 구조체는 자체 메서드나 내부 오류 처리를 포함하지 않으므로, 전달된 값의 타당성 검사 및 스레드 안전성은 호출 컴포넌트에서 보장해야 합니다.

자세히 ›

컨텍스트

구조체 ara::diag::FileTransferService::FileSizes은(는) AUTOSAR Adaptive Platform의 진단 모듈(diag)의 필수 구성 요소입니다[SWS_DM_01321]. 상위 서비스 ara::diag::FileTransferService의 네임스페이스 내에서 전체 파일 크기 정보를 표현하기 위한 컴팩트한 데이터 모델을 정의합니다AUTOSAR_AP_SWS_Diagnostics §8.18.2 “Struct: FileSizes”. 이 형식은 헤더 파일 ara/diag/file_transfer.h을(를) 통해 선언됩니다[SWS_DM_01322]. 주요 역할은 상호작용하는 플랫폼 및 애플리케이션 컴포넌트가 파일 크기를 일관되게 교환할 수 있도록 파일 전송 작업과 관련된 크기 정보를 통일된 데이터 구조로 묶는 것입니다AUTOSAR_AP_SWS_Diagnostics 1126쪽.

기능적으로 이 데이터 구조는 두 가지 고유한 크기 정보를 기록합니다. 요소 uncompressed_size을(를) 통한 파일의 비압축 총 크기[SWS_DM_01322]와 요소 compressed_size을(를) 통한 압축 총 크기[SWS_DM_01323]입니다. 두 값 모두 부호 없는 64비트 정수(std::uint64_t)로 바이트 단위로 관리됩니다. 이를 통해 FileSizes은(는) 진단 클라이언트, Diagnostic Management, 그리고 Adaptive Platform에서 파일 전송을 처리하는 구체적인 서비스 제공자 간의 시맨틱 정보 전달자 역할을 합니다.

수명 주기

구조체 ara::diag::FileTransferService::FileSizes은(는) 자체 가상 메서드나 복잡한 상속 계층이 없는 순수 데이터 레코드(Value Object)로 모델링되었습니다AUTOSAR_AP_SWS_Diagnostics §8.18.2.1 “Public Member Variables”. 생성은 일반적으로 호출 스택에서 직접 이루어지거나 상위 데이터 구조의 멤버로 이루어집니다. 표준 정수 형식만 포함되어 있으므로 구조체는 기본적으로 복사 및 이동이 모두 가능하며 힙에서의 동적 메모리 관리를 필요로 하지 않을 것으로 보입니다. 질문 Q-f9c6e76fc8c62463 (열림)

소유권 관계는 각각의 사용 컨텍스트에 따라 결정됩니다. 진단 애플리케이션에서 인스턴스를 생성하는 경우 소유권은 해당 애플리케이션에 유지되거나 값 전달(Pass-by-Value)을 통해 호출된 인터페이스 함수로 이전됩니다. 인스턴스의 소멸은 사소하며 추가적인 정리 로직 없이 스코프(Scope)를 벗어남과 동시에 자동으로 수행됩니다. 이 형식은 내부 동기화 메커니즘을 제공하지 않으므로, 동일한 인스턴스에 대한 동시 액세스 시 조정되고 스레드 안전한 사용은 참여하는 진단 또는 애플리케이션 컴포넌트의 책임일 것으로 추정됩니다. 질문 Q-d2e83f9098c7f8c8 (열림)

사용 경로

구조체의 일반적인 사용은 초기화, 매개변수 할당 및 FileTransferService[SWS_DM_01321]의 전송 루틴으로의 전달 단계로 나뉩니다. 일반적인 사용 사례에서는 송신 컴포넌트가 파일 전송을 시작하기 전에 파일 시스템이나 메모리에서 실제 파일 크기를 확인합니다. 그런 다음 FileSizes을(를) 인스턴스화하고 측정된 바이트 값을 두 퍼블릭 변수에 할당합니다:

• uncompressed_size: 원본 파일의 절대 크기를 바이트 단위로 지정합니다[SWS_DM_01322].
• compressed_size: 전송할 데이터 스트림의 압축 크기를 바이트 단위로 지정합니다[SWS_DM_01323].

사전 압축 없이 파일을 전송하는 경우 compressed_size과(와) uncompressed_size은(는) 동일한 값을 가질 것으로 추정됩니다. 질문 Q-1edcb924fd5932ee (열림) 초기화 후 상대 측에서 메모리 요구량을 사전에 할당하고 전송 진행률을 정확하게 모니터링할 수 있도록 구조체가 해당 파일 전송 메서드로 전달됩니다AUTOSAR_AP_SWS_Diagnostics 77쪽.

오류 시나리오

ara::diag::FileTransferService::FileSizes의 사양에는 자체 진단 오류 코드, 반환 값 또는 예외가 정의되어 있지 않습니다AUTOSAR_AP_SWS_Diagnostics §8.18.2 “Struct: FileSizes”. 수동적인 데이터 형식으로서 구조체 자체는 오류 메시지를 트리거하지 않으며 런타임에 입력된 값을 검증하지도 않습니다.

오류 가능성은 주로 매개변수 채우기 시의 잘못된 사전 및 사후 조건에서 비롯됩니다. 형식 std::uint64_t을(를) 통해 최대 $2^{64}-1$ 바이트까지의 값을 나타낼 수 있습니다[SWS_DM_01322], [SWS_DM_01323]. 존재하는 파일에 대해 0바이트 값을 전달하거나 타당한 설명 없이 압축 크기가 비압축 크기를 대폭 초과하는 등 컴포넌트가 비합리적인 크기를 전달하는 경우, 이는 FileTransferService의 사전 또는 사후 처리 로직에 의해 포착되어야 합니다. 또한 사용 가능한 대상 메모리의 오버플로 역시 상위 수준의 오류 시나리오를 나타내며, 이는 데이터 전송을 시작하기 전에 FileSizes에서 전달된 바이트 값을 기반으로 감지되어야 합니다.