JavaScript용 Azure Core Service 클라이언트 라이브러리 - 버전 1.9.2

이 라이브러리는 주로 AutoRest 및 autorest.typescript에 의해 생성된 코드에서 사용하기 위한 것입니다.

시작

현재 지원되는 환경

• Node.js의 LTS 버전
• 최신 버전의 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 사양 파일에서 설명하는 응답 셰이프로 변환하는 것입니다.

Mappers / createSerializer

Mapper는 데이터를 HTTP 헤더 및 본문으로 인코딩하고 디코딩하는 데 사용됩니다. 모든 요청 및 응답 필드를 설명합니다. 이러한 항목은 OperationSpec으로 참조됩니다.

createSerializer 메서드는 요청을 하거나 응답을 처리할 때 데이터를 변환하는 작업의 대부분을 수행하는 데 사용되는 Serializer를 만듭니다. Mapper의 코퍼스와 적절한 OperationSpec의 경우 사용자가 제공한 입력에서 HTTP 요청 개체를 제조하거나 HTTP 응답 개체를 사용자에게 친숙한 형식으로 변환할 수 있습니다.

다음 단계

rushx test를 실행하여 로컬에서 테스트를 빌드하고 실행할 수 있습니다. 테스트 폴더를 탐색하여 공용 클래스의 고급 사용 및 동작을 확인합니다.

이 패키지 위에 호환되는 클라이언트를 생성하기 위한 AutoRest 및 autorest.typescript 확장에 대해 자세히 알아봅니다.

문제 해결

이 라이브러리를 사용하는 동안 문제가 발생하면 자유롭게 문제를 제기하세요.

참여

이 라이브러리에 기여하려면 기여 가이드 를 참조하여 코드를 빌드하고 테스트하는 방법에 대해 자세히 알아보세요.