Libreria client del servizio Azure Core per JavaScript - versione 1.9.3

Questa libreria è destinata principalmente all'uso nel codice generato da AutoRest e autorest.typescript.

Introduttiva

Ambienti attualmente supportati

• versioni LTS di Node.js
• Versioni più recenti di Safari, Chrome, Edge e Firefox.

Per altri dettagli, vedere i criteri di supporto .

Installazione

Questo pacchetto viene usato principalmente nel codice generato e non deve essere utilizzato direttamente dagli utenti finali.

Concetti chiave

ServiceClient

Si tratta della classe base comune per i client generati. Fornisce i metodi sendOperationRequest e sendRequest.

sendRequest semplicemente effettua una richiesta HTTP usando un Pipeline (vedere @azure/core-rest-pipeline per informazioni dettagliate).

sendOperationRequest viene usato dal codice generato per effettuare una richiesta usando un OperationSpec e OperationArguments. Un OperationSpec è una conversione dei requisiti di richiesta dal file OpenAPI/Swagger che descrive il servizio.

createClientPipeline

Questo metodo viene usato per creare un'istanza di Pipeline personalizzata con criteri aggiuntivi che eseguono la serializzazione e la deserializzazione. La maggior parte del lavoro consiste nella conversione delle richieste nel messaggio HTTP corretto che un servizio prevede e quindi converte il payload della risposta HTTP nella forma di risposta descritta dal file di specifica OpenAPI del servizio.

Mapper/createSerializer

Mappervengono usati per codificare e decodificare i dati in intestazioni e corpi HTTP. Descrivono tutti i campi di richiesta e risposta. Viene fatto riferimento da OperationSpecs.

Il metodo createSerializer crea un Serializer utilizzato per eseguire la maggior parte del lavoro che trasforma i dati durante l'esecuzione di una richiesta o l'elaborazione di una risposta. Dato un corpus di Mappers e il OperationSpec appropriato, può produrre un oggetto richiesta HTTP da un input fornito dall'utente o convertire un oggetto risposta HTTP in un modulo descrittivo.

Passaggi successivi

È possibile compilare ed eseguire i test in locale eseguendo rushx test. Esplorare la cartella test per visualizzare l'utilizzo e il comportamento avanzati delle classi pubbliche.

Altre informazioni su AutoRest e sull'estensione autorest.typescript per generare un client compatibile sopra questo pacchetto.

Risoluzione dei problemi

Se si verificano problemi durante l'uso di questa libreria, è possibile segnalare un problema.

Contribuire

Per contribuire a questa libreria, leggere la guida contribuire per altre informazioni su come compilare e testare il codice.