IHttpClient Rozhraní

Balíček:
com.microsoft.aad.msal4j
Artefakt Mavenu:
com.microsoft.azure:msal4j:1.26.0

public interface IHttpClient

Rozhraní, které se má implementovat při konfiguraci vlastního klienta HTTP pro IPublicClientApplication nebo IConfidentialClientApplication.

MSAL Java používá protokol HTTP ke komunikaci s Microsoft identity platform pro získání ověřování a tokenu. MsAL ve výchozím nastavení používá httpURLConnection sady JDK, ale toto rozhraní umožňuje aplikacím poskytovat vlastní implementaci klienta HTTP. To je užitečné v těchto případech:

  • Aplikace musí přizpůsobit chování sítě (např. nakonfigurovat proxy servery, přidat vlastní hlavičky).
  • Aplikace chtějí použít konkrétní klientskou knihovnu HTTP, jako je Apache HttpClient nebo OkHttp.
  • Aplikace se musí integrovat se stávající síťovou infrastrukturou nebo systémy protokolování.

Další podrobnosti najdete v článku https://aka.ms/msal4j-http-client.

Souhrn metod

Modifikátor a typ Metoda a popis
abstract IHttpResponse send(HttpRequest httpRequest)

Spustí odchozí požadavek HTTP pomocí zvolené implementace klienta HTTP.

Podrobnosti metody

send

public abstract IHttpResponse send(HttpRequest httpRequest)

Spustí odchozí požadavek HTTP pomocí zvolené implementace klienta HTTP.

Tato metoda by měla zpracovat všechny podrobnosti o vytvoření požadavku HTTP a přizpůsobení odpovědi rozhraní IHttpResponse . Implementace by také měla zahrnovat vhodné zpracování chyb pro problémy související se sítí.

Parametry:

httpRequest - Obsahuje HttpRequest podrobnosti o požadavku, který se má provést, včetně adresy URL, hlaviček, metody HTTP a textu.

Návraty:

Objekt IHttpResponse obsahující stavový kód, hlavičky a text odpovědi.

Vyvolání výjimek:

java.lang.Exception - Neopravitelné výjimky, které nelze zpracovat implementací klienta HTTP. Mějte na paměti, že samotné implementace by měla zpracovávat obnovitelné chyby (např. opakovatelné stavové kódy HTTP, přechodné problémy se sítí).

Platí pro