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ý. |
| max |
Maximální doba trvání v milisekundách, po kterou se zámek relace automaticky obnoví klientem.
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). |
| receive |
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 |
| skip |
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. |
| skip |
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
| abort |
Signál, který lze použít k přerušení požadavků. |
| tracing |
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í :
300000milisekundy (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