nl::การสาน:การเชื่อมโยง

บันทึกเป้าหมายที่ต้องการของการสื่อสาร Weave และข้อมูลการกําหนดค่าที่เกี่ยวข้อง

สรุป

ออบเจ็กต์ Binding ระบุเป้าหมายการสื่อสารของ Weave (หรือที่เรียกว่า "peer") พร้อมชุดพารามิเตอร์การกําหนดค่าที่อธิบายว่าการสื่อสารกับเพียร์ควรเกิดขึ้นอย่างไร การเชื่อมโยงจะแยกออกจากโปรโตคอลของแอปพลิเคชันที่มีการพูดระหว่าง 2 ฝ่าย ด้วยเหตุนี้ พวกเขาจึงบันทึก &&tt ใคร &"how" ของการสื่อสาร แต่ไม่บันทึก "what."

การกำหนดค่า

แอปพลิเคชันต้องกําหนดค่าการเชื่อมโยงด้วยพารามิเตอร์ที่เฉพาะเจาะจงกับประเภทช่องทางการสื่อสารที่ต้องการ การเชื่อมโยงจะสนับสนุนการขนส่งเครือข่ายที่หลากหลาย ได้แก่ TCP, UDP, UDP ที่มี Weave Reliable Messaging และ Weave Over BLE (WoBLE) นอกจากนี้ แอปพลิเคชันยังส่งคําขอใช้กลไกการรักษาความปลอดภัยที่เจาะจงเพื่อปกป้องข้อความที่ส่งระหว่างคู่สัญญาได้ ซึ่งรวมถึงเซสชัน CASE และ PASE และคีย์กลุ่มแอปพลิเคชัน อินเทอร์เฟซสําหรับการกําหนดค่า Binding ใช้รูปแบบ API แบบการประกาศซึ่งช่วยให้แอปพลิเคชันสามารถระบุข้อกําหนดของแอปพลิเคชันที่ต้องการสื่อสารได้ง่าย

โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบสําหรับ Binding::Configuration

การจัดเตรียม

ก่อนจะเริ่มการสื่อสาร การเชื่อมโยงต้องเป็น "prepared." การดําเนินการจัดเตรียมการเชื่อมโยงเกี่ยวข้องกับการกําหนดสถานะการสื่อสารที่จําเป็น ซึ่งอาจรวมถึงสิ่งต่างๆ อย่างเช่น การแก้ไขที่อยู่เครือข่ายของแอปเทียบเท่า การสร้างการเชื่อมต่อเครือข่าย และการเจรจาต่อรองเกี่ยวกับคีย์ความปลอดภัย เมื่อแอปพลิเคชันกําหนดค่าแล้ว การเชื่อมโยงจะจัดการขั้นตอนทั้งหมดที่จําเป็นสําหรับการเตรียมการสื่อสาร โดยให้โทรกลับไปยังแอปพลิเคชันเมื่อกระบวนการเสร็จสมบูรณ์ ด้วยวิธีนี้ การเชื่อมโยงจะซ่อนกลไกการสื่อสารไว้ ทําให้แอปพลิเคชันมีสมาธิกับการโต้ตอบในระดับสูง

การสื่อสาร

เมื่อเตรียมการเชื่อมโยงเรียบร้อยแล้ว ก็จะพร้อมใช้งาน ในกรณีนี้ แอปพลิเคชัน (หรือบ่อยกว่าโค้ดเลเยอร์โปรโตคอลที่ทํางานในนามของแอปพลิเคชัน) ขอการเชื่อมโยงเพื่อจัดสรรบริบทการแลกเปลี่ยน Weave บริบทของ Exchange ที่ได้มาจะมีการกําหนดค่าไว้ล่วงหน้าสําหรับการสื่อสาร ซึ่งช่วยให้แอปพลิเคชันเริ่มต้นการแลกเปลี่ยน Weave กับแอปเทียบเท่าได้ทันที แอปพลิเคชันยังคงขอบริบทการแลกเปลี่ยนจากการเชื่อมโยงได้จนถึงเวลาที่การเชื่อมโยงปิดลง หรือบางเหตุการณ์ เช่น ความล้มเหลวของเครือข่าย จะยุติช่องทางการสื่อสารที่สําคัญ

การเชื่อมโยงการเปลี่ยนแปลงสถานะ

ในช่วงการใช้งาน ระบบจะเชื่อมโยงเหตุการณ์ API กับแอปพลิเคชัน โดยแจ้งให้ทราบถึงการเปลี่ยนแปลงของสถานะการเชื่อมโยง&#39 เช่น เมื่อเตรียมสําเร็จ แอปพลิเคชันจะได้รับเหตุการณ์แจ้งให้ทราบว่าการเชื่อมโยงพร้อมใช้งานแล้ว ในทํานองเดียวกัน หากช่องทางการสื่อสารที่สําคัญล้มเหลว ระบบจะส่งเหตุการณ์ไปยังแอปพลิเคชันเพื่อแจ้งให้ทราบว่าการเชื่อมโยงไม่อยู่ในสถานะที่พร้อมใช้งานแล้ว

ระบบจะส่งเหตุการณ์ API ไปยังแอปพลิเคชันผ่านฟังก์ชันเรียกกลับของเหตุการณ์ที่กําหนดไว้เมื่อจัดสรรการเชื่อมโยง

การเชื่อมโยงตลอดอายุ

การเชื่อมโยงนับว่าเป็นข้อมูลอ้างอิงเพื่อให้สามารถใช้ร่วมกันในคอมโพเนนต์ซอฟต์แวร์ได้หลายคอมโพเนนต์ เมื่อจัดสรรการเชื่อมโยงแล้ว ระบบจะสร้างข้อมูลอ้างอิงการเชื่อมโยงเดียว แอปพลิเคชันนี้มีหน้าที่รับผิดชอบในการเผยแพร่ข้อมูลอ้างอิงนี้ในอนาคต ซึ่งจะทําให้การเชื่อมโยงเป็นแบบฟรีสําหรับการใช้งานซ้ําได้

เมื่อเรียกใช้แอปพลิเคชันด้วยการเชื่อมโยง แอปพลิเคชันอาจเรียก Close() ในการเชื่อมโยง การดําเนินการนี้จะเผยแพร่ข้อมูลอ้างอิงของแอปพลิเคชันไปยังการเชื่อมโยง และบล็อกการส่งเหตุการณ์ API เพิ่มเติมทั้งหมด เมื่อถอนการอ้างอิงล่าสุดกับการเชื่อมโยงแล้ว ระบบจะปิดการอ้างอิงโดยอัตโนมัติ

ประเภทสาธารณะ

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