nl::Weave::Vinculación

Captura el destino previsto de una comunicación de Weave y la información de configuración asociada.

Resumen

Un objeto Binding identifica el objetivo previsto de una comunicación de Weave (también conocida como "peer"); junto con un conjunto de parámetros de configuración que describen cómo se debería realizar la comunicación con el par. Las vinculaciones son independientes del protocolo de aplicaciones que se habla entre las dos partes. Como tales, capturan el "quién", el "cómo" y el "cómo" de una comunicación, pero no el "qué"

Configuration

Las aplicaciones deben configurar una Binding con parámetros específicos para el tipo de canal de comunicación deseado. Las vinculaciones proporcionan compatibilidad con un rango de transportes de red, incluidos TCP, UDP, UDP con Weave Reliable Messaging, y Weave sobre BLE (WoBLE). Las aplicaciones también pueden solicitar el uso de mecanismos de seguridad específicos para proteger los mensajes enviados entre las partes. Esto incluye las sesiones CASE y PASE, y las claves de grupo de aplicaciones. La interfaz para configurar una Binding usa un estilo de API declarativo que permite a las aplicaciones establecer sus requisitos para la comunicación en términos simples.

Consulta la documentación de Binding::Configuration para obtener más detalles.

Preparación

Antes de la comunicación, una vinculación debe estar preparada. El acto de preparar una vinculación implica establecer el estado necesario para que se realice la comunicación. Esto puede incluir lo siguiente: resolver la dirección de red del par, establecer una conexión de red y negociar las llaves de seguridad. Una vez configurada por la aplicación, la vinculación se encarga de todos los pasos necesarios para prepararse para la comunicación y vuelve a llamar a la aplicación cuando se completa el proceso. De esta manera, las vinculaciones ocultan la mecánica de la comunicación, lo que permite que las aplicaciones se concentren en las interacciones de alto nivel.

Comunicación

Una vez que se prepara una vinculación, está lista para usarse. En este estado, las aplicaciones (o, más comúnmente, el código de la capa de protocolo que funciona en nombre de una aplicación) solicitan la vinculación para asignar un contexto de intercambio de Weave. El contexto de intercambio resultante viene preconfigurado para la comunicación, lo que permite que la aplicación inicie de inmediato un intercambio de Weave con el par. La aplicación puede seguir solicitando contextos de intercambio desde la vinculación hasta que la vinculación se cierre, o bien algún evento, p.ej., un error de red, finalice el canal de comunicación subyacente.

Cambios de estado de Binding

Durante el uso, una Binding enviará eventos de API a la aplicación para informarle sobre cambios en el estado de Binding. Por ejemplo, cuando se realice correctamente la preparación, la aplicación recibirá un evento que le informará que la vinculación está lista para usarse. De manera similar, si el canal de comunicación subyacente falla, se entrega un evento a la aplicación para informarle que la vinculación ya no está en el estado listo.

Los eventos de la API se entregan a la aplicación a través de una función de devolución de llamada de eventos que se proporciona cuando se asigna la vinculación.

Duración de la vinculación

Las vinculaciones son recuentos de referencias que permiten el uso compartido en varios componentes de software. Cuando se asigna una vinculación, se crea una sola referencia a la vinculación. La aplicación es responsable de lanzar esta referencia en algún momento a fin de que la Binding sea gratuita para su reutilización posterior.

Cuando se completa una aplicación con una Binding, puede llamar a Close() en la vinculación. De esta manera, se libera la referencia de la aplicación a la Binding y se bloquea toda la entrega de eventos de la API. Cuando se libera la última referencia a una Binding, esta se cierra automáticamente.

Tipos públicos

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