nl::Weave::Profiles::DataManagement_Legacy::ProfileDatabase

هذه فئة تجريدية.

#include <src/lib/profiles/data-management/Legacy/ProfileDatabase.h>

الفئة الإضافية المجرّدة ProfileDatabase.

ملخّص

تفصل WDM تنفيذ البروتوكول عن تنفيذ إدارة البيانات، وتترك الجزء الأكبر منه من حيث المبدأ على الأقل لمطوِّر التطبيق. تأخذ جميع الطلبات المثيرة للاهتمام في WDM وجميع الطرق المجرّدة التي يطلبها مطوّر الملف الشخصي تنفيذها قوائم مسارات أو قوائم بيانات بترميز TLV. ويشكِّل ذلك عبئًا على مطوّري الملفات الشخصية، وسيتسبب عمليًا بحدوث الكثير من حالات تكرار الرموز التي قد يُحدثها المطوّر بعد أن يكتب المطوّر الرمز نفسه لتعبئة ملف TLV وتفريغه، وما إلى ذلك. ولتسهيل الأمر قليلاً، نقدّم نوعًا من "مجموعة أدوات إدارة البيانات".

توفّر هذه الفئة الإضافية إمكانية تخزين البيانات واستردادها بشرط توفير الفئات الفرعية الملموسة اللازمة من ProfileData وإضافتها إلى طريقة LookupProfileData() أدناه.

الدوال العامة
LookupDataFromProfileDescriptor(nl::Weave::TLV::TLVReader & aDescReader, ProfileData **aProfileData)
ابحث عن كائن ProfileData في قاعدة البيانات.
LookupProfileData(nl::Weave::TLV::TLVReader & aPathReader, ProfileData **aProfileData)
ابحث عن كائن ProfileData في قاعدة البيانات.
LookupProfileData(uint32_t aProfileId, nl::Weave::TLV::TLVReader *aInstanceIdRdr, ProfileData **aResult)=0
virtual WEAVE_ERROR
ابحث عن كائن ProfileData.
Retrieve(ReferencedTLVData & aPathList, ReferencedTLVData & aDataList)
استرداد قائمة بيانات معينة لقائمة مسارات.
Retrieve(ReferencedTLVData & aPathList, nl::Weave::TLV::TLVWriter & aWriter)
اكتب قائمة بيانات بالنظر إلى قائمة المسارات.
Store(ReferencedTLVData & aDataList)
تخزين قائمة بيانات.

الدوال المحمية
StoreInternal(nl::Weave::TLV::TLVReader & aPathReader, uint64_t aVersion, nl::Weave::TLV::TLVReader & aDataReader)

صفوف
nl::Weave::Profiles::DataManagement_Legacy::ProfileDatabase::ProfileData

الفئة الداخلية المجرّدة ProfileData

الدوال العامة

LookupDataFromProfileDescriptor

WEAVE_ERROR LookupDataFromProfileDescriptor(
  nl::Weave::TLV::TLVReader & aDescReader,
  ProfileData **aProfileData
)

ابحث عن كائن ProfileData في قاعدة البيانات.

تُستخدم طريقة الأداة هذه للعثور على كائنات ProfileData في نوع معين من ProfileDatabase. ويعتمد ذلك إلى حد كبير على طرق البحث التي يوفرها منفّذ الفئة الفرعية الملموسة ProfileDatabase.

التفاصيل
المَعلمات
[in] aDescReader
يشير إلى قارئ TLV موضوع في مسار WDM، أي مسار TLV يحتوي، عنصره الأول، على وصف للملف الشخصي.
[out] aProfileData
مؤشر يهدف إلى عرض مؤشر إلى الكائن ProfileData المهم له.
المرتجعات
WEAVE_NO_ERROR عند نجاح العملية، أو عرض خطأ WEAVE_ERROR يشير إلى تعذّر البحث عن كائن ProfileData مطابق.

LookupProfileData

WEAVE_ERROR LookupProfileData(
  nl::Weave::TLV::TLVReader & aPathReader,
  ProfileData **aProfileData
)

ابحث عن كائن ProfileData في قاعدة البيانات.

تُستخدم طريقة الأداة هذه للعثور على كائنات ProfileData في نوع معين من ProfileDatabase. ويعتمد ذلك إلى حد كبير على طرق البحث التي يوفرها منفّذ الفئة الفرعية الملموسة ProfileDatabase.

التفاصيل
المَعلمات
[in] aPathReader
يشير إلى قارئ TLV موضوع في مسار WDM، أي مسار TLV يحتوي، عنصره الأول، على وصف للملف الشخصي.
[out] aProfileData
مؤشر يهدف إلى عرض مؤشر إلى الكائن ProfileData المهم له.
المرتجعات
WEAVE_NO_ERROR عند نجاح العملية، أو عرض خطأ WEAVE_ERROR يشير إلى تعذّر البحث عن كائن ProfileData مطابق.

LookupProfileData

virtual WEAVE_ERROR LookupProfileData(
  uint32_t aProfileId,
  nl::Weave::TLV::TLVReader *aInstanceIdRdr,
  ProfileData **aResult
)=0

ابحث عن كائن ProfileData.

ابحث عن عنصر ProfileData معيّن من خلال رقم تعريف الملف الشخصي ورقم تعريف المثيل (اختياري)< الذي يتم تقديمه كقارئ TLV.

التفاصيل
المَعلمات
[in] aProfileId
رقم الملف الشخصي 32 بت للملف الشخصي محل الاهتمام.
[in] aInstanceIdRdr
مؤشر يشير إلى قارئ TLV ضِمن بيانات معرِّف المثيل. إذا لم يتم تقديم معرّف المثيل، يكون هذا الحقل فارغًا (NULL).
[out] aResult
مؤشر يهدف إلى عرض مؤشر إلى الكائن ProfileData المهم له.
المرتجعات
WEAVE_NO_ERROR بنجاح. بخلاف ذلك، يتم عرض WEAVE_ERROR يشير إلى عدم القدرة على العثور على كائن ProfileData.

استرداد

WEAVE_ERROR Retrieve(
  ReferencedTLVData & aPathList,
  ReferencedTLVData & aDataList
)

استرداد قائمة بيانات معينة لقائمة مسارات.

استنادًا إلى قائمة المسارات، استرجع قائمة بيانات تتضمن عناصر قائمة البيانات لكل مسار في قائمة المسارات، البيانات التي تمثل طرفًا لهذا المسار.

التفاصيل
المَعلمات
[in] aPathList
يشير إلى عنصر ReferencedTLVData الذي يحتوي على قائمة مسارات بترميز TLV تمثّل البيانات المطلوب استردادها. تظل هذه المعلمة ثابتة طوال تنفيذ هذه الدالة.
[out] aDataList
يشير إلى عنصر ReferencedTLVData الذي يمكن فيه كتابة النتائج التي تم استردادها. يتم تعديل طول البيانات فقط بعد تنفيذ هذه الدالة بنجاح.
المرتجعات
WEAVE_NO_ERROR بنجاح. بخلاف ذلك، يمكنك عرض رمز WEAVE_ERROR يشير إلى تعذّر استرداد قائمة البيانات المهمة.

استرداد

WEAVE_ERROR Retrieve(
  ReferencedTLVData & aPathList,
  nl::Weave::TLV::TLVWriter & aWriter
)

اكتب قائمة بيانات بالنظر إلى قائمة المسارات.

استنادًا إلى قائمة بالمسارات وكاتب TLV، يمكنك كتابة قائمة بيانات تحتوي على عناصر قائمة البيانات لكل مسار في قائمة المسارات والبيانات التي تمثّل طرفًا لهذا المسار.

التفاصيل
المَعلمات
[in] aPathList
يشير إلى عنصر ReferencedTLVData الذي يحتوي على قائمة بمسارات TLV التي تمثِّل البيانات المطلوب استردادها. تظل هذه المعلمة ثابتة طوال تنفيذ هذه الدالة.
[in] aWriter
مرجع إلى كاتب TLV لاستخدامه في كتابة قائمة المسارات التي تم استردادها. قد تصبح الحالة الداخلية للكاتب غير قابلة للاسترداد في حال حدوث خطأ.
المرتجعات
WEAVE_NO_ERROR بنجاح. بخلاف ذلك، يمكنك عرض رمز WEAVE_ERROR يشير إلى تعذّر استرداد البيانات أو كتابة قائمة البيانات التي تهمّك.

المتجر

WEAVE_ERROR Store(
  ReferencedTLVData & aDataList
)

تخزين قائمة بيانات.

باستخدام قائمة بيانات بترميز TLV، تمر هذه الطريقة بعملية تحليل تلك القائمة واستدعاء الطرق الملموسة التي يوفرها منفِّذو الفئة الفرعية ProfileDatabase لوضع البيانات المشار إليها في المكان الذي تنتمي إليه.

التفاصيل
المَعلمات
[in] aDataList
يشير إلى عنصر ReferencedTLVData الذي يحتوي على البيانات المهمة في نموذج بترميز TLV.
المرتجعات
WEAVE_NO_ERROR بنجاح. وبخلاف ذلك، يمكنك عرض WEAVE_ERROR تشير إلى تعذُّر تخزين البيانات المهمة.

الدوال المحمية

StoreInternal

WEAVE_ERROR StoreInternal(
  nl::Weave::TLV::TLVReader & aPathReader,
  uint64_t aVersion,
  nl::Weave::TLV::TLVReader & aDataReader
)