nl::Dệt::Liên kết

Chụp mục tiêu dự kiến của thông tin Weave và thông tin cấu hình được liên kết.

Tóm tắt

Đối tượng Liên kết xác định mục tiêu dự kiến của giao tiếp Weave (còn gọi là "Peer"), cùng với một tập hợp tham số cấu hình mô tả quá trình giao tiếp với ứng dụng ngang hàng sẽ diễn ra như thế nào. Các liên kết độc lập với giao thức ứng dụng được nói giữa hai bên. Do đó, họ có thể theo dõi "ai" và "how" của thông tin liên lạc, nhưng không phải &"what."

Configuration

Ứng dụng phải định cấu hình Liên kết với các thông số dành riêng cho loại kênh liên lạc mong muốn. Liên kết hỗ trợ một loạt phương thức truyền mạng, bao gồm TCP, UDP, UDP với Weave Messaging Messaging và Weave qua BLE (WoBLE). Các ứ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. Các phiên này bao gồm phiên CASE và PASE và khóa 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 đối với giao tiếp theo cách ngắn gọn.

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

Chuẩn bị

Trước khi thông báo diễn ra, Liên kết phải là "chuẩn bị." Hành động chuẩn bị Thỏa thuận bao gồm việc thiết lập trạng thái cần thiết cho hoạt động giao tiếp. Quá trình này có thể bao gồm những việc như: giải quyết địa chỉ mạng của đồng nghiệp, thiết lập kết nối mạng và thương lượng các khóa bảo mật. Sau khi ứng dụng định cấu hình, Liên kết sẽ thực hiện mọi bước cần thiết để chuẩn bị liên lạc, gọi lại cho ứng dụng khi quy trình hoàn tất. Bằng cách này, Binding ẩn cơ chế giao tiếp, cho phép ứng dụng tập trung vào các tương tác cấp cao.

Truyền thông

Sau khi chuẩn bị một Binding, liên kết sẽ sẵn sàng để sử dụng. Ở trạng thái này, các ứng dụng (hoặc phổ biến hơn là mã lớp giao thức hoạt động thay mặt cho một ứng dụng) yêu cầu địa chỉ liên kết phân bổ ngữ cảnh trao đổi Weave. Ngữ cảnh trao đổi kết quả được định cấu hình sẵn để giao tiếp, cho phép ứng dụng bắt đầu ngay một cuộc 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ừ Binding cho đến khi đóng Binding hoặc một số sự kiện, chẳng hạn như lỗi mạng, chấm dứt kênh liên lạc cơ bản.

Thay đổi trạng thái liên kết

Trong quá trình sử dụng, Binding sẽ phân phối các sự kiện API tới ứng dụng để thông báo về các thay đổi trong trạng thái Binding\39; Ví dụ: khi quá trình chuẩn bị thành công, ứng dụng sẽ nhận được sự kiện thông báo rằng Binding sẵn sàng để sử dụng. Tương tự, nếu kênh liên lạc cơ bản không hoạt động, thì sự kiện được gửi tới ứng dụng để thông báo rằng Binding không còn ở trạng thái sẵn sàng.

Các sự kiện API được gửi đến ứng dụng thông qua hàm gọi lại sự kiện được cung cấp khi Liên kết được phân bổ.

Giá trị lâu dài của Binding

Liên kết được tham chiếu để 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 tệp tham chiếu duy nhất đến liên kết đó sẽ được tạo. Ứng dụng 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 nào đó trong tương lai để Binding miễn phí cho lần sử dụng lại sau này.

Khi một ứng dụng hoàn tất với một Binding, ứng dụng có thể gọi Close() trên liên kết. Thao tác này sẽ hủy bỏ tệp tham chiếu đến ứng dụng đối với Binding và chặn tất cả các sự kiện phân phối tiếp theo của API. Khi tệp đối chiếu cuối cùng liên kết với Binding được phát hành, tệp đối chiếu đó 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
)