DEENESPTFRRUARHIKOZHNL

بنية ara::com::FindServiceHandle

[SWS_CM_00303] Upstream: RS_CM_00102

struct FindServiceHandle {...};

The exact definition of ara::com::FindServiceHandle is Communication Management implementation specific. ara::com::FindServiceHandle satisfies the [equalitycomparable] and [lessthancomparable] requirements as per [30] to allow storing and managing ara::com::FindServiceHandles by the application.

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/service/find_service_handle.h"
Forwarding-Header#include "ara/com/com_fwd.h"
Scopenamespace ara::com

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

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

يُستخدم كرمز تحكم لإدارة وإنهاء بحث غير متزامن قيد التشغيل في الخلفية عن نسخ الخدمة.

يُستخدم الهيكل ara::com::FindServiceHandle كرمز تحكم فريد لإدارة مراقبة الخدمة التي تعمل في الخلفية (AUTOSAR_AP_EXP_ARAComAPI ص. 34). ونظرًا لحذف المُنشئ الافتراضي ([SWS_CM_00353])، يتم إنشاء المقبض حصريًا بواسطة StartFindService، ويتيح بعد استقبال ردود نداء الحالة غير المتزامنة إنهاء البحث بشكل هادف عبر StopFindService (AUTOSAR_AP_EXP_ARAComAPI ص. 30). كما تضمن معاملات المقارنة المدعومة إدارة قابلة للتخزين لعدة مهام بحث في الحاويات القياسية ([SWS_CM_11526]، [SWS_CM_11527]).

السياق

يعمل الهيكل ara::com::FindServiceHandle في الوحدة com في Adaptive Platform كمُعرّف فريد ورمز تحكم لعملية بحث غير متزامنة ومستمرة عن الخدمات. بينما يحدد الاستعلام المتزامن عبر FindService نسخ الخدمة المطابقة لمرة واحدة ويُرجع حاويات المقابض مباشرة، يبدأ StartFindService مراقبة دائمة لتوفر الخدمة في الخلفية (AUTOSAR_AP_EXP_ARAComAPI ص. 34). وعادةً ما يشترك في هذه العملية نسخة التطبيق، وفئة الوكيل الخاصة بالنوع (على سبيل المثال RadarServiceProxy)، بالإضافة إلى دالة رد اتصال محددة من قبل المستخدم من النوع FindServiceHandler (AUTOSAR_AP_EXP_ARAComAPI ص. 30). تم تصميم التمثيل الداخلي الفعلي لـ ara::com::FindServiceHandle بشكل خاص بكل تنفيذ لـ Communication Management المعنية، ولكنه يوفر واجهات C++‎ قياسية للتعامل معه.

دورة الحياة

ترتبط دورة حياة ara::com::FindServiceHandle ارتباطًا وثيقًا بعملية البحث النشطة في Communication Management:

  • الإنشاء: تم حذف المُنشئ الافتراضي صراحة ([SWS_CM_00353]). وبالتالي، لا يمكن للتطبيق إنشاء نسخ مقبض غير مهيأة أو بشكل مستقل. وبدلاً من ذلك، يتم إنشاء مقبض صالح حصريًا كحمولة لـ ara::core::Result بواسطة الطريقة الثابتة StartFindService (AUTOSAR_AP_EXP_ARAComAPI ص. 30).
  • الإدارة والملكية: يدعم المقبض التعيين عبر معامل تعيين النسخ [SWS_CM_11528]. ولتمكين التطبيق من تخزين وتنظيم مهام بحث متعددة في حاويات قياسية (مثل المجموعات المرتبة أو الذواكر الترابطية)، يحقق النوع مفهومي C++‎ [equalitycomparable] و[lessthancomparable] عبر المعاملين operator== ([SWS_CM_11526]) وoperator< ([SWS_CM_11527]).
  • الإنهاء والتدمير: يحتفظ المقبض بصلاحيته طالما أن المراقبة في الخلفية نشطة. يتم إنهاء البحث عن طريق تمرير المقبض إلى StopFindService (AUTOSAR_AP_EXP_ARAComAPI ص. 30، AUTOSAR_AP_EXP_ARAComAPI ص. 34). بعد هذا الاستدعاء، لا يعود المقبض يمثل أي عملية بحث قيد التشغيل.

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

يتضمن التسلسل القياسي تسجيل طلب البحث، والاستلام المستمر لتحديثات التوافر، والإيقاف المنظم لعملية المراقبة:

  1. بدء البحث: يقوم التطبيق بتسجيل FindServiceHandler عبر StartFindService ليتم إخطاره بمثيلات الخدمة المتاحة حديثًا أو التي لم تعد متوفرة (AUTOSAR_AP_EXP_ARAComAPI ص. 30، AUTOSAR_AP_EXP_ARAComAPI ص. 34).
  2. الحصول على المقبض: عند البدء الناجح، يُرجع الاستدعاء ara::core::Result مع FindServiceHandle (AUTOSAR_AP_EXP_ARAComAPI ص. 30)، والذي يحتفظ به التطبيق لاستدعاءات التحكم اللاحقة.
  3. الإخطار غير المتزامن: يقوم Communication Management بتنفيذ البحث في الخلفية واستدعاء المعالج المقدم عند حدوث تغييرات في الحالة (AUTOSAR_AP_EXP_ARAComAPI ص. 34).
  4. إيقاف البحث: بمجرد العثور على المثيلات أو عندما لا تعد المراقبة مطلوبة، يمرر التطبيق المقبض إلى StopFindService (AUTOSAR_AP_EXP_ARAComAPI ص. 30، AUTOSAR_AP_EXP_ARAComAPI ص. 34).
تسلسل البحث غير المتزامن عن الخدمة باستخدام FindServiceHandleApplikationProxyFindServiceHandlerStartFindService(handler)Result<FindServiceHandle>Use Case: المراقبة في الخلفية نشطةإشعار بشأن الحالات المثيلةUse Case: إنهاء المراقبةStopFindService(handle)

مخطط التتابع: التسلسل النموذجي للبحث غير المتزامن عن الخدمة، بدءًا من التسجيل ومرورًا بالإخطارات وحتى الإنهاء عبر FindServiceHandle. المصادر: AUTOSAR_AP_EXP_ARAComAPI ص. 30، AUTOSAR_AP_EXP_ARAComAPI ص. 34.

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

عند استخدام ara::com::FindServiceHandle، يجب مراعاة الشروط الحدية الخاصة بالنظام التالية:

  • فشل بدء البحث: في حال كانت الارتباطات التقنية غير متاحة أو كان تكوين نشر الخدمة غير صحيح (AUTOSAR_AP_EXP_ARAComAPI ص. 34)، يفشل StartFindService. لا يحتوي ara::core::Result المُرجع في هذه الحالة على مقبض صالح، بل على رمز خطأ (AUTOSAR_AP_EXP_ARAComAPI ص. 30).
  • أمان الاستثناءات: تم الإعلان صراحة في المواصفة عن معاملات المقارنة والتعيين المنفذة operator== ([SWS_CM_11526])، وoperator< ([SWS_CM_11527])، وoperator= ([SWS_CM_11528]) على أنها غير آمنة من حيث الاستثناءات (not exception safe).
  • الإيقاف المتعدد: يُفترض أن يظل الاستدعاء المتكرر لـ StopFindService باستخدام نفس المقبض بلا تأثير أو يؤدي إلى خطأ وقت التشغيل، نظراً لأنه قد تمت بالفعل إزالة نشاط المراقبة الأساسي. سؤال Q-f44130c33fa1caea (مفتوح)

يستند هذا الدليل إلى مواصفة AUTOSAR الخاصة بـ Adaptive Platform (الإصدار R25-11). تعتمد الواجهات والسلوكيات الموضحة على متطلبات SWS وأوصاف API المرجعية.

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

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

1
FindServiceHandle

المعاملات

3
operator<operator=operator==

مخطط الفئة

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

G nara__com__FindServiceHandle138 «struct» FindServiceHandle + FindServiceHandle() + operator=() + operator<() + operator==()

عرض التفاصيل

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

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

FindServiceHandle دالة

Default constructor deletion

FindServiceHandle ()=delete;

المعاملات

operator< دالة

LessThan operator as per [lessthancomparable] in [30]

bool operator< (const FindServiceHandle &other) const;
operator= دالة

Copy assignment constructor

FindServiceHandle & operator= (const FindServiceHandle &other);
operator== دالة

Equality operator as per [equalitycomparable] in [30]

bool operator== (const FindServiceHandle &other) const;

توثيق الدوال

دالة FindServiceHandle [SWS_CM_00353] Upstream: RS_AP_00146

FindServiceHandle ()=delete;

Default constructor deletion

Header-Datei#include "ara/com/service/find_service_handle.h"
Scopestruct ara::com::FindServiceHandle

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

Record
AUTOSAR/AP/record/SWS_CM_00353
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00353@rel:R25-11#77ce55e7
Content hash
77ce55e7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00353
Status: valid/unmigrated Version: rel:R25-11#8a450052 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_CM_00353@rel:R25-11#8a450052
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#b1f430d12026-09-30
  • R23-11rel:R23-11#604163032026-10-14
  • R24-11rel:R24-11#8a4500522026-10-14
  • R25-11rel:R25-11#8a4500522026-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

دالة operator< [SWS_CM_11527]

bool operator< (const FindServiceHandle &other) const;

LessThan operator as per [lessthancomparable] in [30]

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/service/find_service_handle.h"
Scopestruct ara::com::FindServiceHandle
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
otherOther ara::com::FindServiceHandle to compare

Rückgabewert

TypBeschreibung
boolTRUE if other is less than *this, FALSE otherwise.

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

Record
AUTOSAR/AP/record/SWS_CM_11527
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11527@rel:R25-11#efa17ebc
Content hash
efa17ebc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11527
Status: valid/unmigrated Version: rel:R25-11#b1ec1ec0 Versionshistorie & Revisions (1 transition, 3 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_CM_11527@rel:R25-11#b1ec1ec0
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#9b3fc18e2026-09-30
  • R24-11rel:R24-11#2bb55cbe2026-10-14
  • R25-11rel:R25-11#b1ec1ec02026-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

دالة operator= [SWS_CM_11528]

FindServiceHandle & operator= (const FindServiceHandle &other);

Copy assignment constructor

Header-Datei#include "ara/com/service/find_service_handle.h"
Scopestruct ara::com::FindServiceHandle
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
otherOther ara::com::FindServiceHandle to copy

Rückgabewert

TypBeschreibung
FindServiceHandle &New ara::com::FindServiceHandle

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

Record
AUTOSAR/AP/record/SWS_CM_11528
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11528@rel:R25-11#20e4da6b
Content hash
20e4da6b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11528
Status: valid/unmigrated Version: rel:R25-11#847556b4 Versionshistorie & Revisions (1 transition, 3 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_CM_11528@rel:R25-11#847556b4
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#414d7a6c2026-09-30
  • R24-11rel:R24-11#f73bf3482026-10-14
  • R25-11rel:R25-11#847556b42026-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

دالة operator== [SWS_CM_11526]

bool operator== (const FindServiceHandle &other) const;

Equality operator as per [equalitycomparable] in [30]

Literaturverzeichnis SWS CommunicationManagement: [30] ISO/IEC 14882:2014, Information technology – Programming languages – C++ – www.iso.org

Header-Datei#include "ara/com/service/find_service_handle.h"
Scopestruct ara::com::FindServiceHandle
Exception-Sicherheitnot exception safe

Parameter (in)

ParameterBeschreibung
otherOther ara::com::FindServiceHandle to compare

Rückgabewert

TypBeschreibung
boolTRUE if other is equal to *this, FALSE otherwise.

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

Record
AUTOSAR/AP/record/SWS_CM_11526
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11526@rel:R25-11#46cc8a37
Content hash
46cc8a37
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11526
Status: valid/unmigrated Version: rel:R25-11#d2ea98ee Versionshistorie & Revisions (1 transition, 3 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_CM_11526@rel:R25-11#d2ea98ee
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#d9c8643c2026-09-30
  • R24-11rel:R24-11#491d93d72026-10-14
  • R25-11rel:R25-11#d2ea98ee2026-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