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. |
max |
İletideki kilidin istemci tarafından otomatik olarak yenileneceği en uzun süre (milisaniye cinsinden). İleti kapatıldıktan sonra bu otomatik yenileme durdurulur.
Ö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). |
receive |
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 |
skip |
İ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. |
skip |
İ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. |
sub |
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
0
ayarlayı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"