Bagikan melalui


Pustaka klien Azure Core Service untuk JavaScript - versi 1.10.1

Pustaka ini terutama dimaksudkan untuk digunakan dalam kode yang dihasilkan oleh AutoRest dan autorest.typescript.

Persiapan

Lingkungan yang saat ini didukung

Lihat kebijakan dukungan kami untuk detail selengkapnya.

Instalasi

Paket ini terutama digunakan dalam kode yang dihasilkan dan tidak dimaksudkan untuk digunakan langsung oleh pengguna akhir.

Konsep utama

Layanan Klien

Ini adalah kelas dasar umum untuk klien yang dihasilkan. Ini menyediakan metode sendOperationRequest dan sendRequest.

sendRequest hanya membuat permintaan HTTP menggunakan Pipeline (lihat @azure/core-rest-pipeline untuk detailnya.)

sendOperationRequest digunakan oleh kode yang dihasilkan untuk membuat permintaan menggunakan OperationSpec dan OperationArguments. OperationSpec adalah terjemahan persyaratan permintaan dari file OpenAPI/Swagger yang menjelaskan layanan.

createClientPipeline

Metode ini digunakan untuk membuat instans Pipeline yang disesuaikan dengan kebijakan tambahan yang melakukan serialisasi dan deserialisasi. Sebagian besar pekerjaan dalam mengonversi permintaan menjadi pesan HTTP yang tepat yang diharapkan layanan dan kemudian mengonversi payload respons HTTP menjadi bentuk respons yang dijelaskan oleh file spesifikasi OpenAPI layanan.

Mapper / createSerializer

Mapperdigunakan untuk mengodekan dan mendekode data ke header dan badan HTTP. Mereka menjelaskan semua bidang permintaan dan respons. Mereka dirujuk oleh OperationSpec.

Metode createSerializer membuat Serializer yang digunakan untuk melakukan sebagian besar data transformasi pekerjaan saat membuat permintaan atau memproses respons. Mengingat korpus Mapperdan OperationSpec yang sesuai dapat memproduksi objek permintaan HTTP dari input yang disediakan pengguna atau mengonversi objek respons HTTP menjadi bentuk yang mudah digunakan.

Langkah berikutnya

Anda dapat membangun dan menjalankan pengujian secara lokal dengan menjalankan npm run test. Jelajahi folder pengujian untuk melihat penggunaan dan perilaku tingkat lanjut dari kelas publik.

Pelajari selengkapnya tentang autorest dan ekstensi autorest.typescript untuk menghasilkan klien yang kompatibel di atas paket ini.

Pemecahan masalah

Jika Anda mengalami masalah saat menggunakan pustaka ini, jangan ragu untuk mengajukan masalah.

Berkontribusi

Jika Anda ingin berkontribusi pada pustaka ini, baca panduan berkontribusi untuk mempelajari selengkapnya tentang cara membuat dan menguji kode.