適用於 JavaScript 的 Azure Core 服務用戶端連結庫 - 1.9.2 版
此程式庫主要用於 AutoRest (英文) 和 autorest.typescript
(英文) 所產生的程式碼中。
開始使用
目前支援的環境
- LTS 版本的 Node.js
- Safari、Chrome、Edge 和 Firefox 的最新版本。
如需詳細資訊,請參閱我們的支援原則。
安裝
此套件主要用於已產生的程式碼中,並不提供終端使用者直接取用。
重要概念
ServiceClient
這是已產生的用戶端的通用基礎類別。 它提供方法 sendOperationRequest
和 sendRequest
。
sendRequest
單純使用 Pipeline
來提出 HTTP 要求 (參閱 @azure/core-rest-pipeline
以瞭解詳細資料。)
sendOperationRequest
可供已產生的程式碼利用 OperationSpec
和 OperationArguments
來提出要求。 OperationSpec
可轉譯來自描述服務的 OpenAPI/Swagger 檔案的要求需求。
createClientPipeline
此方法可用於建立透過其他政策自訂的 Pipeline
執行個體,可執行序列化和還原序列化。 主要工作是將要求轉換成服務所預期的正確 HTTP 訊息,然後將 HTTP 回應承載轉換成服務的 OpenAPI 規格檔案所描述的回應圖形。
對應程式 / 建立序列化程式
Mapper
用於將資料編碼和解碼為 HTTP 標題和內文。 它們會描述所有要求和回應欄位。 它們可作為 OperationSpec
的參照。
方法 createSerializer
會建立 Serializer
,以在提出要求或處理回應時,利用它來執行大部分的資料轉換。 有了 Mapper
的主體和適當的 OperationSpec
,它便可從使用者提供的輸入製造 HTTP 要求的物件,或者將 HTTP 回應物件轉換成方便使用的表單。
後續步驟
您可執行 rushx test
以在本機組建和執行測試。 探索 測試 資料夾,以查看公用類別的進階使用方式和行為。
深入瞭解 AutoRest 和 autorest.typescript 擴充功能,以在此套件之上產生相容的用戶端。
疑難排解
如果您在使用此程式庫時遇到問題,可隨時提出問題。
參與
如果您希望向此程式庫投稿,請參閱投稿指南,深入瞭解如何組建與測試程式碼。