Azure Core AMQP-clientbibliotheek voor JavaScript - versie 4.3.3

Het @azure/core-amqp-pakket biedt algemene functionaliteit voor Azure JavaScript-bibliotheken die gebruikmaken van het AMQP-protocol, zoals de bibliotheken voor Azure Service Bus en Azure Event Hubs.

Slag

Installatie

Installeer deze bibliotheek als volgt met npm:

npm install @azure/core-amqp

Momenteel ondersteunde omgevingen

• LTS-versies van Node.js
• Nieuwste versies van Safari, Chrome, Edge en Firefox.

Zie ons ondersteuningsbeleid voor meer informatie.

Sleutelbegrippen

Enkele van de belangrijkste functies van de Azure Core AMQP-bibliotheek zijn:

• op claims gebaseerde autorisatie-
• Request-Response koppeling voor het verzenden van aanvraag en het ontvangen van antwoorden via AMQP-
• Foutomzetting van AMQP-foutcodes, samen met fouten die specifiek zijn voor Azure Service Bus en Azure Event Hubs.
• RetryPolicy voor het opnieuw proberen van een bepaalde bewerking als er een fout is opgetreden die opnieuw kan worden geprobeerd.

Volgende stappen

U kunt de tests lokaal bouwen en uitvoeren door rushx testuit te voeren. Verken de map test om geavanceerd gebruik en gedrag van de openbare klassen te bekijken.

Probleemoplossing

De core-amqp-bibliotheek is afhankelijk van de rhea-promise-bibliotheek voor het beheren van verbindingen en voor het verzenden en ontvangen van gebeurtenissen via het AMQP--protocol.

Logboekregistratie

U kunt de omgevingsvariabele AZURE_LOG_LEVEL instellen op een van de volgende waarden om logboekregistratie in te schakelen voor stderr:

• breedsprakig
• info
• waarschuwing
• fout

U kunt het logboekniveau ook programmatisch instellen door het @azure/logger--pakket te importeren en de functie setLogLevel aan te roepen met een van de waarden op logboekniveau. Wanneer u bijvoorbeeld het logboekniveau instelt op info, worden de logboeken die zijn geschreven voor niveaus warning en error ook verzonden. Deze SDK volgt de Azure SDK voor TypeScript richtlijnen bij het bepalen van het niveau waarop moet worden aangemeld.

Wanneer u een logboekniveau via een programma of via de omgevingsvariabele AZURE_LOG_LEVEL instelt, worden alle logboeken die zijn geschreven met een logboekniveau dat gelijk is aan of kleiner is dan het logboekniveau dat u kiest, verzonden.

U kunt ook de omgevingsvariabele DEBUG instellen om logboeken op te halen bij het gebruik van deze bibliotheek. Dit kan handig zijn als u ook logboeken wilt verzenden vanuit de afhankelijkheden rhea-promise en rhea.

Opmerking: AZURE_LOG_LEVEL, indien ingesteld, heeft voorrang op DEBUG. Geef geen azure bibliotheken op via DEBUG bij het opgeven van AZURE_LOG_LEVEL of het aanroepen van setLogLevel.

• Alleen foutopsporingslogboeken op informatieniveau ophalen uit de core-amqp-bibliotheek.

export DEBUG=azure:core-amqp:info

• Foutopsporingslogboeken ophalen uit de core-amqp en de bibliotheek op protocolniveau.

export DEBUG=azure:core-amqp:*,rhea*

• Als u niet geïnteresseerd bent in het weergeven van de onbewerkte gebeurtenisgegevens (die een grote hoeveelheid console/schijfruimte verbruikt), kunt u de omgevingsvariabele DEBUG als volgt instellen:

export DEBUG=azure:core-amqp:*,rhea*,-rhea:raw,-rhea:message

• Als u alleen geïnteresseerd bent in fouten en SDK waarschuwingen, kunt u de DEBUG omgevingsvariabele als volgt instellen:

export DEBUG=azure:core-amqp:(error|warning),rhea-promise:error,rhea:events,rhea:frames,rhea:io,rhea:flow

Logboekregistratie naar een bestand

• Stel de omgevingsvariabele DEBUG in zoals hierboven wordt weergegeven en voer het testscript als volgt uit:
  • Logboekregistratie-instructies van u testscript gaan naar out.log en logboekregistratie-instructie van de SDK gaan naar debug.log.

    node your-test-script.js > out.log 2>debug.log
    

  • Logboekregistratie-instructies van uw testscript en de SDK gaan naar hetzelfde bestand out.log door stderr om te leiden naar stdout (&1) en leiden vervolgens stdout om naar een bestand:

    node your-test-script.js >out.log 2>&1
    

  • Logboekregistratie-instructies van uw testscript en de SDK gaan naar hetzelfde bestand out.log.

    node your-test-script.js &> out.log
    

Bijdragen

Dit project verwelkomt bijdragen en suggesties. Voor de meeste bijdragen moet u akkoord gaan met een Licentieovereenkomst voor inzenders (CLA) waarin wordt aangegeven dat u het recht hebt om, en daadwerkelijk, ons de rechten te verlenen om uw bijdrage te gebruiken. Zie https://cla.microsoft.com voor meer informatie.

Wanneer u een pull-aanvraag indient, bepaalt een CLA-bot automatisch of u een CLA moet opgeven en de pull-aanvraag op de juiste wijze moet inrichten (bijvoorbeeld label, opmerking). Volg gewoon de instructies van de bot. U hoeft dit slechts eenmaal te doen voor alle opslagplaatsen met behulp van onze CLA.

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de gids voor bijdragen voor meer informatie over het bouwen en testen van de code.

Dit project heeft de Microsoft Open Source-gedragscodeaangenomen. Zie de Veelgestelde vragen over gedragscodes voor meer informatie of neem contact op met opencode@microsoft.com met eventuele aanvullende vragen of opmerkingen.