nl::Weave::Binding

Weave 통신의 의도된 대상과 관련 구성 정보를 캡처합니다.

요약

Binding 객체는 피어와의 통신 방법을 설명하는 구성 매개변수 집합과 함께 Weave 통신의 의도된 대상('피어'라고도 함)을 식별합니다. 바인딩은 두 당사자 간에 사용되는 애플리케이션 프로토콜과는 별개입니다. 따라서 커뮤니케이션의 '누구'와 '방법'은 포착하지만 '무엇'은 포착하지 않습니다.

구성

애플리케이션은 원하는 통신 채널 유형에 맞는 매개변수를 사용하여 Binding을 구성해야 합니다. 바인딩은 Weave Reliable Messaging을 사용한 TCP, UDP, UDP 및 Weave over BLE (WoBLE)를 포함한 다양한 네트워크 전송을 지원합니다. 또한 애플리케이션에서는 당사자 간에 전송된 메시지를 보호하기 위해 특정 보안 메커니즘의 사용을 요청할 수 있습니다. 여기에는 CASE 및 PASE 세션과 애플리케이션 그룹 키가 포함됩니다. Binding 구성을 위한 인터페이스는 선언적 API 스타일을 사용합니다. 이를 통해 애플리케이션이 통신 요구사항을 간단하게 명시할 수 있습니다.

자세한 내용은 Binding::Configuration 문서를 참고하세요.

준비

통신이 이루어지기 전에 Binding이 'prepared'되어야 합니다. 바인딩을 준비하는 작업에는 통신이 발생하는 데 필요한 상태를 설정하는 작업이 포함됩니다. 여기에는 피어의 네트워크 주소 확인, 네트워크 연결 설정, 보안 키 협상 등이 포함될 수 있습니다. 애플리케이션에서 구성한 후 Binding은 통신을 준비하는 데 필요한 모든 단계를 처리하고 프로세스가 완료되면 애플리케이션을 다시 호출합니다. 이런 식으로 바인딩은 통신의 메커니즘을 숨겨 애플리케이션이 상위 수준의 상호작용에 집중할 수 있게 해줍니다.

커뮤니케이션

결합이 준비되면 사용할 수 있습니다. 이 상태에서 애플리케이션 (또는 애플리케이션을 대신하여 작동하는 프로토콜 레이어 코드)은 Binding을 요청하여 Weave 교환 컨텍스트를 할당합니다. 결과로 반환되는 교환 컨텍스트는 통신에 대해 사전 구성되어 있으므로 애플리케이션이 피어와 Weave 교환을 즉시 시작할 수 있습니다. 애플리케이션은 결합이 종료되거나 일부 이벤트(예: 네트워크 장애)가 기본 통신 채널을 종료할 때까지 결합에서 교환 컨텍스트를 계속 요청할 수 있습니다.

바인딩 상태 변경사항

Binding은 사용하는 동안 애플리케이션에 API 이벤트를 전달하여 Binding 상태의 변경을 알립니다. 예를 들어 준비가 성공하면 애플리케이션은 결합을 사용할 준비가 되었음을 알리는 이벤트를 수신합니다. 마찬가지로 기본 통신 채널에 장애가 발생하면 애플리케이션에 이벤트가 전달되어 Binding이 더 이상 준비 상태가 아님을 알립니다.

API 이벤트는 Binding이 할당될 때 제공되는 이벤트 콜백 함수를 통해 애플리케이션에 전달됩니다.

바인딩 수명

결합은 여러 소프트웨어 구성요소 간에 공유 사용을 허용하기 위해 참조로 계산됩니다. Binding이 할당되면 바인딩의 단일 참조가 생성됩니다. 애플리케이션은 향후 특정 시점에 이 참조를 해제하여 이후에 Binding을 자유롭게 재사용할 책임이 있습니다.

애플리케이션이 결합으로 완료되면 결합에서 Close()를 호출할 수 있습니다. 이렇게 하면 애플리케이션의 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
)