CookieHandler JDK 1.6)

Description

publicabstract abstract class CookieHandler

A CookieHandler object provides a callback mechanism to hook up a HTTP state management policy implementation into the HTTP protocol handler.

See also:

Methods

Hide/Show inherited methods

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

Gets all the applicable cookies from a cookie cache for the specified uri in the request header.

Gets all the applicable cookies from a cookie cache for the
specified uri in the request header.

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.
Returns: an immutable map from state management headers, with field names "Cookie" or "Cookie2" to a list of cookies containing state information
Parameters:
- uri - a URI to send cookies to in a request
- requestHeaders - - a Map from request header field names to lists of field values representing the current request headers
Throws:
- IOException - if an I/O error occurs
- IllegalArgumentException - if either argument is null
See Also: CookieHandler.put(URI, Map),

publicstaticsynchronized CookieHandler getDefault ()

Gets the system-wide cookie handler.

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

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 all the applicable cookies, examples are response header
fields that are named Set-Cookie2, present in the response
headers into a cookie cache.
Parameters:
- uri - a URI where the cookies come from
- responseHeaders - an immutable map from field names to lists of field values representing the response header fields returned
Throws:
- IOException - if an I/O error occurs
- IllegalArgumentException - if either argument is null
See Also: CookieHandler.get(URI, Map),

publicstaticsynchronized void setDefault (CookieHandler cHandler)

Sets (or unsets) the system-wide cookie handler.

Sets (or unsets) the system-wide cookie handler.

Note: non-standard http protocol handlers may ignore this setting.
Parameters:
- cHandler - The HTTP cookie handler, or null to unset.
Throws:
- SecurityException - If a security manager has been installed and it denies {@link NetPermission}("setCookieHandler")
See Also: CookieHandler.getDefault(),