|
||||||||
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 cookies
and authentication
credentials
.
Preemptive authentication can be turned on by using the property value of #PREEMPTIVE_PROPERTY. If left unspecified, it has the default value of #PREEMPTIVE_DEFAULT. This configurable behaviour conforms to rcf2617:
Field Summary | |
static HttpAuthRealm |
DEFAULT_AUTH_REALM
The default authentication realm. |
static java.lang.String |
PREEMPTIVE_DEFAULT
The default property value for #PREEMPTIVE_PROPERTY. |
static java.lang.String |
PREEMPTIVE_PROPERTY
The boolean property name to turn on preemptive authentication. |
Constructor Summary | |
HttpState()
Default constructor. |
Method Summary | |
void |
addCookie(Cookie cookie)
Adds an HTTP cookie , replacing any existing equivalent cookies. |
void |
addCookies(Cookie[] cookies)
Adds an array of HTTP cookies . |
int |
getCookiePolicy()
Returns the current cookie policy for this
HTTP state. |
Cookie[] |
getCookies()
Returns an array of cookies that this HTTP
state currently contains. |
Cookie[] |
getCookies(java.lang.String domain,
int port,
java.lang.String path,
boolean secure)
Deprecated. use CookieSpec.match(String, int, String, boolean, Cookie) |
Cookie[] |
getCookies(java.lang.String domain,
int port,
java.lang.String path,
boolean secure,
java.util.Date now)
Deprecated. use CookieSpec#match(String, int, String, boolean, Cookie) |
Credentials |
getCredentials(java.lang.String realm)
Deprecated. This method does not distinguish between realms on different servers with the same name. Use getCredentials(String, String)
instead. |
Credentials |
getCredentials(java.lang.String realm,
java.lang.String host)
Get the credentials for the given authentication realm on the
given host. |
HttpConnectionManager |
getHttpConnectionManager()
Deprecated. Connection manager is controlled by the HttpClient class. Use HttpClient.getHttpConnectionManager() instead. |
Credentials |
getProxyCredentials(java.lang.String realm)
Deprecated. This method does not distinguish between realms on different hosts. Use getProxyCredentials(String, String) instead. |
Credentials |
getProxyCredentials(java.lang.String realm,
java.lang.String proxyHost)
Get the credentials for the proxy host with the given
authentication realm. |
boolean |
isAuthenticationPreemptive()
Returns true if preemptive authentication should be attempted, false otherwise. |
boolean |
purgeExpiredCookies()
Removes all of cookies in this HTTP state
that have expired according to the current system time. |
boolean |
purgeExpiredCookies(java.util.Date date)
Removes all of cookies in this HTTP state
that have expired by the specified date . |
void |
setAuthenticationPreemptive(boolean value)
Defines whether preemptive authentication should be attempted. |
void |
setCookiePolicy(int policy)
Sets the current cookie policy for this HTTP
state to one of the following supported policies:
CookiePolicy.COMPATIBILITY ,
CookiePolicy.NETSCAPE_DRAFT or
CookiePolicy.RFC2109 . |
void |
setCredentials(java.lang.String realm,
Credentials credentials)
Deprecated. This method does not distinguish between realms with the same name on different hosts. Use setCredentials(String, String, Credentials) instead. |
void |
setCredentials(java.lang.String realm,
java.lang.String host,
Credentials credentials)
Sets the credentials for the given authentication
realm on the given host. |
void |
setHttpConnectionManager(HttpConnectionManager httpConnectionManager)
Deprecated. Connection manager is controlled by the HttpClient class. Use HttpClient.setHttpConnectionManager(HttpConnectionManager) instead. |
void |
setProxyCredentials(java.lang.String realm,
Credentials credentials)
Deprecated. This method does not differentiate between realms with the same name on different servers. Use setProxyCredentials(String, String, Credentials) instead. |
void |
setProxyCredentials(java.lang.String realm,
java.lang.String proxyHost,
Credentials credentials)
Sets the credentials for the given proxy authentication
realm on the given proxy host. |
java.lang.String |
toString()
Returns a string representation of this HTTP state. |
Methods inherited from class java.lang.Object |
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
Field Detail |
public static final java.lang.String PREEMPTIVE_PROPERTY
public static final java.lang.String PREEMPTIVE_DEFAULT
public static final HttpAuthRealm DEFAULT_AUTH_REALM
Constructor Detail |
public HttpState()
Method Detail |
public void addCookie(Cookie cookie)
HTTP cookie
, replacing any existing equivalent cookies.
If the given cookie has already expired it will not be added, but existing
values will still be removed.cookie
- the cookie
to be addedaddCookies(Cookie[])
public void addCookies(Cookie[] cookies)
HTTP cookies
. Cookies are added individually and
in the given array order. If any of the given cookies has already expired it will
not be added, but existing values will still be removed.cookies
- the cookies
to be addedaddCookie(Cookie)
public Cookie[] getCookies()
cookies
that this HTTP
state currently contains.cookies
.getCookies(String, int, String, boolean, java.util.Date)
public Cookie[] getCookies(java.lang.String domain, int port, java.lang.String path, boolean secure, java.util.Date now)
cookies
in this HTTP
state 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 determinedcookies
.getCookies()
public Cookie[] getCookies(java.lang.String domain, int port, java.lang.String path, boolean secure)
CookieSpec.match(String, int, String, boolean, Cookie)
cookies
in this HTTP
state that match the given request parameters.domain
- the request domainport
- the request portpath
- the request pathsecure
- true
when using HTTPScookies
.getCookies()
public boolean purgeExpiredCookies()
cookies
in this HTTP state
that have expired according to the current system time.purgeExpiredCookies(java.util.Date)
public boolean purgeExpiredCookies(java.util.Date date)
cookies
in this HTTP state
that have expired by the specified date
.date
- The date
to compare against.Cookie.isExpired(java.util.Date)
,
purgeExpiredCookies()
public int getCookiePolicy()
cookie policy
for this
HTTP state.cookie policy
.public void setAuthenticationPreemptive(boolean value)
value
- true if preemptive authentication should be
attempted, false otherwise.public boolean isAuthenticationPreemptive()
public void setCookiePolicy(int policy)
cookie policy
for this HTTP
state to one of the following supported policies:
CookiePolicy.COMPATIBILITY
,
CookiePolicy.NETSCAPE_DRAFT
or
CookiePolicy.RFC2109
.policy
- new cookie policy
public void setCredentials(java.lang.String realm, Credentials credentials)
setCredentials(String, String, Credentials)
instead.
credentials
for the given authentication
realm. The null
realm signifies default credentials, which
should be used when no credentials
have been explictly
supplied for the given challenging realm. Any previous credentials for
the given realm will be overwritten.realm
- the authentication realmcredentials
- the authentication credentials for the given realmgetCredentials(String, String)
,
setProxyCredentials(String, String, Credentials)
public void setCredentials(java.lang.String realm, java.lang.String host, Credentials credentials)
credentials
for the given authentication
realm on the given host. The null
realm signifies default
credentials for the given host, which should be used when no
credentials
have been explictly supplied for the
challenging realm. The null
host signifies default
credentials, which should be used when no credentials
have been explictly supplied for the challenging host. Any previous
credentials for the given realm on the given host will be overwritten.realm
- the authentication realmhost
- the host the realm belongs tocredentials
- the authentication credentials
for the given realm.getCredentials(String, String)
,
setProxyCredentials(String, String, Credentials)
public Credentials getCredentials(java.lang.String realm, java.lang.String host)
credentials
for the given authentication realm on the
given host.
If the realm exists on host, return the coresponding credentials.
If the host exists with a null realm, return the corresponding
credentials.
If the realm exists with a null host, return the
corresponding credentials. If the realm does not exist, return
the default Credentials. If there are no default credentials, return
null
.realm
- the authentication realmhost
- the host the realm is onsetCredentials(String, String, Credentials)
public Credentials getCredentials(java.lang.String realm)
getCredentials(String, String)
instead.
credentials
for the given authentication realm.realm
- the authentication realmsetCredentials(String, String, Credentials)
public void setProxyCredentials(java.lang.String realm, Credentials credentials)
setProxyCredentials(String, String, Credentials)
instead.
credentials
for the given proxy authentication
realm. The null
realm signifies default credentials, which
should be used when no credentials
have been explictly
supplied for the given challenging proxy realm. Any previous credentials for
the given realm will be overwritten.realm
- the authentication realmcredentials
- the authentication credentials for the given realmgetProxyCredentials(String)
,
setCredentials(String, Credentials)
public void setProxyCredentials(java.lang.String realm, java.lang.String proxyHost, Credentials credentials)
credentials
for the given proxy authentication
realm on the given proxy host. The null
proxy realm signifies
default credentials for the given proxy host, which should be used when no
credentials
have been explictly supplied for the
challenging proxy realm. The null
proxy host signifies default
credentials, which should be used when no credentials
have been explictly supplied for the challenging proxy host. Any previous
credentials for the given proxy realm on the given proxy host will be
overwritten.realm
- the authentication realmproxyHost
- the proxy hostcredentials
- the authentication credentials for the given realmgetProxyCredentials(String)
,
setCredentials(String, Credentials)
public Credentials getProxyCredentials(java.lang.String realm)
getProxyCredentials(String, String)
instead.
credentials
for the given
proxy authentication realm.
If the realm exists, return the coresponding credentials. If the
realm does not exist, return the default Credentials. If there is
no default credentials, return null
.realm
- the authentication realmsetProxyCredentials(String, String, Credentials)
public Credentials getProxyCredentials(java.lang.String realm, java.lang.String proxyHost)
credentials
for the proxy host with the given
authentication realm.
If the realm exists on host, return the coresponding credentials.
If the host exists with a null realm, return the corresponding
credentials.
If the realm exists with a null host, return the
corresponding credentials. If the realm does not exist, return
the default Credentials. If there are no default credentials, return
null
.realm
- the authentication realmproxyHost
- the proxy host the realm is onsetProxyCredentials(String, String, Credentials)
public java.lang.String toString()
Object.toString()
public HttpConnectionManager getHttpConnectionManager()
HttpClient.getHttpConnectionManager()
instead.
public void setHttpConnectionManager(HttpConnectionManager httpConnectionManager)
HttpClient.setHttpConnectionManager(HttpConnectionManager)
instead.
httpConnectionManager
- The httpConnectionManager to set
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |