nl::Weave::Binding

Weave iletişiminin amaçlanan hedefini ve ilişkili yapılandırma bilgilerini yakalar.

Özet

Binding nesnesi, bir Weave iletişiminin amaçlanan hedefini ("eş" olarak da bilinir) ve eşle iletişimin nasıl olması gerektiğini açıklayan bir dizi yapılandırma parametresiyle birlikte tanımlar. Bağlamalar, iki taraf arasında konuşulan uygulama protokolünden bağımsızdır. Bu nedenle iletişimin "kim" ve "nasıl" sorularına yer verilir ancak "ne" soruları cevaplanmaz.

Yapılandırma

Uygulamalar, istenen iletişim kanalı türüne özel parametreler içeren bir Bağlayıcı yapılandırmalıdır. Bağlamalar; TCP, UDP, Weave Reliable Messaging ile UDP ve Weave over BLE (WoBLE) dahil olmak üzere çeşitli ağ aktarımları için destek sağlar. Uygulamalar, taraflar arasında gönderilen iletileri korumak için belirli güvenlik mekanizmalarının kullanılmasını da isteyebilir. Bunlar arasında CASE ve PASE oturumları ile uygulama grubu anahtarları bulunur. Binding yapılandırma arayüzü, uygulamaların iletişim gereksinimlerini basit ifadelerle ifade etmesine olanak tanıyan bildirim temelli bir API stili kullanır.

Daha ayrıntılı bilgi için Binding::Configuration dokümanlarına bakın.

Hazırlık

İletişim gerçekleşmeden önce Bağlama "hazırlanmalıdır". Bağlama hazırlama işlemi, iletişimin gerçekleşmesi için gerekli durumun belirlenmesini içerir. Bu; eşin ağ adresini çözümleme, ağ bağlantısı oluşturma ve güvenlik anahtarları için pazarlık yapma gibi işlemleri içerebilir. Binding, uygulama tarafından yapılandırıldıktan sonra iletişime hazırlanmak için gerekli tüm adımları tamamlar ve işlem tamamlandığında uygulamayı geri çağırır. Bu sayede, Bağlamalar iletişim mekanizmasını gizleyerek uygulamaların üst düzey etkileşimlere odaklanmasını sağlar.

İletişim

Bağlama hazırlandıktan sonra kullanıma hazır hale gelir. Bu durumda, uygulamalar (veya daha yaygın şekilde, bir uygulama adına çalışan protokol katmanı kodu) bir Weave değişim bağlamı ayırmak için Binding (Bağlama) isteğinde bulunur. Sonuçta oluşan değişim bağlamı, iletişim için önceden yapılandırılmış olarak gelir ve uygulamanın eşle hemen bir Weave değişimi başlatmasını sağlar. Uygulama, Bağlama kapatılana veya bir ağ hatası gibi bir olay (ör. ağ hatası) temel iletişim kanalını sonlandırana kadar Bağlama'dan değişim bağlamı istemeye devam edebilir.

Bağlayıcı Durumu Değişiklikleri

Binding, kullanım süresi boyunca uygulamaya Binding durumundaki değişiklikleri bildiren API etkinlikleri yayınlar. Örneğin, hazırlık başarılı olduğunda uygulama, Bağlayıcı'nın kullanıma hazır olduğunu bildiren bir etkinlik alır. Benzer şekilde, temel iletişim kanalı başarısız olursa, uygulamaya Binding (Bağlayıcı) durumunun artık hazır durumda olmadığını bildiren bir etkinlik gönderilir.

API etkinlikleri, uygulamaya Binding ayrıldığında sağlanan bir etkinlik geri çağırma işlevi aracılığıyla gönderilir.

Bağlama Ömrü

Bağlama, birden fazla yazılım bileşeni arasında ortak kullanıma olanak tanımak için referans sayılır. Bir Binding (Bağlama) ayrıldığında, bağlamaya tek bir referans oluşturulur. Uygulama, bu referansı gelecekte belirli bir zamanda yayınlamaktan sorumludur. Böylece Bağlayıcı, daha sonra yeniden kullanılabilir.

Bir uygulama Binding ile tamamlandığında bağlamada Close() işlevini çağırabilir. Bu işlem, uygulamanın Bağlama referansını serbest bırakır ve API etkinliklerinin bundan sonraki tüm iletimini engeller. Bir Bağlama'ya yapılan son referans serbest bırakıldığında otomatik olarak kapatılır.

Herkese açık türler

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