Condividi tramite


@azure/core-amqp package

Classi

CbsClient

Descrive il client Cbs EventHub/ServiceBus che comunica con l'endpoint $cbs tramite la connessione AMQP.

MessagingError

Descrive la classe di base per l'errore di messaggistica.

RequestResponseLink

Descrive un collegamento amqp request(sender)-response(receiver) creato in una sessione amqp.

Interfacce

AcquireLockProperties

Descrive le proprietà che devono essere fornite durante l'acquisizione di un blocco.

AmqpAnnotatedMessage

Descrive AmqpAnnotatedMessage, parte della proprietà ServiceBusReceivedMessage(come amqpAnnotatedMessage).

AmqpMessageHeader

Descrive il set definito di proprietà di intestazione standard del messaggio.

AmqpMessageProperties

Descrive il set definito di proprietà standard del messaggio.

CancellableAsyncLock

CancellableAsyncLock fornisce un meccanismo per forzare l'esecuzione seriale delle attività che usano la stessa 'chiave'.

Le attività in sospeso possono essere annullate manualmente tramite un oggetto abortSignal o annullate automaticamente dal raggiungimento di un valore di timeout specificato.

CbsResponse

Descrive la risposta CBS.

ConnectionConfig

Descrive l'oggetto config di connessione creato dopo l'analisi di una stringa di connessione EventHub o ServiceBus.

ConnectionConfigOptions

Vengono descritte le opzioni che è possibile specificare durante la creazione di una configurazione di connessione.

ConnectionContextBase

Fornisce informazioni contestuali come la connessione amqp sottostante, la sessione cbs, tokenProvider, la configurazione della connessione, il trasformatore di dati e così via.

ConnectionProperties

Definisce le proprietà che devono essere impostate durante la definizione della connessione AMQP.

CreateConnectionContextBaseParameters

Descrive i parametri che è possibile specificare per creare il contesto di connessione di base.

NetworkSystemError

Descrive i campi di un Node.js SystemError. Omette i campi non correlati alle chiamate di rete ,ad esempio le chiamate al file system. Vedere https://nodejs.org/dist/latest-v12.x/docs/api/errors.html#errors_class_systemerror

RetryConfig

Descrive i parametri che devono essere configurati per l'operazione di ripetizione dei tentativi.

RetryOptions

Opzioni dei criteri di ripetizione dei tentativi che determinano la modalità, il numero di tentativi, l'intervallo di ripetizione dei tentativi e così via.

SendRequestOptions

Descrive le opzioni che è possibile specificare durante l'invio di una richiesta.

WebSocketOptions

Opzioni per configurare il canale della connessione AMQP tramite Web Socket.

Alias tipo

ParsedOutput

Definisce un oggetto con le possibili proprietà definite in T.

Enumerazioni

ConditionErrorNameMapper

Esegue il mapping delle condizioni di errore amqp ai nomi degli errori.

ErrorNameConditionMapper

Esegue il mapping dei nomi degli errori alle condizioni di errore amqp.

RetryMode

Descrive il tipo di modalità di ripetizione dei tentativi

RetryOperationType

Descrive il tipo di operazione di ripetizione dei tentativi.

SystemErrorConditionMapper

Esegue il mapping di alcuni errori SystemErrors a condizioni di errore amqp

TokenType

Descrive il tipo di token supportati.

Funzioni

delay<T>(number, AbortSignalLike, string, T)

Wrapper per setTimeout che risolve una promessa dopo t millisecondi.

isMessagingError(MessagingError | Error)

Determina se un errore è un errore MessagingError.

isSystemError(unknown)

Controlla se l'errore specificato è un node.js SystemError.

parseConnectionString<T>(string)

Analizza la stringa di connessione e restituisce un oggetto di tipo T.

Le stringhe di connessione hanno la sintassi seguente:

ConnectionString ::= Part { ";" Part } [ ";" ] [ WhiteSpace ] Parte ::= [ PartLiteral [ "=" PartLiteral ] ] PartLiteral ::= [ WhiteSpace ] Letterale [ WhiteSpace ] Letterale ::= ? qualsiasi sequenza di caratteri tranne ; o = o spazi vuoti ? Spazio bianco ::= ? tutti gli spazi vuoti, inclusi \r e \n ?

retry<T>(RetryConfig<T>)

Ogni operazione viene tentata almeno una volta. Vengono eseguiti altri tentativi se il tentativo precedente non è riuscito con un errore riprovabile. Il numero di tentativi aggiuntivi è disciplinato dalla proprietà maxRetries fornita nell'argomento RetryConfig.

Se mode opzione è impostata su Fixed, i tentativi vengono eseguiti nell'operazione specificata per un numero specificato di volte, con un ritardo fisso tra ogni tentativo ogni volta.

Se mode opzione è impostata su Exponential, il ritardo tra i tentativi viene modificato in modo da aumentare in modo esponenziale ogni tentativo usando il fattore di back-off della potenza 2.

translate(unknown)

Converte l'errore AMQP ricevuto a livello di protocollo o SystemError in un MessagingError. Tutti gli altri errori vengono restituiti invariati.

Dettagli funzione

delay<T>(number, AbortSignalLike, string, T)

Wrapper per setTimeout che risolve una promessa dopo t millisecondi.

function delay<T>(delayInMs: number, abortSignal?: AbortSignalLike, abortErrorMsg?: string, value?: T): Promise<T | void>

Parametri

delayInMs

number

Numero di millisecondi da ritardare.

abortSignal
AbortSignalLike

AbortSignal associato all'operazione contenitore.

abortErrorMsg

string

Messaggio di errore di interruzione associato all'operazione contenitore.

value

T

Valore da risolvere con dopo un timeout di t millisecondi.

Restituisce

Promise<T | void>

  • Promessa risolta

isMessagingError(MessagingError | Error)

Determina se un errore è un errore MessagingError.

function isMessagingError(error: MessagingError | Error): error

Parametri

error

MessagingError | Error

Errore che può essere un errore o un errore di MessagingError.

Restituisce

error

isSystemError(unknown)

Controlla se l'errore specificato è un node.js SystemError.

function isSystemError(err: unknown): err

Parametri

err

unknown

Oggetto che può contenere informazioni sull'errore.

Restituisce

err

parseConnectionString<T>(string)

Analizza la stringa di connessione e restituisce un oggetto di tipo T.

Le stringhe di connessione hanno la sintassi seguente:

ConnectionString ::= Part { ";" Part } [ ";" ] [ WhiteSpace ] Parte ::= [ PartLiteral [ "=" PartLiteral ] ] PartLiteral ::= [ WhiteSpace ] Letterale [ WhiteSpace ] Letterale ::= ? qualsiasi sequenza di caratteri tranne ; o = o spazi vuoti ? Spazio bianco ::= ? tutti gli spazi vuoti, inclusi \r e \n ?

function parseConnectionString<T>(connectionString: string): ParsedOutput<T>

Parametri

connectionString

string

Stringa di connessione da analizzare.

Restituisce

ParsedOutput<T>.

retry<T>(RetryConfig<T>)

Ogni operazione viene tentata almeno una volta. Vengono eseguiti altri tentativi se il tentativo precedente non è riuscito con un errore riprovabile. Il numero di tentativi aggiuntivi è disciplinato dalla proprietà maxRetries fornita nell'argomento RetryConfig.

Se mode opzione è impostata su Fixed, i tentativi vengono eseguiti nell'operazione specificata per un numero specificato di volte, con un ritardo fisso tra ogni tentativo ogni volta.

Se mode opzione è impostata su Exponential, il ritardo tra i tentativi viene modificato in modo da aumentare in modo esponenziale ogni tentativo usando il fattore di back-off della potenza 2.

function retry<T>(config: RetryConfig<T>): Promise<T>

Parametri

config

RetryConfig<T>

Parametri per configurare l'operazione di ripetizione dei tentativi

Restituisce

Promise<T>

Promessa<T>.

translate(unknown)

Converte l'errore AMQP ricevuto a livello di protocollo o SystemError in un MessagingError. Tutti gli altri errori vengono restituiti invariati.

function translate(err: unknown): MessagingError | Error

Parametri

err

unknown

Errore amqp ricevuto.

Restituisce

MessagingError | Error

Oggetto MessagingError.