Biblioteca de clientes do Serviço Principal do Azure para JavaScript – versão 1.10.1

Essa biblioteca destina-se principalmente a ser usada no código gerado por e autorest.typescriptdo AutoRest.

Introdução

Ambientes com suporte no momento

• versões lts do Node.js
• Versões mais recentes do Safari, Chrome, Edge e Firefox.

Consulte nossa política de suporte para obter mais detalhes.

Instalação

Esse pacote é usado principalmente no código gerado e não deve ser consumido diretamente pelos usuários finais.

Principais conceitos

Cliente de serviço

Essa é a classe base comum para clientes gerados. Ele fornece os métodos sendOperationRequest e sendRequest.

sendRequest simplesmente faz uma solicitação HTTP usando um Pipeline (consulte @azure/core-rest-pipeline para obter detalhes.)

sendOperationRequest é usado pelo código gerado para fazer uma solicitação usando um OperationSpec e OperationArguments. Um OperationSpec é uma tradução dos requisitos de solicitação do arquivo OpenAPI/Swagger que descreve o serviço.

createClientPipeline

Esse método é usado para criar uma instância de Pipeline personalizada com políticas extras que executam serialização e desserialização. A maior parte do trabalho está na conversão de solicitações na mensagem HTTP certa que um serviço espera e, em seguida, convertendo o conteúdo da resposta HTTP na forma de resposta descrita pelo arquivo de especificação OpenAPI do serviço.

Mappers/createSerializer

Mappersão usados para codificar e decodificar dados em cabeçalhos e corpos HTTP. Eles descrevem todos os campos de solicitação e resposta. Eles são referenciados por OperationSpecs.

O método createSerializer cria um Serializer que é usado para fazer a maior parte do trabalho transformando dados ao fazer uma solicitação ou processar uma resposta. Dado um corpus de Mappers e o OperationSpec apropriado, ele pode fabricar um objeto de solicitação HTTP de uma entrada fornecida pelo usuário ou converter um objeto de resposta HTTP em um formulário amigável.

Próximas etapas

Você pode compilar e executar os testes localmente executando npm run test. Explore a pasta de teste de para ver o uso e o comportamento avançados das classes públicas.

Saiba mais sobre autoRest e a extensão autorest.typescript para gerar um cliente compatível com esse pacote.

Solucionando problemas

Se você tiver problemas ao usar essa biblioteca, fique à vontade para registrar um problema.

Contribuindo

Se você quiser contribuir com essa biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.