Client Plugin
Cookie
程式碼範例: client-cookies
Ktor 用戶端允許你透過以下方式手動處理 Cookie:
HttpCookies 外掛程式會自動處理 Cookie,並將其保存在儲存區中以便在各次呼叫之間保留。 預設情況下,它使用記憶體內儲存,但你也可以使用 CookiesStorage 實作持久化儲存。
新增相依性
HttpCookies 只需要 ktor-client-core 構件,不需要任何特定的相依性。
安裝與設定 HttpCookies
若要安裝 HttpCookies,請在用戶端設定區塊中將其傳遞給 install 函式:
kotlin
val client = HttpClient(CIO) {
install(HttpCookies)
}這樣就足以讓 Ktor 用戶端在各請求之間保留 Cookie。你可以在此處找到完整範例:client-cookies。
HttpCookies 外掛程式還允許你透過使用 ConstantCookiesStorage 為每個請求新增一組特定的 Cookie。這在驗證伺服器回應的測試案例中可能非常有用。以下範例展示如何為特定網域的所有請求新增指定的 Cookie:
kotlin
val client = HttpClient(CIO) {
install(HttpCookies) {
storage = ConstantCookiesStorage(Cookie(name = "user_name", value = "jetbrains", domain = "0.0.0.0"))
}
}取得 Cookie
用戶端提供了 cookies 函式以取得指定 URL 的所有 Cookie:
kotlin
client.cookies("http://0.0.0.0:8080/")自訂 Cookie 儲存
如有需要,你可以透過實作 CookiesStorage 介面來建立自訂的 Cookie 儲存:
kotlin
val client = HttpClient(CIO) {
install(HttpCookies) {
storage = CustomCookiesStorage()
}
}
public class CustomCookiesStorage : CookiesStorage {
// ...
}你可以參考 AcceptAllCookiesStorage 的實作方式。
