@azure/core-amqp package
Классы
CbsClient |
Описывает клиент EventHub/ServiceBus Cbs, который взаимодействует с конечной точкой $cbs через amQP-подключение. |
MessagingError |
Описывает базовый класс для ошибки обмена сообщениями. |
RequestResponseLink |
Описывает ссылку amqp request(sender)-response(receiver), созданную в сеансе amqp. |
Интерфейсы
AcquireLockProperties |
Описывает свойства, которые необходимо предоставить при получении блокировки. |
AmqpAnnotatedMessage |
Описывает amqpAnnotatedMessage, часть свойства ServiceBusReceivedMessage(as |
AmqpMessageHeader |
Описывает определенный набор стандартных свойств заголовка сообщения. |
AmqpMessageProperties |
Описывает определенный набор стандартных свойств сообщения. |
CancellableAsyncLock |
CancellableAsyncLock предоставляет механизм для принудительного последовательного выполнения задач с использованием одного и того же ключа. Ожидающие задачи можно отменить вручную с помощью функции abortSignal или автоматически отменить, достигнув указанного значения времени ожидания. |
CbsResponse |
Описывает ответ CBS. |
ConnectionConfig |
Описывает объект конфигурации подключения, созданный после синтаксического анализа строки подключения EventHub или ServiceBus. |
ConnectionConfigOptions |
Описание параметров, которые можно предоставить при создании конфигурации подключения. |
ConnectionContextBase |
Предоставляет контекстные сведения, такие как базовое подключение amqp, сеанс cbs, tokenProvider, конфигурация подключения, преобразователь данных и т. д. |
ConnectionProperties |
Определяет свойства, которые необходимо задать при установке подключения AMQP. |
CreateConnectionContextBaseParameters |
Описывает параметры, которые можно предоставить для создания базового контекста подключения. |
NetworkSystemError |
Описывает поля в Node.js SystemError. Пропускает поля, не связанные с сетевыми вызовами (например, вызовы файловой системы). См. раздел https://nodejs.org/dist/latest-v12.x/docs/api/errors.html#errors_class_systemerror |
RetryConfig |
Описывает параметры, которые необходимо настроить для операции повтора. |
RetryOptions |
Параметры политики повтора, определяющие режим, количество повторных попыток, интервал повтора и т. д. |
SendRequestOptions |
Описывает параметры, которые можно указать при отправке запроса. |
WebSocketOptions |
Параметры для настройки канала подключения AMQP через веб-сокеты. |
Псевдонимы типа
ParsedOutput |
Определяет объект с возможными свойствами, определенными в T. |
Перечисления
ConditionErrorNameMapper |
Сопоставляет условия ошибок amqp с именами ошибок. |
ErrorNameConditionMapper |
Сопоставляет имена ошибок с условиями ошибок amqp. |
RetryMode |
Описывает тип режима повторных попыток. |
RetryOperationType |
Описывает тип операции повтора. |
SystemErrorConditionMapper |
Сопоставляет некоторые ошибки SystemErrors с ошибками amqp |
TokenType |
Описывает тип поддерживаемых маркеров. |
Функции
delay<T>(number, Abort |
Оболочка для setTimeout, которая разрешает обещание после t миллисекунда. |
is |
Определяет, является ли ошибка ошибкой MessagingError. |
is |
Проверяет, является ли указанная ошибка node.js SystemError. |
parse |
Анализирует строку подключения и возвращает объект типа T. Строки подключения имеют следующий синтаксис: ConnectionString ::= |
retry<T>(Retry |
Каждая операция выполняется по крайней мере один раз. Дополнительные попытки выполняются, если предыдущая попытка завершилась сбоем с ошибкой, допускаемой повторно. Количество дополнительных попыток определяется свойством Если |
translate(unknown) | Преобразует ошибку AMQP, полученную на уровне протокола или SystemError, в MessagingError. Все остальные ошибки возвращаются без ошибок. |
Сведения о функции
delay<T>(number, AbortSignalLike, string, T)
Оболочка для setTimeout, которая разрешает обещание после t миллисекунда.
function delay<T>(delayInMs: number, abortSignal?: AbortSignalLike, abortErrorMsg?: string, value?: T): Promise<T | void>
Параметры
- delayInMs
-
number
Число миллисекундах для задержки.
- abortSignal
-
AbortSignalLike
AbortSignal, связанный с содержащей операцией.
- abortErrorMsg
-
string
Сообщение об ошибке прерывания, связанное с содержащей операцию.
- value
-
T
Значение, с которым необходимо разрешить по истечении времени ожидания t миллисекунда.
Возвращаемое значение
Promise<T | void>
- Обещание решено
isMessagingError(Error | MessagingError)
Определяет, является ли ошибка ошибкой MessagingError.
function isMessagingError(error: Error | MessagingError): error
Параметры
- error
-
Error | MessagingError
Ошибка, которая может иметь значение Error или MessagingError.
Возвращаемое значение
error
isSystemError(unknown)
Проверяет, является ли указанная ошибка node.js SystemError.
function isSystemError(err: unknown): err
Параметры
- err
-
unknown
Объект , который может содержать сведения об ошибке.
Возвращаемое значение
err
parseConnectionString<T>(string)
Анализирует строку подключения и возвращает объект типа T. Строки подключения имеют следующий синтаксис:
ConnectionString ::= Part { ";" Part } [ ";" ] [ WhiteSpace ]
Part ::= [ PartLiteral [ "=" PartLiteral ] PartLiteral ::= [ WhiteSpace ] Literal [ WhiteSpace ] Литерал ::= ? любая последовательность символов, кроме ; или = или пробел?
Пробел ::= ? все символы пробелов, включая \r
и \n
?
function parseConnectionString<T>(connectionString: string): ParsedOutput<T>
Параметры
- connectionString
-
string
Строка подключения для анализа.
Возвращаемое значение
ParsedOutput<T>
ParsedOutput.
retry<T>(RetryConfig<T>)
Каждая операция выполняется по крайней мере один раз. Дополнительные попытки выполняются, если предыдущая попытка завершилась сбоем с ошибкой, допускаемой повторно. Количество дополнительных попыток определяется свойством maxRetries
, указанным в аргументе RetryConfig
.
Если mode
параметр имеет значение Fixed
, повторные попытки выполняются для данной операции в течение указанного числа раз с фиксированной задержкой между каждой повторными попытками.
Если mode
для параметра задано значение Exponential
, задержка между повторными попытками корректируется для экспоненциального увеличения при каждой попытке с использованием коэффициента отката мощности 2.
function retry<T>(config: RetryConfig<T>): Promise<T>
Параметры
- config
-
RetryConfig<T>
Параметры для настройки операции повтора
Возвращаемое значение
Promise<T>
Обещаю.
translate(unknown)
Преобразует ошибку AMQP, полученную на уровне протокола или SystemError, в MessagingError. Все остальные ошибки возвращаются без ошибок.
function translate(err: unknown): MessagingError | Error
Параметры
- err
-
unknown
Полученная ошибка amqp.
Возвращаемое значение
MessagingError | Error
Объект MessagingError.