nl:: بافت:: پروفایل ها:: DataManagement_Current
این فضای نام شامل تمام رابطهای موجود در پروفایل Weave Data Management (WDM) است که در حال حاضر برای استفاده در تولید پشتیبانی میشوند.
خلاصه
Typedefs | |
---|---|
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) | تابع ابزاری که TraitUpdatableDataSink را در کاتالوگ TraitDataSink پیدا می کند. |
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 (const nl::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:: بافت:: پروفایل ها:: DataManagement_Current:: مهر زمانی | اتحادیه ای که یک سیستم مجموعه برنامه یا مهر زمانی 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 بیتی که برابر با ProfileID صفت است. |
kTag_EventType | اجباری. عدد صحیح بدون علامت 16 بیتی که برابر با wdl.event.id برای این نوع رویداد است. |
kTag_EventUTCTimestamp | اختیاری. مهر زمانی UTC رویداد در میلی ثانیه. |
kTag_ExternalEventStructure | برچسب داخلی برای رویدادهای خارجی. هرگز از طریق سیم منتقل نمی شود، هرگز نباید خارج از کتابخانه Weave استفاده شود. |
kTag_RelatedEventID | اختیاری. شناسه رویدادی که این رویداد به آن مرتبط است. اگر حذف شود، مقدار برابر با مقدار kTag_EventID است. |
kTag_RelatedEventImportance | اختیاری. اهمیت رویداد مرتبط اگر حذف شود، مقدار برابر با مقدار kTag_EventImportance است. |
@98
@98
تعاریف نمایه برای صفت اشکال زدایی.
@99
@99
CommandFlags
CommandFlags
نوع اهمیت
ImportanceType
اهمیت ورود گزارش
اهمیت به عنوان راهی برای فیلتر کردن رویدادها قبل از انتشار واقعی در گزارش استفاده می شود. پس از اینکه رویداد در گزارش قرار گرفت، هیچ تمهید دیگری برای حذف آن از گزارش انجام نمی دهیم. سطح اهمیت برای اولویتبندی ذخیرهسازی رویداد است. اگر رویدادی با اهمیت بالا به یک بافر کامل اضافه شود، رویدادها به ترتیب اهمیت (و سن) حذف می شوند تا با آن مطابقت داشته باشند. به این ترتیب، سطوح اهمیت فقط ارزش نسبی دارند. اگر سیستمی فقط از یک سطح اهمیت استفاده می کند، رویدادها فقط به ترتیب سن حذف می شوند، مانند بافر حلقه.
LoggingManagementStates
LoggingManagementStates
Typedefs
CommandFlags
enum nl::Weave::Profiles::DataManagement_Current::CommandFlags CommandFlags
DataVersion
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
EventWriterTLVCopy
FetchExternalEventsFunct
WEAVE_ERROR(* FetchExternalEventsFunct)(EventLoadOutContext *aContext)
نمونه اولیه تابع برای تماس های پلت فرم که داده های رویداد را واکشی می کند.
مشابه FetchEventsSince، این تابع واکشی همه رویدادها را از EventLoadOutContext.mStartingEventID از طریق ExternalEvents.mLastEventID برمیگرداند.
اشاره گر زمینه از نوع FetchExternalEventsContext است. این شامل EventLoadOutContext ، با برخی از متغیرهای کمکی برای قالب TLV است. همچنین شامل یک اشاره گر به ساختار ExternalEvents است که در ثبت نام پاسخ به تماس ایجاد شده است. این محدوده شناسه رویداد برای پاسخ به تماس را مشخص می کند.
در بازگشت از تابع، EventLoadOutContext.mCurrentEventID باید اولین شناسه رویداد را که با موفقیت در بافر TLV نوشته نشده است، منعکس کند. پلتفرم باید هدر رویدادها و داده ها را در فرمت صحیحی که توسط پروتکل EventLogging مشخص شده است، در نویسنده TLV بنویسد. پلتفرم باید منحصر به فرد بودن رویدادها و مُهرهای زمانی را نیز حفظ کند.
تمام خطاهای TLV باید به سطوح بالاتر منتشر شوند. به عنوان مثال، خالی شدن فضای خالی در بافر یک پیام ارسال شده را راه اندازی می کند و به دنبال آن یک تماس دیگر با هر شناسه رویداد باقی می ماند.
جزئیات | |||||||||
---|---|---|---|---|---|---|---|---|---|
ارزش های بازگشتی |
|
GenericTraitSinkCatalog
GenericTraitCatalogImpl< TraitDataSink > GenericTraitSinkCatalog
GenericTraitSourceCatalog
GenericTraitCatalogImpl< TraitDataSource > GenericTraitSourceCatalog
نوع اهمیت
enum nl::Weave::Profiles::DataManagement_Current::ImportanceType ImportanceType
اهمیت ورود گزارش
اهمیت به عنوان راهی برای فیلتر کردن رویدادها قبل از انتشار واقعی در گزارش استفاده می شود. پس از اینکه رویداد در گزارش قرار گرفت، هیچ تمهید دیگری برای حذف آن از گزارش انجام نمی دهیم. سطح اهمیت برای اولویتبندی ذخیرهسازی رویداد است. اگر رویدادی با اهمیت بالا به یک بافر کامل اضافه شود، رویدادها به ترتیب اهمیت (و سن) حذف می شوند تا با آن مطابقت داشته باشند. به این ترتیب، سطوح اهمیت فقط ارزش نسبی دارند. اگر سیستمی فقط از یک سطح اهمیت استفاده می کند، رویدادها فقط به ترتیب سن حذف می شوند، مانند بافر حلقه.
IteratorCallback
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 منحصر به فرد دارای یک PropertyPathHandle منحصر به فرد خواهد بود.
- PropertyPathHandles به طور خودکار توسط یک کامپایلر ویژگی از IDL تولید می شود (در حال حاضر با دست انجام می شود) و به عنوان یک لیست شمارشی در فایل هدر صفت مربوطه نشان داده می شود.
- با این ساختار، منطق برنامه هرگز مستقیماً با مسیرهای WDM سروکار ندارد. در عوض، تعامل آنها با WDM منحصراً از طریق این دسته ها انجام می شود.
- دو مقدار رزرو شده برای دسته های مسیر وجود دارد که معنای خاصی دارند:
- 0 نشان دهنده یک دسته "NULL" است
- 1 نشان دهنده دسته ای است که به ریشه نمونه صفت اشاره می کند.
PropertySchemaHandle
uint16_t PropertySchemaHandle
SchemaVersion
uint16_t SchemaVersion
SingleResourceSinkTraitCatalog
SingleResourceTraitCatalog< TraitDataSink > SingleResourceSinkTraitCatalog
SingleResourceSourceTraitCatalog
SingleResourceTraitCatalog< TraitDataSource > SingleResourceSourceTraitCatalog
TimestampType
enum nl::Weave::Profiles::DataManagement_Current::TimestampType TimestampType
اعتبار و نوع مهر زمانی موجود در EventOptions .
TraitDataHandle
uint16_t TraitDataHandle
duration_t
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"
کارکرد
BdxError Handler
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 )
BdxXferError Handler
void BdxXferErrorHandler( nl::Weave::Profiles::BulkDataTransfer::BDXTransfer *aXfer, nl::Weave::Profiles::StatusReporting::StatusReport *aXferError )
CreatePropertyPathHandle
PropertyPathHandle CreatePropertyPathHandle( PropertySchemaHandle aPropertyPathSchemaId, PropertyDictionaryKey aPropertyPathDictionaryKey )
EventWriterTLVCopy
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 )
IsVersionNewer
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 . اگر دسته وجود نداشته باشد یا به TraitDataSink غیرقابل به روز رسانی اشاره کند، NULL. |
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 جایگزین می کند.
رویداد در صورتی ثبت میشود که اهمیت آن از آستانه ورود مشخص شده در 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 جایگزین می کند.
رویداد در صورتی ثبت میشود که اهمیت آن از آستانه ورود مشخص شده در 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 جایگزین می کند.
رویداد در صورتی ثبت میشود که اهمیت آن از آستانه ورود مشخص شده در 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 جایگزین می کند.
رویداد در صورتی ثبت میشود که اهمیت آن از آستانه ورود مشخص شده در LoggingConfiguration فراتر رود. اگر اهمیت رویداد با آستانه فعلی مطابقت نداشته باشد، حذف می شود و تابع 0
را به عنوان شناسه رویداد حاصل برمی گرداند.
این نوع فراخوان به تماس گیرنده اجازه می دهد هر ترکیبی از EventOptions
را تنظیم کند:
- برچسب زمانی، زمانی که 0 به طور پیشفرض به زمان فعلی در نقطه تماس میرسد،
- بخش "ریشه" منبع رویداد (منبع رویداد و شناسه صفت)؛ اگر NULL باشد، به طور پیش فرض روی دستگاه فعلی است. رویداد به عنوان مربوط به دستگاهی است که تماس را برقرار می کند،
- شناسه رویداد مرتبط برای گروهبندی شناسههای رویداد؛ وقتی شناسه رویداد مربوطه 0 باشد، رویداد به عنوان غیر مرتبط با رویدادهای دیگر علامت گذاری می شود،
- فوریت؛ به طور پیش فرض غیر فوری
جزئیات | |||||||||
---|---|---|---|---|---|---|---|---|---|
مولفه های |
| ||||||||
برمی گرداند | event_id_t شناسه رویداد اگر رویداد در گزارش نوشته شده باشد، 0 در غیر این صورت. |
LogFreeform
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 )
یک تابع کمکی برای انتشار یک متن آزاد به عنوان یک رویداد اشکال زدایی.
رویداد اشکال زدایی ساختاری با یک logregion و یک متن آزاد است.
جزئیات | |||||||
---|---|---|---|---|---|---|---|
مولفه های |
| ||||||
ارزش های بازگشتی |
|
PlainTextWriter
WEAVE_ERROR PlainTextWriter( ::nl::Weave::TLV::TLVWriter & ioWriter, uint8_t inDataTag, void *appData )
یک تابع کمکی برای انتشار یک متن آزاد به عنوان یک رویداد اشکال زدایی.
رویداد اشکال زدایی ساختاری با یک logregion و یک متن آزاد است.
جزئیات | |||||||
---|---|---|---|---|---|---|---|
مولفه های |
| ||||||
ارزش های بازگشتی |
|
اپراتور!=
bool operator!=( const ResourceIdentifier & lhs, const ResourceIdentifier & rhs )
اپراتور==
bool operator==( const ResourceIdentifier & lhs, const ResourceIdentifier & rhs )
جز در مواردی که غیر از این ذکر شده باشد، محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است و نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است. Thread علامت تجاری ثبتشده Thread Group, Inc است.
تاریخ آخرین بهروزرسانی 2022-08-30 بهوقت ساعت هماهنگ جهانی.