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

זהו שיעור מופשט.

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

המחלקה הפנימית המופשטת של ProfileData.

סיכום

מטמיעים של מחלקות המשנה ProfileDatabase צריכים להטמיע גם מחלקות משנה של המחלקה הפנימית המשנית הזו. הפונקציה של אובייקטי ProfileData היא לספק קטעי הוק (hooks) שבהם ניתן לאחסן נתונים קונקרטיים, בהינתן ייצוג שלהם כ-TLV ומאוחזרים כייצוג TLV עם רשימת נתיבים בקידוד TLV.

בנייה
ProfileData(void)
בנאי ברירת המחדל של ProfileData.
~ProfileData(void)
המחסנית של ProfileData.

מאפיינים ציבוריים
mVersion
uint64_t
הגרסה של נתוני הפרופיל.

פונקציות ציבוריות
Retrieve(nl::Weave::TLV::TLVReader & aPathReader, nl::Weave::TLV::TLVWriter & aDataWriter)=0
virtual WEAVE_ERROR
כתיבת פריט נתונים בהינתן נתיב WDM שיורי.
Store(nl::Weave::TLV::TLVReader & aPathReader, uint64_t aVersion, nl::Weave::TLV::TLVReader & aDataReader)
virtual WEAVE_ERROR
אחסון פריט ברשימת הנתונים שנקרא.
StoreItem(const uint64_t & aTag, nl::Weave::TLV::TLVReader & aDataReader)=0
virtual WEAVE_ERROR
אחסון פריט נתונים על סמך התג שלו.

מאפיינים ציבוריים

mVersion

uint64_t mVersion

הגרסה של נתוני הפרופיל.

הגרסה שמופיעה כאן באובייקט ProfileData חלה על כל קבוצת נתוני הפרופיל במופע מסוים.

פונקציות ציבוריות

ProfileData

 ProfileData(
  void
)

בנאי ברירת המחדל של ProfileData.

כדי לאתחל פריט ProfileData חדש, מגדירים את הגרסה שלו ל-0.

אחזור

virtual WEAVE_ERROR Retrieve(
  nl::Weave::TLV::TLVReader & aPathReader,
  nl::Weave::TLV::TLVWriter & aDataWriter
)=0

כתיבת פריט נתונים בהינתן נתיב WDM שיורי.

מטמיעי מחלקות משנה של ProfileDatabase חייבים לספק הטמעה קונקרטית לשיטה הזו בכל מקרה שבו לרכיבים הנפרדים של אובייקט המחלקה ProfileData יש גישה לתגים מסוימים.

פרטים
פרמטרים
[in] aPathReader
הפניה לקורא TLV שממוקם בנתיב WDM אחרי פרטי הפרופיל, כלומר בקטע 'שאיר' רכיבי נתיב, אם יש כאלה.
[in] aDataWriter
הפניה לכותב TLV שמשמש לכתיבת הנתונים שמציינים בנתיב השיור.
החזרות
WEAVE_NO_ERROR בהצלחה. אחרת, מוחזר WEAVE_ERROR המשקף חוסר יכולת לזהות תג שנותר או לכתוב את הנתונים המתאימים.

חנות

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

אחסון פריט ברשימת הנתונים שנקרא.

שיטה וירטואלית זו משמשת לאחסון פריט ספציפי ברשימת נתונים באובייקט של תת-מחלקה קונקרטית ProfileData. ניתן להשתמש בהטמעה כאן במחלקה-העל אם האובייקט פשוט ו"חלש", שכולל רק נתיבים באורך רכיב אחד. עבור סכימה מורכבת יותר, מטמיעים צריכים לבטל את השיטה הזו.

פרטים
פרמטרים
[in] aPathReader
הפניה לקורא TLV שממוקם במרכיב הנתיב של פריט רשימת הנתונים.
[in] aVersion
הרכיב של גרסת 64 הסיביות של הפריט ברשימת הנתונים.
[in] aDataReader
הפניה לקורא TLV שממוקם ברכיב הנתונים של פריט רשימת הנתונים.
החזרות
WEAVE_NO_ERROR בהצלחה. אחרת, מוחזר WEAVE_ERROR המציין כי לא ניתן לאחסן את הנתונים שמעניינים אותך.

StoreItem

virtual WEAVE_ERROR StoreItem(
  const uint64_t & aTag,
  nl::Weave::TLV::TLVReader & aDataReader
)=0

אחסון פריט נתונים על סמך התג שלו.

פרטים
פרמטרים
[in] aTag
הפניה לתג TLV באורך 64 ביט שמוגדר במלואו, שבו צריך לאחסן את הנתונים.
[in] aDataReader
קורא TLV ממוקם ליד פריט הנתונים שיש לאחסן.
החזרות
WEAVE_NO_ERROR אם הפעולה מצליחה, מחזירה WEAVE_ERROR המשקף חוסר יכולת לזהות את התג או לאחסן את הנתונים.

~ProfileData

virtual  ~ProfileData(
  void
)

המחסנית של ProfileData.

בדומה ל-constructor, פעולה זו מנקה את גרסת הנתונים ל-0.