Azure Core Service-clientbibliotheek voor JavaScript - versie 1.9.2

Deze bibliotheek is voornamelijk bedoeld om te worden gebruikt in code die wordt gegenereerd door AutoRest en autorest.typescript.

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

Belangrijkste concepten

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 gebruikt door gegenereerde code 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 bestaat uit het converteren van aanvragen naar het juiste HTTP-bericht dat een service verwacht en vervolgens het converteren van de nettolading van het HTTP-antwoord naar de antwoordshape die wordt beschreven in het OpenAPI-specificatiebestand van de service.

Mappers/ createSerializer

Mappers worden gebruikt voor het coderen en decoderen van gegevens in HTTP-headers en -hoofdteksten. Ze beschrijven alle aanvraag- en antwoordvelden. Er wordt naar verwezen door OperationSpecs.

Met de methode createSerializer wordt een Serializer gemaakt die wordt gebruikt om het grootste deel van het werk te doen bij het transformeren van gegevens bij het indienen van een aanvraag of het verwerken van een antwoord. Op basis van een corpus van Mappers en de juiste OperationSpec kan het een HTTP-aanvraagobject maken van een door de gebruiker opgegeven invoer of een HTTP-antwoordobject converteren naar een gebruiksvriendelijke vorm.

Volgende stappen

U kunt de tests lokaal bouwen en uitvoeren door uit te rushx testvoeren. Verken de testmap 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.

Problemen oplossen

Als u problemen ondervindt tijdens het gebruik van deze bibliotheek, kunt u gerust een probleem melden.

Bijdragen

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.