클래스 ara::diag::DiagnosticSovdContentElementDataWithKey

[SWS_DM_02375] Upstream: RS_Diag_04260

class DiagnosticSovdContentElementDataWithKey {...};

A DiagnosticSovdContentElementData with associated key.

Header-Datei	#include "ara/diag/diagnostic_sovd_content_element_data.h"
Forwarding-Header	#include "ara/diag/diag_fwd.h"
Scope	namespace ara::diag

사용자 가이드AI 생성

읽기 및 쓰기 작업을 위해 키 식별자와 함께 SOVD 진단 콘텐츠 요소를 캡슐화합니다.

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

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

읽기 및 쓰기 작업을 위해 키 식별자와 함께 SOVD 진단 콘텐츠 요소를 캡슐화합니다.

이 클래스는 고유한 키 식별자와 함께 SOVD 진단 콘텐츠 요소를 캡슐화하는 데 사용됩니다 [SWS_DM_02375]. ASAM SOVD에 따른 쓰기 액세스 시 Diagnostic Management에 의해 채워져 GenericDiagnosticSovdContent::Write(으)로 전달됩니다 [SWS_DM_02166]. 모든 멤버 함수는 스레드 안전하고 예외에 안전하게 명시되어 있으며, 잘못된 대입은 ara::core::Result을(를) 통해 DiagErrc::kInvalidArgument(으)로 보고됩니다 [SWS_DM_02381].

컨텍스트

ara::diag::DiagnosticSovdContentElementDataWithKey 클래스는 Adaptive Platform 내에서 ASAM SOVD(Service-Oriented Vehicle Diagnostics) 맥락의 단일 진단 콘텐츠 요소를 위한 데이터 캡슐 역할을 하며, 페이로드 데이터 객체에 고유한 키 식별자를 할당합니다 [SWS_DM_02375]. SOVD 데이터는 최소 하나의 DiagnosticSovdContentElement(으)로 구성된 DiagnosticSovdContent 모델 요소를 통해 구조화됩니다 AUTOSAR_AP_SWS_Diagnostics §7.3.3.3.2 “SOVD Data – Conversion”. 읽기 쿼리는 GenericDiagnosticSovdContent::Read을(를) 통해 처리되는 반면 [SWS_DM_01432], 이 클래스는 데이터 리소스에 대한 구조화된 쓰기 액세스를 수행하기 위해 주로 Diagnostic Management(DM) 및 서비스 인터페이스 GenericDiagnosticSovdContent::Write와(과) 상호작용합니다 [SWS_DM_01431], [SWS_DM_02166].

수명 주기

ara::diag::DiagnosticSovdContentElementDataWithKey의 인스턴스화 및 제거는 RAII 원칙을 준수하여 수행됩니다. 소멸자 및 관련 복사/이동 작업(이동/복사 생성자 및 대입 연산자)은 명시적으로 noexcept(으)로 선언되어 있습니다 [SWS_DM_02376]. 소유권과 관련하여, 클래스는 SetContent에서 값 전달을 통해 페이로드 콘텐츠를 인수하는 반면 [SWS_DM_02381], 키 이름은 ara::core::StringView(으)로 전달됩니다 [SWS_DM_02378]. Diagnostic Management는 내부적으로 액세스 중에 기본 문자열이 유효하게 유지되거나 내부 메모리로 복사되도록 보장할 것으로 보입니다. 질문 Q-f00f62f43629a773 (열림) 사양에 따르면 클래스의 모든 멤버 함수는 스레드 안전하고 예외에 안전하게 설계되었습니다 [SWS_DM_02376], [SWS_DM_02377], [SWS_DM_02378], [SWS_DM_02379], [SWS_DM_02380], [SWS_DM_02381].

사용 경로

전형적인 사용 경로는 엔티티 데이터 리소스에 대한 SOVD 쓰기 요청을 수신할 때 발생합니다 [SWS_DM_01431]. Diagnostic Management는 인스턴스를 생성하거나 사용하며, 먼저 SetName을(를) 사용하여 각 DiagnosticSovdContentElement의 shortName을(를) 설정합니다 [SWS_DM_02166], [SWS_DM_02378]. 그런 다음 수신된 값은 변환 규칙에 따라 변환되고 AUTOSAR_AP_SWS_Diagnostics §7.3.3.3.2 “SOVD Data – Conversion”, SetContent을(를) 통해 대입됩니다 [SWS_DM_02166], [SWS_DM_02381]. 이렇게 집계된 데이터는 이후 GenericDiagnosticSovdContent::Write(으)로 전달됩니다 [SWS_DM_02166]. 소비자는 GetName을(를) 통해 키 이름을 쿼리할 수 있으며 [SWS_DM_02377], GetContent의 상수 또는 비상수 오버로드를 통해 데이터 콘텐츠를 검사하거나 조작할 수 있습니다 [SWS_DM_02379], [SWS_DM_02380].

시퀀스 다이어그램: DiagnosticSovdContentElementDataWithKey를 사용하는 SOVD 쓰기 요청 처리 시 호출 및 데이터 흐름. 출처: [SWS_DM_01431], [SWS_DM_02166], [SWS_DM_02378], [SWS_DM_02381].

오류 시나리오

오류 발생 시 클래스는 C++ 예외를 사용하지 않고 대신 SetContent의 반환 타입 ara::core::Result<void>을(를) 통해 실패를 보고합니다 [SWS_DM_02381]. 전달된 콘텐츠 타입이 대상 구조와 일치하지 않거나 유효하지 않은 경우와 같이 콘텐츠 설정에 실패하면 오류 코드 DiagErrc::kInvalidArgument이(가) 반환됩니다 [SWS_DM_02381]. 호출자는 객체를 GenericDiagnosticSovdContent::Write에 전달하기 전에 반환된 결과를 확인해야 합니다 [SWS_DM_02166].

이 클래스 가이드는 AUTOSAR AP Release R25-11 사양을 기반으로 합니다. 모든 진술은 SWS 요구사항 및 ara::diag 인터페이스의 문서 위치에 의해 뒷받침됩니다.

멤버 맵

생성자 및 소멸자

~DiagnosticSovdContentElementDataWithKey

메서드

GetContent GetName SetContent SetName

클래스 다이어그램

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

상세 보기

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

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

생성자 및 소멸자

~DiagnosticSovdContentElementDataWithKey 함수

Declare the Dtor and move/copy constructors/assignments .

~DiagnosticSovdContentElementDataWithKey () noexcept;

메서드

GetContent 함수 2

Gets the associated content.

오버로드 GetContent 2

auto GetContent () noexcept -> DiagnosticSovdContentElementData &; SWS_DM_02379

auto GetContent () const noexcept -> DiagnosticSovdContentElementData const &; SWS_DM_02380

GetName 함수

Gets the name of the key.

auto GetName () const noexcept -> ara::core::StringView;

SetContent 함수

Sets the associated content.

auto SetContent (DiagnosticSovdContentElementData content) noexcept -> ara::core::Result< void >;

SetName 함수

Sets the name of the key.

void SetName (ara::core::StringView name) noexcept;

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

메서드 문서

함수 GetContent [SWS_DM_02379] Upstream: RS_Diag_04260

auto GetContent () noexcept -> DiagnosticSovdContentElementData &;

Gets the associated content.

Header-Datei	#include "ara/diag/diagnostic_sovd_content_element_data.h"
Scope	class ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
DiagnosticSovdContentElementData	Reference to the associated content

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

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

Status: valid/unmigrated Version: rel:R25-11#9baa2f7d Versionshistorie & Revisions (1 transition)

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_DM_02379@rel:R25-11#9baa2f7d

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

함수 GetContent [SWS_DM_02380] Upstream: RS_Diag_04260

auto GetContent () const noexcept -> DiagnosticSovdContentElementData const &;

Gets the associated content.

Header-Datei	#include "ara/diag/diagnostic_sovd_content_element_data.h"
Scope	class ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
DiagnosticSovdContent	Reference to the associated content ElementData const

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

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

Status: valid/unmigrated Version: rel:R25-11#95b7050b Versionshistorie & Revisions (1 transition)

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_DM_02380@rel:R25-11#95b7050b

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

함수 GetName [SWS_DM_02377] Upstream: RS_Diag_04260

auto GetName () const noexcept -> ara::core::StringView;

Gets the name of the key.

Header-Datei	#include "ara/diag/diagnostic_sovd_content_element_data.h"
Scope	class ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Rückgabewert

Typ	Beschreibung
ara::core::StringView	The name of the key

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

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

Status: valid/unmigrated Version: rel:R25-11#70bc13b7 Versionshistorie & Revisions (1 transition)

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_DM_02377@rel:R25-11#70bc13b7

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

함수 SetContent [SWS_DM_02381] Upstream: RS_Diag_04260

auto SetContent (DiagnosticSovdContentElementData content) noexcept -> ara::core::Result< void >;

Sets the associated content.

Header-Datei	#include "ara/diag/diagnostic_sovd_content_element_data.h"
Scope	class ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
content	The content to set

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	void result or error if the content is of type ContentData

Fehler

Fehlercode	Beschreibung
DiagErrc::kInvalidArgument	rollback_semantics e.g. kPreFailed with internal debouncing

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

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

Status: valid/unmigrated Version: rel:R25-11#019a85d8 Versionshistorie & Revisions (1 transition)

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_DM_02381@rel:R25-11#019a85d8

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

함수 SetName [SWS_DM_02378] Upstream: RS_Diag_04260

void SetName (ara::core::StringView name) noexcept;

Sets the name of the key.

Header-Datei	#include "ara/diag/diagnostic_sovd_content_element_data.h"
Scope	class ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
name	The name of the key

Rückgabewert

Typ	Beschreibung
None

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

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

Status: valid/unmigrated Version: rel:R25-11#f02ced67 Versionshistorie & Revisions (1 transition)

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_DM_02378@rel:R25-11#f02ced67

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

함수 ~DiagnosticSovdContentElementDataWithKey [SWS_DM_02376] Upstream: RS_Diag_04260

~DiagnosticSovdContentElementDataWithKey () noexcept;

Declare the Dtor and move/copy constructors/assignments .

Header-Datei	#include "ara/diag/diagnostic_sovd_content_element_data.h"
Scope	class ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

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

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

Status: valid/unmigrated Version: rel:R25-11#c6febcde Versionshistorie & Revisions (1 transition)

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_DM_02376@rel:R25-11#c6febcde

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::diag::DiagnosticSovdContentElementDataWithKey

사용자 가이드AI 생성

컨텍스트

수명 주기

사용 경로

오류 시나리오

멤버 맵

생성자 및 소멸자

메서드

클래스 다이어그램

상세 보기

생성자 및 소멸자

메서드

메서드 문서

함수 GetContent [SWS_DM_02379] Upstream: RS_Diag_04260

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 GetContent [SWS_DM_02380] Upstream: RS_Diag_04260

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 GetName [SWS_DM_02377] Upstream: RS_Diag_04260

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 SetContent [SWS_DM_02381] Upstream: RS_Diag_04260

Parameter (in)

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 SetName [SWS_DM_02378] Upstream: RS_Diag_04260

Parameter (in)

Rückgabewert

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

함수 ~DiagnosticSovdContentElementDataWithKey [SWS_DM_02376] Upstream: RS_Diag_04260

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: