nl::Weave::Binding

Nắm bắt mục tiêu dự kiến của hoạt động giao tiếp trên Weave và thông tin cấu hình liên quan.

Tóm tắt

Đối tượng Binding xác định mục tiêu dự kiến của hoạt động giao tiếp Weave (còn gọi là "ngang hàng"), cùng với một tập hợp các tham số cấu hình mô tả cách quá trình giao tiếp với ứng dụng ngang hàng sẽ diễn ra. Các liên kết độc lập với giao thức ứng dụng được đọc giữa hai bên. Do vậy, chúng nắm bắt được "ai" và câu hỏi "cách thức" về giao tiếp mà không phải là "cái gì".

Cấu hình

Ứng dụng phải định cấu hình Liên kết với các tham số cụ thể cho loại kênh liên lạc mong muốn. Các mối liên kết hỗ trợ nhiều phương thức truyền tải mạng, bao gồm TCP, UDP, UDP với Weave Trusted Messaging và Weave over BLE (WoBLE). Ứng dụng cũng có thể yêu cầu sử dụng các cơ chế bảo mật cụ thể để bảo vệ thư được gửi giữa các bên. Chúng bao gồm các phiên CASE và PASE cũng như các khoá nhóm ứng dụng. Giao diện để định cấu hình Liên kết sử dụng kiểu API khai báo cho phép các ứng dụng nêu rõ yêu cầu giao tiếp theo cách đơn giản.

Hãy xem tài liệu về Binding::Configuration để biết thêm chi tiết.

Chuẩn bị

Trước khi quá trình giao tiếp diễn ra, một Liên kết phải được "chuẩn bị". Hành động chuẩn bị Ràng buộc bao gồm việc thiết lập trạng thái cần thiết để quá trình giao tiếp diễn ra. Chẳng hạn như: phân giải địa chỉ mạng của ứng dụng ngang hàng, thiết lập kết nối mạng và thương lượng khoá bảo mật. Sau khi ứng dụng định cấu hình, Liên kết sẽ xử lý tất cả các bước cần thiết để chuẩn bị giao tiếp, gọi lại ứng dụng khi quá trình hoàn tất. Bằng cách này, Ràng buộc ẩn cơ chế giao tiếp, cho phép các ứng dụng tập trung vào những hoạt động tương tác cấp cao.

Liên lạc

Khi đã chuẩn bị, Binding (Liên kết) sẽ sẵn sàng để sử dụng. Ở trạng thái này, các ứng dụng (hay phổ biến hơn là mã lớp giao thức hoạt động thay mặt cho ứng dụng) yêu cầu Binding để phân bổ ngữ cảnh trao đổi Weave. Bối cảnh trao đổi kết quả được định cấu hình sẵn để giao tiếp, cho phép ứng dụng ngay lập tức bắt đầu một hoạt động trao đổi Weave với ứng dụng ngang hàng. Ứng dụng có thể tiếp tục yêu cầu ngữ cảnh trao đổi từ Liên kết cho đến khi Liên kết được đóng, hoặc một số sự kiện (ví dụ: lỗi mạng) chấm dứt kênh liên lạc cơ bản.

Các thay đổi về trạng thái Binding

Trong quá trình sử dụng, Binding (Liên kết) sẽ gửi các sự kiện API đến ứng dụng để thông báo cho ứng dụng về những thay đổi đối với trạng thái của Binding. Ví dụ: khi chuẩn bị thành công, ứng dụng sẽ nhận được một sự kiện thông báo rằng Liên kết đã sẵn sàng để sử dụng. Tương tự, nếu kênh liên lạc cơ bản bị lỗi, một sự kiện sẽ được gửi đến ứng dụng để thông báo rằng Binding không còn ở trạng thái sẵn sàng nữa.

Các sự kiện API được phân phối đến ứng dụng thông qua hàm callback sự kiện được cung cấp khi phân bổ Binding.

Thời gian tồn tại của Binding

Liên kết được tính để cho phép sử dụng chung trên nhiều thành phần phần mềm. Khi một Liên kết được phân bổ, một tham chiếu duy nhất đến liên kết đó sẽ được tạo. Ứng dụng sẽ chịu trách nhiệm phát hành tệp đối chiếu này vào một thời điểm trong tương lai sao cho Liên kết được miễn phí để sử dụng lại sau này.

Khi hoàn tất quá trình Liên kết, ứng dụng có thể gọi Close() trên liên kết. Thao tác này sẽ huỷ bỏ tham chiếu đến Binding của ứng dụng và chặn tất cả việc phân phối thêm sự kiện API. Khi tham chiếu cuối cùng đến một Liên kết được giải phóng, nó sẽ tự động đóng.

Loại công khai

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