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, השיטה הזו עוברת את תהליך ניתוח הרשימה הזו וקריאה ל-methods קונקרטיות שמסופקות על ידי מטמיעי המשנה של 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
)