Azure Core Service JavaScript-ügyféloldali kódtár – 1.10.1-es verzió

Ez a kódtár elsősorban AutoRest és autorest.typescriptáltal létrehozott kódban használható.

Kezdetekhez

Jelenleg támogatott környezetek

• Node.js LTS-verziói
• A Safari, a Chrome, az Edge és a Firefox legújabb verziói.

További részletekért tekintse meg a támogatási szabályzat.

Telepítés

Ezt a csomagot elsősorban generált kódban használják, és nem közvetlenül a végfelhasználóknak szánták.

Főbb fogalmak

ServiceClient

Ez a generált ügyfelek közös alaposztálya. Ez biztosítja a metódusokat sendOperationRequest és sendRequest.

sendRequest egyszerűen http-kérést küld egy Pipeline használatával (részletekért lásd @azure/core-rest-pipeline.)

sendOperationRequest generált kód egy OperationSpec és OperationArgumentshasználatával történő kéréshez használja. A OperationSpec a szolgáltatás leírását tartalmazó OpenAPI/Swagger-fájlból származó kérési követelmények fordítása.

createClientPipeline

Ez a módszer egy olyan Pipeline-példány létrehozásához használható, amely szerializálást és deszerializálást végző további szabályzatokkal van testre szabva. A munka nagy része a kérések megfelelő HTTP-üzenetté alakítása, amelyet a szolgáltatás elvár, majd a HTTP-válasz hasznos adatainak átalakítása a szolgáltatás OpenAPI-specifikációs fájljában leírt válaszalakzattá.

Leképezők / createSerializer

Mapperaz adatok HTTP-fejlécekbe és -testekbe való kódolására és dekódolására szolgálnak. Az összes kérelem- és válaszmezőt ismertetik. Ezekre OperationSpecs hivatkozik.

A createSerializer metódus létrehoz egy Serializer, amely a kérelem vagy a válasz feldolgozása során az adatokat átalakító munka nagy részének elvégzésére szolgál. Mivel a korpusz Mappers és a megfelelő OperationSpec képes létrehozni egy HTTP-kérés objektumot a felhasználó által megadott bemenet, vagy átalakítani egy HTTP válaszobjektum egy felhasználóbarát űrlapot.

Következő lépések

A teszteket helyileg hozhatja létre és futtathatja a npm run testvégrehajtásával. A nyilvános osztályok speciális használatának és viselkedésének megtekintéséhez tekintse meg a teszt mappát.

További információ a AutoRest és az autorest.typescript bővítményről, amely kompatibilis ügyfelet hoz létre a csomag tetején.

Hibaelhárítás

Ha a kódtár használata során problémákba ütközik, nyugodtan a problémát.

Hozzájárulás

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót, amelyből többet is megtudhat a kód összeállításáról és teszteléséről.