IHttpClient 介面

public interface IHttpClient

介面在配置自訂 HTTP 用戶端IPublicClientApplicationIConfidentialClientApplication時實作。

MSAL Java 使用 HTTP 與 Microsoft 身分識別平台 進行認證與憑證取得。 預設情況下,MSAL 使用 JDK 的 HttpURLConnection,但此介面允許應用程式自行實作 HTTP 用戶端。 這在以下情況下非常有用:

  • 應用程式需要自訂網路行為(例如,設定代理、新增自訂標頭)
  • 應用程式希望使用特定的 HTTP 用戶端函式庫,例如 Apache HttpClient 或 OkHttp
  • 應用程式需要與現有的網路基礎設施或日誌系統整合

如需詳細資訊,請參閱 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 - 包含 HttpRequest 請求執行細節,包括 URL、標頭、HTTP 方法與主體。

傳回:

一個 IHttpResponse 包含狀態碼、標頭和回應內容的物件。

擲回:

java.lang.Exception - HTTP 用戶端實作無法處理的不可恢復異常。 請注意,可復原的錯誤(例如可重試的 HTTP 狀態碼、暫時性的網路問題)應由實作本身處理。

適用於