Libreria client del servizio Core di Azure per JavaScript - versione 1.9.2
Questa libreria viene in genere usata nel codice generato da AutoRest e autorest.typescript
.
Introduzione
Ambienti attualmente supportati
- Versioni LTS di Node.js
- Ultime versioni di Safari, Chrome, Edge e Firefox.
Per altre informazioni, vedere i criteri di supporto.
Installazione
Questo pacchetto viene in genere usato nel codice generato e non è destinato a essere utilizzato direttamente dagli utenti finali.
Concetti chiave
ServiceClient
Si tratta della classe di base comune per i client generati. Fornisce i metodi sendOperationRequest
e sendRequest
.
sendRequest
invia semplicemente una richiesta HTTP usando Pipeline
. Per informazioni dettagliate, vedere @azure/core-rest-pipeline
.
sendOperationRequest
viene usato dal codice generato per inviare una richiesta usando OperationSpec
e OperationArguments
. OperationSpec
è una traduzione dei requisiti della 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 nel convertire le richieste nel messaggio HTTP corretto previsto da un servizio e quindi nel convertire il payload della risposta HTTP nella forma di risposta descritta dal file della specifica OpenAPI del servizio.
Mapper/createSerializer
Gli oggetti Mapper
vengono usati per codificare e decodificare i dati in intestazioni e corpi HTTP. Descrivono tutti i campi della richiesta e della risposta. Vi fanno riferimento gli oggetti OperationSpec
.
Il metodo createSerializer
crea un oggetto Serializer
usato per eseguire la maggior parte del lavoro di trasformazione dei dati quando si invia una richiesta o si elabora una risposta. Con un corpus di Mapper
e l'oggetto OperationSpec
appropriato, può produrre un oggetto richiesta HTTP da un input fornito dall'utente o convertire un oggetto risposta HTTP in un modulo intuitivo.
Passaggi successivi
È possibile compilare ed eseguire i test in locale eseguendo rushx test
. Esplorare la cartella di test per visualizzare l'utilizzo e il comportamento avanzati delle classi pubbliche.
Per generare un client compatibile sulla base di questo pacchetto, vedere le informazioni relative ad AutoRest e all'estensione autorest.typescript.
Risoluzione dei problemi
Se si verificano problemi durante l'uso di questa libreria, è possibile segnalare un problema.
Contributo
Per contribuire a questa libreria, leggere la guida ai contributi per altre informazioni su come compilare e testare il codice.
Azure SDK for JavaScript