public abstract class CookieHandler extends Object
A system-wide CookieHandler that to used by the HTTP protocol handler can be registered by doing a CookieHandler.setDefault(CookieHandler). The currently registered CookieHandler can be retrieved by calling CookieHandler.getDefault(). For more information on HTTP state management, see RFC 2965: HTTP State Management Mechanism
|Constructor and Description|
|Modifier and Type||Method and Description|
Gets all the applicable cookies from a cookie cache for the specified uri in the request header.
Gets the system-wide cookie handler.
Sets all the applicable cookies, examples are response header fields that are named Set-Cookie2, present in the response headers into a cookie cache.
Sets (or unsets) the system-wide cookie handler.
public static CookieHandler getDefault()
public static void setDefault(CookieHandler cHandler)
public abstract Map<String,List<String>> get(URI uri, Map<String,List<String>> requestHeaders) throws IOException
URI passed as an argument specifies the intended use for
the cookies. In particular the scheme should reflect whether the cookies
The host part should reflect either the destination of the cookies or
It is up to the implementation to take into account the
the cookies attributes and security settings to determine which ones
should be returned.
HTTP protocol implementers should make sure that this method is called after all request headers related to choosing cookies are added, and before the request is sent.
URIrepresenting the intended use for the cookies
requestHeaders- - a Map from request header field names to lists of field values representing the current request headers
IOException- if an I/O error occurs
IllegalArgumentException- if either argument is null
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.