หน้านี้ได้รับการแปลโดย Cloud Translation API

nl::Weave::โปรไฟล์::DataManagement_Current::TraitSchemaEngine

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

เครื่องมือสคีมาจะนําข้อมูลสคีมาที่เชื่อมโยงกับคุณลักษณะเฉพาะหนึ่งๆ มาใช้ และมอบเครื่องมือในการแยกวิเคราะห์และแปลลงในแบบฟอร์มที่เครื่อง WDM ใช้งานได้

สรุป

ซึ่งรวมถึงการแปลงจากเส้นทาง PathHandles เป็นเส้นทาง WDM (และในทางกลับกัน) วิธีตีความ/ค้นหาสคีมาเองและวิธีการที่จะช่วยให้อ่าน/เขียนข้อมูลไปยัง/จาก TLV ที่ระบุ

สคีมาจะจัดเก็บไว้ในรูปแบบตารางซึ่งอธิบายอย่างเพียงพอเพื่ออนุญาตการแยกวิเคราะห์/องค์ประกอบทั่วไปของเส้นทาง/ข้อมูล WDM สําหรับลักษณะเฉพาะใดๆ ตารางเหล่านี้คือผลลัพธ์สุดท้ายใน 'code-gen' (ตัวคําที่ทําให้เข้าใจผิดเพราะไม่มีโค้ดที่สร้างขึ้น :P)

แอตทริบิวต์สาธารณะแบบคงที่
`kHandleTableOffset = 2`	`const uint32_t`

แอตทริบิวต์สาธารณะ
`mSchema`	`const Schema`

ฟังก์ชันสาธารณะ
`FindLowestCommonAncestor(PropertyPathHandle aHandle1, PropertyPathHandle aHandle2, PropertyPathHandle aHandle1BranchChild, PropertyPathHandle aHandle2BranchChild) const`	`PropertyPathHandle` จะคํานวณแฮนเดิลที่ต่ําที่สุดซึ่งทําหน้าที่เป็นระดับบนสุดของแฮนเดิลทั้ง 2 รายการนี้ เนื่องจากแฮนเดิลพร็อพเพอร์ตี้ 2 รายการ
`GetChildHandle(PropertyPathHandle aParentHandle, uint8_t aContextTag) const`	`PropertyPathHandle`
`GetDepth(PropertyPathHandle aHandle) const`	`int32_t` คํานวณความลึกในแผนผังสคีมาสําหรับแฮนเดิลที่กําหนด
`GetDictionaryItemHandle(PropertyPathHandle aParentHandle, uint16_t aDictionaryKey) const`	`PropertyPathHandle`
`GetFirstChild(PropertyPathHandle aParentHandle) const`	`PropertyPathHandle` แสดงผลแฮนเดิลย่อยแรกที่เชื่อมโยงกับระดับบนสุด
`GetHighestForwardVersion(SchemaVersion aVersion) const`	`SchemaVersion` เวอร์ชันของสคีมาสคีมาที่ระบุที่ระบุจะส่งคืนเวอร์ชันสคีมาที่เข้ากันได้สูงสุด
`GetLowestCompatibleVersion(SchemaVersion aVersion) const`	`SchemaVersion` เวอร์ชันของสคีมาสคีมาที่ระบุที่ระบุจะส่งคืนเวอร์ชันสคีมาขั้นต่ําที่เข้ากันได้
`GetMap(PropertyPathHandle aHandle) const`	`const PropertyInfo *` แสดงผลตัวชี้ไปยังโครงสร้าง PropertyInfo ที่อธิบายแฮนเดิลเส้นทางที่เจาะจง
`GetMaxVersion() const`	`SchemaVersion`
`GetMinVersion() const`	`SchemaVersion`
`GetNextChild(PropertyPathHandle aParentId, PropertyPathHandle aChildHandle) const`	`PropertyPathHandle` แฮนเดิลที่มีการจัดการถัดไปจะส่งคืนแฮนเดิลย่อยถัดไปที่เชื่อมโยงกับบัญชีระดับบนสุดที่เฉพาะเจาะจง
`GetParent(PropertyPathHandle aHandle) const`	`PropertyPathHandle` แสดงผลแฮนเดิลระดับบนสุดของแฮนเดิลเส้นทางย่อยที่ระบุ
`GetProfileId(void) const`	`uint32_t` แสดงรหัสโปรไฟล์ของลักษณะที่เกี่ยวข้อง
`GetRelativePathTags(const PropertyPathHandle aCandidateHandle, uint64_t *aTags, const uint32_t aTagsSize, uint32_t & aNumTags) const`	`WEAVE_ERROR` แปลง PropertyPathHandle เป็นอาร์เรย์ของแท็กบริบท
`GetTag(PropertyPathHandle aHandle) const`	`uint64_t` แสดงผลแท็กที่เชื่อมโยงกับแฮนเดิลเส้นทาง
`GetVersionIntersection(SchemaVersionRange & aVersion, SchemaVersionRange & aIntersection) const`	`bool` เพื่อให้มีช่วงฟังก์ชันนี้ ฟังก์ชันนี้จะตรวจสอบว่ามีจุดร่วมระหว่างค่าดังกล่าวหรือไม่ และสคีมาที่อยู่เบื้องหลังเครื่องมือสคีมานี้รองรับมีอะไรบ้าง
`IsDictionary(PropertyPathHandle aHandle) const`	`bool` ส่งคืนค่า "จริง" หากแฮนเดิลเป็นพจนานุกรม (ไม่ใช่ในพจนานุกรม โปรดดูวิธีการด้านล่าง)
`IsEphemeral(PropertyPathHandle aHandle) const`	`bool`
`IsInDictionary(PropertyPathHandle aHandle, PropertyPathHandle & aDictionaryItemHandle) const`	`bool` แสดงค่า "จริง" หากแฮนเดิลอยู่ในภายในพจนานุกรม (องค์ประกอบพจนานุกรม)
`IsLeaf(PropertyPathHandle aPropertyHandle) const`	`bool` แสดงผลเป็น "จริง" หากแฮนเดิลหมายถึงโหนด Leaf ในแผนผังสคีมา
`IsNullable(PropertyPathHandle aHandle) const`	`bool`
`IsOptional(PropertyPathHandle aHandle) const`	`bool`
`IsParent(PropertyPathHandle aChildHandle, PropertyPathHandle aParentHandle) const`	`bool` ตรวจสอบว่าแฮนเดิลหนึ่งเป็นของแฮนเดิลอื่นหรือไม่
`MapHandleToPath(PropertyPathHandle aHandle, nl::Weave::TLV::TLVWriter & aPathWriter) const`	`WEAVE_ERROR` แปลงแฮนเดิลเส้นทางเป็นเส้นทาง TLV
`MapPathToHandle(nl::Weave::TLV::TLVReader & aPathReader, PropertyPathHandle & aHandle) const`	`WEAVE_ERROR` ให้อ่านแท็กที่เกี่ยวข้องที่รากขององค์ประกอบเส้นทาง WDM แล้วอ่านแท็กที่เกี่ยวข้องและระบุแฮนเดิลเส้นทางที่เทียบเท่า
`MapPathToHandle(const char *aPathString, PropertyPathHandle & aHandle) const`	`WEAVE_ERROR` ในการนําเสนอสตริงสตริงของเส้นทาง WDM ให้อ่านแท็กที่เกี่ยวข้องและระบุแฮนเดิลของเส้นทางที่เทียบเท่า
`MatchesProfileId(uint32_t aProfileId) const`	`bool` แสดงผลเป็น "จริง" หากการส่งต่อใน profileId ตรงกับที่เก็บไว้ในสคีมา
`RetrieveData(PropertyPathHandle aHandle, uint64_t aTagToWrite, nl::Weave::TLV::TLVWriter & aWriter, IGetDataDelegate aDelegate, IDirtyPathCut apDirtyPathCut) const`	`WEAVE_ERROR` จากแฮนเดิลเส้นทางและตําแหน่งผู้เขียนในองค์ประกอบข้อมูลที่เกี่ยวข้อง ให้เรียกข้อมูล Leaf จากแหล่งข้อมูล และเขียนลงในบัฟเฟอร์ที่ผู้เขียนชี้ไปที่ในลักษณะที่เป็นไปตามสคีมา
`RetrieveUpdatableDictionaryData(PropertyPathHandle aHandle, uint64_t aTagToWrite, nl::Weave::TLV::TLVWriter & aWriter, IGetDataDelegate *aDelegate, PropertyPathHandle & aPropertyPathHandleOfDictItemToStartFrom) const`	`WEAVE_ERROR`
`StoreData(PropertyPathHandle aHandle, nl::Weave::TLV::TLVReader & aReader, ISetDataDelegate aDelegate, IPathFilter aPathFilter) const`	`WEAVE_ERROR` แฮนเดิลแฮนเดิลที่วางอยู่บนองค์ประกอบข้อมูลที่เกี่ยวข้อง ให้ประมวลผลบัฟเฟอร์ข้อมูลที่เครื่องอ่านชี้ไปและเก็บไว้ในถังขยะโดยเรียกใช้การเรียก SetLeafData เมื่อใดก็ตามที่พบรายการข้อมูล Leaf

ชั้นเรียน
nl::Weave::Profiles::DataManagement_Current::TraitSchemaEngine::IGetDataDelegate
nl::Weave::Profiles::DataManagement_Current::TraitSchemaEngine::ISetDataDelegate

โครงสร้าง
nl::Weave::Profiles::DataManagement_Current::TraitSchemaEngine::PropertyInfo
nl::Weave::Profiles::DataManagement_Current::TraitSchemaEngine::Schema	โครงสร้างสคีมาหลักที่จัดเก็บข้อมูลสคีมา

แอตทริบิวต์สาธารณะแบบคงที่

ออฟเซ็ตตาราง KkTable

const uint32_t kHandleTableOffset = 2

แอตทริบิวต์สาธารณะ

สคีมา mm

const Schema mSchema

ฟังก์ชันสาธารณะ

FindLowestCommonAncestor

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

จะคํานวณแฮนเดิลที่ต่ําที่สุดซึ่งทําหน้าที่เป็นระดับบนสุดของแฮนเดิลทั้ง 2 รายการนี้ เนื่องจากแฮนเดิลพร็อพเพอร์ตี้ 2 รายการ

นอกจากนี้ ให้แสดงผลสาขาย่อย 2 สาขาที่มีแฮนเดิลทั้ง 2 หมายเลข (แม้ว่าเหมือนกัน)

รายละเอียด

แสดงผลค่า

PropertyPathHandle

แฮนเดิลไปยังระดับบนสุดต่ําสุด

แฮนเดิล GetChild

PropertyPathHandle GetChildHandle(
  PropertyPathHandle aParentHandle,
  uint8_t aContextTag
) const

ความลึกที่ได้รับ

int32_t GetDepth(
  PropertyPathHandle aHandle
) const

คํานวณความลึกในแผนผังสคีมาสําหรับแฮนเดิลที่กําหนด

รายละเอียด

แสดงผลค่า

int32_t

ความลึกในต้นไม้

แฮนเดิล GetDictionaryItem

PropertyPathHandle GetDictionaryItemHandle(
  PropertyPathHandle aParentHandle,
  uint16_t aDictionaryKey
) const

GetFirstChild

PropertyPathHandle GetFirstChild(
  PropertyPathHandle aParentHandle
) const

แสดงผลแฮนเดิลย่อยแรกที่เชื่อมโยงกับระดับบนสุด

รายละเอียด

แสดงผลค่า

PropertyPathHandle

แฮนเดิลของเด็กคนแรก

รับเวอร์ชันสูงสุด

SchemaVersion GetHighestForwardVersion(
  SchemaVersion aVersion
) const

เวอร์ชันของสคีมาสคีมาที่ระบุที่ระบุจะส่งคืนเวอร์ชันสคีมาที่เข้ากันได้สูงสุด

เวอร์ชันที่เข้ากันได้ต่ําสุด

SchemaVersion GetLowestCompatibleVersion(
  SchemaVersion aVersion
) const

เวอร์ชันของสคีมาสคีมาที่ระบุที่ระบุจะส่งคืนเวอร์ชันสคีมาขั้นต่ําที่เข้ากันได้

ดาวน์โหลดแผนที่

const PropertyInfo * GetMap(
  PropertyPathHandle aHandle
) const

แสดงผลตัวชี้ไปยังโครงสร้าง PropertyInfo ที่อธิบายแฮนเดิลเส้นทางที่เจาะจง

รายละเอียด

แสดงผลค่า

PropertyInfo*

เวอร์ชันของ GetMax

SchemaVersion GetMaxVersion() const

เวอร์ชัน GetMin

SchemaVersion GetMinVersion() const

ดาวน์โหลดถัดไป

PropertyPathHandle GetNextChild(
  PropertyPathHandle aParentId,
  PropertyPathHandle aChildHandle
) const

แฮนเดิลที่มีการจัดการถัดไปจะส่งคืนแฮนเดิลย่อยถัดไปที่เชื่อมโยงกับบัญชีระดับบนสุดที่เฉพาะเจาะจง

รายละเอียด

แสดงผลค่า

PropertyPathHandle

แฮนเดิลของเด็กคนถัดไป

ผู้ปกครอง

PropertyPathHandle GetParent(
  PropertyPathHandle aHandle
) const

แสดงผลแฮนเดิลระดับบนสุดของแฮนเดิลเส้นทางย่อยที่ระบุ

ระบบจะเก็บรักษาคีย์พจนานุกรมในแฮนเดิลไว้ในกรณีที่แฮนเดิลหลักเป็นองค์ประกอบพจนานุกรมด้วย

รายละเอียด

แสดงผลค่า

PropertyPathHandle

แฮนเดิลของผู้ปกครอง

รหัส GetProfile

uint32_t GetProfileId(
  void
) const

แสดงรหัสโปรไฟล์ของลักษณะที่เกี่ยวข้อง

รายละเอียด

แสดงผลค่า

Trait

รหัสโปรไฟล์

แท็ก GetRelativePath

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

แปลง PropertyPathHandle เป็นอาร์เรย์ของแท็กบริบท

รายละเอียด

พารามิเตอร์

`[in] aCandidateHandle`	PropertyPathHandle ที่จะถูกแปลง
`[in] aTags`	ชี้ไปที่อาร์เรย์เอาต์พุต
`[in] aTagsSize`	ขนาดของอาร์เรย์ aTag ในจํานวนองค์ประกอบ
`[out] aNumTags`	จํานวนแท็กที่เขียนไปยัง aTag

การคืนสินค้า

WEhave_NO_ERROR ในกรณีที่สําเร็จ; WEhave_ERROR_NO_MEMORY หาก aTag มีขนาดเล็กเกินกว่าที่จะจัดเก็บเส้นทางแบบเต็ม

รับแท็ก

uint64_t GetTag(
  PropertyPathHandle aHandle
) const

แสดงผลแท็กที่เชื่อมโยงกับแฮนเดิลเส้นทาง

หากเป็นองค์ประกอบของพจนานุกรม ฟังก์ชันนี้จะแสดงผล ProfileTag ไม่เช่นนั้นระบบจะแสดงแท็กบริบท

รายละเอียด

แสดงผลค่า

uint64_t

ส่วน GetVersionIntersection

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

เพื่อให้มีช่วงฟังก์ชันนี้ ฟังก์ชันนี้จะตรวจสอบว่ามีจุดร่วมระหว่างค่าดังกล่าวหรือไม่ และสคีมาที่อยู่เบื้องหลังเครื่องมือสคีมานี้รองรับมีอะไรบ้าง

หากมีทางแยก ฟังก์ชันดังกล่าวจะส่งคืนข้อมูลจริง และอัปเดตอาร์กิวเมนต์ AIntersection ที่ผ่านเพื่อสะท้อนให้เห็นว่าผลการทดสอบการแยกนั้น

พจนานุกรม

bool IsDictionary(
  PropertyPathHandle aHandle
) const

ส่งคืนค่า "จริง" หากแฮนเดิลเป็นพจนานุกรม (ไม่ใช่ในพจนานุกรม โปรดดูวิธีการด้านล่าง)

รายละเอียด

แสดงผลค่า

bool

ชั่วคราว

bool IsEphemeral(
  PropertyPathHandle aHandle
) const

พจนานุกรม

bool IsInDictionary(
  PropertyPathHandle aHandle,
  PropertyPathHandle & aDictionaryItemHandle
) const

แสดงค่า "จริง" หากแฮนเดิลอยู่ในภายในพจนานุกรม (องค์ประกอบพจนานุกรม)

ผู้ใช้ที่ส่งผ่านแฮนเดิล (aDictionaryItemHandle) จะอัปเดตให้ชี้ไปที่แฮนเดิลองค์ประกอบพจนานุกรมด้านบนสุดภายในพจนานุกรม

รายละเอียด

แสดงผลค่า

bool

เกาะใบไม้

bool IsLeaf(
  PropertyPathHandle aPropertyHandle
) const

แสดงผลเป็น "จริง" หากแฮนเดิลหมายถึงโหนด Leaf ในแผนผังสคีมา

รายละเอียด

แสดงผลค่า

bool

เป็นค่าว่าง

bool IsNullable(
  PropertyPathHandle aHandle
) const

ไม่บังคับ

bool IsOptional(
  PropertyPathHandle aHandle
) const

เป็นผู้ปกครอง

bool IsParent(
  PropertyPathHandle aChildHandle,
  PropertyPathHandle aParentHandle
) const

ตรวจสอบว่าแฮนเดิลหนึ่งเป็นของแฮนเดิลอื่นหรือไม่

ซึ่งอาจเป็นเพราะผู้ปกครองโดยอ้อม

รายละเอียด

แสดงผลค่า

bool

เส้นทางการจัดการแผนที่

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

แปลงแฮนเดิลเส้นทางเป็นเส้นทาง TLV

รายละเอียด

แสดงผลค่า

`WEAVE_NO_ERROR`	สําเร็จแล้ว
`other`	แปลงแฮนเดิลเป็นเส้นทาง TLV ไม่ได้

MapPathToHandle

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

ให้อ่านแท็กที่เกี่ยวข้องที่รากขององค์ประกอบเส้นทาง WDM แล้วอ่านแท็กที่เกี่ยวข้องและระบุแฮนเดิลเส้นทางที่เทียบเท่า

รายละเอียด

แสดงผลค่า

`WEAVE_NO_ERROR`	สําเร็จแล้ว
`WEAVE_ERROR_TLV_TAG_NOT_FOUND`	หากไม่พบแฮนเดิลที่ตรงกันเนื่องจากเส้นทางที่ระบุไม่ถูกต้อง/ระบุไม่ถูกต้อง

MapPathToHandle

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

ในการนําเสนอสตริงสตริงของเส้นทาง WDM ให้อ่านแท็กที่เกี่ยวข้องและระบุแฮนเดิลของเส้นทางที่เทียบเท่า

เส้นทาง WDM จะแสดงเป็นสตริงโดยใช้กฎต่อไปนี้

แท็กคั่นด้วย /
เส้นทางต้องเริ่มต้นด้วย / นําหน้า และไม่มีเครื่องหมายทับปิดท้าย
แท็กตัวเลขในเส้นทาง WDM ต้องเข้ารหัสลับโดยใช้ไลบรารี C มาตรฐานเพื่อจํานวนเต็มสําหรับการเข้ารหัสสตริง กล่าวคือ การเข้ารหัสทศนิยม (ค่าเริ่มต้น) ต้องไม่มี 0 นําหน้า การเข้ารหัสเลขฐานสิบหกต้องเริ่มต้นด้วย 0x และการเข้ารหัสฐานแปดต้องมี 0 นําหน้า

รายละเอียด

แสดงผลค่า

`WEAVE_NO_ERROR`	สําเร็จแล้ว
`WEAVE_ERROR_TLV_TAG_NOT_FOUND`	หากไม่พบแฮนเดิลที่ตรงกัน
`WEAVE_ERROR_INVALID_ARGUMENT`	หากสตริงเส้นทางมีรูปแบบไม่ถูกต้อง

รหัสโปรไฟล์ที่ตรงกัน

bool MatchesProfileId(
  uint32_t aProfileId
) const

แสดงผลเป็น "จริง" หากการส่งต่อใน profileId ตรงกับที่เก็บไว้ในสคีมา

รายละเอียด

แสดงผลค่า

bool

เรียกข้อมูล

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

จากแฮนเดิลเส้นทางและตําแหน่งผู้เขียนในองค์ประกอบข้อมูลที่เกี่ยวข้อง ให้เรียกข้อมูล Leaf จากแหล่งข้อมูล และเขียนลงในบัฟเฟอร์ที่ผู้เขียนชี้ไปที่ในลักษณะที่เป็นไปตามสคีมา

รายละเอียด

แสดงผลค่า

`WEAVE_NO_ERROR`	สําเร็จแล้ว
`other`	พบข้อผิดพลาดในการเขียนข้อมูล

เรียกข้อมูลค่าพจนานุกรม

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

ข้อมูลร้านค้า

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

แฮนเดิลแฮนเดิลที่วางอยู่บนองค์ประกอบข้อมูลที่เกี่ยวข้อง ให้ประมวลผลบัฟเฟอร์ข้อมูลที่เครื่องอ่านชี้ไปและเก็บไว้ในถังขยะโดยเรียกใช้การเรียก SetLeafData เมื่อใดก็ตามที่พบรายการข้อมูล Leaf

Details

แสดงผลค่า

`WEAVE_NO_ERROR`	สําเร็จแล้ว
`other`	พบข้อผิดพลาดในการแยกวิเคราะห์/ประมวลผลข้อมูล

nl::Weave::โปรไฟล์::DataManagement_Current::TraitSchemaEngine

สรุป

แอตทริบิวต์สาธารณะแบบคงที่

แอตทริบิวต์สาธารณะ

ฟังก์ชันสาธารณะ

ชั้นเรียน

โครงสร้าง

แอตทริบิวต์สาธารณะแบบคงที่

ออฟเซ็ตตาราง KkTable

แอตทริบิวต์สาธารณะ

สคีมา mm

ฟังก์ชันสาธารณะ

FindLowestCommonAncestor

แฮนเดิล GetChild

ความลึกที่ได้รับ

แฮนเดิล GetDictionaryItem

GetFirstChild

รับเวอร์ชันสูงสุด

เวอร์ชันที่เข้ากันได้ต่ําสุด

ดาวน์โหลดแผนที่

เวอร์ชันของ GetMax

เวอร์ชัน GetMin

ดาวน์โหลดถัดไป

ผู้ปกครอง

รหัส GetProfile

แท็ก GetRelativePath

รับแท็ก

ส่วน GetVersionIntersection

พจนานุกรม

ชั่วคราว

พจนานุกรม

เกาะใบไม้

เป็นค่าว่าง

ไม่บังคับ

เป็นผู้ปกครอง

เส้นทางการจัดการแผนที่

MapPathToHandle

MapPathToHandle

รหัสโปรไฟล์ที่ตรงกัน

เรียกข้อมูล

เรียกข้อมูลค่าพจนานุกรม

ข้อมูลร้านค้า