nl::Weave::Bağlama

Weave iletişiminin hedeflenen hedefini ve ilişkili yapılandırma bilgilerini yakalar.

Özet

Bağlama nesnesi, eş ile iletişimin nasıl gerçekleşeceğini açıklayan bir yapılandırma parametreleri grubuyla birlikte Weave iletişiminin amaçlanan hedefini (""eş" olarak da bilinir) tanımlar. Bağlamalar, iki taraf arasında söylenen uygulama protokolünden bağımsızdır. Bu şekilde, iletişimin nasıl ve nasıl yakalandığını yakalar ancak "ne"yi yakalamazlar.

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, Weave Güvenilir Mesajlaşma ile UDP ve BLE üzerinden Wweve (WoBLE) dahil olmak üzere çeşitli ağ aktarımları için destek sağlar. Uygulamalar ayrıca, taraflar arasında gönderilen mesajları korumak için belirli güvenlik mekanizmalarının kullanılmasını da isteyebilir. Bunlar, CASE ve PASE oturumlarını ve uygulama grubu anahtarlarını içerir. Bağlama yapılandırma arayüzü, uygulamaların iletişimle ilgili şartlarını basit terimlerle belirtmesine olanak tanıyan bildirimli bir API stili kullanır.

Daha fazla bilgi için Bağlama::Yapılandırma dokümanlarına bakın.

Hazırlık

İletişim başlamadan önce Bağlama "hazırlanmalıdır". Bağlama hazırlama işlemi, iletişimin gerçekleşmesi için gereken durumun belirlenmesini içerir. Bunlar, eşin ağ adresini çözümleme, ağ bağlantısı kurma ve güvenlik anahtarları için pazarlık yapma gibi bilgileri içerebilir. Uygulama tarafından yapılandırıldıktan sonra Bağlama işlemi, işlem tamamlandığında uygulamaya geri çağrılmak üzere iletişim için hazırlanmak üzere gerekli tüm adımları gerçekleştirir. Böylece bağlamalar, iletişimin mekaniklerini gizleyerek uygulamaların üst düzey etkileşimlere odaklanmasına olanak tanır.

İ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) Weave exchange bağlamını ayırmak için Bağlama isteğinde bulunur. Sonuçta ortaya çıkan exchange bağlamı, iletişim için önceden yapılandırılmıştır. Böylece uygulama, eşle hemen Weave exchange'i başlatabilir. Uygulama, Bağlama kapatılana veya ağ hatası gibi bir etkinlik meydana gelene kadar temel bağlama kanalını feshedene kadar Bağlama'dan exchange bağlamı istemeye devam edebilir.

Bağlama Durum Değişiklikleri

Bağlama işlemi, uygulama sırasında uygulama sırasında Bağlama durumundaki değişiklikler hakkında bilgi veren API etkinliklerini yayınlar. Örneğin, hazırlık başarılı olduğunda uygulama, Bağlama'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 Bağlama özelliğinin artık hazır durumda olmadığını bildiren bir etkinlik yayınlanır.

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

Bağlama Ömür Boyu

Bağlama, birden çok yazılım bileşeninde paylaşılan kullanıma izin vermek için sayılır. Bir Bağlama ayrıldığında bağlama için tek bir referans oluşturulur. Uygulama, gelecekte bu referansın serbest bırakılmasından sorumludur. Böylece Bağlama, sonraki kullanım için ücretsiz olur.

Uygulama bir Bağlama ile tamamlandığında bağlamada Close() çağrısı yapabilir. Bu, uygulamanın Bağlama referansını serbest bırakır ve API etkinliklerinin daha fazla yayınlanmasını engeller. Bir Bağlama için son referans yayınlandığı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
)