DEENESPTFRRUARHIKOZHNL

بنية ara::diag::SovdConfiguration::SovdConfigurationMetaInfo

[SWS_DM_01861] Upstream: RS_Diag_04261

struct SovdConfigurationMetaInfo {...};

MetaInfo for Transfer of SOVD Configurations.

Header-Datei#include "ara/diag/sovd_configuration.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopeclass ara::diag::SovdConfiguration

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

يوفر معلومات تعريفية مثل نوع MIME وحجم البيانات لنقل تكوينات SOVD.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 487f6d360b41 المصدر أسئلة مفتوحة (3)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يوفر معلومات تعريفية مثل نوع MIME وحجم البيانات لنقل تكوينات SOVD.

تُستخدم البنية ara::diag::SovdConfiguration::SovdConfigurationMetaInfo ككائن نقل بيانات لمعلومات التعريف عند نقل بيانات تكوين SOVD في AUTOSAR Adaptive [SWS_DM_01861]. وهي تجمع نوع MIME في mimetype بالإضافة إلى الطول الإجمالي لبيانات التكوين اختياريًا في size، واللذين يتم تعيينهما بواسطة التطبيق قبل التمرير إلى طرق النقل [SWS_DM_01863]. وبصفتها بنية بيانات C++ سلبية بدون دوال خاصة بها، فإنها لا تمتلك أمان خيوط المعالجة ولا منطق تحقق، بحيث لا يتم إجراء فحوصات الاتساق إلا من خلال خدمات المنصة المعالجة.

السياق

تُستخدم البنية ara::diag::SovdConfiguration::SovdConfigurationMetaInfo كحاوية بيانات وصفية قياسية لنقل بيانات تكوين SOVD (Service-Oriented Vehicle Diagnostics) في AUTOSAR Adaptive Platform [SWS_DM_01861]. تم التصريح عنها في ملف الترويسة ara/diag/sovd_configuration.h وهي مخصصة تنظيمياً بشكل مباشر لفئة الواجهة ara::diag::SovdConfiguration AUTOSAR_AP_SWS_Diagnostics §8.54.2 «Struct: SovdConfigurationMetaInfo». وتتمثل مسؤوليتها الأساسية في توفير المعلومات الوصفية المطلوبة لنقل تكوين التشخيص، مثل نوع المحتوى وحجم البيانات [SWS_DM_01862]، [SWS_DM_01863].

تشمل أطراف التفاعل الأساسية من جهة تطبيق التشخيص المستخدم، الذي يُنشئ بيانات التكوين أو يعدلها أو يعالجها، ومن جهة أخرى نظام إدارة التشخيص في AUTOSAR Adaptive. تعمل البنية ككائن لنقل البيانات (Data Transfer Object، DTO) يتوسط بين المنطق الخاص بالتطبيق وخدمات النقل القياسية لمنصة Diagnostics. ومن خلال الحقول المتوفرة، يمكن للمرسل والمستقبل الاتفاق على التنسيق الذي تتوفر به بيانات التكوين وعدد البايتات المتوقعة في قناة النقل.

دورة الحياة

كنوع بيانات C++ سلبي بحت (struct)، لا تخضع SovdConfigurationMetaInfo لمراحل دورة حياة معقدة تديرها المنصة [SWS_DM_01861]. يتم الإنشاء عادةً مباشرة بواسطة Adaptive Application على المكدس (Stack) أو في الذاكرة المكدسة (Heap)، قبل بدء نقل التكوين مباشرة أو قبل تقييم مجموعة بيانات تعريف مستلمة. تتبع البنية دلالات القيمة القياسية للغة C++؛ ويتحمل المكون المالك المسؤولية عن إنشاء النسخة وعمرها الافتراضي.

فيما يتعلق بالحالة الداخلية، لا تمتلك البنية آلة حالة ولا أوضاع تشغيل منفصلة. بعد تهيئة المتغيرات العامة، تظل البيانات في الذاكرة دون تغيير حتى إتلاف النسخة، ما لم تتم الكتابة فوقها صراحة بواسطة التطبيق المالك. يتم تحرير النسخة تلقائيًا وفقًا لنمط RAII عند مغادرة نطاق الصلاحية (Scope)، حيث يتم تحرير الذاكرة المخصصة ديناميكيًا للسلسلة النصية المضمنة [SWS_DM_01863].

فيما يتعلق بالتزامن، لا توفر SovdConfigurationMetaInfo أمانًا متكاملاً لخيوط المعالجة. يُسمح لعدة خيوط معالجة بقراءة نسخة بالتزامن، على سبيل المثال لفحص معلمات التكوين. ومع ذلك، تتطلب عمليات الكتابة المتزامنة على نفس النسخة إجراءات مزامنة خارجية، نظرًا لأن التعديلات المتنافسة على متغيرات الأعضاء تؤدي إلى عدم اتساق البيانات.

مسار الاستخدام

تتمثل حالة الاستخدام النموذجية في إعداد بيانات التعريف وتوفيرها قبل نقل التكوين الفعلي. يُنشئ التطبيق أولاً نسخة من البنية ويعين إلى الحقل mimetype سلسلة نصية تصف نوع الوسائط لملف التكوين [SWS_DM_01863]، AUTOSAR_AP_SWS_Diagnostics §8.54.2.1.1 «mimetype». يتيح ذلك للمستقبل ربطها بمحلل أو مخطط، على سبيل المثال للتكوينات المستندة إلى JSON أو XML.

في الخطوة التالية، يتم التحقق مما إذا كان يمكن تحديد حجم الملف الدقيق لبيانات الحمولة مسبقًا. إذا كان الأمر كذلك، يتم ملء السمة size بقيمة البايت الصحيحة المقابلة [SWS_DM_01862]، AUTOSAR_AP_SWS_Diagnostics §8.54.2.1.2 «size». إذا كان الحجم غير معروف قبل بدء النقل، يظل المتغير غير معين. بعد ذلك، يتم تمرير الكائن المُجهّز كوسيطة إلى دالة النقل للفئة ara::diag::SovdConfiguration.

تسلسل توفير البيانات الوصفية أثناء نقل تكوين SOVDالتطبيقSovdConfigurationMetaInfoSovdConfigurationإنشاء النسخةتعيين mimetype وsize الاختياريتمرير التكوين مع MetaInfoإفادة حول حالة النقل

مخطط تسلسلي: التسلسل النموذجي لتهيئة SovdConfigurationMetaInfo وتمريرها في إطار نقل التكوين. المصادر: [SWS_DM_01861]، [SWS_DM_01862]، [SWS_DM_01863]، AUTOSAR_AP_SWS_Diagnostics §8.54.2 «Struct: SovdConfigurationMetaInfo».

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

نظرًا لتصميم SovdConfigurationMetaInfo كبنية بيانات بحتة بدون دوال أعضاء، فإنها لا تحدد قيم إرجاع أو رموز أخطاء أو استثناءات خاصة بها [SWS_DM_01861]. تنشأ حالات الخطأ المحتملة أساسًا من تعيينات بيانات غير مكتملة أو غير متسقة، والتي تكتشفها خدمات المنصة المعالجة في ara::diag::SovdConfiguration.

تفسير: يتعلق سيناريو الخطأ الأول بأنواع MIME غير المسموح بها. سؤال (مفتوح) إذا تم تخزين سلسلة نصية فارغة أو معرف تنسيق غير مدعوم في mimetype، فمن المرجح أن ترفض خدمة النقل المستدعاة المعالجة وترجع رمز خطأ مطابقًا إلى التطبيق. ويكمن سيناريو الخطأ الثاني في وجود تعارض في حجم البيانات: إذا اختلف حجم البيانات المنقولة فعليًا عن قيمة البايت المصرح بها في size، فمن المحتمل أن تقطع البنية التحتية للتشخيص النقل بسبب عدم الاتساق. بالإضافة إلى ذلك، قد يؤدي ترك الحقل size غير معين إلى أخطاء في النقل، إذا كانت قناة النقل المختارة تتطلب بالضرورة طولاً إجماليًا معروفًا مسبقًا.

يستند هذا الدليل إلى مواصفة AUTOSAR Adaptive Platform الإصدار R25-11.

مخطط الفئات UML

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

G nara__diag__SovdConfiguration__SovdConfigurationMetaInfo383 «struct» SovdConfigurationMetaInfo + mimetype + size

الثوابت

mimetype متغير

Specifies the configuration mimetype .

ara::core::String mimetype;
size متغير

Specifies the size of the configuration data .

ara::core::Optional<std::uint64_t> size;

توثيق الثوابت / المتغيرات

متغير mimetype [SWS_DM_01863] Upstream: RS_Diag_04261

ara::core::String mimetype;

Specifies the configuration mimetype .

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopestruct ara::diag::SovdConfiguration::SovdConfigurationMetaInfo
Symbolmimetype
Typara::core::String

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

Record
AUTOSAR/AP/record/SWS_DM_01863
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01863@rel:R25-11#e66c05a8
Content hash
e66c05a8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01863
Status: valid/unmigrated Version: rel:R25-11#65d44bcf Versionshistorie & Revisions (1 transition, 4 revision)
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_01863@rel:R25-11#65d44bcf
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#5fa2a0012026-09-30
  • R23-11rel:R23-11#65d44bcf2026-10-14
  • R24-11rel:R24-11#65d44bcf2026-10-14
  • R25-11rel:R25-11#65d44bcf2026-10-14 active
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

متغير size [SWS_DM_01862] Upstream: RS_Diag_04261

ara::core::Optional<std::uint64_t> size;

Specifies the size of the configuration data .

Header-Datei#include "ara/diag/sovd_configuration.h"
Scopestruct ara::diag::SovdConfiguration::SovdConfigurationMetaInfo
Symbolsize
Typara::core::Optional< std::uint64_t >

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

Record
AUTOSAR/AP/record/SWS_DM_01862
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01862@rel:R25-11#0736132d
Content hash
0736132d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01862
Status: valid/unmigrated Version: rel:R25-11#25ab5cd6 Versionshistorie & Revisions (1 transition, 4 revision)
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_01862@rel:R25-11#25ab5cd6
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#6b9b42d22026-09-30
  • R23-11rel:R23-11#25ab5cd62026-10-14
  • R24-11rel:R24-11#25ab5cd62026-10-14
  • R25-11rel:R25-11#25ab5cd62026-10-14 active
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