CookieManager 类

定义

[Android.Runtime.Register("java/net/CookieManager", DoNotGenerateAcw=true)]
public class CookieManager : Java.Net.CookieHandler

[<Android.Runtime.Register("java/net/CookieManager", DoNotGenerateAcw=true)>]
type CookieManager = class
    inherit CookieHandler

继承

Object

Object

CookieHandler

CookieManager

属性

RegisterAttribute

注解

CookieManager 提供了具体实现 CookieHandler，它将 Cookie 的存储与接受和拒绝 Cookie 的策略分开。 CookieManager 使用 CookieStore 管理存储的对象进行 CookiePolicy 初始化，该对象针对 Cookie 接受/拒绝做出策略决策。

java.net 包中的 HTTP Cookie 管理如下所示： <blockquote>

{@code
                             use
            CookieHandler <------- HttpURLConnection
                  ^
                  | impl
                  |         use
            CookieManager -------> CookiePolicy
                        |   use
                        |--------> HttpCookie
                        |              ^
                        |              | use
                        |   use        |
                        |--------> CookieStore
                                       ^
                                       | impl
                                       |
                             Internal in-memory implementation
            }

<ul><li> CookieHandler 是 Cookie 管理的核心。 用户可以调用 CookieHandler.setDefault 来设置要使用的具体 CookieHanlder 实现。 </li li><> CookiePolicy.shouldAccept 将由 CookieManager.put 调用，以查看是否应接受并放入 Cookie 存储中。 用户可以使用三个预定义的 CookiePolicy 中的任何一个，即ACCEPT_ALL、ACCEPT_NONE和ACCEPT_ORIGINAL_SERVER，或者用户可以定义自己的 CookiePolicy 实现并告知 CookieManager 使用它。 </li><> CookieStore 是存储任何接受的 HTTP Cookie 的位置。 如果未在创建时指定，CookieManager 实例将使用内部内存中实现。 或者，用户可以实现一个并告知 CookieManager 使用它。 </li li><> 目前，CookieManager 仅使用 CookieStore.add（URI、HttpCookie）和 CookieStore.get（URI）。 其他方案是为了完整性，可能需要更复杂的 CookieStore 实现，例如 NetscapeCookieStore。 </li></ul></blockquote>

用户可以通过多种方式挂钩自己的 HTTP Cookie 管理行为，例如 <blockquote><ul><li>Use CookieHandler.setDefault，将全新的 CookieHandler 实现 <li>Let CookieManager 设置为默认 CookieHandler 实现，但实现用户自己的 CookieStore 并 CookiePolicy 告知默认 CookieManager 使用它们： <blockquote>

// this should be done at the beginning of an HTTP session
                  CookieHandler.setDefault(new CookieManager(new MyCookieStore(), new MyCookiePolicy()));

</blockquote><li>Let CookieManager 是默认 CookieHandler 实现，但使用自定义 CookiePolicy： <blockquote>

// this should be done at the beginning of an HTTP session
                  CookieHandler.setDefault(new CookieManager());
                  // this can be done at any point of an HTTP session
                  ((CookieManager)CookieHandler.getDefault()).setCookiePolicy(new MyCookiePolicy());

</blockquote/ul></blockquote><>

实现符合 RFC 2965 第 3.3 节。

已在 1.6 中添加。

Java文档java.net.CookieManager。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。