nl::Weave::Profiles::DataManagement_Current::TraitSchemaEngine

#include <src/lib/profiles/data-management/Current/TraitData.h>

Mesin skema mengambil informasi skema yang terkait dengan karakteristik tertentu dan menyediakan fasilitas untuk mengurai dan menerjemahkannya ke dalam bentuk yang dapat digunakan oleh mesin WDM.

Ringkasan

Hal ini mencakup konversi dari PathHandles ke jalur WDM (dan sebaliknya), metode untuk menafsirkan/mengkueri skema itu sendiri, dan metode untuk membantu membaca/menulis data ke/dari TLV dengan handle tertentu.

Skema itu sendiri disimpan dalam bentuk tabel, yang dijelaskan secara memadai untuk memungkinkan penguraian/komposisi generik jalur/data WDM untuk setiap sifat tertentu. Tabel ini adalah output akhir dari 'code-gen' (Istilah itu sendiri agak menyesatkan karena tidak ada kode yang dihasilkan :P)

Atribut statis publik
kHandleTableOffset = 2
const uint32_t

Atribut publik
mSchema
const Schema

Fungsi publik
FindLowestCommonAncestor(PropertyPathHandle aHandle1, PropertyPathHandle aHandle2, PropertyPathHandle *aHandle1BranchChild, PropertyPathHandle *aHandle2BranchChild) const
Dengan dua nama sebutan properti, hitung nama sebutan terendah yang berfungsi sebagai induk untuk kedua nama sebutan ini.
GetChildHandle(PropertyPathHandle aParentHandle, uint8_t aContextTag) const
GetDepth(PropertyPathHandle aHandle) const
int32_t
Menghitung kedalaman dalam hierarki skema untuk nama sebutan channel tertentu.
GetDictionaryItemHandle(PropertyPathHandle aParentHandle, uint16_t aDictionaryKey) const
GetFirstChild(PropertyPathHandle aParentHandle) const
Menampilkan nama sebutan channel turunan pertama yang terkait dengan induk tertentu.
GetHighestForwardVersion(SchemaVersion aVersion) const
SchemaVersion
Dengan versi skema data yang diberikan, tindakan ini akan menampilkan versi skema yang kompatibel dengan versi mendatang tertinggi.
GetLowestCompatibleVersion(SchemaVersion aVersion) const
SchemaVersion
Dengan versi skema data yang diberikan, tindakan ini akan menampilkan versi skema minimum yang kompatibel.
GetMap(PropertyPathHandle aHandle) const
const PropertyInfo *
Menampilkan pointer ke struktur PropertyInfo yang menjelaskan handle jalur tertentu.
GetMaxVersion() const
SchemaVersion
GetMinVersion() const
SchemaVersion
GetNextChild(PropertyPathHandle aParentId, PropertyPathHandle aChildHandle) const
Mengingat handle untuk turunan yang ada, menampilkan handle turunan berikutnya yang terkait dengan induk tertentu.
GetParent(PropertyPathHandle aHandle) const
Menampilkan nama sebutan induk dari nama sebutan jalur turunan tertentu.
GetProfileId(void) const
uint32_t
Menampilkan ID profil dari karakteristik terkait.
GetRelativePathTags(const PropertyPathHandle aCandidateHandle, uint64_t *aTags, const uint32_t aTagsSize, uint32_t & aNumTags) const
Mengonversi PropertyPathHandle menjadi array tag konteks.
GetTag(PropertyPathHandle aHandle) const
uint64_t
Menampilkan tag yang terkait dengan handle jalur.
GetVersionIntersection(SchemaVersionRange & aVersion, SchemaVersionRange & aIntersection) const
bool
Dengan mempertimbangkan rentang versi, fungsi ini memeriksa apakah ada perpotongan kompatibilitas antara versi tersebut dan apa yang didukung oleh skema yang mendukung mesin skema ini.
IsDictionary(PropertyPathHandle aHandle) const
bool
Menampilkan nilai benar jika nama sebutan channel adalah kamus (dan bukan dalam kamus - lihat metode di bawah).
IsEphemeral(PropertyPathHandle aHandle) const
bool
IsInDictionary(PropertyPathHandle aHandle, PropertyPathHandle & aDictionaryItemHandle) const
bool
Menampilkan true jika handle berada di dalam kamus (elemen kamus).
IsLeaf(PropertyPathHandle aPropertyHandle) const
bool
Menampilkan true jika nama sebutan merujuk ke node daun dalam hierarki skema.
IsNullable(PropertyPathHandle aHandle) const
bool
IsOptional(PropertyPathHandle aHandle) const
bool
IsParent(PropertyPathHandle aChildHandle, PropertyPathHandle aParentHandle) const
bool
Memeriksa apakah nama sebutan channel tertentu adalah turunan dari nama sebutan channel lain.
MapHandleToPath(PropertyPathHandle aHandle, nl::Weave::TLV::TLVWriter & aPathWriter) const
Konversikan handle jalur ke jalur TLV.
MapPathToHandle(nl::Weave::TLV::TLVReader & aPathReader, PropertyPathHandle & aHandle) const
Dengan pembaca yang diposisikan di root elemen jalur WDM, bacakan tag yang relevan dan berikan handle jalur yang setara.
MapPathToHandle(const char *aPathString, PropertyPathHandle & aHandle) const
Dengan representasi string jalur WDM, baca tag yang relevan dan berikan handle jalur yang setara.
MatchesProfileId(uint32_t aProfileId) const
bool
Menampilkan true jika profileId yang diteruskan cocok dengan yang disimpan dalam skema.
RetrieveData(PropertyPathHandle aHandle, uint64_t aTagToWrite, nl::Weave::TLV::TLVWriter & aWriter, IGetDataDelegate *aDelegate, IDirtyPathCut *apDirtyPathCut) const
Dengan handle jalur dan posisi penulis pada elemen data yang sesuai, ambil data daun dari sumber dan tulis ke buffer yang ditunjuk oleh penulis dengan cara yang sesuai dengan skema.
RetrieveUpdatableDictionaryData(PropertyPathHandle aHandle, uint64_t aTagToWrite, nl::Weave::TLV::TLVWriter & aWriter, IGetDataDelegate *aDelegate, PropertyPathHandle & aPropertyPathHandleOfDictItemToStartFrom) const
StoreData(PropertyPathHandle aHandle, nl::Weave::TLV::TLVReader & aReader, ISetDataDelegate *aDelegate, IPathFilter *aPathFilter) const
Dengan handle jalur dan pembaca yang diposisikan pada elemen data yang sesuai, proses buffering data yang ditunjuk oleh pembaca dan simpan ke sink dengan memanggil panggilan SetLeafData setiap kali item data leaf ditemukan.

Class
nl::Weave::Profiles::DataManagement_Current::TraitSchemaEngine::IGetDataDelegate
nl::Weave::Profiles::DataManagement_Current::TraitSchemaEngine::ISetDataDelegate

Struct
nl::Weave::Profiles::DataManagement_Current::TraitSchemaEngine::PropertyInfo
nl::Weave::Profiles::DataManagement_Current::TraitSchemaEngine::Schema

Struktur skema utama yang menampung informasi skema.

Atribut statis publik

kHandleTableOffset

const uint32_t kHandleTableOffset = 2

Atribut publik

mSchema

const Schema mSchema

Fungsi publik

FindLowestCommonAncestor

PropertyPathHandle FindLowestCommonAncestor(
  PropertyPathHandle aHandle1,
  PropertyPathHandle aHandle2,
  PropertyPathHandle *aHandle1BranchChild,
  PropertyPathHandle *aHandle2BranchChild
) const

Dengan dua nama sebutan properti, hitung nama sebutan terendah yang berfungsi sebagai induk untuk kedua nama sebutan ini.

Selain itu, tampilkan dua cabang turunan yang berisi setiap dua nama sebutan channel (meskipun sama).

Detail
Nilai yang Ditampilkan
PropertyPathHandle
Menangani ke induk terendah.

GetChildHandle

PropertyPathHandle GetChildHandle(
  PropertyPathHandle aParentHandle,
  uint8_t aContextTag
) const

GetDepth

int32_t GetDepth(
  PropertyPathHandle aHandle
) const

Menghitung kedalaman dalam hierarki skema untuk nama sebutan channel tertentu.

Detail
Nilai yang Ditampilkan
int32_t
Kedalaman dalam hierarki

GetDictionaryItemHandle

PropertyPathHandle GetDictionaryItemHandle(
  PropertyPathHandle aParentHandle,
  uint16_t aDictionaryKey
) const

GetFirstChild

PropertyPathHandle GetFirstChild(
  PropertyPathHandle aParentHandle
) const

Menampilkan nama sebutan channel turunan pertama yang terkait dengan induk tertentu.

Detail
Nilai yang Ditampilkan
PropertyPathHandle
Nama sebutan turunan pertama.

GetHighestForwardVersion

SchemaVersion GetHighestForwardVersion(
  SchemaVersion aVersion
) const

Dengan versi skema data yang diberikan, tindakan ini akan menampilkan versi skema yang kompatibel dengan versi mendatang tertinggi.

GetLowestCompatibleVersion

SchemaVersion GetLowestCompatibleVersion(
  SchemaVersion aVersion
) const

Dengan mempertimbangkan versi skema data yang disediakan, versi ini akan menampilkan versi skema minimum yang kompatibel.

GetMap

const PropertyInfo * GetMap(
  PropertyPathHandle aHandle
) const

Menampilkan pointer ke struktur PropertyInfo yang menjelaskan handle jalur tertentu.

Detail
Nilai yang Ditampilkan
PropertyInfo*

GetMaxVersion

SchemaVersion GetMaxVersion() const

GetMinVersion

SchemaVersion GetMinVersion() const

GetNextChild

PropertyPathHandle GetNextChild(
  PropertyPathHandle aParentId,
  PropertyPathHandle aChildHandle
) const

Dengan nama sebutan channel yang diberikan ke turunan yang ada, menampilkan nama sebutan channel turunan berikutnya yang terkait dengan induk tertentu.

Detail
Nilai yang Ditampilkan
PropertyPathHandle
Nama sebutan anak berikutnya.

GetParent

PropertyPathHandle GetParent(
  PropertyPathHandle aHandle
) const

Menampilkan nama sebutan induk dari nama sebutan jalur turunan tertentu.

Kunci kamus di nama sebutan akan dipertahankan jika nama sebutan induk juga merupakan elemen kamus.

Detail
Nilai yang Ditampilkan
PropertyPathHandle
Nama sebutan channel induk.

GetProfileId

uint32_t GetProfileId(
  void
) const

Menampilkan ID profil dari atribut terkait.

Detail
Nilai yang Ditampilkan
Trait
ID profil

GetRelativePathTags

WEAVE_ERROR GetRelativePathTags(
  const PropertyPathHandle aCandidateHandle,
  uint64_t *aTags,
  const uint32_t aTagsSize,
  uint32_t & aNumTags
) const

Mengonversi PropertyPathHandle ke array tag konteks.

Detail
Parameter
[in] aCandidateHandle
PropertyPathHandle yang akan dikonversi.
[in] aTags
Pointer ke array output.
[in] aTagsSize
Ukuran array aTags, dalam jumlah elemen.
[out] aNumTags
Jumlah tag yang ditulis ke Tag
Hasil
WEAVE_NO_ERROR jika berhasil; WEAVE_ERROR_NO_MEMORY jika aTags terlalu kecil untuk menyimpan jalur lengkap.

GetTag

uint64_t GetTag(
  PropertyPathHandle aHandle
) const

Menampilkan tag yang terkait dengan handle jalur.

Jika elemen kamus, fungsi ini akan menampilkan ProfileTag. Jika tidak, sistem akan menampilkan tag konteks.

Detail
Nilai yang Ditampilkan
uint64_t

GetVersionIntersection

bool GetVersionIntersection(
  SchemaVersionRange & aVersion,
  SchemaVersionRange & aIntersection
) const

Dengan rentang versi tertentu, fungsi ini akan memeriksa apakah ada persimpangan kompatibilitas antara rentang versi tersebut dan yang didukung oleh skema yang mendukung mesin skema ini.

Jika ada persimpangan, fungsi akan menampilkan true dan memperbarui argumen aIntersection yang diteruskan untuk mencerminkan hasil pengujian persimpangan tersebut.

IsDictionary

bool IsDictionary(
  PropertyPathHandle aHandle
) const

Menampilkan nilai benar jika nama sebutan channel adalah kamus (dan bukan dalam kamus - lihat metode di bawah).

Detail
Nilai yang Ditampilkan
bool

IsEphemeral

bool IsEphemeral(
  PropertyPathHandle aHandle
) const

IsInDictionary

bool IsInDictionary(
  PropertyPathHandle aHandle,
  PropertyPathHandle & aDictionaryItemHandle
) const

Menampilkan true jika handle berada di dalam kamus (elemen kamus).

Pengguna yang diteruskan ke nama sebutan channel (aDictionaryItemHandle) akan diperbarui agar mengarah ke nama sebutan channel kamus paling atas dalam kamus.

Detail
Nilai yang Ditampilkan
bool

IsLeaf

bool IsLeaf(
  PropertyPathHandle aPropertyHandle
) const

Menampilkan true (benar) jika handle merujuk pada node daun di hierarki skema.

Detail
Nilai yang Ditampilkan
bool

IsNullable

bool IsNullable(
  PropertyPathHandle aHandle
) const

IsOptional

bool IsOptional(
  PropertyPathHandle aHandle
) const

IsParent

bool IsParent(
  PropertyPathHandle aChildHandle,
  PropertyPathHandle aParentHandle
) const

Memeriksa apakah nama sebutan channel yang diberikan adalah turunan dari nama sebutan channel lain.

Ini dapat berupa induk tidak langsung.

Detail
Nilai yang Ditampilkan
bool

MapHandleToPath

WEAVE_ERROR MapHandleToPath(
  PropertyPathHandle aHandle,
  nl::Weave::TLV::TLVWriter & aPathWriter
) const

Konversikan handle jalur ke jalur TLV.

Detail
Nilai yang Ditampilkan
WEAVE_NO_ERROR
Jika berhasil.
other
Tidak dapat mengonversi nama sebutan ke jalur TLV

MapPathToHandle

WEAVE_ERROR MapPathToHandle(
  nl::Weave::TLV::TLVReader & aPathReader,
  PropertyPathHandle & aHandle
) const

Dengan pembaca yang diposisikan di root elemen jalur WDM, baca tag yang relevan dan berikan handle jalur yang setara.

Detail
Nilai yang Ditampilkan
WEAVE_NO_ERROR
Jika berhasil.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
Jika nama sebutan channel yang cocok tidak dapat ditemukan karena format jalur salah/salah ditentukan.

MapPathToHandle

WEAVE_ERROR MapPathToHandle(
  const char *aPathString,
  PropertyPathHandle & aHandle
) const

Dengan representasi string jalur WDM, baca tag yang relevan dan berikan handle jalur yang setara.

Jalur WDM direpresentasikan sebagai string menggunakan aturan berikut:

  • tag dipisahkan dengan /
  • jalur HARUS diawali dengan / di awal dan TIDAK BOLEH berisi garis miring di akhir
  • tag numerik di jalur WDM HARUS dienkode menggunakan library C standar untuk encoding bilangan bulat ke string, yaitu encoding desimal (default) TIDAK BOLEH berisi 0 di awal, encoding heksadesimal HARUS diawali dengan 0x, dan encoding oktal HARUS berisi 0 di awal.

Detail
Nilai yang Ditampilkan
WEAVE_NO_ERROR
Jika berhasil.
WEAVE_ERROR_TLV_TAG_NOT_FOUND
Jika nama sebutan channel yang cocok tidak dapat ditemukan.
WEAVE_ERROR_INVALID_ARGUMENT
Jika string jalur salah

MatchesProfileId

bool MatchesProfileId(
  uint32_t aProfileId
) const

Menampilkan true (benar) jika ID profil yang diteruskan cocok dengan yang tersimpan dalam skema.

Detail
Nilai yang Ditampilkan
bool

RetrieveData

WEAVE_ERROR RetrieveData(
  PropertyPathHandle aHandle,
  uint64_t aTagToWrite,
  nl::Weave::TLV::TLVWriter & aWriter,
  IGetDataDelegate *aDelegate,
  IDirtyPathCut *apDirtyPathCut
) const

Dengan handle jalur dan posisi penulis pada elemen data yang sesuai, ambil data daun dari sumber dan tulis ke buffer yang ditunjuk oleh penulis dengan cara yang sesuai dengan skema.

Detail
Nilai yang Ditampilkan
WEAVE_NO_ERROR
Jika berhasil.
other
Terjadi error saat menulis data.

RetrieveUpdatableDictionaryData

WEAVE_ERROR RetrieveUpdatableDictionaryData(
  PropertyPathHandle aHandle,
  uint64_t aTagToWrite,
  nl::Weave::TLV::TLVWriter & aWriter,
  IGetDataDelegate *aDelegate,
  PropertyPathHandle & aPropertyPathHandleOfDictItemToStartFrom
) const

StoreData

WEAVE_ERROR StoreData(
  PropertyPathHandle aHandle,
  nl::Weave::TLV::TLVReader & aReader,
  ISetDataDelegate *aDelegate,
  IPathFilter *aPathFilter
) const

Dengan handle jalur dan pembaca yang diposisikan pada elemen data yang sesuai, proses buffering data yang ditunjuk oleh pembaca dan simpan ke sink dengan memanggil panggilan SetLeafData setiap kali item data leaf ditemukan.

Detail
Nilai yang Ditampilkan
WEAVE_NO_ERROR
Jika berhasil.
other
Terjadi error saat mengurai/memproses data.