DEENESPTFRRUARHIKOZHNL

فئة 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"
Scopenamespace ara::diag

دليل المستخدممولَّد بالذكاء الاصطناعي

تغليف عنصر محتوى تشخيصي لـ SOVD جنبًا إلى جنب مع معرّف مفتاح لعمليات القراءة والكتابة.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 816c129f74ba المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تغليف عنصر محتوى تشخيصي لـ SOVD جنبًا إلى جنب مع معرّف مفتاح لعمليات القراءة والكتابة.

تُستخدم الفئة لتغليف عنصر محتوى تشخيصي لـ SOVD مع معرّف مفتاح فريد [SWS_DM_02375]. ويتم ملؤها بواسطة Diagnostic Management عند عمليات الوصول للكتابة وفقًا لـ ASAM SOVD وتمريرها إلى 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 عبر عنصر النموذج DiagnosticSovdContent، والذي يتألف من DiagnosticSovdContentElement واحد على الأقل 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 shortName الخاص بـ DiagnosticSovdContentElement المعني [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].

سير كتابة بيانات SOVD عبر DiagnosticSovdContentElementDataWithKeySOVD-ClientDiagnostic ManagementDiagnosticSovdContentElementDataWithKeyGenericDiagnosticSovdContentSOVD Write a data resourceSetName(shortName)SetContent(content)ara::core::Result<void>Write(DiagnosticSovdContentData)GetName() / GetContent()اسم المفتاح & مرجع البياناتSchreibstatusSOVD-Antwort

مخطط تسلسلي: تدفق الاستدعاء والبيانات أثناء معالجة طلب كتابة SOVD باستخدام DiagnosticSovdContentElementDataWithKey. المصادر: [SWS_DM_01431]، [SWS_DM_02166]، [SWS_DM_02378]، [SWS_DM_02381].

سيناريوهات الأخطاء

في حالة الخطأ، تتخلى الفئة عن استثناءات C++ وتبلغ بدلاً من ذلك عن الإخفاقات عبر نوع الإرجاع ara::core::Result<void> الخاص بـ SetContent [SWS_DM_02381]. إذا فشل تعيين المحتوى – على سبيل المثال إذا كان نوع المحتوى الممرر لا يتطابق مع الهيكل الهدف أو كان غير صالح –، فسيتم إرجاع رمز الخطأ DiagErrc::kInvalidArgument [SWS_DM_02381]. يجب على المستدعي فحص النتيجة المرجعة قبل تسليم الكائن إلى GenericDiagnosticSovdContent::Write [SWS_DM_02166].

يستند دليل الفئة هذا إلى مواصفة AUTOSAR AP الإصدار R25-11. جميع العبارات مدعومة بمتطلبات SWS ومواضع التوثيق الخاصة بالواجهة ara::diag.

خريطة الأعضاء

المُنشئات والمُتلف

1

الدوال الأعضاء

4

مخطط الفئة

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

G nara__diag__DiagnosticSovdContentElementDataWithKey42 DiagnosticSovdContentElementDataWithKey + ~DiagnosticSovdContentElementDataWithKey() + GetContent() + GetName() + SetContent() + SetName()

عرض التفاصيل

اختر عنصرًا من المخطط.

المُنشئات والمُتلف

Declare the Dtor and move/copy constructors/assignments .

الدوال الأعضاء

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"
Scopeclass ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
DiagnosticSovdContentElementDataReference 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#f99c1785
Content hash
f99c1785
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
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
DiagnosticSovdContentReference 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#791cdc91
Content hash
791cdc91
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
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::StringViewThe 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#8173fd9d
Content hash
8173fd9d
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
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
contentThe content to set

Rückgabewert

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

Fehler

FehlercodeBeschreibung
DiagErrc::kInvalidArgumentrollback_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#c974ae45
Content hash
c974ae45
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
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
nameThe name of the key

Rückgabewert

TypBeschreibung
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#7c417aa1
Content hash
7c417aa1
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
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-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"
Scopeclass ara::diag::DiagnosticSovdContentElementDataWithKey
Exception-Sicherheitexception safe
Thread-Sicherheitthread-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#e7d6c06f
Content hash
e7d6c06f
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
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill