nl::Weave::Profiles::DataManagement_Current::SubscriptionHandler

Ringkasan

Jenis publik
@142 enum
EventCallback)(void *const aAppState, EventID aEvent, const InEventParam &aInParam, OutEventParam &aOutParam) typedef
void(*
EventID enum
HandlerId typedef
uint8_t

Fungsi statis publik
DefaultEventHandler(EventID aEvent, const InEventParam & aInParam, OutEventParam & aOutParam)
void

Fungsi publik
AbortSubscription(void)
void
Fungsi ini akan langsung menghentikan langganan - ini adalah panggilan sinkron.
AcceptSubscribeRequest(const uint32_t aLivenessTimeoutSec)
EndSubscription(const uint32_t aReasonProfileId, const uint16_t aReasonStatusCode)
Fungsi ini memulai penonaktifan langganan secara halus dan pembersihan objek pengendali.
GetBinding(void) const
GetMaxNotificationSize(void) const
uint32_t
GetPeerNodeId(void) const
uint64_t
GetSubscriptionId(uint64_t *const apSubscriptionId)
IsActive(void)
bool
IsCanceling() const
bool
IsEstablishedIdle()
bool
IsFree()
bool
IsTerminated()
bool
SetMaxNotificationSize(const uint32_t aMaxPayload)
void

Struct
nl::Weave::Profiles::DataManagement_Current::SubscriptionHandler::TraitInstanceInfo

Serikat
nl::Weave::Profiles::DataManagement_Current::SubscriptionHandler::InEventParam
nl::Weave::Profiles::DataManagement_Current::SubscriptionHandler::OutEventParam

Jenis publik

@142

 @142

EventCallback

void(* EventCallback)(void *const aAppState, EventID aEvent, const InEventParam &aInParam, OutEventParam &aOutParam)

EventID

 EventID

HandlerId

uint8_t HandlerId

Fungsi statis publik

DefaultEventHandler

void DefaultEventHandler(
  EventID aEvent,
  const InEventParam & aInParam,
  OutEventParam & aOutParam
)

Fungsi publik

AbortSubscription

void AbortSubscription(
  void
)

Fungsi ini akan langsung menghentikan langganan - ini adalah panggilan sinkron.

Membatalkan langganan penayang.

Tidak ada upaya yang dilakukan untuk memberi tahu klien tentang penghentian tersebut, dan konteks bursa yang mendasarinya, jika ada, akan segera dibatalkan. Setelah panggilan ini, aplikasi tidak akan diberi tahu jika ada aktivitas lebih lanjut pada objek ini. Selain itu, aplikasi tidak diizinkan berinteraksi dengan objek ini setelahnya melalui salah satu metodenya.

Menghentikan akhir langganan penayang, tanpa memberi tahu klien langganan dan tanpa mengirim peristiwa OnSubscriptionTerminated ke pengendali peristiwa aplikasi. Jika sudah ada langganan bersama, langganan balasan dari penerbit yang kembali ke klien juga akan dihentikan.

Setelah memanggil AbortSubscription(), objek SubscriptionHandler memasuki status Terminated. Jika tidak ada referensi tambahan ke objek saat proses penghentian selesai, objek SubscriptionHandler akan dibebaskan.

AcceptSubscribeRequest

WEAVE_ERROR AcceptSubscribeRequest(
  const uint32_t aLivenessTimeoutSec
)

EndSubscription

WEAVE_ERROR EndSubscription(
  const uint32_t aReasonProfileId,
  const uint16_t aReasonStatusCode
)

Fungsi ini memulai penonaktifan langganan secara halus dan pembersihan objek pengendali.

Mengakhiri langganan penerbit dengan baik.

Ini adalah panggilan asinkron dan akan memberi tahu klien tentang penonaktifan yang akan terjadi melalui pesan SubscribeCancel/StatusReport jika relevan.

Hal ini terutama melepaskan keterlibatan aplikasi dalam langganan ini. Setelah panggilan ini, aplikasi tidak akan diberi tahu jika ada aktivitas lebih lanjut pada objek ini. Selain itu, aplikasi tidak diizinkan berinteraksi dengan objek ini setelahnya melalui salah satu metodenya.

Menghentikan akhir langganan penerbit secara halus. Jika dukungan pembatalan langganan diaktifkan, pesan SubscribeCancelRequest akan dikirim ke klien langganan dan sistem akan menunggu balasan sebelum menghentikan langganan; jika tidak, langganan akan langsung dihentikan dengan cara yang serupa dengan AbortSubscription(). Jika sudah ada langganan bersama, langganan balasan dari penerbit yang kembali ke klien juga akan dihentikan.

Detail
Parameter
[in] aReasonProfileId
ProfileId dari StatusCode yang menunjukkan alasan di balik penghentian
[in] aReasonStatusCode
StatusCode yang menunjukkan alasan di balik penghentian
Nilai yang Ditampilkan
Returns
kode kesalahan Weave hanya untuk tujuan informasi. Pada error apa pun, objek akan dihentikan secara sinkron (yaitu dibatalkan).

Selagi menunggu respons terhadap SubscribeCancelRequest, SubscriptionHandler akan memasuki status Canceling.

Setelah proses penghentian dimulai, objek SubscriptionHandler memasuki status Terminated dan peristiwa OnSubscriptionTerminated dikirim ke pengendali peristiwa aplikasi. Perhatikan bahwa, jika dukungan pembatalan tidak diaktifkan, pengendali peristiwa dapat dipanggil secara sinkron dalam panggilan ke EndSubscription().

Setelah pengendali peristiwa aplikasi ditampilkan, jika tidak ada referensi tambahan ke objek SubscriptionHandler, objek tersebut akan dibebaskan.

GetBinding

Binding * GetBinding(
  void
) const

GetMaxNotificationSize

uint32_t GetMaxNotificationSize(
  void
) const

GetPeerNodeId

uint64_t GetPeerNodeId(
  void
) const

GetSubscriptionId

WEAVE_ERROR GetSubscriptionId(
  uint64_t *const apSubscriptionId
)

IsActive

bool IsActive(
  void
)

IsCanceling

bool IsCanceling() const

IsEstablishedIdle

bool IsEstablishedIdle()

IsFree

bool IsFree()

IsTerminated

bool IsTerminated()

SetMaxNotificationSize

void SetMaxNotificationSize(
  const uint32_t aMaxPayload
)