nl:: বুনা:: বাঁধাই

একটি ওয়েভ যোগাযোগ এবং সংশ্লিষ্ট কনফিগারেশন তথ্যের উদ্দেশ্য লক্ষ্য ক্যাপচার করে।

সারসংক্ষেপ

একটি বাইন্ডিং অবজেক্ট একটি ওয়েভ কমিউনিকেশনের ("পিয়ার" নামেও পরিচিত) উদ্দিষ্ট টার্গেটকে চিহ্নিত করে, সাথে কনফিগারেশন প্যারামিটারের একটি সেট সহ বর্ণনা করে যে পিয়ারের সাথে কীভাবে যোগাযোগ করা উচিত। বাইন্ডিং দুটি পক্ষের মধ্যে কথিত অ্যাপ্লিকেশন প্রোটোকল থেকে স্বাধীন। যেমন, তারা একটি যোগাযোগের "কে" এবং "কিভাবে" ক্যাপচার করে, কিন্তু "কি" নয়।

কনফিগারেশন

অ্যাপ্লিকেশানগুলিকে অবশ্যই পছন্দসই যোগাযোগের চ্যানেলের ধরণের নির্দিষ্ট পরামিতি সহ একটি বাঁধাই কনফিগার করতে হবে৷ বাইন্ডিংগুলি বিভিন্ন নেটওয়ার্ক পরিবহনের জন্য সমর্থন প্রদান করে, যার মধ্যে রয়েছে TCP, UDP, UDP উইথ উইভ রিলায়েবল মেসেজিং এবং ওয়েভ ওভার BLE (WoBLE)। অ্যাপ্লিকেশনগুলি পক্ষগুলির মধ্যে প্রেরিত বার্তাগুলিকে সুরক্ষিত করতে নির্দিষ্ট সুরক্ষা ব্যবস্থা ব্যবহারের অনুরোধও করতে পারে। এর মধ্যে রয়েছে CASE এবং PASE সেশন এবং অ্যাপ্লিকেশন গ্রুপ কী। একটি বাইন্ডিং কনফিগার করার জন্য ইন্টারফেস একটি ঘোষণামূলক 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
)