nl :: نسج:: مظهر:: إدارة البيانات_الحالية
تتضمن مساحة الاسم هذه جميع الواجهات داخل Weave لملف تعريف Weave Data Management (WDM) المدعومة حاليًا للاستخدام الإنتاجي.
ملخص
النوع | |
---|---|
CommandFlags | typedef |
DataVersion | typedefuint64_t |
EventProcessor | typedefvoid * |
EventWriterFunct )(nl::Weave::TLV::TLVWriter &ioWriter, uint8_t inDataTag, void *appData) | typedefWEAVE_ERROR (* دالة توفر عنصر eventData للنظام الفرعي لتسجيل الأحداث. |
FetchExternalEventsFunct )(EventLoadOutContext *aContext) | typedefWEAVE_ERROR (* نموذج أولي لوظيفة عمليات رد نداءات النظام الأساسي التي تجلب بيانات الحدث. |
GenericTraitSinkCatalog | typedef |
GenericTraitSourceCatalog | typedef |
ImportanceType | typedef أهمية إدخال السجل. |
IteratorCallback )(void *aTraitInstance, TraitDataHandle aHandle, void *aContext) | typedefvoid(* مكرر مقبض السمة. |
LoggingBufferHandler )(void *inAppState, PacketBuffer *inBuffer) | typedefWEAVE_ERROR (* |
NotifyExternalEventsDeliveredFunct )(ExternalEvents *inEv, event_id_t inLastDeliveredEventID, uint64_t inRecipientNodeID) | typedefvoid(* تم استدعاء نموذج أولي لوظيفة رد اتصال عند تسليم أحداث خارجية إلى المشترك البعيد. |
NotifyExternalEventsEvictedFunct )(ExternalEvents *inEv) | typedefvoid(* يتم استدعاء نموذج أولي لوظيفة رد نداء عند طرد الأحداث الخارجية من المخازن المؤقتة. |
PropertyDictionaryKey | typedefuint16_t |
PropertyPathHandle | typedefuint32_t PropertyPathHandle عبارة عن تجزئة رقمية فريدة 32 بت لمسار WDM بالنسبة إلى جذر مثيل سمة. |
PropertySchemaHandle | typedefuint16_t |
SchemaVersion | typedefuint16_t |
SingleResourceSinkTraitCatalog | typedef |
SingleResourceSourceTraitCatalog | typedef |
TimestampType | typedef صلاحية ونوع الطابع الزمني المتضمن في EventOptions . |
TraitDataHandle | typedefuint16_t |
duration_t | nl :: Weave :: Profiles :: DataManagement_Current :: duration_tuint32_t النوع المستخدم لوصف المدة بالمللي ثانية. |
event_id_t | nl :: Weave :: Profiles :: DataManagement_Current :: event_id_tuint32_t نوع معرف الحدث. |
timestamp_t | nl :: Weave :: Profiles :: DataManagement_Current :: timestamp_tuint32_t النوع المستخدم لوصف الطابع الزمني بالمللي ثانية. |
utc_timestamp_t | nl :: Weave :: Profiles :: DataManagement_Current :: utc_timestamp_tuint64_t النوع المستخدم لوصف الطابع الزمني UTC بالمللي ثانية. |
المتغيرات | |
---|---|
sInstance | |
sLogFileName = "topazlog"[] | char |
المهام | |
---|---|
BdxErrorHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, WEAVE_ERROR aErrorCode) | void |
BdxGetBlockHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, uint64_t *aLength, uint8_t **aDataBlock, bool *aIsLastBlock) | void |
BdxRejectHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, nl::Weave::Profiles::StatusReporting::StatusReport *aReport) | void |
BdxSendAcceptHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, nl::Weave::Profiles::BulkDataTransfer::SendAccept *aSendAcceptMsg) | |
BdxXferDoneHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer) | void |
BdxXferErrorHandler (nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, nl::Weave::Profiles::StatusReporting::StatusReport *aXferError) | void |
CreatePropertyPathHandle (PropertySchemaHandle aPropertyPathSchemaId, PropertyDictionaryKey aPropertyPathDictionaryKey) | |
EventWriterTLVCopy (TLVWriter & ioWriter, uint8_t inDataTag, void *appData) | وظيفة مساعد تترجم عنصر بيانات حدث متسلسل بالفعل إلى المخزن المؤقت للحدث. |
GetPropertyDictionaryKey ( PropertyPathHandle aHandle) | PropertyDictionaryKey |
GetPropertySchemaHandle ( PropertyPathHandle aHandle) | PropertySchemaHandle |
IsNullPropertyPathHandle ( PropertyPathHandle aHandle) | bool |
IsRootPropertyPathHandle ( PropertyPathHandle aHandle) | bool |
IsVersionNewer (const DataVersion & aVersion, const DataVersion & aReference) | bool هذا هو التنفيذ الأمثل للخوارزمية لمقارنة الإصدارات. |
IsVersionNewerOrEqual (const DataVersion & aVersion, const DataVersion & aReference) | bool |
Locate (TraitDataHandle aTraitDataHandle, const TraitCatalogBase < TraitDataSink > *aDataSinkCatalog) | |
LogEvent (const EventSchema & inSchema,nl::Weave::TLV::TLVReader & inData) | سجل حدثًا من نموذج مُسلسل مسبقًا. |
LogEvent (const EventSchema & inSchema,nl::Weave::TLV::TLVReader & inData, const EventOptions *inOptions) | سجل حدثًا من نموذج مُسلسل مسبقًا ، مع خيارات إضافية. |
LogEvent (const EventSchema & inSchema, EventWriterFunct inEventWriter, void *inAppData) | تسجيل حدث عبر رد الاتصال. |
LogEvent (const EventSchema & inSchema, EventWriterFunct inEventWriter, void *inAppData, const EventOptions *inOptions) | سجل حدثًا عبر رد اتصال ، مع خيارات. |
LogFreeform ( ImportanceType inImportance, const char *inFormat, ...) | LogFreeform يرسل سلسلة حرة إلى دفق الحدث الافتراضي. |
LookForElementWithTag (constnl::Weave::TLV::TLVReader & aSrcReader, const uint64_t aTagInApiForm,nl::Weave::TLV::TLVReader *apDstReader) | |
PlainTextWriter (TLVWriter & ioWriter, uint8_t inDataTag, void *appData) | وظيفة مساعدة لإرسال نص حر كحدث تصحيح. |
PlainTextWriter (::nl::Weave::TLV::TLVWriter & ioWriter, uint8_t inDataTag, void *appData) | وظيفة مساعدة لإرسال نص حر كحدث تصحيح. |
operator!= (const ResourceIdentifier & lhs, const ResourceIdentifier & rhs) | bool |
operator== (const ResourceIdentifier & lhs, const ResourceIdentifier & rhs) | bool |
النقابات | |
---|---|
nl :: Weave :: Profiles :: DataManagement_Current :: Timestamp | الاتحاد الذي يوفر نظام تعيين التطبيق أو الطابع الزمني UTC. |
التعداد
@ 100
@100
@ 101
@101
@ 102
@102
علامات للأحداث المستمرة.
@ 104
@104
أنواع رسائل ملف تعريف WDM.
يتم استدعاء هذه القيم في مواصفات إدارة البيانات.
@ 105
@105
رموز الحالة الخاصة بـ WDM.
@ 147
@147
@ 95
@95
علامات إعدادات التسجيل .
@ 96
@96
علامات لإمكانيات التسجيل.
@ 97
@97
علامات للبيانات الوصفية للحدث.
للحصول على دلالات كاملة لقيم العلامة ، راجع مواصفات تصميم الحدث.
الخصائص | |
---|---|
kTag_EventData | اختياري. بيانات الحدث نفسها. إذا كان فارغًا ، فسيتم تعيينه افتراضيًا على هيكل فارغ. |
kTag_EventDeltaSystemTime | العلامة الداخلية لـ WDM ، فرق التوقيت عن الحدث السابق في الترميز. |
kTag_EventDeltaUTCTime | علامة WDM الداخلية ، فرق التوقيت عن الحدث السابق في الترميز. |
kTag_EventID | رقم تسلسلي للحدث ، معبرًا عنه بكمية غير موقعة 64 بت. يجب أن تكون متتالية ، تشير القفزات في التسلسل إلى فجوات الأحداث. |
kTag_EventImportance | أهمية الحدث. |
kTag_EventResourceID | اختياري. القيمة هي معرف المورد الذي ينتمي إليه الحدث. عند حذفها ، تكون القيمة هي نفس قيمة kTag_EventSource |
kTag_EventSource | NodeID للجهاز الذي أنشأ الحدث. |
kTag_EventSystemTimestamp | اختياري. الطابع الزمني للنظام للحدث بالملي ثانية. |
kTag_EventTraitInstanceID | اختياري ، مثيل السمة التي ولدت الحدث. |
kTag_EventTraitProfileID | إلزامي. عدد صحيح بدون إشارة يبلغ 32 بت يساوي معرف ملف التعريف للسمة. |
kTag_EventType | إلزامي. عدد صحيح 16 بت بدون إشارة يساوي wdl.event.id لهذا النوع من الأحداث. |
kTag_EventUTCTimestamp | اختياري. الطابع الزمني للتوقيت العالمي المنسق للحدث بالملي ثانية. |
kTag_ExternalEventStructure | علامة داخلية للأحداث الخارجية. لا تنتقل أبدًا عبر السلك ، ولا ينبغي أبدًا استخدامها خارج مكتبة Weave. |
kTag_RelatedEventID | اختياري. معرّف الحدث المرتبط به هذا الحدث. إذا تم حذفها ، فإن القيمة تساوي قيمة kTag_EventID. |
kTag_RelatedEventImportance | اختياري. أهمية الحدث ذي الصلة. في حالة حذفها ، تكون القيمة مساوية لقيمة kTag_EventImportance. |
@ 98
@98
تعريفات الملف الشخصي لسمة التصحيح.
@ 99
@99
CommandFlags
CommandFlags
النوع
ImportanceType
أهمية إدخال السجل.
تُستخدم الأهمية كطريقة لتصفية الأحداث قبل إرسالها فعليًا إلى السجل. بعد أن يتم تسجيل الحدث في السجل ، لا نضع أية أحكام أخرى لحذفه من السجل. يعمل مستوى الأهمية على تحديد أولويات تخزين الحدث. إذا تمت إضافة حدث ذي أهمية عالية إلى مخزن مؤقت كامل ، يتم إسقاط الأحداث حسب الأهمية (والعمر) لاستيعابها. على هذا النحو ، مستويات الأهمية لها قيمة نسبية فقط. إذا كان النظام يستخدم مستوى أهمية واحدًا فقط ، فسيتم إسقاط الأحداث بترتيب العمر فقط ، مثل المخزن المؤقت الدائري.
إدارة السجلات
LoggingManagementStates
النوع
CommandFlags
enum nl::Weave::Profiles::DataManagement_Current::CommandFlags CommandFlags
داتافرسون
uint64_t DataVersion
معالج الحدث
void * EventProcessor
EventWriterFunct
WEAVE_ERROR(* EventWriterFunct)(nl::Weave::TLV::TLVWriter &ioWriter, uint8_t inDataTag, void *appData)
دالة توفر عنصر eventData للنظام الفرعي لتسجيل الأحداث.
من المتوقع أن توفر وظائف من هذا النوع عنصر eventData للنظام الفرعي لتسجيل الأحداث. يتم استدعاء الوظائف من هذا النوع بعد أن يقوم النظام الفرعي للحدث بإنشاء جميع بيانات تعريف الحدث المطلوبة. يتم استدعاءالوظيفة بكائنnl :: Weave :: TLV :: TLVWriter حيث ستبعث إليه عنصر TLV واحد بعلامة kTag_EventData ؛ يجب أن تكون قيمة هذا العنصر عبارة عن بنية تحتوي على بيانات الحدث. يجب تنظيم بيانات الحدث نفسها باستخدام علامات السياق.
تفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلمات |
| ||||||
إرجاع القيم |
|
PlainTextWriter
EventWriterTLV نسخ
FetchExternalEventsFunct
WEAVE_ERROR(* FetchExternalEventsFunct)(EventLoadOutContext *aContext)
نموذج أولي لوظيفة عمليات رد نداءات النظام الأساسي التي تجلب بيانات الحدث.
على غرار FetchEventsSince ، تقوم وظيفة الجلب هذه بإرجاع كافة الأحداث من EventLoadOutContext.mStartingEventID من خلال ExternalEvents.mLastEventID .
مؤشر السياق من النوع FetchExternalEventsContext. يتضمن هذا EventLoadOutContext ، مع بعض المتغيرات المساعدة لتنسيق TLV . ويتضمن أيضًا مؤشرًا إلى بنية ExternalEvents التي تم إنشاؤها عند تسجيل رد النداء. هذا يحدد نطاق معرف الحدث لرد الاتصال.
عند العودة من الوظيفة ، يجب أن يعكس EventLoadOutContext.mCurrentEventID معرف الحدث الأول الذي لم تتم كتابته بنجاح إلى المخزن المؤقت TLV . يجب أن يكتب النظام الأساسي عنوان الأحداث والبيانات إلى كاتب TLV بالتنسيق الصحيح ، المحدد بواسطة بروتوكول EventLogging. يجب أن تحافظ المنصة أيضًا على تفرد الأحداث والطوابع الزمنية.
يجب نشر جميع أخطاء TLV إلى مستويات أعلى. على سبيل المثال ، سيؤدي نفاد المساحة في المخزن المؤقت إلى تشغيل رسالة مرسلة ، متبوعة باستدعاء آخر لمعاودة الاتصال مع معرف الحدث المتبقي.
تفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
إرجاع القيم |
|
GenericTraitSinkCatalog
GenericTraitCatalogImpl< TraitDataSink > GenericTraitSinkCatalog
GenericTraitSourceCatalog
GenericTraitCatalogImpl< TraitDataSource > GenericTraitSourceCatalog
النوع
enum nl::Weave::Profiles::DataManagement_Current::ImportanceType ImportanceType
أهمية إدخال السجل.
تُستخدم الأهمية كطريقة لتصفية الأحداث قبل إرسالها فعليًا إلى السجل. بعد أن يتم تسجيل الحدث في السجل ، لا نضع أية أحكام أخرى لحذفه من السجل. يعمل مستوى الأهمية على تحديد أولويات تخزين الحدث. إذا تمت إضافة حدث ذي أهمية عالية إلى مخزن مؤقت كامل ، يتم إسقاط الأحداث حسب الأهمية (والعمر) لاستيعابها. على هذا النحو ، مستويات الأهمية لها قيمة نسبية فقط. إذا كان النظام يستخدم مستوى أهمية واحدًا فقط ، فسيتم إسقاط الأحداث بترتيب العمر فقط ، مثل المخزن المؤقت الدائري.
التكرار
void(* IteratorCallback)(void *aTraitInstance, TraitDataHandle aHandle, void *aContext)
مكرر مقبض السمة.
LoggingBufferHandler
WEAVE_ERROR(* LoggingBufferHandler)(void *inAppState, PacketBuffer *inBuffer)
NotifyExternalEventsDeliveredFunct
void(* NotifyExternalEventsDeliveredFunct)(ExternalEvents *inEv, event_id_t inLastDeliveredEventID, uint64_t inRecipientNodeID)
تم استدعاء نموذج أولي لوظيفة رد اتصال عند تسليم أحداث خارجية إلى المشترك البعيد.
عندما يتم تسليم الأحداث الخارجية إلى مشترك عن بعد ، سيقدم المحرك إشعارًا لموفر الحدث الخارجي. يحتوي رد الاتصال على حدث آخر معرف تم تسليمه ومعرف المشترك الذي استقبل الحدث.
تفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلمات |
|
NotifyExternalEventsEvictedFunct
void(* NotifyExternalEventsEvictedFunct)(ExternalEvents *inEv)
يتم استدعاء نموذج أولي لوظيفة رد نداء عند طرد الأحداث الخارجية من المخازن المؤقتة.
عند إخراج كائن الأحداث الخارجية من المخزن المؤقت للرسالة الصادرة ، سيقدم المحرك إشعارًا لموفر الحدث الخارجي. رد الاتصال يحتوي على الحدث الخارجي الذي سيتم إخلاؤه.
تفاصيل | |||
---|---|---|---|
المعلمات |
|
PropertyDictionaryKey
uint16_t PropertyDictionaryKey
PropertyPathHandle
uint32_t PropertyPathHandle
PropertyPathHandle عبارة عن تجزئة رقمية فريدة 32 بت لمسار WDM بالنسبة إلى جذر مثيل سمة.
لها جزأين:
- رقم 16 بت أقل يتم تعيينه إلى الجزء الثابت من المخطط.
- عندما تشير 16 بت الأدنى إلى مسار داخل عنصر القاموس ، يوجد رقم 16 بت أعلى يمثل مفتاح القاموس المرتبط بهذا العنصر. إذا كانت 16 بت السفلية تشير إلى عنصر غير قاموس ، فيجب أن تكون 16 بت العلوية 0.
بعض الخصائص:
- كل سمة لها مساحة مقبض مسار الملكية الخاصة بها.
- سيكون لكل مسار مسار فرعي فريد لـ WDM خاصية فريدة مماثلة.
- يتم إنشاء PropertyPathHandles تلقائيًا (يتم إجراؤه يدويًا في الوقت الحالي) بواسطة مترجم سمات من IDL ويتم تمثيله كقائمة تعداد في ملف رأس السمة المقابل.
- مع هذا البناء ، لا يتعين على منطق التطبيق أبدًا التعامل مع مسارات WDM مباشرة. بدلاً من ذلك ، يتم إجراء تفاعلاتهم مع إدارة الطلب على المياه بشكل حصري من خلال هذه المقابض.
- هناك قيمتان محجوزتان لمقابض المسار التي لها معنى محدد:
- 0 يشير إلى مقبض 'NULL'
- 1 يشير إلى مقبض يشير إلى جذر مثيل السمة.
PropertySchemaHandle
uint16_t PropertySchemaHandle
الإصدار
uint16_t SchemaVersion
SingleResourceSinkTraitCatalog
SingleResourceTraitCatalog< TraitDataSink > SingleResourceSinkTraitCatalog
SingleResourceSourceTraitCatalog
SingleResourceTraitCatalog< TraitDataSource > SingleResourceSourceTraitCatalog
النوع الزمني
enum nl::Weave::Profiles::DataManagement_Current::TimestampType TimestampType
صلاحية ونوع الطابع الزمني المتضمن في EventOptions .
TraitDataHandle
uint16_t TraitDataHandle
المدة __
uint32_t duration_t
النوع المستخدم لوصف المدة بالمللي ثانية.
event_id_t
uint32_t event_id_t
نوع معرف الحدث.
timestamp_t
uint32_t timestamp_t
النوع المستخدم لوصف الطابع الزمني بالمللي ثانية.
utc_timestamp_t
uint64_t utc_timestamp_t
النوع المستخدم لوصف الطابع الزمني UTC بالمللي ثانية.
المتغيرات
sInstance
LoggingManagement sInstance
sLogFileName
char sLogFileName[] = "topazlog"
المهام
BdxErrorHandler
void BdxErrorHandler( nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, WEAVE_ERROR aErrorCode )
BdxGetBlockHandler
void BdxGetBlockHandler( nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, uint64_t *aLength, uint8_t **aDataBlock, bool *aIsLastBlock )
BdxRejectHandler
void BdxRejectHandler( nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, nl::Weave::Profiles::StatusReporting::StatusReport *aReport )
BdxSendAcceptHandler
WEAVE_ERROR BdxSendAcceptHandler( nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, nl::Weave::Profiles::BulkDataTransfer::SendAccept *aSendAcceptMsg )
BdxXferDoneHandler
void BdxXferDoneHandler( nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer )
BdxXferErrorHandler
void BdxXferErrorHandler( nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, nl::Weave::Profiles::StatusReporting::StatusReport *aXferError )
CreatePropertyPathHandle
PropertyPathHandle CreatePropertyPathHandle( PropertySchemaHandle aPropertyPathSchemaId, PropertyDictionaryKey aPropertyPathDictionaryKey )
EventWriterTLV نسخ
WEAVE_ERROR EventWriterTLVCopy( TLVWriter & ioWriter, uint8_t inDataTag, void *appData )
وظيفة مساعد تترجم عنصر بيانات حدث متسلسل بالفعل إلى المخزن المؤقت للحدث.
تفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلمات |
| ||||||
إرجاع القيم |
|
GetPropertyDictionaryKey
PropertyDictionaryKey GetPropertyDictionaryKey( PropertyPathHandle aHandle )
GetPropertySchemaHandle
PropertySchemaHandle GetPropertySchemaHandle( PropertyPathHandle aHandle )
IsNullPropertyPathHandle
bool IsNullPropertyPathHandle( PropertyPathHandle aHandle )
IsRootPropertyPathHandle
bool IsRootPropertyPathHandle( PropertyPathHandle aHandle )
IsVersion أحدث
bool IsVersionNewer( const DataVersion & aVersion, const DataVersion & aReference )
هذا هو التنفيذ الأمثل للخوارزمية لمقارنة الإصدارات.
من جانب العميل ، تكون النسخة المستلمة من الخدمة هي الأحدث دائمًا.
IsVersionNewerOrEqual
bool IsVersionNewerOrEqual( const DataVersion & aVersion, const DataVersion & aReference )
حدد
TraitUpdatableDataSink * Locate( TraitDataHandle aTraitDataHandle, const TraitCatalogBase< TraitDataSink > *aDataSinkCatalog )
دالة الأداة المساعدة التي تبحث عن TraitUpdatableDataSink في كتالوج TraitDataSink .
تفاصيل | |||||
---|---|---|---|---|---|
المعلمات |
| ||||
عائدات | مؤشر إلى TraitUpdatableDataSink ؛ NULL إذا كان المقبض غير موجود أو يشير إلى TraitDataSink غير قابل للتحديث. |
LogEvent
event_id_t LogEvent( const EventSchema & inSchema, nl::Weave::TLV::TLVReader & inData )
سجل حدثًا من نموذج مُسلسل مسبقًا.
تقوم الوظيفة بتسجيل حدث تم تمثيله كـnl :: Weave :: TLV :: TLVReader . هذا يعني أن تمثيل بيانات الحدث متسلسل بالفعل في التخزين الكامن وراءnl :: Weave :: TLV :: TLVReader . من المتوقع أن يحتويnl :: Weave :: TLV :: TLVReader على عنصر بيانات واحد على الأقل ، يجب أن يكون هذا العنصر بنية. يتم التعامل مع العنصر الأول الذي تمت قراءته من القارئ كبيانات حدث ويتم تخزينه في سجل الأحداث. يجب أن تحتوي بيانات الحدث على علامات سياق ليتم تفسيرها داخل المخطط المعرف بواسطة inProfileID و inEventType. سيتم تجاهل علامة العنصر الأول ؛ سيستبدلها نظام تسجيل الأحداث بعلامة eventData.
يتم تسجيل الحدث إذا تجاوز inImportance حد التسجيل المحدد في LoggingConfiguration . إذا كانت أهمية الحدث لا تفي بالحد الحالي ، فسيتم إسقاطها وإرجاع الدالة 0
كمعرف الحدث الناتج.
هذا المتغير من الاستدعاء يحدد ضمنيًا جميع خيارات الحدث الافتراضية:
- الحدث مختومًا بختم زمني بالوقت الحالي عند نقطة المكالمة ،
- تم تمييز الحدث على أنه متعلق بالجهاز الذي يُجري المكالمة ،
- الحدث مستقل ، ولا يتعلق بأي أحداث أخرى ،
- تم وضع علامة على الحدث على أنه غير عاجل ،
تفاصيل | |||||
---|---|---|---|---|---|
المعلمات |
| ||||
عائدات | event_id_t معرف الحدث إذا تمت كتابة الحدث في السجل ، 0 بخلاف ذلك. |
LogEvent
event_id_t LogEvent( const EventSchema & inSchema, nl::Weave::TLV::TLVReader & inData, const EventOptions *inOptions )
سجل حدثًا من نموذج مُسلسل مسبقًا ، مع خيارات إضافية.
تقوم الوظيفة بتسجيل حدث تم تمثيله كـnl :: Weave :: TLV :: TLVReader . هذا يعني أن تمثيل بيانات الحدث متسلسل بالفعل في التخزين الكامن وراءnl :: Weave :: TLV :: TLVReader . من المتوقع أن يحتويnl :: Weave :: TLV :: TLVReader على عنصر بيانات واحد على الأقل ، ويجب أن يكون هذا العنصر بنية. يتم التعامل مع العنصر الأول الذي تمت قراءته من القارئ كبيانات حدث ويتم تخزينه في سجل الأحداث. يجب أن تحتوي بيانات الحدث على علامات سياق ليتم تفسيرها داخل المخطط المعرف بواسطة inProfileID و inEventType. سيتم تجاهل علامة العنصر الأول ؛ سيستبدلها نظام تسجيل الأحداث بعلامة eventData.
يتم تسجيل الحدث إذا تجاوز inImportance حد التسجيل المحدد في LoggingConfiguration . إذا كانت أهمية الحدث لا تلبي الحد الحالي ، يتم إسقاطها وترجع الدالة 0
كمعرف الحدث الناتج.
يسمح هذا البديل من الاستدعاء للمتصل بتعيين أي مجموعة من EventOptions
:
- الطابع الزمني ، عندما يكون 0 افتراضيًا على الوقت الحالي عند نقطة الاتصال ،
- قسم "الجذر" لمصدر الحدث (مصدر الحدث ومعرف السمة) ؛ إذا كان NULL ، فسيتم تعيينه افتراضيًا على الجهاز الحالي. تم تمييز الحدث على أنه متعلق بالجهاز الذي يُجري المكالمة ،
- معرف حدث ذي صلة لتجميع معرفات الحدث ؛ عندما يكون معرف الحدث ذي الصلة 0 ، يتم تمييز الحدث على أنه لا يتعلق بأي أحداث أخرى ،
- الاستعجال؛ بشكل افتراضي غير عاجل.
تفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلمات |
| ||||||
عائدات | event_id_t معرف الحدث إذا تمت كتابة الحدث في السجل ، 0 بخلاف ذلك. |
LogEvent
event_id_t LogEvent( const EventSchema & inSchema, EventWriterFunct inEventWriter, void *inAppData )
تسجيل حدث عبر رد الاتصال.
تسجل الوظيفة حدثًا يتم تمثيله على هيئة EventWriterFunct وسياق بيانات التطبيق الخاص appData
. تكتب الدالة بيانات تعريف الحدث وتستدعي inEventWriter
nl :: Weave :: TLV :: TLVWriter inAppData
بحيث يمكن لرمز المستخدم إرسال بيانات الحدث مباشرة إلى سجل الأحداث. هذا النوع من تسجيل الأحداث يقلل من استهلاك الذاكرة ، حيث يتم تسلسل بيانات الحدث مباشرة في المخزن المؤقت الهدف. يجب أن تحتوي بيانات الحدث على علامات سياق ليتم تفسيرها ضمن المخطط المعرّف بواسطة inProfileID
و inEventType
. سيتم تجاهل علامة العنصر الأول ؛ سيستبدلها نظام تسجيل الأحداث بعلامة eventData.
يتم تسجيل الحدث إذا تجاوز inImportance حد التسجيل المحدد في LoggingConfiguration . إذا كانت أهمية الحدث لا تلبي الحد الحالي ، يتم إسقاطها وترجع الدالة 0
كمعرف الحدث الناتج.
هذا المتغير من الاستدعاء يحدد ضمنيًا جميع خيارات الحدث الافتراضية:
- الحدث مختومًا بختم زمني بالوقت الحالي عند نقطة المكالمة ،
- تم تمييز الحدث على أنه متعلق بالجهاز الذي يُجري المكالمة ،
- الحدث مستقل ، ولا يتعلق بأي أحداث أخرى ،
- تم وضع علامة على الحدث على أنه غير عاجل ،
تفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلمات |
| ||||||
عائدات | event_id_t معرف الحدث إذا تمت كتابة الحدث في السجل ، 0 بخلاف ذلك. |
LogEvent
event_id_t LogEvent( const EventSchema & inSchema, EventWriterFunct inEventWriter, void *inAppData, const EventOptions *inOptions )
سجل حدثًا عبر رد اتصال ، مع خيارات.
تسجل الوظيفة حدثًا يتم تمثيله على هيئة EventWriterFunct وسياق بيانات التطبيق الخاص appData
. تكتب الدالة بيانات تعريف الحدث وتستدعي inEventWriter
nl :: Weave :: TLV :: TLVWriter inAppData
بحيث يمكن لرمز المستخدم إرسال بيانات الحدث مباشرة إلى سجل الأحداث. هذا النوع من تسجيل الأحداث يقلل من استهلاك الذاكرة ، حيث يتم تسلسل بيانات الحدث مباشرة في المخزن المؤقت الهدف. يجب أن تحتوي بيانات الحدث على علامات سياق ليتم تفسيرها ضمن المخطط المعرّف بواسطة inProfileID
و inEventType
. سيتم تجاهل علامة العنصر الأول ؛ سيستبدلها نظام تسجيل الأحداث بعلامة eventData.
يتم تسجيل الحدث إذا تجاوز inImportance حد التسجيل المحدد في LoggingConfiguration . إذا كانت أهمية الحدث لا تفي بالحد الحالي ، فسيتم إسقاطها وإرجاع الدالة 0
كمعرف الحدث الناتج.
يسمح هذا البديل من الاستدعاء للمتصل بتعيين أي مجموعة من EventOptions
:
- الطابع الزمني ، عندما يكون 0 افتراضيًا على الوقت الحالي عند نقطة الاتصال ،
- قسم "الجذر" لمصدر الحدث (مصدر الحدث ومعرف السمة) ؛ إذا كان NULL ، فسيتم تعيينه افتراضيًا على الجهاز الحالي. تم تمييز الحدث على أنه متعلق بالجهاز الذي يُجري المكالمة ،
- معرف حدث ذي صلة لتجميع معرفات الحدث ؛ عندما يكون معرف الحدث ذي الصلة 0 ، يتم تمييز الحدث على أنه لا يتعلق بأي أحداث أخرى ،
- الاستعجال؛ بشكل افتراضي غير عاجل.
تفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المعلمات |
| ||||||||
عائدات | event_id_t معرف الحدث إذا تمت كتابة الحدث في السجل ، 0 بخلاف ذلك. |
سجل حر
event_id_t LogFreeform( ImportanceType inImportance, const char *inFormat, ... )
LogFreeform يرسل سلسلة حرة إلى دفق الحدث الافتراضي.
سيتم تغليف السلسلة في بنية حدث التصحيح ، متطابقة هيكليًا مع السلاسل الأخرى المسجلة. سيكون معرف الملف الشخصي للحدث هو معرف حدث Nest Debug ، وسيكون نوع الحدث هو kNestDebug_StringLogEntryEvent
.
تفاصيل | |||||
---|---|---|---|---|---|
المعلمات |
| ||||
عائدات | event_id_t معرف الحدث إذا تمت كتابة الحدث في السجل ، 0 بخلاف ذلك. |
LookForElementWithTag
WEAVE_ERROR LookForElementWithTag( const nl::Weave::TLV::TLVReader & aSrcReader, const uint64_t aTagInApiForm, nl::Weave::TLV::TLVReader *apDstReader )
PlainTextWriter
WEAVE_ERROR PlainTextWriter( TLVWriter & ioWriter, uint8_t inDataTag, void *appData )
وظيفة مساعدة لإرسال نص حر كحدث تصحيح.
حدث التصحيح عبارة عن بنية ذات سجل ونص حر.
تفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلمات |
| ||||||
إرجاع القيم |
|
PlainTextWriter
WEAVE_ERROR PlainTextWriter( ::nl::Weave::TLV::TLVWriter & ioWriter, uint8_t inDataTag, void *appData )
وظيفة مساعدة لإرسال نص حر كحدث تصحيح.
حدث التصحيح عبارة عن بنية ذات سجل ونص حر.
تفاصيل | |||||||
---|---|---|---|---|---|---|---|
المعلمات |
| ||||||
إرجاع القيم |
|
عامل! =
bool operator!=( const ResourceIdentifier & lhs, const ResourceIdentifier & rhs )
عامل التشغيل ==
bool operator==( const ResourceIdentifier & lhs, const ResourceIdentifier & rhs )
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates. Thread is a registered trademark of the Thread Group, Inc.
Last updated 2020-08-28 UTC.