Aracılığıyla paylaş


ServiceBusReceiverOptions interface

Alıcı oluştururken kullanılacak seçenekler.

Özellikler

identifier

Alıcıyı tanımlamak için adı ayarlar. Bu, günlükleri ve özel durumları ilişkilendirmek için kullanılabilir. Belirtilmezse veya boşsa, rastgele benzersiz bir tane kullanılır.

maxAutoLockRenewalDurationInMs

İletideki kilidin istemci tarafından otomatik olarak yenileneceği en uzun süre (milisaniye cinsinden). İleti kapatıldıktan sonra bu otomatik yenileme durdurulur.

  • Varsayılan: 300 * 1000 milisaniye (5 dakika).
  • Otomatik kilitleme yenilemesini devre dışı bırakmak için bunu olarak 0ayarlayın.

Örnek:

İleti kilidinin süresi 2 dakika içinde dolarsa ve ileti işleme süreniz 8 dakikaysa...

maxAutoLockRenewalDurationInMs değerini 10 dakika olarak ayarlayın ve ileti kilidi 4 kez otomatik olarak yenilenir (kilit yenilemelerinden yararlanarak iletinin kilit süresinin 4 katı boyunca kilitlenmesine eşdeğerdir).

receiveMode

Alıcı için alma modunu temsil eder.

receiveAndDelete modunda iletiler alındıklarında Service Bus'tan silinir.

PeekLock modunda, alıcının kuyrukta/abonelikte belirtilen süre boyunca iletide bir kilidi vardır.

Kilit süresi içinde kapatılmayan iletiler, kuyrukta/abonelikte ayarlanan maksimum teslim sayısı kadar tekrar teslim edilir ve daha sonra ayrı bir teslim edilemeyen ileti kuyruğuna gönderilir.

İletide complete(), abandon(), defer() veya deadletter() yöntemlerini çağırarak iletiyi kapatabilirsiniz.

PeekLock ve ileti düzenlemenin nasıl çalıştığı hakkında daha fazla bilgiyi burada bulabilirsiniz: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock

skipConvertingDate

İletiyi alırken ileti ek açıklamalarının veya uygulama özelliklerinin özelliklerindeki Tarih türünün sayıya dönüştürülmesinin atlanıp atlanmadığı. Varsayılan olarak, Tarih türünün özellikleri uyumluluk için UNIX dönem numarasına dönüştürülür.

skipParsingBodyAsJson

İstemcinin, iletiyi alırken ileti gövdesinde JSON.parse() çalıştırmasını devre dışı bırakma seçeneği. İleti AMQP gövde türü değeri veya dizisiyle gönderildiyse geçerli değildir. İstemcinin bunu ayrıştırmaya çalışmasındansa doğrudan ileti gövdesinde bulunan baytlarla çalışmayı tercih ettiğinizde bu seçeneği kullanın.

subQueueType

Herhangi bir kuyruk veya abonelik için geçerli olan alt kuyruğu temsil eder. Geçerli değerler "deadLetter" ve "transferDeadLetter" değerleridir. Teslim edilemeyen ileti kuyrukları hakkında daha fazla bilgi edinmek için bkz. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-dead-letter-queues

Özellik Ayrıntıları

identifier

Alıcıyı tanımlamak için adı ayarlar. Bu, günlükleri ve özel durumları ilişkilendirmek için kullanılabilir. Belirtilmezse veya boşsa, rastgele benzersiz bir tane kullanılır.

identifier?: string

Özellik Değeri

string

maxAutoLockRenewalDurationInMs

İletideki kilidin istemci tarafından otomatik olarak yenileneceği en uzun süre (milisaniye cinsinden). İleti kapatıldıktan sonra bu otomatik yenileme durdurulur.

  • Varsayılan: 300 * 1000 milisaniye (5 dakika).
  • Otomatik kilitleme yenilemesini devre dışı bırakmak için bunu olarak 0ayarlayın.

Örnek:

İleti kilidinin süresi 2 dakika içinde dolarsa ve ileti işleme süreniz 8 dakikaysa...

maxAutoLockRenewalDurationInMs değerini 10 dakika olarak ayarlayın ve ileti kilidi 4 kez otomatik olarak yenilenir (kilit yenilemelerinden yararlanarak iletinin kilit süresinin 4 katı boyunca kilitlenmesine eşdeğerdir).

maxAutoLockRenewalDurationInMs?: number

Özellik Değeri

number

receiveMode

Alıcı için alma modunu temsil eder.

receiveAndDelete modunda iletiler alındıklarında Service Bus'tan silinir.

PeekLock modunda, alıcının kuyrukta/abonelikte belirtilen süre boyunca iletide bir kilidi vardır.

Kilit süresi içinde kapatılmayan iletiler, kuyrukta/abonelikte ayarlanan maksimum teslim sayısı kadar tekrar teslim edilir ve daha sonra ayrı bir teslim edilemeyen ileti kuyruğuna gönderilir.

İletide complete(), abandon(), defer() veya deadletter() yöntemlerini çağırarak iletiyi kapatabilirsiniz.

PeekLock ve ileti düzenlemenin nasıl çalıştığı hakkında daha fazla bilgiyi burada bulabilirsiniz: https://docs.microsoft.com/azure/service-bus-messaging/message-transfers-locks-settlement#peeklock

receiveMode?: "peekLock" | "receiveAndDelete"

Özellik Değeri

"peekLock" | "receiveAndDelete"

skipConvertingDate

İletiyi alırken ileti ek açıklamalarının veya uygulama özelliklerinin özelliklerindeki Tarih türünün sayıya dönüştürülmesinin atlanıp atlanmadığı. Varsayılan olarak, Tarih türünün özellikleri uyumluluk için UNIX dönem numarasına dönüştürülür.

skipConvertingDate?: boolean

Özellik Değeri

boolean

skipParsingBodyAsJson

İstemcinin, iletiyi alırken ileti gövdesinde JSON.parse() çalıştırmasını devre dışı bırakma seçeneği. İleti AMQP gövde türü değeri veya dizisiyle gönderildiyse geçerli değildir. İstemcinin bunu ayrıştırmaya çalışmasındansa doğrudan ileti gövdesinde bulunan baytlarla çalışmayı tercih ettiğinizde bu seçeneği kullanın.

skipParsingBodyAsJson?: boolean

Özellik Değeri

boolean

subQueueType

Herhangi bir kuyruk veya abonelik için geçerli olan alt kuyruğu temsil eder. Geçerli değerler "deadLetter" ve "transferDeadLetter" değerleridir. Teslim edilemeyen ileti kuyrukları hakkında daha fazla bilgi edinmek için bkz. https://docs.microsoft.com/azure/service-bus-messaging/service-bus-dead-letter-queues

subQueueType?: "deadLetter" | "transferDeadLetter"

Özellik Değeri

"deadLetter" | "transferDeadLetter"