DEENESPTFRRUARHIKOZHNL

فئة ara::diag::DataTransferReadSession

[SWS_DM_01548] Upstream: RS_Diag_04135

class DataTransferReadSession final {...};

Encapsulates all data transfer reading variants.

Header-Datei#include "ara/diag/data_transfer.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

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

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

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

تُستخدم الفئة لتغليف وإدارة كافة متغيرات عمليات نقل القراءة المستندة إلى التشخيص بشكل منظم داخل وحدة تشخيص AUTOSAR التكيفية وفقًا لـ [SWS_DM_01548]. بعد بدء عملية القراءة بنجاح، تُفوض نسخة خادم التشخيص الطلبات الواردة لنقل كتل البيانات المتسلسلة وكذلك لإتمام الجلسة إلى الطرق المسجلة لمعالج القراءة [SWS_DM_01317]. ومن خلال التعطيل المستهدف لعمليات النسخ مع الدعم المتزامن لدلالات النقل (Move semantics)، تضمن الفئة تخصيصًا فريدًا لملكية جلسة النقل الأساسية.

السياق

تُمثل الفئة ara::diag::DataTransferReadSession تغليفًا لجميع متغيرات القراءة المدعومة بالتشخيص لكتل البيانات في وحدة التشخيص التكيفية [SWS_DM_01548]. وفي إطار خدمات UDS القياسية مثل RequestFileTransfer ‏(0x38) وTransferData ‏(0x36) وRequestTransferExit ‏(0x37)، تعمل فئة الجلسة كحلقة وصل بين بيئة وقت التشغيل الداخلية لخادم التشخيص ومعالجات القراءة الخاصة بالتطبيق SWS Diagnostics §7 «Realization of TransferData and RequestTransferExit». وتضمن إدارة عمليات القراءة الجارية – مثل الملفات عبر ReadFile [SWS_DM_01314] أو الأدلة عبر ReadDir [SWS_DM_01315] – بشكل معزول وتمريرها إلى المعالجات التابعة لها.

DataTransferReadSessionContext client Diagnose-Client (Tester) server Diagnostic Server (ara::diag) client->server UDS RequestFileTransfer TransferData / Exit session ara::diag::DataTransferReadSession (Transfersitzung) server->session verwaltet Lesesitzung handler Lese-Handler (Applikation) session->handler delegiert Read() / Exit()

مخطط السياق: تضمين DataTransferReadSession بين خادم التشخيص ومعالج التطبيق. المصادر: [SWS_DM_01317]، [SWS_DM_01318]، SWS Diagnostics §7 «Realization of TransferData and RequestTransferExit»

دورة الحياة

تمتلك نسخة من ara::diag::DataTransferReadSession فترة عمر مرتبطة ارتباطًا وثيقًا بجلسة النقل. يُحظر صراحة إنشاؤها عبر منشئ افتراضي [SWS_DM_01549]. وبدلًا من ذلك، تتم تهيئة الجلسة عبر منشئات قوالب متخصصة تقوم بتسجيل المعالجات الخاصة بالتطبيق SWS Diagnostics §7 «Realization of TransferData and RequestTransferExit». ومن المفترض عمليًا أن يتم إنشاء النسخة عادةً بواسطة خادم التشخيص أو معالج الخدمة عند بدء نقل الملفات. سؤال Q-b0706bcd28c702c6 (مفتوح)

لاستبعاد التعيينات المتعددة أو حالات الجلسة غير المتسقة، تم تصميم ara::diag::DataTransferReadSession كنسخة أحادية غير قابلة للنسخ: تم حذف كل من منشئ النسخ [SWS_DM_01553] ومعامل إسناد النسخ [SWS_DM_01554] (=delete). ويقتصر نقل الملكية حصريًا على دلالات النقل (Move semantics). تم تعريف منشئ النقل [SWS_DM_01551] ومعامل إسناد النقل [SWS_DM_01552] كـ noexcept=default. ويتم التدمير بشكل حتمي عبر مُدمّر الكائن [SWS_DM_01550]، والذي تم الإعلان عنه أيضًا كـ noexcept=default. ويُرجح أن يؤدي إنهاء النقل عبر RequestTransferExit إلى تحرير الكائن. سؤال Q-c1999fd1f283a007 (مفتوح)

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

ينقسم المسار النموذجي لجلسة نقل القراءة إلى ثلاث مراحل متتالية:

  • التهيئة: يُرسل عميل تشخيص خارجي RequestFileTransfer مع وضع قراءة مثل ReadFile ‏(0x04) [SWS_DM_01314] أو ReadDir ‏(0x05) [SWS_DM_01315]. يتم هنا إنشاء نسخة الجلسة وتسجيل معالج القراءة.
  • نقل البيانات: يُعالج خادم التشخيص طلبات التشخيص الواردة من النوع TransferData ‏(0x36) من خلال استدعاء طريقة Read المقابلة للمعالج المسجل عبر منشئات القوالب [SWS_DM_01317]. ويتم ذلك بشكل تكراري لكل كتلة بيانات مطلوبة.
  • الإتمام: بمجرد نقل جميع البيانات، يُرسل العميل RequestTransferExit ‏(0x37). يستدعي خادم التشخيص عندئذٍ طريقة Exit للمعالج المسجل لإنهاء عملية القراءة بشكل سليم [SWS_DM_01318].
سير عملية نقل قراءة قائم على الملفاتعميل التشخيصDiagnostic ServerDataTransferReadSessionRequestFileTransfer (0x38)ReadFile / ReadDirInitialisierung viaTemplate-KonstruktorPositiv-Response (0x78)loopطالما يتم نقل كتل البياناتTransferData (0x36)Read()Gelesene BlockdatenTransferData Positiv-ResponseRequestTransferExit (0x37)Exit()تأكيد الإكمالRequestTransferExit Response

مخطط تسلسلي: تسلسل استدعاء نقل قراءة UDS مع التمرير إلى الجلسة المسجلة. المصادر: [SWS_DM_01314]، [SWS_DM_01315]، [SWS_DM_01317]، [SWS_DM_01318]

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

نظرًا لأنه تم الإعلان عن ara::diag::DataTransferReadSession كـ final وأن المنشئ الافتراضي [SWS_DM_01549] غير موجود، يتم منع الإنشاء الخاطئ دون معالج مسجل بالفعل في وقت الترجمة. وبالمثل، تمنع عمليات النسخ المحذوفة [SWS_DM_01553] التكرار العرضي لحالات الجلسة. كما يضمن كل من بناء النقل وإسناد النقل والتدمير أمانًا مطلقًا من الاستثناءات من خلال مواصفة noexcept الخاصة بها [SWS_DM_01551] [SWS_DM_01550]. وإذا فشل توفير كتل البيانات في المعالج، تتم معالجة ذلك ضمن اتصالات UDS على مستوى البروتوكول.

يستند هذا الدليل إلى مواصفة AUTOSAR Adaptive Platform R25-11 (الوحدة diag) ويُلخص متطلبات ara::diag::DataTransferReadSession.

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

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

2
DataTransferReadSession~DataTransferReadSession

المعاملات

1
operator=

مخطط الفئة

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

G nara__diag__DataTransferReadSession318 DataTransferReadSession + DataTransferReadSession() + ~DataTransferReadSession() + operator=()

عرض التفاصيل

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

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

DataTransferReadSession دالة 3

No default construction allowed.

التحميلات الزائدة DataTransferReadSession 3
DataTransferReadSession ()=delete; SWS_DM_01549
DataTransferReadSession (DataTransferReadSession &&other) noexcept=default; SWS_DM_01551
DataTransferReadSession (DataTransferReadSession const &)=delete; SWS_DM_01553
~DataTransferReadSession دالة

Destructs an instance of this class.

~DataTransferReadSession () noexcept=default;

المعاملات

operator= دالة 2

Move assigns an instance of this class.

التحميلات الزائدة = 2
auto operator= (DataTransferReadSession &&other) & noexcept -> Data TransferReadSession & =default; SWS_DM_01552
auto operator= (DataTransferReadSession const &) -> DataTransferRead Session &=delete; SWS_DM_01554

توثيق الدوال

دالة DataTransferReadSession [SWS_DM_01549] Upstream: RS_Diag_04135

DataTransferReadSession ()=delete;

No default construction allowed.

Header-Datei#include "ara/diag/data_transfer.h"
Scopeclass ara::diag::DataTransferReadSession

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

Record
AUTOSAR/AP/record/SWS_DM_01549
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01549@rel:R25-11#1d0077a2
Content hash
1d0077a2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01549
Status: valid/unmigrated Version: rel:R25-11#b12b963b Versionshistorie & Revisions (1 transition, 5 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_01549@rel:R25-11#b12b963b
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#c4cbcc0b2026-09-30
  • R22-11rel:R22-11#99668fac2026-10-14
  • R23-11rel:R23-11#f616e79a2026-10-14
  • R24-11rel:R24-11#b12b963b2026-10-14
  • R25-11rel:R25-11#b12b963b2026-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

دالة DataTransferReadSession [SWS_DM_01551] Upstream: RS_Diag_04135

DataTransferReadSession (DataTransferReadSession &&other) noexcept=default;

Move constructs an instance of this class.

Header-Datei#include "ara/diag/data_transfer.h"
Scopeclass ara::diag::DataTransferReadSession
Exception-Sicherheitexception safe

Parameter (out)

ParameterBeschreibung
otherThe other object

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

Record
AUTOSAR/AP/record/SWS_DM_01551
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01551@rel:R25-11#e7e3e121
Content hash
e7e3e121
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01551
Status: valid/unmigrated Version: rel:R25-11#9d8ef11f Versionshistorie & Revisions (1 transition, 5 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_01551@rel:R25-11#9d8ef11f
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#21edf1762026-09-30
  • R22-11rel:R22-11#313c13512026-10-14
  • R23-11rel:R23-11#ab0c46e72026-10-14
  • R24-11rel:R24-11#5b475da32026-10-14
  • R25-11rel:R25-11#9d8ef11f2026-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

دالة DataTransferReadSession [SWS_DM_01553] Upstream: RS_Diag_04135

DataTransferReadSession (DataTransferReadSession const &)=delete;

DataTransferReadSession shall be a single not copy-able instance.

Header-Datei#include "ara/diag/data_transfer.h"
Scopeclass ara::diag::DataTransferReadSession

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

Record
AUTOSAR/AP/record/SWS_DM_01553
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01553@rel:R25-11#b82d9d44
Content hash
b82d9d44
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01553
Status: valid/unmigrated Version: rel:R25-11#fbc13491 Versionshistorie & Revisions (1 transition, 5 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_01553@rel:R25-11#fbc13491
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#a630ea6c2026-09-30
  • R22-11rel:R22-11#35a6d77b2026-10-14
  • R23-11rel:R23-11#c1d834202026-10-14
  • R24-11rel:R24-11#6803928e2026-10-14
  • R25-11rel:R25-11#fbc134912026-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_DM_01552] Upstream: RS_Diag_04135

auto operator= (DataTransferReadSession &&other) & noexcept -> Data TransferReadSession & =default;

Move assigns an instance of this class.

Header-Datei#include "ara/diag/data_transfer.h"
Scopeclass ara::diag::DataTransferReadSession
Exception-Sicherheitexception safe

Parameter (out)

ParameterBeschreibung
otherThe other object

Rückgabewert

TypBeschreibung
DataTransferReadSessionReference to self

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

Record
AUTOSAR/AP/record/SWS_DM_01552
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01552@rel:R25-11#5bda0aca
Content hash
5bda0aca
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01552
Status: valid/unmigrated Version: rel:R25-11#d99670ce Versionshistorie & Revisions (1 transition, 5 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_01552@rel:R25-11#d99670ce
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#457fd3d02026-09-30
  • R22-11rel:R22-11#85ce121e2026-10-14
  • R23-11rel:R23-11#e7bc25f92026-10-14
  • R24-11rel:R24-11#826c7d1b2026-10-14
  • R25-11rel:R25-11#d99670ce2026-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_DM_01554] Upstream: RS_Diag_04135

auto operator= (DataTransferReadSession const &) -> DataTransferRead Session &=delete;

DataTransferReadSession shall be a single not assign-able instance.

Header-Datei#include "ara/diag/data_transfer.h"
Scopeclass ara::diag::DataTransferReadSession

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

Record
AUTOSAR/AP/record/SWS_DM_01554
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01554@rel:R25-11#b7836af1
Content hash
b7836af1
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01554
Status: valid/unmigrated Version: rel:R25-11#8d7ab93b Versionshistorie & Revisions (1 transition, 5 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_01554@rel:R25-11#8d7ab93b
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#a2fa062f2026-09-30
  • R22-11rel:R22-11#609b1c622026-10-14
  • R23-11rel:R23-11#22a9c8aa2026-10-14
  • R24-11rel:R24-11#c9a88d712026-10-14
  • R25-11rel:R25-11#8d7ab93b2026-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

دالة ~DataTransferReadSession [SWS_DM_01550] Upstream: RS_Diag_04135

~DataTransferReadSession () noexcept=default;

Destructs an instance of this class.

Header-Datei#include "ara/diag/data_transfer.h"
Scopeclass ara::diag::DataTransferReadSession
Exception-Sicherheitexception safe

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

Record
AUTOSAR/AP/record/SWS_DM_01550
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01550@rel:R25-11#446293cc
Content hash
446293cc
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01550
Status: valid/unmigrated Version: rel:R25-11#0b5bb2a2 Versionshistorie & Revisions (1 transition, 5 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_01550@rel:R25-11#0b5bb2a2
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#d3c560642026-09-30
  • R22-11rel:R22-11#18bafff82026-10-14
  • R23-11rel:R23-11#bfe91d802026-10-14
  • R24-11rel:R24-11#94e05f472026-10-14
  • R25-11rel:R25-11#0b5bb2a22026-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