| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public abstract class CookieHandler extends Object
A CookieHandler object provides a callback mechanism to hook up a HTTP state management policy implementation into the HTTP protocol handler. The HTTP state management mechanism specifies a way to create a stateful session with HTTP requests and responses.
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 Summary | |
---|---|
|
Method Summary | |
---|---|
abstract Map |
Gets all the applicable cookies from a cookie cache for the specified uri in the request header. |
static CookieHandler |
Gets the system-wide cookie handler. |
abstract void |
Sets all the applicable cookies, examples are response header fields that are named Set-Cookie2, present in the response headers into a cookie cache. |
static void |
setDefault(CookieHandler cHandler) Sets (or unsets) the system-wide cookie handler. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public CookieHandler()
Method Detail |
---|
public abstract Map get(URI uri, Map requestHeaders) throws IOException
uri
- a URI
to send cookies to in a requestrequestHeaders
- - a Map from request header
field names to lists of field values representing
the current request headersIOException
- if an I/O error occurspublic static synchronized CookieHandler getDefault()
public abstract void put(URI uri, Map responseHeaders) throws IOException
uri
- a URI
where the cookies come fromresponseHeaders
- an immutable map from field names to
lists of field values representing the response
header fields returnedIOException
- if an I/O error occurspublic static synchronized void setDefault(CookieHandler cHandler)
cHandler
- The HTTP cookie handler, or
null
to unset.
| |||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |