nl::Weave::Profiles::SoftwareUpdate::ImageQueryResponse

#include <src/lib/profiles/software-update/SoftwareUpdateProfile.h>

فئة تتيح إنشاء وفك ترميز رسائل الردّ على طلب البحث عن الصور.

ملخّص

تكون رسالة الرد على طلب البحث عن الصورة على النحو التالي:

الطول اسم الحقل
متغير معرّف الموارد المنتظم (URI)
متغير مواصفات الإصدار
متغير مواصفات التكامل
1 بايت تعديل المخطط
1 بايت خيارات التحديث
يكون تنسيق حقل خيارات التحديث (اختياري) كما يلي:

ريشة المعنى
0..2 تعديل الأولوية
3..4 تعديل الحالة
5 حالة التقرير عند ضبط السياسة، يُطلب من العميل إنشاء الرسالتَين الاختياريتَين DownloadNotifications وUpdateUpdate.
5..7 تم الحجز
لا يتم إرسال الردّ على طلب البحث عن الصورة إلا في حال تمت معالجة طلب البحث عن الصورة بنجاح، ما يؤدي إلى إنشاء صورة لتنزيلها. تشكل الرسالة تعليمات تنزيل للعقدة التي تم إرسال طلب البحث فيها. لاحظ أنه في الحالات التي يتعذر فيها على الخادم معالجة استعلام الصورة، فإنه سينشئ حالة استعلام عن الصورة.

الدلالة والهياكل
ImageQueryResponse()
الدالة الإنشائية التلقائية لـ ImageQueryResponse.

السمات العامة
integritySpec
حقل يحتوي على معلومات السلامة (نوع التكامل وتجزئة) لصورة تحديث البرنامج.
reportStatus
bool
طلب إبلاغ الخادم بمدى تقدم تحديث البرنامج من خلال الرسالتين الاختياريتين Downloadإعلام وUpdateUpdate،
updateCondition
تعليمات عن الشروط التي بموجبها متابعة تحديث البرنامج.
updatePriority
يشير هذا المصطلح إلى التعليمات التي توجّه الجهاز لموعد إجراء تحديث البرنامج.
updateScheme
uint8_t
مخطط التحديث المطلوب استخدامه لتنزيل صورة تحديث البرنامج.
uri
سلسلة UTF-8 متغيرة الطول تحتوي على موقع صورة البرنامج
versionSpec
سلسلة UTF-8 متغيرة الطول تحتوي على تعريف إصدار برنامج خاص بالمورّد.

الدوال العامة
init(ReferencedString &, ReferencedString &, IntegritySpec &, uint8_t, UpdatePriority, UpdateCondition, bool)
عليك تهيئة الكائن ImageQueryResponse بوضوح باستخدام القيم المقدَّمة.
operator==(const ImageQueryResponse &) const
bool
عامل مساواة.
pack(PacketBuffer *)
أدخِل دالة ImageQueryResponse في تسلسل استدعاء الدوال البرمجية في PacketBuffer المتوفّر.
print(void)
void

الدوال الثابتة العامة
parse(PacketBuffer *, ImageQueryResponse &)
عليك الاطّلاع على رسالة الردّ على طلب البحث عن الصورة المقدَّمة في PacketBuffer في دالة ImageQueryResponse المقدَّمة.

السمات العامة

integritySpec

IntegritySpec integritySpec

حقل يحتوي على معلومات السلامة (نوع التكامل وتجزئة) لصورة تحديث البرنامج.

reportStatus

bool reportStatus

طلب إبلاغ الخادم بمدى تقدم تحديث البرنامج من خلال الرسالتين الاختياريتين Downloadإعلام وUpdateUpdate،

updateCondition

UpdateCondition updateCondition

تعليمات عن الشروط التي بموجبها متابعة تحديث البرنامج.

updatePriority

UpdatePriority updatePriority

يشير هذا المصطلح إلى التعليمات التي توجّه الجهاز لموعد إجراء تحديث البرنامج.

updateScheme

uint8_t updateScheme

مخطط التحديث المطلوب استخدامه لتنزيل صورة تحديث البرنامج.

ويتم الحصول على قيمته من UpdateSchemes.

uri

ReferencedString uri

سلسلة UTF-8 متغيرة الطول تحتوي على موقع صورة البرنامج

يجب أن تتوافق محتويات هذه السلسلة مع مواصفات RFC 3986. بالنسبة إلى مخططات التحديث المقابلة لبروتوكول إنترنت محدد جيدًا (HTTP وHTTPS وSFTP)، يجب أن يتطابق عنصر مخطط معرّف الموارد المنتظم (URI) مع ترميز عنوان URL الأساسي لنظام البروتوكول هذا. يجب ألا يتجاوز طول السلسلة 65565، ويجب أن تتناسب السلسلة مع رسالة Weave واحدة، والتي قد تخضع لقيود MTU.

versionSpec

ReferencedString versionSpec

سلسلة UTF-8 متغيرة الطول تحتوي على تعريف إصدار برنامج خاص بالمورّد.

يجب ألا يتجاوز طول السلسلة 256 بايت.

الدوال العامة

ImageQueryResponse

 ImageQueryResponse()

الدالة الإنشائية التلقائية لـ ImageQueryResponse.

يمكن تعبئة ImageQueryResponse عن طريق الإجراء init() أو من خلال إلغاء تسلسل الكائن من رسالة.

init

WEAVE_ERROR init(
  ReferencedString &,
  ReferencedString &,
  IntegritySpec &,
  uint8_t,
  UpdatePriority,
  UpdateCondition,
  bool
)

عليك تهيئة الكائن ImageQueryResponse بوضوح باستخدام القيم المقدَّمة.

التفاصيل
المَعلمات
[in] aUri
هو معرّف الموارد المنتظم (URI) الذي يمكن العثور به على النسخة الجديدة للبرامج الثابتة.
[in] aVersion
سلسلة الإصدار لهذه الصورة
[in] aIntegrity
مواصفات السلامة المقابلة للصورة الجديدة
[in] aScheme
نظام التحديث المطلوب استخدامه في عملية التنزيل.
[in] aPriority
أولوية التحديث المرتبطة بهذا التعديل
[in] aCondition
الشرط المطلوب التعديل بموجبه.
[in] aReportStatus
إذا كانت القيمة true تطلب من العميل الإبلاغ بعد التنزيل والتحديث، لن يُبلغ العميل بخلاف ذلك.
المرتجعات
WEAVE_NO_ERROR بدون شروط.

==

bool operator==(
  const ImageQueryResponse &
) const

عامل مساواة.

التفاصيل
المَعلمات
another
استخدام ImageQueryResponse للتحقّق من الأمر ImageQueryResponse
المرتجعات
true إذا كانت جميع الحقول في كلا الكائنين متساوية، false وإلا

حزمة

WEAVE_ERROR pack(
  PacketBuffer *
)

أدخِل دالة ImageQueryResponse في تسلسل استدعاء الدوال البرمجية في PacketBuffer المتوفّر.

التفاصيل
المَعلمات
[in] aBuffer
يشير هذا المصطلح إلى مخزن مؤقّت للحِزم يمكن تجميع ردّ طلب البحث فيه.
قيم الإرجاع
WEAVE_NO_ERROR
عند النجاح
WEAVE_ERROR_BUFFER_TOO_SMALL
إذا كان حجم ImageQueryResponse كبيرًا جدًا بحيث لا يمكن احتواؤه في المخزن المؤقت المقدَّم.

طباعة

void print(
  void
)

الدوال الثابتة العامة

parse

WEAVE_ERROR parse(
  PacketBuffer *,
  ImageQueryResponse &
)

عليك الاطّلاع على رسالة الردّ على طلب البحث عن الصورة المقدَّمة في PacketBuffer في دالة ImageQueryResponse المقدَّمة.

التفاصيل
المَعلمات
[in] aBuffer
مؤشر يشير إلى حزمة يمكن تحليل استعلام الصورة منها
[in] aResponse
كائن يتم وضع النتيجة فيه
المرتجعات
WEAVE_NO_ERROR عند النجاح
المرتجعات
WEAVE_ERROR_BUFFER_TOO_SMALL إذا كانت الرسالة صغيرة جدًا بحيث لا يمكن أن تحتوي على جميع حقول ImageQuery
المرتجعات
WEAVE_ERROR_INVALID_INTEGRITY_TYPE إذا لم يكن نوع السلامة المقدّم من القيم المحددة في IntegrityTypes