ServiceBusSessionReceiverOptions interface

الحزمة:

@azure/service-bus

توضح هذه المقالة الخيارات التي تم تمريرها إلى أساليب acceptSessionacceptNextSession عند استخدام قائمة انتظار/اشتراك تم تمكين جلسات العمل فيه.

يمتد

OperationOptionsBase

الخصائص

identifier	تعيين الاسم لتعريف مستقبل جلسة العمل. يمكن استخدام هذا لربط السجلات والاستثناءات. إذا لم يتم تحديده أو إفراغه، استخدام واحد فريد عشوائي.
maxAutoLockRenewalDurationInMs	الحد الأقصى للمدة، بالمللي ثانية، التي سيتم فيها تجديد التأمين على الجلسة تلقائيا من قبل العميل. الافتراضي: 300000 مللي ثانية (5 دقائق). لتعطيل تجديد القفل التلقائي، قم بتعيين هذا إلى 0. مثال : إذا انتهت صلاحية التأمين في دقيقتين وكان وقت المعالجة 8 دقائق... قم بتعيين maxAutoLockRenewalDurationInMs إلى 10 دقائق، وسيتم تجديد القفل تلقائيا حوالي 4 مرات (ما يعادل تأمين الجلسة لمدة 4 أضعاف مدة التأمين الخاصة بها من خلال الاستفادة من تجديدات التأمين).
receiveMode	يمثل وضع الاستلام للمتلقي. في وضع receiveAndDelete، يتم حذف الرسائل من ناقل خدمة Microsoft Azure عند تلقيها. في وضع peekLock، يكون لدى المتلقي تأمين على الرسالة للمدة المحددة في قائمة الانتظار/الاشتراك. ستتم إعادة تسليم الرسائل التي لم تتم تسويتها خلال مدة التأمين عدة مرات مثل الحد الأقصى لعدد التسليم المحدد في قائمة الانتظار/الاشتراك، وبعد ذلك يتم إرسالها إلى قائمة انتظار منفصلة غير مستخدمة. يمكنك تسوية رسالة عن طريق استدعاء أساليب complete() أو abandon() أو defer() أو deadletter() على الرسالة. مزيد من المعلومات حول كيفية عمل peekLock وتسوية الرسائل هنا: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock
skipConvertingDate	ما إذا كان يجب تخطي تحويل نوع التاريخ على خصائص التعليقات التوضيحية للرسالة أو خصائص التطبيق إلى أرقام عند تلقي الرسالة. بشكل افتراضي، يتم تحويل خصائص نوع التاريخ إلى رقم فترة UNIX للتوافق.
skipParsingBodyAsJson	خيار تعطيل العميل من تشغيل JSON.parse() على نص الرسالة عند تلقي الرسالة. لا ينطبق إذا تم إرسال الرسالة بقيمة أو تسلسل نوع نص AMQP. استخدم هذا الخيار عندما تفضل العمل مباشرة مع وحدات البايت الموجودة في نص الرسالة بدلا من محاولة العميل تحليلها.

الخصائص الموروثة

abortSignal	الإشارة التي يمكن استخدامها لإجهاض الطلبات.
tracingOptions	الخيارات المستخدمة عند تمكين التتبع.

تفاصيل الخاصية

identifier

تعيين الاسم لتعريف مستقبل جلسة العمل. يمكن استخدام هذا لربط السجلات والاستثناءات. إذا لم يتم تحديده أو إفراغه، استخدام واحد فريد عشوائي.

identifier?: string

قيمة الخاصية

string

maxAutoLockRenewalDurationInMs

الحد الأقصى للمدة، بالمللي ثانية، التي سيتم فيها تجديد التأمين على الجلسة تلقائيا من قبل العميل.

• الافتراضي: 300000 مللي ثانية (5 دقائق).
• لتعطيل تجديد القفل التلقائي، قم بتعيين هذا إلى 0.

مثال :

إذا انتهت صلاحية التأمين في دقيقتين وكان وقت المعالجة 8 دقائق...

قم بتعيين maxAutoLockRenewalDurationInMs إلى 10 دقائق، وسيتم تجديد القفل تلقائيا حوالي 4 مرات (ما يعادل تأمين الجلسة لمدة 4 أضعاف مدة التأمين الخاصة بها من خلال الاستفادة من تجديدات التأمين).

maxAutoLockRenewalDurationInMs?: number

قيمة الخاصية

number

receiveMode

يمثل وضع الاستلام للمتلقي.

في وضع receiveAndDelete، يتم حذف الرسائل من ناقل خدمة Microsoft Azure عند تلقيها.

في وضع peekLock، يكون لدى المتلقي تأمين على الرسالة للمدة المحددة في قائمة الانتظار/الاشتراك.

ستتم إعادة تسليم الرسائل التي لم تتم تسويتها خلال مدة التأمين عدة مرات مثل الحد الأقصى لعدد التسليم المحدد في قائمة الانتظار/الاشتراك، وبعد ذلك يتم إرسالها إلى قائمة انتظار منفصلة غير مستخدمة.

يمكنك تسوية رسالة عن طريق استدعاء أساليب complete() أو abandon() أو defer() أو deadletter() على الرسالة.

مزيد من المعلومات حول كيفية عمل peekLock وتسوية الرسائل هنا: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock

receiveMode?: "peekLock" | "receiveAndDelete"

قيمة الخاصية

"peekLock" | "receiveAndDelete"

skipConvertingDate

ما إذا كان يجب تخطي تحويل نوع التاريخ على خصائص التعليقات التوضيحية للرسالة أو خصائص التطبيق إلى أرقام عند تلقي الرسالة. بشكل افتراضي، يتم تحويل خصائص نوع التاريخ إلى رقم فترة UNIX للتوافق.

skipConvertingDate?: boolean

قيمة الخاصية

boolean

skipParsingBodyAsJson

خيار تعطيل العميل من تشغيل JSON.parse() على نص الرسالة عند تلقي الرسالة. لا ينطبق إذا تم إرسال الرسالة بقيمة أو تسلسل نوع نص AMQP. استخدم هذا الخيار عندما تفضل العمل مباشرة مع وحدات البايت الموجودة في نص الرسالة بدلا من محاولة العميل تحليلها.

skipParsingBodyAsJson?: boolean

قيمة الخاصية

boolean

تفاصيل الخاصية الموروثة

abortSignal

الإشارة التي يمكن استخدامها لإجهاض الطلبات.

abortSignal?: AbortSignalLike

قيمة الخاصية

AbortSignalLike

موروث من OperationOptionsBase.abortSignal

tracingOptions

الخيارات المستخدمة عند تمكين التتبع.

tracingOptions?: OperationTracingOptions

قيمة الخاصية

OperationTracingOptions

موروث من OperationOptionsBase.tracingOptions