nl::Weave::Profiles::DataManagement_Current::ResourceIdentifier

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

يشير ذلك المصطلح إلى بنية تتضمّن رقم تعريف أحد الموارد.

ملخّص

وقد يكون ResourceIdentifier معرّفًا عامًا لكائن 64 بت من نوع معيّن أو معرّف فريد عالمي (UUID). عند ترميز المحتوى خارجيًا، تتوفّر التمثيلات التالية:

عدد صحيح 64 بت غير موقَّع ويتوافق مع الكائن المعمم من النوع DEVICE برقم التعريف المحدّد في التمثيل

تمثيل معمم مُرمَّز كسلسلة بايت من 10 ثُمانيات. تُشفِّر أول ثُمانيتين نوع المورد كعدد صحيح صغير 16 بت، مع ترميز الـ 8 بايت المتبقية على معرّف مورد صغير 64 بت.

تتضمن ResourceIdentifiers أيضًا الاصطلاحات المتوفرة في جميع أنحاء رمز WDM: يتجاوب ResourceIdentifier الفارغ مع رقم تعريف العقدة DEVICE، ويتم توفير دوال الإنشاء لحالات الاستخدام الأكثر شيوعًا.

الشركات المصنّعة والمُصنّعة
ResourceIdentifier()
أنشِئ ResourceIdentifier مطابقًا لمعرّف ResourceID غير محدّد.
ResourceIdentifier(const uint64_t & aNodeId)
يمكنك إنشاء ResourceIdentifier من النوع DEVICE استنادًا إلى قيمة aNodeId معيّنة.
ResourceIdentifier(uint16_t aResourceType, const uint64_t & aResourceId)
يمكنك إنشاء ResourceIdentifier من النوع المحدّد باستخدام المعرّف المحدّد.
ResourceIdentifier(uint16_t aResourceType, const uint8_t *aResourceId, size_t aResourceIdLen)
يمكنك إنشاء ResourceIdentifier من النوع المحدّد باستخدام المعرّف المحدّد.

الأنواع العامة
@125{
  RESOURCE_TYPE_RESERVED = 0
} 		تعداد
@126 تعداد
تحدِّد هذه السياسة قيمة خاصة لمعرّف NodeId تشير إلى القيمة "self".
@127 تعداد

السمات العامة
ResourceId
uint64_t
ResourceIdBytes[8]
uint8_t

وظائف عامة
FromString(const char *inBuffer, size_t inBufferLen)
تحليل تمثيل سلسلة أساسية لمورد في كائن مورد.
FromString(const char *inBuffer, size_t inBufferLen, const uint64_t & aSelfNodeId)
تحليل تمثيل سلسلة أساسية لمورد في كائن مورد.
FromTLV(nl::Weave::TLV::TLVReader & aReader)
عليك البحث عن ResourceIdentifier من تمثيل TLV في هذا العنصر.
FromTLV(nl::Weave::TLV::TLVReader & aReader, const uint64_t & aSelfNodeId)
عليك البحث عن ResourceIdentifier من تمثيل TLV في هذا العنصر.
GetResourceId() const
uint64_t
دالة موصّل لجلب ResourceId
GetResourceType() const
uint16_t
دالة موصّل لجلب ResourceType.
ResourceTypeAsString(void) const
const char *
إنشاء تمثيل سلسلة من ResourceType.
ToString(char *buffer, size_t bufferLen)
حوِّل ResourceIdentifier إلى سلسلة قابلة للطباعة.
ToTLV(nl::Weave::TLV::TLVWriter & aWriter) const
تسلسل المورد إلى تمثيل TLV باستخدام علامة Path::ResourceID للسياق.
ToTLV(nl::Weave::TLV::TLVWriter & aWriter, const uint64_t & aTag) const
تسلسل المورد إلى تمثيل TLV باستخدام علامة معيّنة.

الدوال الثابتة العامة
ResourceTypeAsString(uint16_t aResourceType)
const char *
إنشاء تمثيل سلسلة لنوع مورد.

صفوف الأصدقاء
operator==
friend bool

الأنواع العامة

125@

 @125
أماكن إقامة
RESOURCE_TYPE_RESERVED

نوع مورد محجوز.

يتم اختيار التعداد بحيث لا يتعارض مع قيم التعداد من تعدادات Schema::Weave:::Common::ResourceType. في الوقت الحالي، تتوفّر قيمتان ResourceId لنوع المورد RESERVED: يتوافق kNodeIdNotSpecified مع ResourceIdentifier موحَّدًا ويتوافق SELF_NODE_ID مع مورد ستتم إعادة ضبطه على قيمة SELF من أي تمثيل آخر.

@126

 @126

تحدِّد هذه السياسة قيمة خاصة لمعرّف NodeId تشير إلى القيمة "self".

في بعض تفاعلات WDM، يسمح وجود القيمة الذاتية للمورد بضغط تلك المعلومات لأنها متكررة لمعرف عقدة المصدر للجهاز المُعبر عنه في Weave. الرسالة نفسها

127@

 @127

السمات العامة

ResourceId

uint64_t ResourceId

ResourceIdBytes

uint8_t ResourceIdBytes[8]

وظائف عامة

FromString

WEAVE_ERROR FromString(
  const char *inBuffer,
  size_t inBufferLen
)

تحليل تمثيل سلسلة أساسية لمورد في كائن مورد.

تحوِّل هذه الدالة تمثيل السلسلة الأساسي لمورد إلى كائن مورد. لاحظ أنه لا يمكن تمثيل سوى مجموعة فرعية من الموارد كسلسلة، على وجه الخصوص، فإن تنفيذ المرجع في Weave سيحلل فقط موارد الأنواع الأساسية كما هو موضح في ResourceTypeEnum.

التفاصيل
المعلمات
[in] inBuffer
يشير هذا المصطلح إلى مخزن مؤقت يحتوي على رقم تعريف المورد المطلوب تحليله.
[in] inBufferLen
طول السلسلة المطلوب تحليلها (بالبايت)

FromString

WEAVE_ERROR FromString(
  const char *inBuffer,
  size_t inBufferLen,
  const uint64_t & aSelfNodeId
)

تحليل تمثيل سلسلة أساسية لمورد في كائن مورد.

تحوِّل هذه الدالة تمثيل السلسلة الأساسي لمورد إلى كائن مورد. لاحظ أنه لا يمكن تمثيل سوى مجموعة فرعية من الموارد كسلسلة، على وجه الخصوص، فإن تنفيذ المرجع في Weave سيحلل فقط موارد الأنواع الأساسية كما هو موضح في ResourceTypeEnum.

التفاصيل
المعلمات
[in] inBuffer
يشير هذا المصطلح إلى مخزن مؤقت يحتوي على رقم تعريف المورد المطلوب تحليله.
[in] inBufferLen
طول السلسلة المطلوب تحليلها (بالبايت)
[in] aSelfNodeId
رقم التعريف 64 بت الذي يشير إلى رقم تعريف الجهاز الذي يجب تعيينه إلى SELF_NODE_ID

FromTLV

WEAVE_ERROR FromTLV(
  nl::Weave::TLV::TLVReader & aReader
)

عليك البحث عن ResourceIdentifier من تمثيل TLV في هذا العنصر.

التفاصيل
المعلمات
[in] aReader
قارئ TLV موضوع في العنصر ResourceIdentifier
المرتجعات
WEAVE_NO_ERROR بشأن النجاح. تظهر أخطاء من TLVReader في حال عدم إمكانية قراءة ResourceIdentifier بشكلٍ صحيح.

FromTLV

WEAVE_ERROR FromTLV(
  nl::Weave::TLV::TLVReader & aReader,
  const uint64_t & aSelfNodeId
)

عليك البحث عن ResourceIdentifier من تمثيل TLV في هذا العنصر.

التفاصيل
المعلمات
[in] aReader
قارئ TLV موضوع في العنصر ResourceIdentifier
[in] aSelfNodeId
ResourceID 64 بت ستتم إعادة تعيينه من التمثيل المتسلسل إلى SELF_NODE_ID
المرتجعات
WEAVE_NO_ERROR بشأن النجاح. تظهر أخطاء من TLVReader في حال عدم إمكانية قراءة ResourceIdentifier بشكلٍ صحيح.

GetResourceId

uint64_t GetResourceId() const

دالة موصّل لجلب ResourceId

GetResourceType

uint16_t GetResourceType() const

دالة موصّل لجلب ResourceType.

ResourceIdentifier

 ResourceIdentifier()

أنشِئ ResourceIdentifier مطابقًا لمعرّف ResourceID غير محدّد.

معرِّف المورد غير المحدَّد هو صف يتكون من نوع مورد محجوز مع مورد kNodeIdNotSpeficied.

ResourceIdentifier

 ResourceIdentifier(
  const uint64_t & aNodeId
)

يمكنك إنشاء ResourceIdentifier من النوع DEVICE استنادًا إلى قيمة aNodeId معيّنة.

التفاصيل
المعلمات
[in] aNodeId
NodeId لمعرّف المورد المحدّد

ResourceIdentifier

 ResourceIdentifier(
  uint16_t aResourceType,
  const uint64_t & aResourceId
)

يمكنك إنشاء ResourceIdentifier من النوع المحدّد باستخدام المعرّف المحدّد.

التفاصيل
المعلمات
[in] aResourceType
يشير هذا المصطلح إلى نوع مورد ستتم تسميته.
[in] aResourceId
رقم تعريف المورد المطلوب تسميته

ResourceIdentifier

 ResourceIdentifier(
  uint16_t aResourceType,
  const uint8_t *aResourceId,
  size_t aResourceIdLen
)

يمكنك إنشاء ResourceIdentifier من النوع المحدّد باستخدام المعرّف المحدّد.

التفاصيل
المعلمات
[in] aResourceType
يشير هذا المصطلح إلى نوع مورد ستتم تسميته.
[in] aResourceId
رقم تعريف المورد المطلوب تسميته كمصفوفة من وحدات البايت
[in] aResourceIdLen
طول المعرّف بالبايت

ResourceTypeAsString

const char * ResourceTypeAsString(
  void
) const

إنشاء تمثيل سلسلة من ResourceType.

أنواع الموارد المحوَّلة هي تلك التي تم تعدادها في ResourceTypeEnum.h و0 (المتوافقة مع Resource_TYPE_RESERVED)

سلسلة ToString

WEAVE_ERROR ToString(
  char *buffer,
  size_t bufferLen
)

حوِّل ResourceIdentifier إلى سلسلة قابلة للطباعة.

التفاصيل
المعلمات
[in] buffer
مخزن مؤقت للطباعة فيه
[in] bufferLen
طول المورد الاحتياطي

ToTLV

WEAVE_ERROR ToTLV(
  nl::Weave::TLV::TLVWriter & aWriter
) const

تسلسل المورد إلى تمثيل TLV باستخدام علامة Path::ResourceID للسياق.

التفاصيل
المعلمات
[in] aWriter
كاتب TLV ينشئ تسلسلاً لـ ResourceIdentifier في

ToTLV

WEAVE_ERROR ToTLV(
  nl::Weave::TLV::TLVWriter & aWriter,
  const uint64_t & aTag
) const

تسلسل المورد إلى تمثيل TLV باستخدام علامة معيّنة.

التفاصيل
المعلمات
[in] aWriter
كاتب TLV ينشئ تسلسلاً لـ ResourceIdentifier في
[in] aTag
علامة تحدّد اسم ResourceIdentifier المتسلسل

الدوال الثابتة العامة

ResourceTypeAsString

const char * ResourceTypeAsString(
  uint16_t aResourceType
)

إنشاء تمثيل سلسلة لنوع مورد.

أنواع الموارد المحوَّلة هي تلك التي تم تعدادها في ResourceTypeEnum.h و0 (المتوافقة مع Resource_TYPE_RESERVED)

التفاصيل
المعلمات
[in] aResourceType
تعداد نوع مورد المطلوب تحويله إلى تمثيل سلسلة.

صفوف الأصدقاء

عامل التشغيل==

friend bool operator==(const ResourceIdentifier &lhs, const ResourceIdentifier &rhs)