模块 java.base
包 java.net

接口 CookieStore

public interface CookieStore
CookieStore 对象表示 cookie 的存储。可以存储和检索 cookie。

CookieManager 将调用 CookieStore.add 为每个传入的 HTTP 响应保存 cookie，并调用 CookieStore.get 为每个传出的 HTTP 请求检索 cookie。 CookieStore 负责删除已过期的 HttpCookie 实例。

自从：
1.6

  • 方法总结

    修饰符和类型
    方法
    描述
    void
    add(URI uri, HttpCookie cookie)
    向商店添加一个 HTTP cookie。
    List<HttpCookie>
    get(URI uri)
    检索与给定 URI 关联的 cookie，或者其域与给定 URI 匹配的 cookie。
    List<HttpCookie>
    getCookies()
    获取 cookie 存储中所有未过期的 cookie。
    List<URI>
    getURIs()
    获取标识此 cookie 存储中的 cookie 的所有 URI。
    boolean
    remove(URI uri, HttpCookie cookie)
    从商店中删除 cookie。
    boolean
    removeAll()
    删除此 cookie 存储中的所有 cookie。

  • 方法详情

    • add

      void add(URI  uri, HttpCookie  cookie)
      向商店添加一个 HTTP cookie。为每个传入的 HTTP 响应调用此方法。

      要存储的 cookie 可能与 URI 相关联，也可能不相关联。如果它没有与 URI 关联，则 cookie 的域和路径属性将指示它的来源。如果它与 URI 相关联并且未指定其域和路径属性，则给定的 URI 将指示此 cookie 来自何处。

      如果与给定 URI 对应的 cookie 已经存在，则将其替换为新的。

      参数：
      uri - 此 cookie 关联的 uri。如果是 null ，则此 cookie 将不会与 URI 相关联
      cookie - 要存储的 cookie
      抛出：
      NullPointerException - 如果 cookie 是 null
      参见：

    • get

      List <HttpCookie > get(URI  uri)
      检索与给定 URI 关联的 cookie，或者其域与给定 URI 匹配的 cookie。仅返回未过期的 cookie。每个传出 HTTP 请求都会调用此方法。
      参数：
      uri - 与要返回的 cookie 关联的 uri
      返回：
      HttpCookie 的不可变列表，如果没有 cookie 与给定的 URI 匹配，则返回空列表
      抛出：
      NullPointerException - 如果 uri 是 null
      参见：

    • getCookies

      List <HttpCookie > getCookies()
      获取 cookie 存储中所有未过期的 cookie。
      返回：
      不可变的 http cookie 列表；如果存储中没有 http cookie，则返回空列表

    • getURIs

      List <URI > getURIs()
      获取标识此 cookie 存储中的 cookie 的所有 URI。
      返回：
      一个不可变的 URI 列表；如果此 cookie 存储中没有 cookie 与 URI 关联，则返回空列表

    • remove

      boolean remove(URI  uri, HttpCookie  cookie)
      从商店中删除 cookie。
      参数：
      uri - 此 cookie 关联的 uri。如果为 null ，则要删除的 cookie 在添加时不与 URI 相关联；如果不是 null ，要删除的 cookie 在添加时与给定的 URI 相关联。
      cookie - 要删除的 cookie
      返回：
      true 如果该商店包含指定的 cookie
      抛出：
      NullPointerException - 如果 cookie 是 null

    • removeAll

      boolean removeAll()
      删除此 cookie 存储中的所有 cookie。
      返回：
      true 如果这家商店因通话而改变