- java.lang.Object
- 
- java.net.CookieHandler
- 
- java.net.CookieManager
 
 
- 
 public class CookieManager extends CookieHandler CookieManager provides a concrete implementation ofCookieHandler, which separates the storage of cookies from the policy surrounding accepting and rejecting cookies. A CookieManager is initialized with aCookieStorewhich manages storage, and aCookiePolicyobject, which makes policy decisions on cookie acceptance/rejection.The HTTP cookie management in java.net package looks like: 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 NetscapeCookieStore.
 There're various ways user can hook up his own HTTP cookie management behavior, e.g. - Use CookieHandler.setDefault to set a brand new CookieHandlerimplementation
- Let CookieManager be the default CookieHandlerimplementation, but implement user's ownCookieStoreandCookiePolicyand 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 CookieHandlerimplementation, but use customizedCookiePolicy:// 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());
 The implementation conforms to RFC 2965, section 3.3. - Since:
- 1.6
- See Also:
- CookiePolicy
 
- 
- 
Constructor SummaryConstructors Constructor Description CookieManager()Create a new cookie manager.CookieManager(CookieStore store, CookiePolicy cookiePolicy)Create a new cookie manager with specified cookie store and cookie policy.
 - 
Method SummaryAll Methods Instance Methods Concrete Methods Modifier and Type Method Description CookieStoregetCookieStore()To retrieve current cookie store.voidsetCookiePolicy(CookiePolicy cookiePolicy)To set the cookie policy of this cookie manager.- 
Methods declared in class java.net.CookieHandlerget, getDefault, put, setDefault
 
- 
 
- 
- 
- 
Constructor Detail- 
CookieManagerpublic CookieManager() Create a new cookie manager.This constructor will create new cookie manager with default cookie store and accept policy. The effect is same as CookieManager(null, null).
 - 
CookieManagerpublic CookieManager(CookieStore store, CookiePolicy cookiePolicy) Create a new cookie manager with specified cookie store and cookie policy.- Parameters:
- store- a- CookieStoreto be used by cookie manager. if- null, cookie manager will use a default one, which is an in-memory CookieStore implementation.
- cookiePolicy- a- CookiePolicyinstance to be used by cookie manager as policy callback. if- null, ACCEPT_ORIGINAL_SERVER will be used.
 
 
- 
 - 
Method Detail- 
setCookiePolicypublic void setCookiePolicy(CookiePolicy cookiePolicy) To set the cookie policy of this cookie manager.A instance of CookieManagerwill have cookie policy ACCEPT_ORIGINAL_SERVER by default. Users always can call this method to set another cookie policy.- Parameters:
- cookiePolicy- the cookie policy. Can be- null, which has no effects on current cookie policy.
 
 - 
getCookieStorepublic CookieStore getCookieStore() To retrieve current cookie store.- Returns:
- the cookie store currently used by cookie manager.
 
 
- 
 
-