ucar.nc2.util.net

Class HTTPCredentialsCache

java.lang.Object

ucar.nc2.util.net.HTTPCredentialsCache

All Implemented Interfaces:

org.apache.http.client.CredentialsProvider

public class HTTPCredentialsCache
extends Object
implements org.apache.http.client.CredentialsProvider

With httpclient 4.2.x, credentials caching is pushed to the CredentialsProvider implementation. See org.apache.http.impl.client.BasicCredentialsProvider, for an example. However, most existing CredentialsProviders do not do caching.

So this class is used as a wrapper around CredentialsProviders to supply caching support. The cache is a singleton kept as static data in this class.

Previously, the cache was per-session, but this turn out to be a mistake because the opendap code repeatedly calls the server in checkifdods() with a new HTTPSession, so we get repeated requests to the credentials provider.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	HTTPCredentialsCache.Triple

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.http.auth.AuthScope	authscope
protected static List<HTTPCredentialsCache.Triple>	cache
protected String	principal
static String	PROXY_AUTH_RESP
protected int	retryCount
protected ucar.nc2.util.net.HTTPAuthStore	store
protected static List<HTTPCredentialsCache.Triple>	testlist
static String	WWW_AUTH_RESP

Constructor Summary

Constructors

Constructor and Description
HTTPCredentialsCache(ucar.nc2.util.net.HTTPAuthStore store, org.apache.http.auth.AuthScope authscope, String principal)

Method Summary

Methods

Modifier and Type	Method and Description
protected static org.apache.http.auth.Credentials	cacheCredentials(String principal, org.apache.http.auth.AuthScope scope, org.apache.http.auth.Credentials creds) Insert a credentials into the cache; will return any previous value.
protected static org.apache.http.auth.Credentials	checkCache(String principal, org.apache.http.auth.AuthScope scope) Retrieve a credentials from the cache.
void	clear()
static void	clearCache()
static List<HTTPCredentialsCache.Triple>	getCache()
org.apache.http.auth.Credentials	getCredentials(org.apache.http.auth.AuthScope scope)
static List<HTTPCredentialsCache.Triple>	getTestList()
static void	invalidate(org.apache.http.auth.AuthScope scope) Clear some entries matching the argument
void	setCredentials(org.apache.http.auth.AuthScope scope, org.apache.http.auth.Credentials creds)
String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

WWW_AUTH_RESP

public static final String WWW_AUTH_RESP

See Also:

Constant Field Values

PROXY_AUTH_RESP

public static final String PROXY_AUTH_RESP

See Also:

Constant Field Values

store

protected ucar.nc2.util.net.HTTPAuthStore store

retryCount

protected int retryCount

authscope

protected org.apache.http.auth.AuthScope authscope

principal

protected String principal

cache

protected static List<HTTPCredentialsCache.Triple> cache

testlist

protected static List<HTTPCredentialsCache.Triple> testlist

Constructor Detail

HTTPCredentialsCache

public HTTPCredentialsCache(ucar.nc2.util.net.HTTPAuthStore store,
                    org.apache.http.auth.AuthScope authscope,
                    String principal)

Method Detail

getCredentials

public org.apache.http.auth.Credentials getCredentials(org.apache.http.auth.AuthScope scope)

Specified by:

getCredentials in interface org.apache.http.client.CredentialsProvider

setCredentials

public void setCredentials(org.apache.http.auth.AuthScope scope,
                  org.apache.http.auth.Credentials creds)

Specified by:

setCredentials in interface org.apache.http.client.CredentialsProvider

clear

public void clear()

Specified by:

clear in interface org.apache.http.client.CredentialsProvider

toString

public String toString()

Overrides:

toString in class Object

cacheCredentials

protected static org.apache.http.auth.Credentials cacheCredentials(String principal,
                                                org.apache.http.auth.AuthScope scope,
                                                org.apache.http.auth.Credentials creds)

Insert a credentials into the cache; will return any previous value.

Parameters:

scope - the key for retrieving a credentials object.

creds - the credentials object associated with this key

Returns:

the old credentials object if overwriting, else null

checkCache

protected static org.apache.http.auth.Credentials checkCache(String principal,
                                          org.apache.http.auth.AuthScope scope)

Retrieve a credentials from the cache.

Parameters:

principal - a key for retrieving a credentials object.

scope - a key for retrieving a credentials object.

Returns:

the matching credentials object, else null

invalidate

public static void invalidate(org.apache.http.auth.AuthScope scope)

Clear some entries matching the argument

clearCache

public static void clearCache()

getCache

public static List<HTTPCredentialsCache.Triple> getCache()

getTestList

public static List<HTTPCredentialsCache.Triple> getTestList()