Class ResolverDirectHTTP

java.lang.Object

org.apache.xml.security.utils.resolver.ResourceResolverSpi

org.apache.xml.security.utils.resolver.implementations.ResolverDirectHTTP

public class ResolverDirectHTTP
extends ResourceResolverSpi

A simple ResourceResolver for HTTP requests. This class handles only 'pure' HTTP URIs which means without a fragment. The Fragment handling is done by the ResolverFragment class.
If the user has a corporate HTTP proxy which is to be used, the usage can be switched on by setting properties for the resolver:

resourceResolver.setProperty("http.proxy.host", "proxy.company.com");
resourceResolver.setProperty("http.proxy.port", "8080");

// if we need a password for the proxy
resourceResolver.setProperty("http.proxy.username", "proxyuser3");
resourceResolver.setProperty("http.proxy.password", "secretca");

See Also:

• Java Tip 42: Write Java apps that work with proxy-based firewalls
• JDK docs for network properties
• The JAVA FAQ Question 9.5: How do I make Java work with a proxy server?

Field Summary

Fields

Modifier and Type	Field	Description
private static final int	HttpBasicPass	Field HttpProxyPass
private static final int	HttpBasicUser	Field HttpProxyUser
private static final int	HttpProxyHost	Field HttpProxyHost
private static final int	HttpProxyPass	Field HttpProxyPass
private static final int	HttpProxyPort	Field HttpProxyPort
private static final int	HttpProxyUser	Field HttpProxyUser
private static final org.slf4j.Logger	LOG
private static final String[]	properties	Field properties[]

Constructor Summary

Constructors

Constructor	Description
ResolverDirectHTTP()

Method Summary

Modifier and Type	Method	Description
boolean	engineCanResolveURI(ResourceResolverContext context)	We resolve http URIs without fragment...
String[]	engineGetPropertyKeys()	Method engineGetPropertyKeys
boolean	engineIsThreadSafe()	Tells if the implementation does can be reused by several threads safely.
XMLSignatureInput	engineResolveURI(ResourceResolverContext context)	This is the workhorse method used to resolve resources.
private static URI	getNewURI(String uri, String baseURI)
private URLConnection	openConnection(URL url)

Methods inherited from class ResourceResolverSpi

engineAddProperies, engineGetProperty, engineSetProperty, fixURI, understandsProperty

Methods inherited from class Object

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

Field Details

LOG

private static final org.slf4j.Logger LOG

properties

private static final String[] properties

Field properties[]

HttpProxyHost

private static final int HttpProxyHost

Field HttpProxyHost

See Also:

• Constant Field Values

HttpProxyPort

private static final int HttpProxyPort

Field HttpProxyPort

See Also:

• Constant Field Values

HttpProxyUser

private static final int HttpProxyUser

Field HttpProxyUser

See Also:

• Constant Field Values

HttpProxyPass

private static final int HttpProxyPass

Field HttpProxyPass

See Also:

• Constant Field Values

HttpBasicUser

private static final int HttpBasicUser

Field HttpProxyUser

See Also:

• Constant Field Values

HttpBasicPass

private static final int HttpBasicPass

Field HttpProxyPass

See Also:

• Constant Field Values

Constructor Details

ResolverDirectHTTP

public ResolverDirectHTTP()

Method Details

engineIsThreadSafe

public boolean engineIsThreadSafe()

Description copied from class: ResourceResolverSpi

Tells if the implementation does can be reused by several threads safely. It normally means that the implementation does not have any member, or there is member change between engineCanResolve and engineResolve invocations. Or it maintains all member info in ThreadLocal methods.

Overrides:

engineIsThreadSafe in class ResourceResolverSpi

engineResolveURI

public XMLSignatureInput engineResolveURI(ResourceResolverContext context)
                                   throws ResourceResolverException

This is the workhorse method used to resolve resources.

Specified by:

engineResolveURI in class ResourceResolverSpi

Parameters:

context - Context to use to resolve resources.

Returns:

the resource wrapped around a XMLSignatureInput

Throws:

ResourceResolverException

openConnection

private URLConnection openConnection(URL url)
                              throws IOException

Throws:

IOException

engineCanResolveURI

public boolean engineCanResolveURI(ResourceResolverContext context)

We resolve http URIs without fragment...

Specified by:

engineCanResolveURI in class ResourceResolverSpi

Parameters:

context -

Returns:

true if can be resolved

engineGetPropertyKeys

public String[] engineGetPropertyKeys()

Method engineGetPropertyKeys

Overrides:

engineGetPropertyKeys in class ResourceResolverSpi

Returns:

the property keys

getNewURI

private static URI getNewURI(String uri,
 String baseURI)
                      throws URISyntaxException

Throws:

URISyntaxException