IHttpClient Interface

public interface IHttpClient

Interface a implementar ao configurar um cliente HTTP personalizado para IPublicClientApplication ou IConfidentialClientApplication.

O MSAL Java utiliza HTTP para comunicar com a plataforma de identidades da Microsoft para autenticação e aquisição de tokens. Por defeito, a MSAL utiliza o HttpURLConnection do JDK, mas esta interface permite que as aplicações forneçam a sua própria implementação de cliente HTTP. Isto é útil quando:

  • As aplicações precisam de personalizar o comportamento da rede (por exemplo, configurar proxies, adicionar cabeçalhos personalizados)
  • As aplicações querem usar uma biblioteca cliente HTTP específica, como o Apache HttpClient ou o OkHttp
  • As aplicações precisam de se integrar com a infraestrutura de rede existente ou com sistemas de registo

Para obter mais detalhes, veja https://aka.ms/msal4j-http-client

Resumo do Método

Modificador e Tipo Método e Descrição
abstract IHttpResponse send(HttpRequest httpRequest)

Executa um pedido HTTP de saída usando a implementação do cliente HTTP escolhida.

Detalhes de Método

send

public abstract IHttpResponse send(HttpRequest httpRequest)

Executa um pedido HTTP de saída usando a implementação do cliente HTTP escolhida.

Este método deve tratar de todos os detalhes da realização do pedido HTTP e da adaptação da resposta à IHttpResponse interface. A implementação deve também incluir o tratamento adequado de erros para questões relacionadas com a rede.

Parâmetros:

httpRequest - Contém HttpRequest detalhes do pedido a executar, incluindo URL, cabeçalhos, método HTTP e corpo.

Devoluções:

Um objeto contendo IHttpResponse o código de estado, cabeçalhos e corpo da resposta.

Lançamentos:

java.lang.Exception - Exceções não recuperáveis que não podem ser tratadas pela implementação do cliente HTTP. Note que erros recuperáveis (por exemplo, códigos de estado HTTP retentáveis, problemas de rede transitórios) devem ser tratados pela própria implementação.

Aplica-se a