nl::Weave::ربط

يشير إلى الهدف المقصود من اتصالات Weave ومعلومات الإعداد المرتبطة.

الملخّص

يحدد كائن الربط الهدف المقصود لاتصال Weave (المعروف أيضًا باسم "P&;&") بالإضافة إلى مجموعة من معلمات الإعداد التي تصف كيفية إجراء الاتصال مع نظيره. ترتبط عمليات الربط ببروتوكول التطبيق الذي يتم قوله بين الطرفين. وبالتالي، تلتقط العلامة "&&;;&&;;&;;ٍّ&ٍّ؛؛؛؛؛؛ أو؛ غير أنّها ليست في اقتباس؛؛؛؛؛ تمثل؛

الإعداد

يجب على التطبيقات ضبط ربط بمعلمات خاصة بنوع قناة الاتصال المطلوبة. توفّر عمليات الربط دعمًا لمجموعة من عمليات نقل الشبكة، بما في ذلك TCP وUDP وUDP مع مراسلة موثوقة من Weave وWaBLE (WoBLE). ويمكن للتطبيقات أيضًا طلب استخدام آليات أمان محددة لحماية الرسائل المُرسَلة بين الطرفين. ويشمل ذلك جلسات CASE وPASE ومفاتيح مجموعة التطبيقات. تستخدم الواجهة لإعداد الربط نمط واجهة برمجة تطبيقات تعريفية يسمح للتطبيقات بتوضيح متطلبات الاتصال بعبارات بسيطة.

للحصول على مزيد من التفاصيل، يمكنك الاطّلاع على مستندات ربط::الإعداد.

الإعداد

قبل بدء التواصل، يجب تحضير علامة إلزامية. يتضمّن عملية إعداد الربط إنشاء الحالة اللازمة للتواصل. وقد يتضمن ذلك إجراءات مثل: حل عنوان الشبكة لشبكة الند أو إنشاء اتصال بالشبكة أو التفاوض على مفاتيح الأمان. بعد تهيئة التطبيق، يتولى الربط جميع الخطوات اللازمة للاستعداد للاتصال، ومعاودة الاتصال بالتطبيق عند اكتمال العملية. وبهذه الطريقة، تخفي عمليات الربط آليات التواصل، ما يسمح للتطبيقات بالتركيز على التفاعلات عالية المستوى.

التواصل

بعد تحضير الربط، يصبح جاهزًا للاستخدام. في هذه الحالة، تطلب التطبيقات (أو بشكل أكثر شيوعًا، رمز طبقة البروتوكول الذي يعمل نيابةً عن تطبيق) الربط لتخصيص سياق تبادل Weave. ويتم ضبط سياق التبادل الناتج بشكل مسبق للتواصل، ما يتيح للتطبيق بدء تبادل Weave على الفور مع الأقران. يمكن للتطبيق الاستمرار في طلب سياقات التبادل من الربط إلى أن يتم إغلاق الربط أو إنهاء بعض الأحداث، مثل تعطّل الشبكة وإنهاء قناة الاتصال الأساسية.

ربط تغييرات الحالة

على مدار استخدامه، سيؤدي الربط إلى تسليم أحداث واجهة برمجة التطبيقات إلى التطبيق لإعلامه بالتغييرات التي تطرأ على حالة الربط's. على سبيل المثال، عند نجاح عملية الإعداد، سيتلقّى التطبيق حدثًا يُعلمك بأنّ الربط جاهز للاستخدام. وبالمثل، في حال تعذُّر قناة الاتصال الأساسية، يتم تسليم حدث إلى التطبيق لإعلامه بأن الربط لم يعد في حالة الاستعداد.

يتم تسليم أحداث واجهة برمجة التطبيقات إلى التطبيق عبر دالة رد اتصال الحدث التي يتم تقديمها عند تخصيص الربط.

الربط منذ إنشاء التطبيق

يتم ربط الملفات المرجعية للسماح بالاستخدام المشترك على مستوى عدة مكونات برامج. عند تخصيص ربط، يتم إنشاء مرجع واحد إلى عملية الربط. ويعمل التطبيق على إصدار هذا المرجع في مرحلة ما في المستقبل بحيث يكون ربط المحتوى مجانيًا لإعادة استخدامه لاحقًا.

عند الانتهاء من تنفيذ أحد التطبيقات باستخدام ربط، قد يطلب التطبيق Close() في عملية الربط. ويؤدي ذلك إلى إصدار التطبيق كمرجع للربط وحظر جميع أحداث واجهة برمجة التطبيقات. وعند إصدار آخر إشارة إلى ربط، يتم إغلاقها تلقائيًا.

الأنواع المتاحة للجميع

 @23

void(* EventCallback)(void *apAppState, EventType aEvent, const InEventParam &aInParam, OutEventParam &aOutParam)

 EventType

 State

void * AppState

void AddRef(
  void
)

WEAVE_ERROR AdjustResponseTimeout(
  ExchangeContext *apExchangeContext
) const 

WEAVE_ERROR AllocateRightSizedBuffer(
  PacketBuffer *& buf,
  const uint32_t desiredSize,
  const uint32_t minSize,
  uint32_t & outMaxPayloadSize
)

Configuration BeginConfiguration()

bool CanBePrepared(
  void
) const 

void Close(
  void
)

WeaveConnection * GetConnection() const 

uint32_t GetDefaultResponseTimeout() const 

const WRMPConfig & GetDefaultWRMPConfig(
  void
) const 

uint8_t GetEncryptionType(
  void
) const 

EventCallback GetEventCallback() const 

WeaveExchangeManager * GetExchangeManager() const 

uint32_t GetKeyId(
  void
) const 

uint16_t GetLogId(
  void
) const 

uint32_t GetMaxWeavePayloadSize(
  const System::PacketBuffer *msgBuf
)

void GetPeerDescription(
  char *buf,
  uint32_t bufSize
) const 

void GetPeerIPAddress(
  nl::Inet::IPAddress & address,
  uint16_t & port,
  InterfaceId & interfaceId
) const 

uint64_t GetPeerNodeId(
  void
) const 

void GetProtocolLayerCallback(
  EventCallback & callback,
  void *& state
) const 

State GetState(
  void
) const 

bool IsAuthenticMessageFromPeer(
  const WeaveMessageInfo *msgInfo
)

bool IsConnectionTransport() const 

bool IsPreparing(
  void
) const 

bool IsReady(
  void
) const 

bool IsUDPTransport() const 

bool IsUnreliableUDPTransport() const 

bool IsWRMTransport() const 

WEAVE_ERROR NewExchangeContext(
  ExchangeContext *& appExchangeContext
)

void Release(
  void
)

WEAVE_ERROR RequestPrepare()

void Reset(
  void
)

void SetDefaultResponseTimeout(
  uint32_t msec
)

void SetDefaultWRMPConfig(
  const WRMPConfig & wrmpConfig
)

void SetEventCallback(
  EventCallback aEventCallback
)

void SetProtocolLayerCallback(
  EventCallback callback,
  void *state
)

void DefaultEventHandler(
  void *apAppState,
  EventType aEvent,
  const InEventParam & aInParam,
  OutEventParam & aOutParam
)