Class CookieStore

java.lang.Object
com.sure.tool.http.CookieStore

public class CookieStore extends Object
会话级 Cookie 管理器(零第三方依赖,基于 JDK HttpCookie)。

与 HttpRequest.cookieStore(CookieStore) 配合实现登录态保持: 请求自动携带已收集的 Cookie,响应中的 Set-Cookie 自动入库。

Since:
1.1.0
Author:
suretool
  • Constructor Details

    • CookieStore

      public CookieStore()
  • Method Details

    • add

      public CookieStore add(String host, String setCookieHeader)
      解析并保存一个 Set-Cookie 响应头(支持逗号分隔多 cookie 的常见形式)。
      Parameters:
      host - 目标主机(如 example.com)
      setCookieHeader - Set-Cookie 头原文
      Returns:
      本 store
    • add

      public CookieStore add(String host, HttpCookie cookie)
      直接添加一个 Cookie。
      Parameters:
      host - 目标主机
      cookie - Cookie 对象
      Returns:
      本 store
    • header

      public String header(String host)
      构建指定主机的 Cookie 请求头(自动剔除已过期项),无可用 Cookie 时返回 null。
      Parameters:
      host - 目标主机
      Returns:
      Cookie 头原文或 null
    • collect

      public CookieStore collect(String url, Map<String, List<String>> headerValues)
      收集响应中的 Set-Cookie 头。
      Parameters:
      url - 请求 URL(用于提取主机)
      headerValues - 响应头映射(key → 值列表)
      Returns:
      本 store
    • clear

      public void clear()
      清空全部 Cookie。
    • isEmpty

      public boolean isEmpty()
      是否为空。
      Returns:
      true 表示无任何 Cookie