Azure Core Service-clientbibliotheek voor JavaScript - versie 1.9.3
Deze bibliotheek is voornamelijk bedoeld om te worden gebruikt in code die wordt gegenereerd door AutoRest- en autorest.typescript
.
Slag
Momenteel ondersteunde omgevingen
- LTS-versies van Node.js
- Nieuwste versies van Safari, Chrome, Edge en Firefox.
Zie ons ondersteuningsbeleid voor meer informatie.
Installatie
Dit pakket wordt voornamelijk gebruikt in gegenereerde code en is niet bedoeld om rechtstreeks door eindgebruikers te worden gebruikt.
Sleutelbegrippen
ServiceClient
Dit is de algemene basisklasse voor gegenereerde clients. Het biedt de methoden sendOperationRequest
en sendRequest
.
sendRequest
maakt gewoon een HTTP-aanvraag met behulp van een Pipeline
(zie @azure/core-rest-pipeline
voor meer informatie.)
sendOperationRequest
wordt door gegenereerde code gebruikt om een aanvraag te doen met behulp van een OperationSpec
en OperationArguments
. Een OperationSpec
is een vertaling van aanvraagvereisten uit het OpenAPI-/Swagger-bestand waarin de service wordt beschreven.
createClientPipeline
Deze methode wordt gebruikt om een Pipeline
exemplaar te maken dat is aangepast met extra beleidsregels die serialisatie en deserialisatie uitvoeren. Het grootste deel van het werk is het converteren van aanvragen naar het juiste HTTP-bericht dat een service verwacht en converteert vervolgens de nettolading van het HTTP-antwoord naar de antwoordshape die wordt beschreven door het OpenAPI-specificatiebestand van de service.
Mappers /createSerializer
Mapper
s worden gebruikt voor het coderen en decoderen van gegevens in HTTP-headers en -lichamen. Ze beschrijven alle aanvraag- en antwoordvelden. Er wordt naar verwezen door OperationSpec
s.
De methode createSerializer
maakt een Serializer
die wordt gebruikt om het grootste deel van het werk dat gegevens transformeert te doen bij het indienen van een aanvraag of het verwerken van een antwoord. Gezien een verzameling Mapper
en de juiste OperationSpec
kan het een HTTP-aanvraagobject van een door de gebruiker verstrekte invoer produceren of een HTTP-antwoordobject converteren naar een gebruiksvriendelijk formulier.
Volgende stappen
U kunt de tests lokaal bouwen en uitvoeren door rushx test
uit te voeren. Verken de map om geavanceerd gebruik en gedrag van de openbare klassen te bekijken.
Meer informatie over AutoRest en de extensie autorest.typescript voor het genereren van een compatibele client boven op dit pakket.
Probleemoplossing
Als u problemen ondervindt tijdens het gebruik van deze bibliotheek, kunt u gerust een probleem indienen.
Bijdragen
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.
Azure SDK for JavaScript