Dela via


ServiceBusSessionReceiverOptions interface

Beskriver de alternativ som skickas till metoderna acceptSession och acceptNextSession när du använder en kö/prenumeration som har sessioner aktiverade.

Extends

Egenskaper

identifier

Anger namnet för att identifiera sessionsmottagaren. Detta kan användas för att korrelera loggar och undantag. Om det inte anges eller är tomt används en slumpmässig unik.

maxAutoLockRenewalDurationInMs

Den maximala varaktigheten, i millisekunder, att låset på sessionen förnyas automatiskt av klienten.

  • Standard: 300000 millisekunder (5 minuter).
  • Om du vill inaktivera automatisk förnyelseanger du detta till 0.

Exempel:

Om låset upphör att gälla om 2 minuter och bearbetningstiden är 8 minuter...

Ange maxAutoLockRenewalDurationInMs till 10 minuter, och låset förnyas automatiskt cirka 4 gånger (vilket motsvarar att sessionen är låst i 4 gånger dess låsvaraktighet genom att utnyttja låsförnyelserna).

receiveMode

Representerar mottagarläget.

I läget receiveAndDelete tas meddelanden bort från Service Bus när de tas emot.

I peekLock-läge har mottagaren ett lås på meddelandet under den tid som anges i kön/prenumerationen.

Meddelanden som inte har lösts inom låsets varaktighet levereras på nytt så många gånger som det maximala leveransantalet anges i kön/prenumerationen, varefter de skickas till en separat kö med obeställbara meddelanden.

Du kan lösa ett meddelande genom att anropa metoderna complete(), abandon(), defer() eller deadletter() i meddelandet.

Mer information om hur peekLock och meddelandebosättning fungerar här: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock

skipConvertingDate

Om du vill hoppa över att konvertera datumtyp på egenskaper för meddelandeanteckningar eller programegenskaper till tal när meddelandet tas emot. Som standard konverteras egenskaper för Datumtyp till UNIX-epoknummer för kompatibilitet.

skipParsingBodyAsJson

Alternativ för att inaktivera klienten från att köra JSON.parse() i meddelandetexten när meddelandet tas emot. Inte tillämpligt om meddelandet skickades med AMQP-brödtexttypens värde eller sekvens. Använd det här alternativet när du föredrar att arbeta direkt med byteen som finns i meddelandetexten än om klienten försöker parsa det.

Ärvda egenskaper

abortSignal

Den signal som kan användas för att avbryta begäranden.

tracingOptions

Alternativ som används när spårning är aktiverat.

Egenskapsinformation

identifier

Anger namnet för att identifiera sessionsmottagaren. Detta kan användas för att korrelera loggar och undantag. Om det inte anges eller är tomt används en slumpmässig unik.

identifier?: string

Egenskapsvärde

string

maxAutoLockRenewalDurationInMs

Den maximala varaktigheten, i millisekunder, att låset på sessionen förnyas automatiskt av klienten.

  • Standard: 300000 millisekunder (5 minuter).
  • Om du vill inaktivera automatisk förnyelseanger du detta till 0.

Exempel:

Om låset upphör att gälla om 2 minuter och bearbetningstiden är 8 minuter...

Ange maxAutoLockRenewalDurationInMs till 10 minuter, och låset förnyas automatiskt cirka 4 gånger (vilket motsvarar att sessionen är låst i 4 gånger dess låsvaraktighet genom att utnyttja låsförnyelserna).

maxAutoLockRenewalDurationInMs?: number

Egenskapsvärde

number

receiveMode

Representerar mottagarläget.

I läget receiveAndDelete tas meddelanden bort från Service Bus när de tas emot.

I peekLock-läge har mottagaren ett lås på meddelandet under den tid som anges i kön/prenumerationen.

Meddelanden som inte har lösts inom låsets varaktighet levereras på nytt så många gånger som det maximala leveransantalet anges i kön/prenumerationen, varefter de skickas till en separat kö med obeställbara meddelanden.

Du kan lösa ett meddelande genom att anropa metoderna complete(), abandon(), defer() eller deadletter() i meddelandet.

Mer information om hur peekLock och meddelandebosättning fungerar här: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock

receiveMode?: "peekLock" | "receiveAndDelete"

Egenskapsvärde

"peekLock" | "receiveAndDelete"

skipConvertingDate

Om du vill hoppa över att konvertera datumtyp på egenskaper för meddelandeanteckningar eller programegenskaper till tal när meddelandet tas emot. Som standard konverteras egenskaper för Datumtyp till UNIX-epoknummer för kompatibilitet.

skipConvertingDate?: boolean

Egenskapsvärde

boolean

skipParsingBodyAsJson

Alternativ för att inaktivera klienten från att köra JSON.parse() i meddelandetexten när meddelandet tas emot. Inte tillämpligt om meddelandet skickades med AMQP-brödtexttypens värde eller sekvens. Använd det här alternativet när du föredrar att arbeta direkt med byteen som finns i meddelandetexten än om klienten försöker parsa det.

skipParsingBodyAsJson?: boolean

Egenskapsvärde

boolean

Information om ärvda egenskaper

abortSignal

Den signal som kan användas för att avbryta begäranden.

abortSignal?: AbortSignalLike

Egenskapsvärde

ärvd från OperationOptionsBase.abortSignal

tracingOptions

Alternativ som används när spårning är aktiverat.

tracingOptions?: OperationTracingOptions

Egenskapsvärde

ärvd från OperationOptionsBase.tracingOptions