Sdílet prostřednictvím


ServiceBusSessionReceiverOptions interface

Popisuje možnosti předávané acceptSession a acceptNextSession metodám při použití fronty nebo předplatného s povolenými relacemi.

Extends

Vlastnosti

identifier

Nastaví název pro identifikaci příjemce relace. Dá se použít ke korelaci protokolů a výjimek. Pokud není zadán nebo prázdný, použije se náhodný jedinečný.

maxAutoLockRenewalDurationInMs

Maximální doba trvání v milisekundách, po kterou se zámek relace automaticky obnoví klientem.

  • výchozí : 300000 milisekundy (5 minut).
  • Chcete-li zakázat automatické uzamčení, nastavte tuto možnost na 0.

Příklad :

Pokud zámek vyprší za 2 minuty a doba zpracování je 8 minut...

Nastavte maxAutoLockRenewalDurationInMs na 10 minut a zámek se automaticky obnoví přibližně 4krát (ekvivalent k uzamčení relace po dobu 4násobku doby trvání uzamčení pomocí prodloužení zámku).

receiveMode

Představuje režim příjmu příjemce.

V režimu receiveAndDelete se zprávy odstraní ze služby Service Bus při jejich přijetí.

V režimu peekLock má příjemce zámek zprávy po dobu trvání uvedenou ve frontě nebo odběru.

Zprávy, které nejsou v rámci doby trvání uzamčení vyřešeny, budou znovu předány tolikrát, kolikrát je maximální počet doručení nastavený ve frontě nebo předplatném, po kterém se odešlou do samostatné fronty nedoručených zpráv.

Zprávu můžete vyřešit voláním metody complete(), abandon(), defer() nebo deadletter() ve zprávě.

Další informace o fungování funkce PeekLock a vypořádání zpráv najdete tady: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock

skipConvertingDate

Zda se má při přijetí zprávy přeskočit převod typu datum u vlastností poznámek zpráv nebo vlastností aplikace na čísla. Ve výchozím nastavení se vlastnosti typu Date pro zajištění kompatibility převedou na epochové číslo systému UNIX.

skipParsingBodyAsJson

Možnost zakázat spuštění klienta JSON.parse() v textu zprávy při přijetí zprávy. Nelze použít, pokud byla zpráva odeslána s hodnotou nebo sekvencí typu textu AMQP. Tuto možnost použijte, pokud chcete pracovat přímo s bajty, které jsou přítomné v textu zprávy, než aby se klient pokusil parsovat.

Zděděné vlastnosti

abortSignal

Signál, který lze použít k přerušení požadavků.

tracingOptions

Možnosti používané při povolení trasování

Podrobnosti vlastnosti

identifier

Nastaví název pro identifikaci příjemce relace. Dá se použít ke korelaci protokolů a výjimek. Pokud není zadán nebo prázdný, použije se náhodný jedinečný.

identifier?: string

Hodnota vlastnosti

string

maxAutoLockRenewalDurationInMs

Maximální doba trvání v milisekundách, po kterou se zámek relace automaticky obnoví klientem.

  • výchozí : 300000 milisekundy (5 minut).
  • Chcete-li zakázat automatické uzamčení, nastavte tuto možnost na 0.

Příklad :

Pokud zámek vyprší za 2 minuty a doba zpracování je 8 minut...

Nastavte maxAutoLockRenewalDurationInMs na 10 minut a zámek se automaticky obnoví přibližně 4krát (ekvivalent k uzamčení relace po dobu 4násobku doby trvání uzamčení pomocí prodloužení zámku).

maxAutoLockRenewalDurationInMs?: number

Hodnota vlastnosti

number

receiveMode

Představuje režim příjmu příjemce.

V režimu receiveAndDelete se zprávy odstraní ze služby Service Bus při jejich přijetí.

V režimu peekLock má příjemce zámek zprávy po dobu trvání uvedenou ve frontě nebo odběru.

Zprávy, které nejsou v rámci doby trvání uzamčení vyřešeny, budou znovu předány tolikrát, kolikrát je maximální počet doručení nastavený ve frontě nebo předplatném, po kterém se odešlou do samostatné fronty nedoručených zpráv.

Zprávu můžete vyřešit voláním metody complete(), abandon(), defer() nebo deadletter() ve zprávě.

Další informace o fungování funkce PeekLock a vypořádání zpráv najdete tady: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock

receiveMode?: "peekLock" | "receiveAndDelete"

Hodnota vlastnosti

"peekLock" | "receiveAndDelete"

skipConvertingDate

Zda se má při přijetí zprávy přeskočit převod typu datum u vlastností poznámek zpráv nebo vlastností aplikace na čísla. Ve výchozím nastavení se vlastnosti typu Date pro zajištění kompatibility převedou na epochové číslo systému UNIX.

skipConvertingDate?: boolean

Hodnota vlastnosti

boolean

skipParsingBodyAsJson

Možnost zakázat spuštění klienta JSON.parse() v textu zprávy při přijetí zprávy. Nelze použít, pokud byla zpráva odeslána s hodnotou nebo sekvencí typu textu AMQP. Tuto možnost použijte, pokud chcete pracovat přímo s bajty, které jsou přítomné v textu zprávy, než aby se klient pokusil parsovat.

skipParsingBodyAsJson?: boolean

Hodnota vlastnosti

boolean

Podrobnosti zděděných vlastností

abortSignal

Signál, který lze použít k přerušení požadavků.

abortSignal?: AbortSignalLike

Hodnota vlastnosti

zděděno z OperationOptionsBase.abortSignal

tracingOptions

Možnosti používané při povolení trasování

tracingOptions?: OperationTracingOptions

Hodnota vlastnosti

zděděno z OperationOptionsBase.tracingOptions