ServiceBusSessionReceiverOptions interface

Pacchetto:

@azure/service-bus

Vengono descritte le opzioni passate ai metodi acceptSession e acceptNextSession quando si usa una coda o una sottoscrizione con sessioni abilitate.

Extends

OperationOptionsBase

Proprietà

identifier	Imposta il nome per identificare il ricevitore di sessione. Può essere usato per correlare log ed eccezioni. Se non specificato o vuoto, verrà usato un valore univoco casuale.
maxAutoLockRenewalDurationInMs	Durata massima, in millisecondi, che il blocco sulla sessione verrà rinnovato automaticamente dal client. predefinita: 300000 millisecondi (5 minuti). Per disabilitare il rinnovo automatico, impostarlo su 0. Esempio di : Se il blocco scade in 2 minuti e il tempo di elaborazione è di 8 minuti... Impostare maxAutoLockRenewalDurationInMs su 10 minuti e il blocco verrà rinnovato automaticamente circa 4 volte (equivale ad avere la sessione bloccata per 4 volte la durata del blocco sfruttando i rinnovi del blocco).
receiveMode	Rappresenta la modalità di ricezione per il ricevitore. In modalità receiveAndDelete i messaggi vengono eliminati dal bus di servizio man mano che vengono ricevuti. In modalità peekLock il ricevitore ha un blocco sul messaggio per la durata specificata nella coda o nella sottoscrizione. I messaggi che non vengono risolti entro la durata del blocco verranno recapitati ogni volta che il numero massimo di recapito impostato nella coda o nella sottoscrizione, dopo il quale vengono inviati a una coda di messaggi non recapitabili separata. È possibile risolvere un messaggio chiamando i metodi complete(), abandon(), defer() o deadletter() nel messaggio. Altre informazioni sul funzionamento di peekLock e message settlement sono disponibili qui: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock
skipConvertingDate	Indica se ignorare la conversione del tipo Date nelle proprietà delle annotazioni dei messaggi o delle proprietà dell'applicazione in numeri durante la ricezione del messaggio. Per impostazione predefinita, le proprietà di tipo Date vengono convertite in numeri di epoca UNIX per la compatibilità.
skipParsingBodyAsJson	Opzione per disabilitare il client dall'esecuzione di JSON.parse() nel corpo del messaggio durante la ricezione del messaggio. Non applicabile se il messaggio è stato inviato con il valore o la sequenza del tipo di corpo AMQP. Usare questa opzione quando si preferisce lavorare direttamente con i byte presenti nel corpo del messaggio rispetto al tentativo del client di analizzarlo.

Proprietà ereditate

abortSignal	Segnale che può essere usato per interrompere le richieste.
tracingOptions	Opzioni utilizzate quando la traccia è abilitata.

Dettagli proprietà

identifier

Imposta il nome per identificare il ricevitore di sessione. Può essere usato per correlare log ed eccezioni. Se non specificato o vuoto, verrà usato un valore univoco casuale.

identifier?: string

Valore della proprietà

string

maxAutoLockRenewalDurationInMs

Durata massima, in millisecondi, che il blocco sulla sessione verrà rinnovato automaticamente dal client.

• predefinita: 300000 millisecondi (5 minuti).
• Per disabilitare il rinnovo automatico, impostarlo su 0.

Esempio di :

Se il blocco scade in 2 minuti e il tempo di elaborazione è di 8 minuti...

Impostare maxAutoLockRenewalDurationInMs su 10 minuti e il blocco verrà rinnovato automaticamente circa 4 volte (equivale ad avere la sessione bloccata per 4 volte la durata del blocco sfruttando i rinnovi del blocco).

maxAutoLockRenewalDurationInMs?: number

Valore della proprietà

number

receiveMode

Rappresenta la modalità di ricezione per il ricevitore.

In modalità receiveAndDelete i messaggi vengono eliminati dal bus di servizio man mano che vengono ricevuti.

In modalità peekLock il ricevitore ha un blocco sul messaggio per la durata specificata nella coda o nella sottoscrizione.

I messaggi che non vengono risolti entro la durata del blocco verranno recapitati ogni volta che il numero massimo di recapito impostato nella coda o nella sottoscrizione, dopo il quale vengono inviati a una coda di messaggi non recapitabili separata.

È possibile risolvere un messaggio chiamando i metodi complete(), abandon(), defer() o deadletter() nel messaggio.

Altre informazioni sul funzionamento di peekLock e message settlement sono disponibili qui: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock

receiveMode?: "peekLock" | "receiveAndDelete"

Valore della proprietà

"peekLock" | "receiveAndDelete"

skipConvertingDate

Indica se ignorare la conversione del tipo Date nelle proprietà delle annotazioni dei messaggi o delle proprietà dell'applicazione in numeri durante la ricezione del messaggio. Per impostazione predefinita, le proprietà di tipo Date vengono convertite in numeri di epoca UNIX per la compatibilità.

skipConvertingDate?: boolean

Valore della proprietà

boolean

skipParsingBodyAsJson

Opzione per disabilitare il client dall'esecuzione di JSON.parse() nel corpo del messaggio durante la ricezione del messaggio. Non applicabile se il messaggio è stato inviato con il valore o la sequenza del tipo di corpo AMQP. Usare questa opzione quando si preferisce lavorare direttamente con i byte presenti nel corpo del messaggio rispetto al tentativo del client di analizzarlo.

skipParsingBodyAsJson?: boolean

Valore della proprietà

boolean

Dettagli proprietà ereditate

abortSignal

Segnale che può essere usato per interrompere le richieste.

abortSignal?: AbortSignalLike

Valore della proprietà

AbortSignalLike

Ereditato da OperationOptionsBase.abortSignal

tracingOptions

Opzioni utilizzate quando la traccia è abilitata.

tracingOptions?: OperationTracingOptions

Valore della proprietà

OperationTracingOptions

Ereditato da OperationOptionsBase.tracingOptions