* A container for HTTP attributes that may persist from request * to request, such as {@link Cookie cookies} and authentication * {@link Credentials credentials}. *
* * @author Remy Maucherat * @author Rodney Waldhoff * @author Jeff Dever * @author Sean C. Sullivan * @author Michael Becke * @author Oleg Kalnichevski * @author Mike Bowler * @author Adrian Sutton * * @version $Revision: 1.1 $ $Date: 2012/08/22 17:30:33 $ * */ public class HttpState { // ----------------------------------------------------- Instance Variables /** * Map of {@link Credentials credentials} by realm that this * HTTP state contains. */ private HashMap credMap = new HashMap(); /** * Map of {@link Credentials proxy credentials} by realm that this * HTTP state contains */ private HashMap proxyCred = new HashMap(); /** * Array of {@link Cookie cookies} that this HTTP state contains. */ private ArrayList cookies = new ArrayList(); private boolean preemptive = false; private int cookiePolicy = -1; // -------------------------------------------------------- Class Variables /** * The boolean system property name to turn on preemptive authentication. * @deprecated This field and feature will be removed following HttpClient 3.0. */ public static final String PREEMPTIVE_PROPERTY = "httpclient.authentication.preemptive"; /** * The default value for {@link #PREEMPTIVE_PROPERTY}. * @deprecated This field and feature will be removed following HttpClient 3.0. */ public static final String PREEMPTIVE_DEFAULT = "false"; /** Log object for this class. */ private static final Log LOG = LogFactory.getLog(HttpState.class); /** * Default constructor. */ public HttpState() { super(); } // ------------------------------------------------------------- Properties /** * Adds an {@link 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. * * @param cookie the {@link Cookie cookie} to be added * * @see #addCookies(Cookie[]) * */ public synchronized void addCookie(Cookie cookie) { LOG.trace("enter HttpState.addCookie(Cookie)"); if (cookie != null) { // first remove any old cookie that is equivalent for (Iterator it = cookies.iterator(); it.hasNext();) { Cookie tmp = (Cookie) it.next(); if (cookie.equals(tmp)) { it.remove(); break; } } if (!cookie.isExpired()) { cookies.add(cookie); } } } /** * Adds an array of {@link Cookie 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. * * @param cookies the {@link Cookie cookies} to be added * * @see #addCookie(Cookie) * * */ public synchronized void addCookies(Cookie[] cookies) { LOG.trace("enter HttpState.addCookies(Cookie[])"); if (cookies != null) { for (int i = 0; i < cookies.length; i++) { this.addCookie(cookies[i]); } } } /** * Returns an array of {@link Cookie cookies} that this HTTP * state currently contains. * * @return an array of {@link Cookie cookies}. * * @see #getCookies(String, int, String, boolean) * */ public synchronized Cookie[] getCookies() { LOG.trace("enter HttpState.getCookies()"); return (Cookie[]) (cookies.toArray(new Cookie[cookies.size()])); } /** * Returns an array of {@link Cookie cookies} in this HTTP * state that match the given request parameters. * * @param domain the request domain * @param port the request port * @param path the request path * @param securetrue when using HTTPS
*
* @return an array of {@link Cookie cookies}.
*
* @see #getCookies()
*
* @deprecated use CookieSpec#match(String, int, String, boolean, Cookie)
*/
public synchronized Cookie[] getCookies(
String domain,
int port,
String path,
boolean secure
) {
LOG.trace("enter HttpState.getCookies(String, int, String, boolean)");
CookieSpec matcher = CookiePolicy.getDefaultSpec();
ArrayList list = new ArrayList(cookies.size());
for (int i = 0, m = cookies.size(); i < m; i++) {
Cookie cookie = (Cookie) (cookies.get(i));
if (matcher.match(domain, port, path, secure, cookie)) {
list.add(cookie);
}
}
return (Cookie[]) (list.toArray(new Cookie[list.size()]));
}
/**
* Removes all of {@link Cookie cookies} in this HTTP state
* that have expired according to the current system time.
*
* @see #purgeExpiredCookies(java.util.Date)
*
*/
public synchronized boolean purgeExpiredCookies() {
LOG.trace("enter HttpState.purgeExpiredCookies()");
return purgeExpiredCookies(new Date());
}
/**
* Removes all of {@link Cookie cookies} in this HTTP state
* that have expired by the specified {@link java.util.Date date}.
*
* @param date The {@link java.util.Date date} to compare against.
*
* @return true if any cookies were purged.
*
* @see Cookie#isExpired(java.util.Date)
*
* @see #purgeExpiredCookies()
*/
public synchronized boolean purgeExpiredCookies(Date date) {
LOG.trace("enter HttpState.purgeExpiredCookies(Date)");
boolean removed = false;
Iterator it = cookies.iterator();
while (it.hasNext()) {
if (((Cookie) (it.next())).isExpired(date)) {
it.remove();
removed = true;
}
}
return removed;
}
/**
* Returns the current {@link CookiePolicy cookie policy} for this
* HTTP state.
*
* @return The {@link CookiePolicy cookie policy}.
*
* @deprecated Use
* {@link org.apache.commons.httpclient.params.HttpMethodParams#getCookiePolicy()},
* {@link HttpMethod#getParams()}.
*/
public int getCookiePolicy() {
return this.cookiePolicy;
}
/**
* Defines whether preemptive authentication should be
* attempted.
*
* @param value true if preemptive authentication should be
* attempted, false otherwise.
*
* @deprecated Use
* {@link org.apache.commons.httpclient.params.HttpClientParams#setAuthenticationPreemptive(boolean)},
* {@link HttpClient#getParams()}.
*/
public void setAuthenticationPreemptive(boolean value) {
this.preemptive = value;
}
/**
* Returns true if preemptive authentication should be
* attempted, false otherwise.
*
* @return boolean flag.
*
* @deprecated Use
* {@link org.apache.commons.httpclient.params.HttpClientParams#isAuthenticationPreemptive()},
* {@link HttpClient#getParams()}.
*/
public boolean isAuthenticationPreemptive() {
return this.preemptive;
}
/**
* Sets the current {@link CookiePolicy cookie policy} for this HTTP
* state to one of the following supported policies:
* {@link CookiePolicy#COMPATIBILITY},
* {@link CookiePolicy#NETSCAPE_DRAFT} or
* {@link CookiePolicy#RFC2109}.
*
* @param policy new {@link CookiePolicy cookie policy}
*
* @deprecated
* Use {@link org.apache.commons.httpclient.params.HttpMethodParams#setCookiePolicy(String)},
* {@link HttpMethod#getParams()}.
*/
public void setCookiePolicy(int policy) {
this.cookiePolicy = policy;
}
/**
* Sets the {@link 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
* {@link Credentials credentials} have been explictly supplied for the
* challenging realm. The null host signifies default
* credentials, which should be used when no {@link Credentials credentials}
* have been explictly supplied for the challenging host. Any previous
* credentials for the given realm on the given host will be overwritten.
*
* @param realm the authentication realm
* @param host the host the realm belongs to
* @param credentials the authentication {@link Credentials credentials}
* for the given realm.
*
* @see #getCredentials(String, String)
* @see #setProxyCredentials(String, String, Credentials)
*
* @deprecated use #setCredentials(AuthScope, Credentials)
*/
public synchronized void setCredentials(String realm, String host, Credentials credentials) {
LOG.trace("enter HttpState.setCredentials(String, String, Credentials)");
credMap.put(new AuthScope(host, AuthScope.ANY_PORT, realm, AuthScope.ANY_SCHEME), credentials);
}
/**
* Sets the {@link Credentials credentials} for the given authentication
* scope. Any previous credentials for the given scope will be overwritten.
*
* @param authscope the {@link AuthScope authentication scope}
* @param credentials the authentication {@link Credentials credentials}
* for the given scope.
*
* @see #getCredentials(AuthScope)
* @see #setProxyCredentials(AuthScope, Credentials)
*
* @since 3.0
*/
public synchronized void setCredentials(final AuthScope authscope, final Credentials credentials) {
if (authscope == null) {
throw new IllegalArgumentException("Authentication scope may not be null");
}
LOG.trace("enter HttpState.setCredentials(AuthScope, Credentials)");
credMap.put(authscope, credentials);
}
/**
* Find matching {@link Credentials credentials} for the given authentication scope.
*
* @param map the credentials hash map
* @param token the {@link AuthScope authentication scope}
* @return the credentials
*
*/
private static Credentials matchCredentials(final HashMap map, final AuthScope authscope) {
// see if we get a direct hit
Credentials creds = (Credentials)map.get(authscope);
if (creds == null) {
// Nope.
// Do a full scan
int bestMatchFactor = -1;
AuthScope bestMatch = null;
Iterator items = map.keySet().iterator();
while (items.hasNext()) {
AuthScope current = (AuthScope)items.next();
int factor = authscope.match(current);
if (factor > bestMatchFactor) {
bestMatchFactor = factor;
bestMatch = current;
}
}
if (bestMatch != null) {
creds = (Credentials)map.get(bestMatch);
}
}
return creds;
}
/**
* Get the {@link Credentials credentials} for the given authentication scope 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.
*
* @param realm the authentication realm
* @param host the host the realm is on
* @return the credentials
*
* @see #setCredentials(String, String, Credentials)
*
* @deprecated use #getCredentials(AuthScope)
*/
public synchronized Credentials getCredentials(String realm, String host) {
LOG.trace("enter HttpState.getCredentials(String, String");
return matchCredentials(this.credMap,
new AuthScope(host, AuthScope.ANY_PORT, realm, AuthScope.ANY_SCHEME));
}
/**
* Get the {@link Credentials credentials} for the given authentication scope.
*
* @param authscope the {@link AuthScope authentication scope}
* @return the credentials
*
* @see #setCredentials(AuthScope, Credentials)
*
* @since 3.0
*/
public synchronized Credentials getCredentials(final AuthScope authscope) {
if (authscope == null) {
throw new IllegalArgumentException("Authentication scope may not be null");
}
LOG.trace("enter HttpState.getCredentials(AuthScope)");
return matchCredentials(this.credMap, authscope);
}
/**
* Sets the {@link 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
* {@link Credentials credentials} have been explictly supplied for the
* challenging proxy realm. The null proxy host signifies default
* credentials, which should be used when no {@link Credentials 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.
*
* @param realm the authentication realm
* @param proxyHost the proxy host
* @param credentials the authentication credentials for the given realm
*
* @see #getProxyCredentials(AuthScope)
* @see #setCredentials(AuthScope, Credentials)
*
* @deprecated use #setProxyCredentials(AuthScope, Credentials)
*/
public synchronized void setProxyCredentials(
String realm,
String proxyHost,
Credentials credentials
) {
LOG.trace("enter HttpState.setProxyCredentials(String, String, Credentials");
proxyCred.put(new AuthScope(proxyHost, AuthScope.ANY_PORT, realm, AuthScope.ANY_SCHEME), credentials);
}
/**
* Sets the {@link Credentials proxy credentials} for the given authentication
* realm. Any previous credentials for the given realm will be overwritten.
*
* @param authscope the {@link AuthScope authentication scope}
* @param credentials the authentication {@link Credentials credentials}
* for the given realm.
*
* @see #getProxyCredentials(AuthScope)
* @see #setCredentials(AuthScope, Credentials)
*
* @since 3.0
*/
public synchronized void setProxyCredentials(final AuthScope authscope,
final Credentials credentials)
{
if (authscope == null) {
throw new IllegalArgumentException("Authentication scope may not be null");
}
LOG.trace("enter HttpState.setProxyCredentials(AuthScope, Credentials)");
proxyCred.put(authscope, credentials);
}
/**
* Get the {@link Credentials credentials} for the proxy host with the given
* authentication scope.
*
* 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.
*
* @param realm the authentication realm
* @param proxyHost the proxy host the realm is on
* @return the credentials
* @see #setProxyCredentials(String, String, Credentials)
*
* @deprecated use #getProxyCredentials(AuthScope)
*/
public synchronized Credentials getProxyCredentials(String realm, String proxyHost) {
LOG.trace("enter HttpState.getCredentials(String, String");
return matchCredentials(this.proxyCred,
new AuthScope(proxyHost, AuthScope.ANY_PORT, realm, AuthScope.ANY_SCHEME));
}
/**
* Get the {@link Credentials proxy credentials} for the given authentication scope.
*
* @param authscope the {@link AuthScope authentication scope}
* @return the credentials
*
* @see #setProxyCredentials(AuthScope, Credentials)
*
* @since 3.0
*/
public synchronized Credentials getProxyCredentials(final AuthScope authscope) {
if (authscope == null) {
throw new IllegalArgumentException("Authentication scope may not be null");
}
LOG.trace("enter HttpState.getProxyCredentials(AuthScope)");
return matchCredentials(this.proxyCred, authscope);
}
/**
* Returns a string representation of this HTTP state.
*
* @return The string representation of the HTTP state.
*
* @see java.lang.Object#toString()
*/
public synchronized String toString() {
StringBuffer sbResult = new StringBuffer();
sbResult.append("[");
sbResult.append(getCredentialsStringRepresentation(proxyCred));
sbResult.append(" | ");
sbResult.append(getCredentialsStringRepresentation(credMap));
sbResult.append(" | ");
sbResult.append(getCookiesStringRepresentation(cookies));
sbResult.append("]");
String strResult = sbResult.toString();
return strResult;
}
/**
* Returns a string representation of the credentials.
* @param credMap The credentials.
* @return The string representation.
*/
private static String getCredentialsStringRepresentation(final Map credMap) {
StringBuffer sbResult = new StringBuffer();
Iterator iter = credMap.keySet().iterator();
while (iter.hasNext()) {
Object key = iter.next();
Credentials cred = (Credentials) credMap.get(key);
if (sbResult.length() > 0) {
sbResult.append(", ");
}
sbResult.append(key);
sbResult.append("#");
sbResult.append(cred.toString());
}
return sbResult.toString();
}
/**
* Returns a string representation of the cookies.
* @param cookies The cookies
* @return The string representation.
*/
private static String getCookiesStringRepresentation(final List cookies) {
StringBuffer sbResult = new StringBuffer();
Iterator iter = cookies.iterator();
while (iter.hasNext()) {
Cookie ck = (Cookie) iter.next();
if (sbResult.length() > 0) {
sbResult.append("#");
}
sbResult.append(ck.toExternalForm());
}
return sbResult.toString();
}
/**
* Clears all credentials.
*/
public void clearCredentials() {
this.credMap.clear();
}
/**
* Clears all proxy credentials.
*/
public void clearProxyCredentials() {
this.proxyCred.clear();
}
/**
* Clears all cookies.
*/
public void clearCookies() {
this.cookies.clear();
}
/**
* Clears the state information (all cookies, credentials and proxy credentials).
*/
public void clear() {
clearCookies();
clearCredentials();
clearProxyCredentials();
}
}