/**@class java.net.CookieManager
@extends java.net.CookieHandler

 CookieManager provides a concrete implementation of {@link java.net.CookieHandler},
 which separates the storage of cookies from the policy surrounding accepting
 and rejecting cookies. A CookieManager is initialized with a {@link java.net.CookieStore}
 which manages storage, and a {@link java.net.CookiePolicy} object, which makes
 policy decisions on cookie acceptance/rejection.

 <p> The HTTP cookie management in java.net package looks like:
 <blockquote>
 <pre>{@code
                  use
 CookieHandler <------- HttpURLConnection
       ^
       | impl
       |         use
 CookieManager -------> CookiePolicy
             |   use
             |--------> HttpCookie
             |              ^
             |              | use
             |   use        |
             |--------> CookieStore
                            ^
                            | impl
                            |
                  Internal in-memory implementation
 }</pre>
 <ul>
   <li>
     CookieHandler is at the core of cookie management. User can call
     CookieHandler.setDefault to set a concrete CookieHanlder implementation
     to be used.
   </li>
   <li>
     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.
   </li>
   <li>
     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.
   </li>
   <li>
     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.
   </li>
 </ul>
 </blockquote>

 <p>There're various ways user can hook up his own HTTP cookie management behavior, e.g.
 <blockquote>
 <ul>
   <li>Use CookieHandler.setDefault to set a brand new {@link java.net.CookieHandler} implementation
   <li>Let CookieManager be the default {@link java.net.CookieHandler} implementation,
       but implement user's own {@link java.net.CookieStore} and {@link java.net.CookiePolicy}
       and tell default CookieManager to use them:
     <blockquote><pre>
       // this should be done at the beginning of an HTTP session
       CookieHandler.setDefault(new CookieManager(new MyCookieStore(), new MyCookiePolicy()));
     </pre></blockquote>
   <li>Let CookieManager be the default {@link java.net.CookieHandler} implementation, but
       use customized {@link java.net.CookiePolicy}:
     <blockquote><pre>
       // 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());
     </pre></blockquote>
 </ul>
 </blockquote>

 <p>The implementation conforms to <a href="http://www.ietf.org/rfc/rfc2965.txt">RFC 2965</a>, section 3.3.

 @see CookiePolicy
 @author Edward Wang
 @since 1.6
*/
var CookieManager = {

/**To set the cookie policy of this cookie manager.

 <p> A instance of {@code CookieManager} will have
 cookie policy ACCEPT_ORIGINAL_SERVER by default. Users always
 can call this method to set another cookie policy.
@param {Object {CookiePolicy}} cookiePolicy      the cookie policy. Can be {@code null}, which
                          has no effects on current cookie policy.
*/
setCookiePolicy : function(  ) {},

/**To retrieve current cookie store.
@return {Object {java.net.CookieStore}} the cookie store currently used by cookie manager.
*/
getCookieStore : function(  ) {},

/**
*/
get : function(  ) {},

/**
*/
put : function(  ) {},


};