DEENESPTFRRUARHIKOZHNL

فئة ara::diag::DiagUdsNrcException

[SWS_DM_00527] Upstream: RS_AP_00119

class DiagUdsNrcException :              public ara::core::Exception {...};

Exception type thrown by Diag classes.

Header-Datei#include "ara/diag/diag_uds_nrc_error_domain.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag
Basisklasse(n)ara::core::Exception

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

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

يُستخدم كاستثناء آمن خيطيًا للإشعار بأخطاء UDS NRC وتمريرها في فئات التشخيص.

تُستخدم الفئة ara::diag::DiagUdsNrcException كاستثناء قياسي للإشعار بأخطاء UDS NRC بواسطة فئات التشخيص لـ AUTOSAR Adaptive Platform (AUTOSAR_AP_SWS_Diagnostics §8.12.4 «Class: DiagUdsNrcException»). عند حدوث حالة خطأ مقابلة، يتم إنشاء مثيل لها مع ara::core::ErrorCode، وتُطلق ويتم التقاطها بواسطة التطبيق المستدعي لمعالجة الخطأ. كقيد أساسي، يضمن منشئها وفقًا لـ [SWS_DM_00528] أمانًا كاملًا من الاستثناءات (noexcept) بالإضافة إلى الأمان الخيطي، مما يضمن إنشاءً موثوقًا للكائن حتى في السياقات المتزامنة.

السياق

تشكل الفئة ara::diag::DiagUdsNrcException في AUTOSAR Adaptive Platform نوع الاستثناء المركزي لفئات التشخيص في الوحدة diag (AUTOSAR_AP_SWS_Diagnostics §8.12.4 «Class: DiagUdsNrcException»). وفقًا للمواصفة [SWS_DM_00527]، فإنها تحدد واجهة استثناء ++C قياسية ترث مباشرة من فئة الاستثناء الأساسية ara::core::Exception. وتتمثل مسؤوليتها الأساسية في نقل حالات الخطأ من سياق التشخيص، ولا سيما أكواد الاستجابة السلبية (Negative Response Codes, NRC) لبروتوكول UDS، كاستثناءات نمطية عبر واجهة البرمجة. تتفاعل الفئة في هذا الصدد بشكل وثيق مع ara::core::ErrorCode، الذي يغلف كود الخطأ الفعلي، ومع طبقات التطبيق المستدعية التي ترسل طلبات التشخيص ويجب عليها التقاط أي أخطاء محتملة ([SWS_DM_00528]). ومن خلال الإعلان في الترويسة ara/diag/diag_uds_nrc_error_domain.h، يرتبط الاستثناء مباشرة بنطاق خطأ UDS NRC المقابل ([SWS_DM_00528]).
diag_uds_nrc_context diag_classes فئات ara::diag nrc_exception ara::diag::DiagUdsNrcException diag_classes->nrc_exception ينشئ ويطرح app Anwendungssoftware nrc_exception->app ينقل الخطأ إلى error_code ara::core::ErrorCode error_code->nrc_exception initialisiert

مخطط سياقي: تضمين DiagUdsNrcException في التفاعل المتبادل بين كود الخطأ، وفئات التشخيص، وبرمجيات التطبيق. المصادر: [SWS_DM_00527]، [SWS_DM_00528]، AUTOSAR_AP_SWS_Diagnostics §8.12.4 «Class: DiagUdsNrcException»

دورة الحياة

تبدأ دورة حياة مثيل لـ ara::diag::DiagUdsNrcException بإنشاء مثيله صراحة بواسطة فئة تشخيص أو روتين داخلي لمعالجة الأخطاء. وفقًا لـ [SWS_DM_00528]، تمتلك الفئة منشئًا explicit DiagUdsNrcException(ara::core::ErrorCode err) noexcept;، والذي يستقبل كود الخطأ الأساسي كمعامل err. تم تعريف هذا المنشئ صراحة على أنه آمن من الاستثناءات (exception safe) وغير مطلق للاستثناءات (noexcept) ([SWS_DM_00528])، مما يضمن عدم إمكانية حدوث استثناءات ثانوية أثناء إنشاء الكائن في مسار الخطأ. بالإضافة إلى ذلك، تم تصنيف الإنشاء وفقًا لـ [SWS_DM_00528] على أنه آمن خيطيًا (thread-safe). بعد الإنشاء، يتم عادةً إطلاق مثيل الاستثناء بالقيمة عبر نظام تشغيل ++C. تظل ملكية الكائن أثناء الـ stack unwinding لدى بيئة التشغيل، حتى يتم ربط الاستثناء وتقييمه في كتلة catch المقابلة. ومع مغادرة كتلة معالجة الاستثناء، تنتهي دورة حياة الكائن من خلال التدمير المنتظم.

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

يشمل مسار الاستخدام النموذجي اكتشاف خطأ UDS NRC، وإنشاء الاستثناء، وتقييمه لاحقًا بواسطة التطبيق:
  1. يستدعي مكون تطبيق دالة تشخيص أو واجهة خدمة لفئة ara::diag.
  2. تكتشف فئة التشخيص أثناء المعالجة أنه لا يمكن خدمة الطلب بنجاح ووجود UDS NRC، وبناءً على ذلك تنشئ ara::core::ErrorCode المقابل.
  3. مع تمرير كود الخطأ هذا، يتم إنشاء مثيل للاستثناء ara::diag::DiagUdsNrcException عبر منشئه ([SWS_DM_00528]).
  4. تطلق فئة التشخيص كائن الاستثناء من سياق التنفيذ (AUTOSAR_AP_SWS_Diagnostics §8.12.4 «Class: DiagUdsNrcException»).
  5. يلتقط التطبيق المستدعي الاستثناء إما بنوعه المحدد كـ ara::diag::DiagUdsNrcException ([SWS_DM_00527]) أو بتعددية الأشكال عبر الفئة الأساسية ara::core::Exception ويصل إلى معلومات الخطأ.
سير معالجة الاستثناء باستخدام DiagUdsNrcExceptionالتطبيقDiag-KlasseDiagUdsNrcExceptionتنفيذ وظيفة التشخيصUDS-NRC-Bedingung erkannt, ErrorCode erzeugtDiagUdsNrcException(err)throw DiagUdsNrcExceptioncatch وتقييم الخطأ

مخطط تسلسلي: تسلسل الإنشاء والإطلاق والالتقاط النموذجي لـ DiagUdsNrcException. المصادر: [SWS_DM_00527]، [SWS_DM_00528]، AUTOSAR_AP_SWS_Diagnostics §8.12.4 «Class: DiagUdsNrcException»

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

بما أن ara::diag::DiagUdsNrcException هي بحد ذاتها وسيلة للإبلاغ عن الأخطاء، فإن سيناريوهات الأخطاء تتعلق أساساً بالمتانة والتزامن أثناء إنشاء الاستثناء:
  • إنشاء كائن متين: من خلال التحديد كـ noexcept وexception safe ([SWS_DM_00528])، يتم استبعاد إطلاق استثناء ثانوي أثناء الإنشاء. يمنع ذلك حالات الإنهاء غير الطبيعي القاتلة في وقت التشغيل مثل std::terminate في مسارات معالجة الأخطاء الحرجة.
  • صلاحية رمز الخطأ: كشرط مسبق لإنشاء النسخة، يجب أن يتوفر ara::core::ErrorCode صالح ([SWS_DM_00528]). ينشأ هذا عادةً من مجال الخطأ المحدد بواسطة ara/diag/diag_uds_nrc_error_domain.h.
  • معالجة التشخيص المتوازية: بما أن المنشئ محدد كـ thread-safe ([SWS_DM_00528])، يُسمح لعدة مسارات ترابط بإنشاء استثناءات التشخيص بالتزامن دون حدوث حالات سباق أثناء تهيئة كائن الاستثناء.

تم إنشاء هذا الدليل بواسطة نظام ذكاء اصطناعي بناءً على مواصفة AUTOSAR R25-11.

مخطط الفئات UML

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

G nara__diag__DiagUdsNrcException343 DiagUdsNrcException + DiagUdsNrcException() nara__core__Exception792 Exception nara__diag__DiagUdsNrcException343->nara__core__Exception792 nstd__exception10 std::exception nara__core__Exception792->nstd__exception10

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

DiagUdsNrcException دالة

Construct a new DiagException from an ErrorCode.

explicit DiagUdsNrcException (ara::core::ErrorCode err) noexcept;

توثيق الدوال

دالة DiagUdsNrcException [SWS_DM_00528] Upstream: RS_AP_00119

explicit DiagUdsNrcException (ara::core::ErrorCode err) noexcept;

Construct a new DiagException from an ErrorCode.

Header-Datei#include "ara/diag/diag_uds_nrc_error_domain.h"
Scopeclass ara::diag::DiagUdsNrcException
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
errthe ErrorCode

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

Record
AUTOSAR/AP/record/SWS_DM_00528
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00528@rel:R25-11#8b59894f
Content hash
8b59894f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00528
Status: valid/unmigrated Version: rel:R25-11#55ae2ae1 Versionshistorie & Revisions (1 transition, 7 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_00528@rel:R25-11#55ae2ae1
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#d0877d832026-09-30
  • R20-11rel:R20-11#cfe41a2e2026-10-14
  • R21-11rel:R21-11#cfe41a2e2026-10-14
  • R22-11rel:R22-11#b5842e552026-10-14
  • R23-11rel:R23-11#ccbb9a702026-10-14
  • R24-11rel:R24-11#55ae2ae12026-10-14
  • R25-11rel:R25-11#55ae2ae12026-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