|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.commons.httpclient.HttpState
A container for HTTP attributes that may persist from request
to request, such as Cookie
s and authentication
Credentials
.
Field Summary | |
static org.apache.commons.logging.Log |
log
Log object for this class. |
Constructor Summary | |
HttpState()
|
Method Summary | |
void |
addCookie(Cookie cookie)
Add a cookie. |
void |
addCookies(Cookie[] newcookies)
Add zero or more cookies If any given cookie has already expired, deletes the corresponding existing cookie (if any). |
Cookie[] |
getCookies()
Obtain an array of my Cookie s. |
Cookie[] |
getCookies(java.lang.String domain,
int port,
java.lang.String path,
boolean secure,
java.util.Date now)
Obtain an array of my Cookie s that
match the given request parameters. |
Credentials |
getCredentials(java.lang.String realm)
Get the Credentials for the given authentication realm. |
Credentials |
getProxyCredentials(java.lang.String realm)
Get the Credentials for the proxy with the given authentication realm. |
boolean |
purgeExpiredCookies()
Remove all of my Cookie s that
have expired according to the current
system time. |
boolean |
purgeExpiredCookies(java.util.Date date)
Remove all of my Cookie s that
have expired by the specified date. |
void |
setCredentials(java.lang.String realm,
Credentials credentials)
Set the Credentials for the given authentication realm. |
void |
setProxyCredentials(java.lang.String realm,
Credentials credentials)
Set the for the proxy with the given authentication realm. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final org.apache.commons.logging.Log log
Constructor Detail |
public HttpState()
Method Detail |
public void addCookie(Cookie cookie)
cookie
- the Cookie
to addpublic void addCookies(Cookie[] newcookies)
newcookies
- the Cookie
s to addpublic Cookie[] getCookies()
Cookie
s.Cookie
s.public Cookie[] getCookies(java.lang.String domain, int port, java.lang.String path, boolean secure, java.util.Date now)
Cookie
s that
match the given request parameters.domain
- the request domainport
- the request portpath
- the request pathsecure
- true
when using HTTPSnow
- the Date
by which expiration is determinedCookie
s.Cookie.matches(java.lang.String, int, java.lang.String, boolean, java.util.Date)
public boolean purgeExpiredCookies()
Cookie
s that
have expired according to the current
system time.purgeExpiredCookies(java.util.Date)
public boolean purgeExpiredCookies(java.util.Date date)
Cookie
s that
have expired by the specified date.Cookie.isExpired(java.util.Date)
public void setCredentials(java.lang.String realm, Credentials credentials)
null
, I'll use the given
credentials when no other Credentials
have
been supplied for the given challenging realm.
(I.e., use a null
realm to set the "default"
credentials.)
Any previous credentials for this realm will be overwritten.
realm
- the authentication realmcredentials
- the authentication credentials for the given realmpublic Credentials getCredentials(java.lang.String realm)
null
.realm
- the authentication realmsetCredentials(java.lang.String, org.apache.commons.httpclient.Credentials)
public void setProxyCredentials(java.lang.String realm, Credentials credentials)
null
, I'll use the given
credentials when no other Credentials
have
been supplied for the given challenging realm.
(I.e., use a null
realm to set the "default"
credentials.) Realms rarely make much sense with proxies, so
null
is normally a good choice here.
Any previous credentials for this realm will be overwritten.
realm
- the authentication realmcredentials
- the authentication credentials for the given realmpublic Credentials getProxyCredentials(java.lang.String realm)
null
.realm
- the authentication realmsetProxyCredentials(java.lang.String, org.apache.commons.httpclient.Credentials)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |