Azure Core Service-Clientbibliothek für JavaScript – Version 1.9.2

Diese Bibliothek ist in erster Linie für Code gedacht, der von AutoRest und autorest.typescript generiert wird.

Erste Schritte

Die derzeitig unterstützten Umgebungen

• LTS-Versionen von Node.js
• Neueste Versionen von Safari, Chrome, Edge und Firefox.

Ausführlichere Informationen finden Sie in der Supportrichtlinie.

Installation

Dieses Paket wird in erster Linie in generiertem Code verwendet und ist nicht für die direkte Nutzung durch Endbenutzer gedacht.

Wichtige Begriffe

ServiceClient

Dies ist die allgemeine Basisklasse für generierte Clients. Sie stellt die Methoden sendOperationRequest und sendRequest bereit.

sendRequest stellt einfach eine HTTP-Anforderung unter Verwendung einer Pipeline (weitere Einzelheiten finden Sie unter @azure/core-rest-pipeline.)

sendOperationRequest wird vom generierten Code verwendet, um eine Anforderung mithilfe von OperationSpec und OperationArguments zu stellen. OperationSpec ist eine Übersetzung der Anforderungen aus der OpenAPI-/Swagger-Datei, die den Dienst beschreibt.

createClientPipeline

Diese Methode dient zum Erstellen einer Pipeline-Instanz, die mit zusätzlichen Richtlinien für die Serialisierung und Deserialisierung angepasst ist. Der Großteil der Arbeit besteht darin, Anforderungen in die richtige HTTP-Nachricht umzuwandeln, die ein Dienst erwartet, und dann die Nutzdaten der HTTP-Antwort in die Antwortform umzuwandeln, die in der OpenAPI-Spezifikationsdatei des Diensts beschrieben ist.

Mappers/createSerializer

Mappers werden zur Codierung und Decodierung von Daten in HTTP-Headern und -Rümpfen verwendet. Sie beschreiben alle Anforderungs- und Antwortfelder. Auf sie wird über Instanzen von OperationSpec verwiesen.

Die createSerializer-Methode erstellt einen Serializer, der den Großteil der Arbeit beim Transformieren von Daten bei der Erstellung einer Anforderung oder Verarbeitung einer Antwort übernimmt. Ausgehend von einem Korpus von Mappers und den entsprechenden OperationSpec kann er anhand einer Benutzereingabe ein HTTP-Anforderungsobjekt herstellen oder ein HTTP-Antwortobjekt in eine benutzerfreundliche Form umwandeln.

Nächste Schritte

Sie können die Tests lokal entwickeln und ausführen, indem Sie rushx test ausführen. Erkunden Sie den Testordner , um die erweiterte Nutzung und das Verhalten der öffentlichen Klassen zu sehen.

Erfahren Sie mehr über AutoRest und die autorest.typescript-Erweiterung zum Generieren eines kompatiblen Clients auf Grundlage dieses Pakets.

Problembehandlung

Wenn bei Nutzung dieser Bibliothek Probleme auftreten, können Sie uns gerne ein Problem melden.

Mitwirken

Wenn Sie an dieser Bibliothek mitwirken möchten, lesen Sie die Anleitung für Mitwirkende, um mehr darüber zu erfahren, wie Sie den Code erstellen und testen können.