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
IHttp |
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 狀態碼、暫時性的網路問題)應由實作本身處理。