IHttpClient インターフェイス

public interface IHttpClient

IPublicClientApplicationまたはIConfidentialClientApplication用にカスタム HTTP クライアントを構成するときに実装するインターフェイス。

MSAL Javaは、認証とトークンの取得のために HTTP を使用してMicrosoft ID プラットフォームと通信します。 既定では、MSAL は JDK の HttpURLConnection を使用しますが、このインターフェイスにより、アプリケーションは独自の HTTP クライアント実装を提供できます。 これは、次の場合に役立ちます。

  • アプリケーションでは、ネットワーク動作をカスタマイズする必要があります (プロキシの構成、カスタム ヘッダーの追加など)
  • アプリケーションでは、Apache HttpClient や OkHttp などの特定の HTTP クライアント ライブラリを使用する必要があります
  • アプリケーションを既存のネットワーク インフラストラクチャまたはログ システムと統合する必要がある

詳細については、https://aka.ms/msal4j-http-client をご覧ください

メソッドの概要

修飾子と型 メソッドと説明
abstract IHttpResponse send(HttpRequest httpRequest)

選択した HTTP クライアント実装を使用して、送信 HTTP 要求を実行します。

メソッドの詳細

send

public abstract IHttpResponse send(HttpRequest httpRequest)

選択した HTTP クライアント実装を使用して、送信 HTTP 要求を実行します。

このメソッドは、HTTP 要求を行い、応答を IHttpResponse インターフェイスに適応させるすべての詳細を処理する必要があります。 実装には、ネットワーク関連の問題に対する適切なエラー処理も含める必要があります。

パラメーター:

httpRequest - URL、ヘッダー、HTTP メソッド、本文など、実行する要求の詳細を含む HttpRequest 。

返品:

応答の状態コード、ヘッダー、および本文を含む IHttpResponse オブジェクト。

スロー:

java.lang.Exception - HTTP クライアントの実装では処理できない回復不可能な例外。 回復可能なエラー (再試行可能な HTTP 状態コード、一時的なネットワークの問題など) は、実装自体で処理する必要があることに注意してください。

適用対象