Azure Core AMQP-clientbibliotheek voor JavaScript - versie 4.3.0

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

Aan de 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.

Belangrijkste concepten

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

• Autorisatie op basis van claims
• Request-Response koppeling voor het verzenden van aanvragen 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 uit te rushx testvoeren. Verken de test map om geavanceerd gebruik en gedrag van de openbare klassen te bekijken.

Problemen oplossen

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:

• verbose
• Info
• waarschuwing
• fout

U kunt het logboekniveau ook programmatisch instellen door het pakket @azure/logger te importeren en de setLogLevel functie aan te roepen met een van de waarden op logboekniveau. Als 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 u zich wilt aanmelden.

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

U kunt ook de DEBUG omgevingsvariabele instellen om logboeken op te halen wanneer u deze bibliotheek gebruikt. Dit kan handig zijn als u ook logboeken van de afhankelijkheden rhea-promiserhea en wilt verzenden.

Opmerking: AZURE_LOG_LEVEL heeft, indien ingesteld, voorrang op FOUTOPSPORING. Geef geen azure bibliotheken op via FOUTOPSPORING wanneer u ook AZURE_LOG_LEVEL opgeeft of setLogLevel aanroept.

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

export DEBUG=azure:core-amqp:info

• Logboeken voor foutopsporing ophalen uit de bibliotheek 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 verbruiken), kunt u de DEBUG omgevingsvariabele 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 DEBUGomgevingsvariabele als volgt instellen:

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

Logboekregistratie bij een bestand

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

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

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

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

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

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

Bijdragen

Wij verwelkomen bijdragen en suggesties voor dit project. Voor de meeste bijdragen moet u instemmen met een licentieovereenkomst voor bijdragers (CLA: Contributor License Agreement) waarin u verklaart dat u gerechtigd bent ons het recht te geven uw bijdrage te gebruiken, en dat u dit ook doet. Ga naar https://cla.microsoft.com voor meer informatie.

Wanneer u een pull-aanvraag indient, wordt met een CLA-bot automatisch bepaald of u een CLA moet verschaffen en wordt de pull-aanvraag dienovereenkomstig opgemaakt (bijvoorbeeld met een label of commentaar). Volg gewoon de instructies van de bot. U hoeft dit maar eenmaal te doen voor alle repo's waar gebruik wordt gemaakt van onze CLA.

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

Op dit project is de Microsoft Open Source Code of Conduct (Microsoft Open Source-gedragscode) van toepassing. Zie de Veelgestelde vragen over de gedragscode voor meer informatie of neem contact op opencode@microsoft.com met eventuele aanvullende vragen of opmerkingen.