DEENESPTFRRUARHIKOZHNL

فئة ara::shwa::ErrorHandler

Diese Seite wurde vollständig KI-generiert auf Basis von SWS Safe Hardware Acceleration (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.

[AP_SWS_SHWA_00501] لم يُستورد النص بعد Upstream: RS_SHWA_00008

class ErrorHandler final {...};

Die Spezifikation definiert diesen Klassentyp mit der gezeigten Schnittstelle.

Header-Datei#include "ara/shwa/error_handler.h"
Scopenamespace ara::shwa

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

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

يُستخدم لرصد الأخطاء وإعادة توجيهها في الوحدة shwa إلى روتين معالجة مخصص للتطبيق.

تُستخدم الفئة للاستقبال المركزي للأخطاء وإعادة توجيهها داخل الوحدة shwa. لا يمكن إنشاء المثيلات إلا عبر طريقة المصنع الثابتة، والتي توفر الكائن في مؤشر حصري [AP_SWS_SHWA_00507]. ويتم تمرير رموز أخطاء محددة ومعالجتها عبر طريقة معالجة الأخطاء [AP_SWS_SHWA_00508]. ونظراً لأن تسوية الأخطاء لم تُصمم لتكون آمنة بالنسبة للخيوط أو آمنة من الاستثناءات، يجب على التطبيق المستدعي تنسيق عمليات الوصول المتزامنة خارجياً.

السياق

توفر الفئة ara::shwa::ErrorHandler في الوحدة shwa (Smart Hardware Actuator) واجهة متخصصة لاستقبال حالات الخطأ الخاصة بالوحدة وإعادة توجيهها بشكل موجه. وباعتبارها جزءاً من AUTOSAR Adaptive Platform، فإنها تفصل منطق العتاد والمشغلات الميكانيكية الفعلي عن استراتيجيات معالجة الأخطاء الأعلى مستوى. وقد تم الإعلان عن الفئة كـ final، مما يستبعد الاشتقاق ويفرض سلوك استخدام محدد بدقة.

الأطراف المتفاعلة الأساسية مع ara::shwa::ErrorHandler هي:

  • التطبيق أو مكون المنصة المستخدم الذي يدير المثيل ويطلق طريقة المعالجة في حالة حدوث خطأ.
  • رد الاتصال std::function<void(ara::core::ErrorCode)> المسجل أثناء الإنشاء، والذي ينفذ استجابة المعالجة الفعلية على مستوى التطبيق.
  • مجال الخطأ الخاص بالوحدة، والممثل بالنوع ara::shwa::ShwaErrorCode.

دورة الحياة

تخضع دورة حياة مثيل ara::shwa::ErrorHandler لقيود صارمة فيما يتعلق بالإنشاء وقابلية النسخ وملكية الذاكرة. ويُستبعد البناء العادي عبر المنشئات الافتراضية، نظراً لحذف المنشئ الخالي من المعاملات [AP_SWS_SHWA_00502]. ولضمان هوية فريدة ومسؤوليات واضحة، يمنع تعريف الفئة أي عمليات نسخ أو نقل:

توفر طريقة المصنع الثابتة Create الإمكانية الوحيدة لإنشاء المثيل [AP_SWS_SHWA_00507]. تستقبل هذه الطريقة كائن الدالة std::function<void(ara::core::ErrorCode)> وتُرجع النتيجة في شكل ara::core::Result<std::unique_ptr<ErrorHandler>>. ومن خلال std::unique_ptr، يتم نقل الملكية الحصرية للكائن إلى المستدعي. وبذلك يرتبط عمر المثيل مباشرةً بعمر المؤشر الذكي؛ وعند إتلافه، يتم أيضاً تحرير ErrorHandler.

فيما يتعلق بالتزامن، تم تحديد طريقة الإنشاء Create على أنها آمنة بالنسبة للخيوط (thread-safe) وآمنة من الاستثناءات (exception safe) [AP_SWS_SHWA_00507]. وفي المقابل، لم يتم تحديد طريقة معالجة الأخطاء التشغيلية HandleError على أنها آمنة بالنسبة للخيوط أو آمنة من الاستثناءات [AP_SWS_SHWA_00508]. وبالتالي، يجب تنسيق عمليات الوصول المتزامنة إلى نفس المثيل على مستوى التطبيق.

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

يشمل المسار النموذجي عند استخدام ara::shwa::ErrorHandler التهيئة عبر المصنع ومعالجة الأخطاء اللاحقة:

  1. تعريف رد الاتصال: يحدد التطبيق روتين معالجة بالتوقيع void(ara::core::ErrorCode).
  2. الإنشاء: يستدعي التطبيق الطريقة الثابتة Create ويمرر دالة رد الاتصال [AP_SWS_SHWA_00507]. وبعد فحص ara::core::Result، يتولى التطبيق std::unique_ptr<ErrorHandler>.
  3. الإشعار بالأخطاء: في حال حدوث خطأ أثناء التشغيل الفعلي، يتم استدعاء الأسلوب HandleError على المثيل مع ara::shwa::ShwaErrorCode المقابل [AP_SWS_SHWA_00508].
  4. إعادة التوجيه: يقوم المثيل بمعالجة حدث الخطأ؛ حيث يُرجح داخليًا تحويل رمز الخطأ الخاص بالموديول إلى ara::core::ErrorCode وتمريره إلى دالة الاستدعاء الذاتي (Callback) المسجلة (تفسير). سؤال Q-4101388d317e1f5b (مفتوح)
التسلسل النموذجي لمعالجة الأخطاء باستخدام ErrorHandlerالتطبيقErrorHandlerHandler-CallbackUse Case: إنشاء المثيل عبر المصنعCreate(handler)Result<std::unique_ptr<ErrorHandler>>Use Case: Operative FehlerbehandlungHandleError(errorCode)handler(coreErrorCode)العودةالعودة

مخطط التسلسل: تسلسل الاستدعاء النموذجي بدءًا من إنشاء المثيل وحتى معالجة الخطأ. المصادر: [AP_SWS_SHWA_00507]، [AP_SWS_SHWA_00508]

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

عند استخدام هذه الفئة، يجب مراعاة الشروط الحدية والحالات الحدية الأساسية التالية:

  • فشل إنشاء الكائن: لا تحدد المواصفة أي رموز خطأ قياسية لأسلوب المصنع Create [AP_SWS_SHWA_00507]. ومع ذلك، يعيد هذا الأسلوب ara::core::Result، بحيث يُرجح الإبلاغ عن أي حالات خطأ محتملة (مثل نقص الذاكرة) عبر كائن النتيجة هذا (تفسير). سؤال Q-85c2140acfda8244 (مفتوح) لذلك، يجب على الجهات المستدعية التحقق من صحة Result قبل الوصول إلى المؤشر.
  • المتطلبات المسبقة لمعالجة الخطأ: يتطلب استدعاء HandleError وجود مثيل سليم وara::shwa::ShwaErrorCode صالح [AP_SWS_SHWA_00508]. ونظرًا لعدم وجود قيمة إرجاع لهذا الأسلوب، لا يمكن إبلاغ الجهة المستدعية بالأخطاء التي تحدث أثناء المعالجة مباشرةً كرمز حالة.
  • غياب أمان الاستثناءات وأمان الخيوط: نظرًا للإعلان عن HandleError كـ not thread-safe وnot exception safe [AP_SWS_SHWA_00508]، يجب على بيئة الاستدعاء التأكد من إجراء الاستدعاءات بشكل تسلسلي وعدم انتشار أي استثناءات غير معالجة داخل معالجة الخطأ.

يستند دليل الفئات هذا إلى مواصفات AUTOSAR الخاصة بـ Adaptive Platform (الإصدار R25-11) وقد تم إنشاؤه آليًا.

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

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

1
ErrorHandler

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

2
CreateHandleError

المعاملات

1
operator=

عرض التفاصيل

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

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

ErrorHandler دالة 3

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

التحميلات الزائدة ErrorHandler 3
ErrorHandler ()=delete; AP_SWS_SHWA_00502
ErrorHandler (ErrorHandler &&)=delete; AP_SWS_SHWA_00505
ErrorHandler (ErrorHandler const &)=delete; AP_SWS_SHWA_00503

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

Create دالة

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

static ara::core::Result< std::unique_ptr< ErrorHandler > > Create (std::function< void(ara::core::ErrorCode)> handler) noexcept;
HandleError دالة

Führt die in der Signatur definierte Fehlerdomänen- oder Fehlerbehandlungsoperation aus.

void HandleError (ara::shwa::ShwaErrorCode errorCode);

المعاملات

operator= دالة 2

Stellt die in der Signatur ausgewiesene Index- beziehungsweise Zuweisungsoperation bereit.

التحميلات الزائدة = 2
ErrorHandler & operator= (const ErrorHandler &)=delete; AP_SWS_SHWA_00504
ErrorHandler & operator= (ErrorHandler &&)=delete; AP_SWS_SHWA_00506

التفاصيل

دالة ErrorHandler [AP_SWS_SHWA_00502] Upstream: RS_SHWA_00008

ErrorHandler ()=delete;

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::ErrorHandler

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00502
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00502@rel:R25-11#cf8bfe67
Content hash
cf8bfe67
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00502
Status: valid/unmigrated Version: rel:R25-11#7fa5897f 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/AP_SWS_SHWA_00502@rel:R25-11#7fa5897f
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

دالة ErrorHandler [AP_SWS_SHWA_00505] Upstream: RS_SHWA_00008

ErrorHandler (ErrorHandler &&)=delete;

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::ErrorHandler

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00505
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00505@rel:R25-11#d7c10ebf
Content hash
d7c10ebf
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00505
Status: valid/unmigrated Version: rel:R25-11#419fe952 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/AP_SWS_SHWA_00505@rel:R25-11#419fe952
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

دالة operator= [AP_SWS_SHWA_00504] Upstream: RS_SHWA_00008

ErrorHandler & operator= (const ErrorHandler &)=delete;

Stellt die in der Signatur ausgewiesene Index- beziehungsweise Zuweisungsoperation bereit.

Scopeclass ara::shwa::ErrorHandler

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00504
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00504@rel:R25-11#0e3d8440
Content hash
0e3d8440
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00504
Status: valid/unmigrated Version: rel:R25-11#5a3dec6d 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/AP_SWS_SHWA_00504@rel:R25-11#5a3dec6d
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

دالة operator= [AP_SWS_SHWA_00506] Upstream: RS_SHWA_00008

ErrorHandler & operator= (ErrorHandler &&)=delete;

Stellt die in der Signatur ausgewiesene Index- beziehungsweise Zuweisungsoperation bereit.

Scopeclass ara::shwa::ErrorHandler

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00506
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00506@rel:R25-11#9d78e2c8
Content hash
9d78e2c8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00506
Status: valid/unmigrated Version: rel:R25-11#e689a389 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/AP_SWS_SHWA_00506@rel:R25-11#e689a389
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

دالة ErrorHandler [AP_SWS_SHWA_00503] Upstream: RS_SHWA_00008

ErrorHandler (ErrorHandler const &)=delete;

Die Spezifikation definiert diese Deklaration mit der in der Signatur ausgewiesenen Semantik.

Scopeclass ara::shwa::ErrorHandler

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00503
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00503@rel:R25-11#e9c8c836
Content hash
e9c8c836
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00503
Status: valid/unmigrated Version: rel:R25-11#2aaa7f49 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/AP_SWS_SHWA_00503@rel:R25-11#2aaa7f49
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

دالة Create [AP_SWS_SHWA_00507] Upstream: RS_SHWA_00008, RS_SHWA_00007

static ara::core::Result< std::unique_ptr< ErrorHandler > > Create (std::function< void(ara::core::ErrorCode)> handler) noexcept;

Erzeugt beziehungsweise liefert das in der Signatur beschriebene Objekt oder Ergebnis über den angegebenen Factory-Pfad.

Scopeclass ara::shwa::ErrorHandler
Thread Safetythread-safe
Exception Safetyexception safe
ErrorsThis function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00507
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00507@rel:R25-11#c57219c4
Content hash
c57219c4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00507
Status: valid/unmigrated Version: rel:R25-11#49774b06 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/AP_SWS_SHWA_00507@rel:R25-11#49774b06
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

دالة HandleError [AP_SWS_SHWA_00508] Upstream: RS_SHWA_00008

void HandleError (ara::shwa::ShwaErrorCode errorCode);

Führt die in der Signatur definierte Fehlerdomänen- oder Fehlerbehandlungsoperation aus.

Scopeclass ara::shwa::ErrorHandler
Thread Safetynot thread-safe
Exception Safetynot exception safe

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

Record
AUTOSAR/AP/record/AP_SWS_SHWA_00508
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_SHWA_00508@rel:R25-11#ec51d3cc
Content hash
ec51d3cc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_SafeHardwareAcceleration.pdf#nameddest=AP_SWS_SHWA_00508
Status: valid/unmigrated Version: rel:R25-11#b5172dde 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/AP_SWS_SHWA_00508@rel:R25-11#b5172dde
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