nl::Weave::Binding

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

요약

Binding 객체는 피어와의 통신이 이루어지는 방식을 설명하는 구성 매개변수 집합과 함께 Weave 통신의 의도한 대상('피어'라고도 함)을 식별합니다. 바인딩은 양 당사자가 말하는 애플리케이션 프로토콜과는 별개입니다. 따라서 '누가' '방법' '무엇을'가 아니라 커뮤니케이션의 핵심입니다.

구성

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

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

준비

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

커뮤니케이션

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

바인딩 상태 변경

Binding은 사용 과정에서 API 이벤트를 애플리케이션에 전달하여 Binding의 상태 변경을 알립니다. 예를 들어 준비가 완료되면 애플리케이션에서 Binding을 사용할 준비가 되었음을 알리는 이벤트를 수신합니다. 마찬가지로 기본 통신 채널이 실패하면 이벤트가 애플리케이션에 전달되어 Binding이 더 이상 준비 상태가 아님을 알립니다.

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

바인딩 수명

바인딩은 여러 소프트웨어 구성요소에서 공유 사용을 허용하기 위해 참조로 계산됩니다. 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
)