nl:: بافت:: صحافی

هدف مورد نظر یک ارتباط Weave و اطلاعات پیکربندی مرتبط را ضبط می کند.

خلاصه

یک شی Binding هدف مورد نظر یک ارتباط Weave (همچنین به عنوان "همتا" شناخته می‌شود)، همراه با مجموعه‌ای از پارامترهای پیکربندی که نحوه برقراری ارتباط با همتا را توصیف می‌کند، شناسایی می‌کند. اتصالات مستقل از پروتکل برنامه است که بین دو طرف صحبت می شود. به این ترتیب، آنها "چه کسی" و "چگونه" یک ارتباط را می گیرند، اما نه "چه چیزی".

پیکربندی

برنامه ها باید یک Binding را با پارامترهای خاص برای نوع کانال ارتباطی مورد نظر پیکربندی کنند. Bindingها از طیف وسیعی از انتقال‌های شبکه، از جمله TCP، UDP، UDP با پیام‌رسانی قابل اعتماد Weave، و Weave over BLE (WoBLE) پشتیبانی می‌کنند. برنامه ها همچنین می توانند استفاده از مکانیسم های امنیتی خاص را برای محافظت از پیام های ارسال شده بین طرفین درخواست کنند. این شامل جلسات CASE و PASE و کلیدهای گروه برنامه است. رابط برای پیکربندی Binding از یک سبک API اعلانی استفاده می کند که به برنامه ها اجازه می دهد الزامات خود را برای ارتباط به زبان ساده بیان کنند.

برای جزئیات بیشتر به مستندات مربوط به Binding::Configuration مراجعه کنید.

آماده سازی

قبل از برقراری ارتباط، یک Binding باید "آماده شود". عمل آماده سازی Binding شامل ایجاد وضعیت لازم برای برقراری ارتباط است. این می تواند شامل مواردی مانند: حل کردن آدرس شبکه همتا، ایجاد اتصال شبکه و مذاکره درباره کلیدهای امنیتی باشد. پس از پیکربندی توسط برنامه، Binding تمام مراحل لازم برای آماده شدن برای برقراری ارتباط را انجام می دهد و پس از تکمیل فرآیند به برنامه باز می گردد. به این ترتیب، Bindings مکانیک ارتباط را پنهان می‌کند و به برنامه‌ها اجازه می‌دهد تا بر تعاملات سطح بالا تمرکز کنند.

ارتباط

هنگامی که یک صحافی آماده شد، برای استفاده آماده می شود. در این حالت، برنامه ها (یا به طور معمول، کد لایه پروتکل که از طرف یک برنامه کار می کند) از Binding درخواست می کنند تا یک زمینه تبادل Weave را اختصاص دهد. زمینه تبادل حاصل از پیش پیکربندی شده برای ارتباط، به برنامه اجازه می‌دهد تا فوراً یک تبادل Weave را با همتا آغاز کند. برنامه می‌تواند به درخواست زمینه‌های مبادله از Binding ادامه دهد تا زمانی که Binding بسته شود، یا برخی رویدادها، به عنوان مثال، خرابی شبکه، کانال ارتباطی اصلی را خاتمه دهد.

تغییرات دولت الزام آور

در طول استفاده از آن، Binding رویدادهای API را به برنامه ارائه می دهد و آن را از تغییرات در وضعیت Binding مطلع می کند. به عنوان مثال، هنگامی که آماده سازی با موفقیت انجام شود، برنامه یک رویداد دریافت می کند که به آن اطلاع می دهد که Binding آماده استفاده است. به طور مشابه، اگر کانال ارتباطی زیربنایی از کار بیفتد، رویدادی به برنامه ارسال می‌شود که به آن اطلاع می‌دهد که Binding دیگر در حالت آماده نیست.

رویدادهای API از طریق یک تابع فراخوانی رویداد که هنگام تخصیص Binding ارائه می‌شود، به برنامه تحویل داده می‌شوند.

طول عمر صحافی

Binding برای اجازه استفاده مشترک در چندین مؤلفه نرم افزاری، مرجع شمارش می شوند. هنگامی که یک Binding اختصاص داده می شود، یک مرجع واحد برای اتصال ایجاد می شود. برنامه مسئول انتشار این مرجع در مقطعی در آینده است به طوری که Binding برای استفاده مجدد بعدی رایگان باشد.

هنگامی که یک برنامه با Binding انجام می شود، ممکن است Close() را روی binding فراخوانی کند. این ارجاع برنامه به Binding را آزاد می کند و همه تحویل بیشتر رویدادهای API را مسدود می کند. هنگامی که آخرین مرجع به یک Binding آزاد می شود، به طور خودکار بسته می شود.

انواع عمومی

 @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
)