CookieManager

public class CookieManager
extends CookieHandler

CookieManager提供了一个具体的实现CookieHandler ，它将cookie的存储从接受和拒绝cookie的策略中分离出来。 那么CookieManager初始化为CookieStore ，其管理存储和CookiePolicy对象，这使得上的cookie接受/拒绝决策。

java.net包中的HTTP cookie管理如下所示：

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

• CookieHandler is at the core of cookie management. User can call CookieHandler.setDefault to set a concrete CookieHanlder implementation to be used.
• CookiePolicy.shouldAccept will be called by CookieManager.put to see whether or not one cookie should be accepted and put into cookie store. User can use any of three pre-defined CookiePolicy, namely ACCEPT_ALL, ACCEPT_NONE and ACCEPT_ORIGINAL_SERVER, or user can define his own CookiePolicy implementation and tell CookieManager to use it.
• CookieStore is the place where any accepted HTTP cookie is stored in. If not specified when created, a CookieManager instance will use an internal in-memory implementation. Or user can implements one and tell CookieManager to use it.
• Currently, only CookieStore.add(URI, HttpCookie) and CookieStore.get(URI) are used by CookieManager. Others are for completeness and might be needed by a more sophisticated CookieStore implementation, e.g. a NetscapeCookieSotre.

用户可以通过多种方式来连接他自己的HTTP cookie管理行为，例如

• Use CookieHandler.setDefault to set a brand new CookieHandler implementation
• Let CookieManager be the default CookieHandler implementation, but implement user's own CookieStore and CookiePolicy and tell default CookieManager to use them:

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

• Let CookieManager be the default CookieHandler implementation, but use customized CookiePolicy:

         // 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());
       

该实现符合 RFC 2965 ，第3.3节。

Summary

Inherited methods
From class java.net.CookieHandler abstract Map<String, List<String>> get(URI uri, Map<String, List<String>> requestHeaders) 从请求标头中指定的URI获取cookie缓存中的所有适用cookie。 static CookieHandler getDefault() 获取系统范围的Cookie处理程序。 abstract void put(URI uri, Map<String, List<String>> responseHeaders) 设置所有适用的cookie，例如响应头中的响应头字段（名为Set-Cookie2），并显示在cookie缓存中。 static void setDefault(CookieHandler cHandler) 设置（或取消设置）系统范围的Cookie处理程序。
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或 notifyAll()方法，或其他某个线程中断当前线程或经过一定的实时时间。 final void wait(long millis) 使当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() ，或经过指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的方法 notify()或方法 notifyAll() 。

Public constructors

CookieManager ()

CookieManager (CookieStore store, 
                CookiePolicy cookiePolicy)

Public methods

Map<String, List<String>> get (URI uri, 
                Map<String, List<String>> requestHeaders)

CookieStore getCookieStore ()

void put (URI uri, 
                Map<String, List<String>> responseHeaders)

void setCookiePolicy (CookiePolicy cookiePolicy)