nl:: বুনা:: প্রোফাইল:: Echo_Next :: WeaveEchoClient

Provides the ability to send Weave EchoRequest messages to a peer node and receive
the corresponding EchoResponse messages.

সারসংক্ষেপ

ওয়েভ ইকো ক্লায়েন্ট ক্লাস ওয়েভ ইকো প্রোটোকলের ইনিশিয়েটর সাইড প্রয়োগ করে। আইসিএমপি পিং প্রোটোকলের মতোই, উইভ ইকো প্রোটোকলটি একটি ওয়েভ নোডের সজীবতা এবং পৌঁছানোর ক্ষমতা পরীক্ষা করতে ব্যবহার করা যেতে পারে।

বাইন্ডিং অবজেক্ট দ্বারা চিহ্নিত পিয়ার নোডে এক-অফ বা পুনরাবৃত্তিমূলক ইকোরিকোয়েস্ট বার্তা পাঠাতে অ্যাপ্লিকেশনগুলি WeaveEchoClient ক্লাস ব্যবহার করতে পারে। ইকো অনুরোধে সাড়া দেওয়ার জন্য একটি সংশ্লিষ্ট শ্রেণী বিদ্যমান (দেখুন WeaveEchoServer )।

ক্লায়েন্ট বাইন্ডিং

WeaveEchoClient একটি ওয়েভ বাইন্ডিং অবজেক্ট নেয় যা ইকো অনুরোধের উদ্দিষ্ট প্রাপকের সাথে যোগাযোগ শনাক্ত করতে এবং স্থাপন করতে ব্যবহৃত হয়। WeaveEchoClient অবজেক্টের সূচনা হওয়ার আগে অ্যাপ্লিকেশন দ্বারা বাইন্ডিং কনফিগার এবং প্রস্তুত করা যেতে পারে, অথবা এটি অপ্রস্তুত রাখা যেতে পারে, এই ক্ষেত্রে WeaveEchoClient বাইন্ডিংয়ের অন-ডিমান্ড প্রস্তুতির অনুরোধ করবে (বিস্তারিত জানার জন্য Binding::RequestPrepare() দেখুন )

রেডি স্টেটে প্রবেশ করার পরে যদি এটি ব্যর্থ হয় তবে বাইন্ডিংয়ের অন-ডিমান্ড প্রস্তুতির জন্যও অনুরোধ করা হবে।

সেন্ড রিপিটিং মোড

SendRepeating() পদ্ধতিটি WeaveEchoClient-কে SendRepeating মোডে রাখতে ব্যবহার করা যেতে পারে। এই মোডে ক্লায়েন্ট অবজেক্ট একটি কনফিগার করা ব্যবধানে পিয়ারের কাছে EchoRequest বার্তাগুলির একটি পুনরাবৃত্তি ক্রম পাঠায়। SendRepeating মোড স্টপ() পদ্ধতিতে কল করে বাতিল করা যেতে পারে।

মাল্টিকাস্ট এবং ব্রডকাস্ট

একটি WeaveEchoClient অবজেক্ট একটি উপযুক্ত IPv6 মাল্টিকাস্ট ঠিকানা বা IPv4 স্থানীয় নেটওয়ার্ক সম্প্রচার ঠিকানা (255.255.255.255) সহ বাইন্ডিং অবজেক্ট কনফিগার করে একাধিক প্রাপককে একযোগে EchoRequest পাঠাতে ব্যবহার করা যেতে পারে। যখন WeaveEchoClient অবজেক্ট একটি মাল্টিকাস্ট বা সম্প্রচার পিয়ার ঠিকানা সনাক্ত করে, এটি স্বয়ংক্রিয়ভাবে EchoRequest পাঠানোর পরে মাল্টি-রিস্পন্স মোডে প্রবেশ করে।

এই মোডে, বস্তুটি একই এক্সচেঞ্জে আসা সমস্ত আগত EchoResponse বার্তা শুনতে এবং বিতরণ করতে থাকে। অবজেক্টটি মাল্টি-রিস্পন্স মোডে থাকে যতক্ষণ না: 1) অ্যাপ্লিকেশনটি Stop() বা Send() , 2) SendRepeating মোডে কল করে, অন্য অনুরোধ পাঠানোর সময় আসে, বা 3) কোনও প্রতিক্রিয়া পাওয়া যায় না এবং প্রাপ্তির সময়সীমা শেষ হয়ে যায়।

API ইভেন্ট

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

নিম্নলিখিত API ইভেন্টগুলি সংজ্ঞায়িত করা হয়েছে:

PreparePayload

WeaveEchoClient একটি EchoRequest বার্তা তৈরি করতে চলেছে এবং একটি পেলোড সরবরাহ করার জন্য অ্যাপ্লিকেশনটিকে অনুরোধ করছে৷ একটি অ্যাপ্লিকেশন ইচ্ছা করলে, এটি পেলোড ডেটা সহ একটি নতুন প্যাকেটবাফার ফেরত দিতে পারে। যদি অ্যাপ্লিকেশনটি এই ইভেন্টটি পরিচালনা না করে, তাহলে শূন্য-দৈর্ঘ্যের পেলোড সহ একটি ইকোরিকুয়েস্ট স্বয়ংক্রিয়ভাবে পাঠানো হবে। এই কলব্যাকের সময় অ্যাপ্লিকেশনটি WeaveEchoClient- এর অবস্থা পরিবর্তন করতে পারে না।

অনুরোধ পাঠানো হল

একটি EchoRequest বার্তা সহকর্মীকে পাঠানো হয়েছিল।

প্রতিক্রিয়া প্রাপ্ত

পিয়ার থেকে একটি ইকোরসপন্স বার্তা পাওয়া গেছে। ইভেন্টের আর্গুমেন্টে প্রতিক্রিয়া পেলোড এবং প্রতিক্রিয়া বার্তা সম্পর্কে মেটা-তথ্য রয়েছে।

যোগাযোগে ত্রুটি

একটি EchoRequest তৈরি বা পাঠানোর সময় বা একটি প্রতিক্রিয়ার জন্য অপেক্ষা করার সময় একটি ত্রুটি ঘটেছে৷ একটি প্রতিক্রিয়ার জন্য অপেক্ষা করার সময় ঘটতে পারে এমন ত্রুটিগুলির উদাহরণ হল মূল ত্রুটি বা সংযোগের অপ্রত্যাশিত বন্ধ। ইভেন্টের আর্গুমেন্টে ত্রুটির কারণ রয়েছে।

প্রতিক্রিয়ার সময়সীমা

বরাদ্দকৃত সময়ে একটি ইকো রেসপন্স পাওয়া যায়নি। রেসপন্স টাইমআউট বাইন্ডিং অবজেক্টে DefaultResponseTimeout বৈশিষ্ট্য দ্বারা নিয়ন্ত্রিত হয়।

অনুরোধ বাতিল করা হয়েছে

একটি অগ্রগতি ইকো এক্সচেঞ্জ বাতিল করা হয়েছে কারণ পূর্ববর্তী বার্তায় প্রতিক্রিয়া পাওয়ার আগে আরেকটি ইকোরিকোয়েস্ট পাঠানোর অনুরোধ করা হয়েছিল৷ পরবর্তী ইকোরিকোয়েস্ট পাঠানোর সময় হলে এটি সেন্ডরিপিটিং মোডে দেখা দিতে পারে। এটিও ঘটতে পারে যদি অ্যাপ্লিকেশনটি একটি ইকোরিকোয়েস্ট পাঠানোর পরে সেন্ড() কল করে কিন্তু কোনো প্রতিক্রিয়া পাওয়ার আগে।

যখন অবজেক্টটি মাল্টি-রিস্পন্স মোডে থাকে, অন্তত একটি ইকো-রিস্পন্স বার্তা প্রাপ্ত হলে ইভেন্টটি দমন করা হয়।

পাবলিক প্রকার

void(* EventCallback)(void *appState, EventType eventType, const InEventParam &inParam, OutEventParam &outParam)

 EventType

 State

void * AppState

Binding * GetBinding(
  void
) const 

EventCallback GetEventCallback(
  void
) const 

State GetState(
  void
) const 

WEAVE_ERROR Init(
  Binding *binding,
  EventCallback eventCallback,
  void *appState
)

bool IsSendRrepeating() const 

bool RequestInProgress() const 

WEAVE_ERROR Send(
  void
)

WEAVE_ERROR Send(
  PacketBuffer *payloadBuf
)

WEAVE_ERROR SendRepeating(
  uint32_t sendIntervalMS
)

void SetEventCallback(
  EventCallback eventCallback
)

void Shutdown(
  void
)

void Stop(
  void
)

 WeaveEchoClient(
  void
)

void DefaultEventHandler(
  void *appState,
  EventType eventType,
  const InEventParam & inParam,
  OutEventParam & outParam
)