nl::Weave::Binding

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

Özet

Binding nesnesi, bir Weave iletişiminin hedeflenen hedefini ("emsal" olarak da bilinir) ve eşle iletişimin nasıl gerçekleşmesi gerektiğini açıklayan bir dizi yapılandırma parametresi tanımlar. Bağlamalar, iki taraf arasında konuşulan uygulama protokolünden bağımsızdır. Böylece, "kim" yanıtını yakalarlar. ve "nasıl" “Ne” sorusunun cevabını alamayabilirsiniz.

Yapılandırma

Uygulamalar, istenen iletişim kanalı türüne özel parametrelerle bir Bağlama yapılandırmalıdır. Bağlamalar; TCP, UDP, UDP ile Weave Güvenilir Mesajlaşma ve Weave over BLE (WoBLE) dahil olmak üzere çeşitli ağ taşımaları 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. Bunlara CASE ve PASE oturumları ve uygulama grubu anahtarları dahildir. Bağlama'yı yapılandırma arayüzü, uygulamaların iletişim gereksinimlerini basit terimlerle ifade etmesine olanak tanıyan bildirim temelli bir API stili kullanır.

Daha fazla bilgi için Binding::Configuration ile ilgili dokümanlara bakın.

Hazırlık

İletişim gerçekleşmeden önce bağlama "hazırlıklı" olmalıdır. Bağlama hazırlama işlemi, iletişimin gerçekleşmesi için gerekli durumun oluşturulmasını içerir. Bu, eşin ağ adresini çözme, ağ bağlantısı kurma ve güvenlik anahtarları için pazarlık yapma gibi şeyleri içerebilir. Uygulama tarafından yapılandırıldıktan sonra Binding, iletişime hazırlanmak için gerekli tüm adımları gerçekleştirir ve işlem tamamlandığında uygulamayı geri arar. Bu şekilde Bağlamalar iletişim mekaniğini 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 olarak, bir uygulama adına çalışan protokol katmanı kodu), bir Weave exchange bağlamı tahsis etmek için Binding'den istekte bulunur. Sonuçta oluşan exchange bağlamı, iletişim için önceden yapılandırılmış olur. Bu sayede uygulama, eş ile anında Weave değişimi başlatabilir. Uygulama, Bağlama kapatılana kadar veya bir ağ hatası (ör. ağ hatası) sonrasında temel iletişim kanalını sonlandırana kadar Bağlama'dan bağlam bilgisi istemeye devam edebilir.

Bağlama Durumu Değişiklikleri

Binding, kullanımı süresince uygulamaya Binding durumundaki değişiklikler hakkında bilgi veren API etkinlikleri gönderir. Örneğin, hazırlık başarılı olduğunda uygulama, Binding'in kullanıma hazır olduğunu bildiren bir etkinlik alır. Benzer şekilde, temel iletişim kanalı başarısız olursa uygulamaya Binding'in artık hazır durumda olmadığını bildiren bir etkinlik iletilir.

API etkinlikleri, Bağlama ayrıldığında sağlanan bir etkinlik geri çağırma işlevi aracılığıyla uygulamaya iletilir.

Bağlama Ömrü

Bağlama, birden çok yazılım bileşeni arasında ortak kullanıma olanak tanımak için referans sayılır. Bir Bağlama ayrıldığında, bağlama için tek bir referans oluşturulur. Uygulama, Binding'in daha sonra tekrar kullanılabilmesi için bu referansı gelecekte bir noktada serbest bırakmaktan sorumludur.

Bir uygulama Binding ile bittiğinde, bağlama üzerinde Close() işlevini çağırabilir. Bu işlem, uygulamanın Bağlama referansını serbest bırakır ve sonraki tüm API etkinliklerinin yayınlanmasını engeller. Bir Binding'e yapılan son referans iptal edildiğinde 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
)