com.browserup.bup.proxy.dns

Class BasicHostResolver

java.lang.Object

com.browserup.bup.proxy.dns.BasicHostResolver

All Implemented Interfaces:

AdvancedHostResolver, HostResolver

public abstract class BasicHostResolver
extends java.lang.Object
implements AdvancedHostResolver

An AdvancedHostResolver that throws UnsupportedOperationException on all methods except HostResolver.resolve(String). Use this class to supply a HostResolver to BrowserUpProxy.setHostNameResolver(AdvancedHostResolver) if you do not need AdvancedHostResolver functionality.

Constructor Summary

Constructors

Constructor and Description
BasicHostResolver()

Method Summary

Modifier and Type	Method and Description
void	clearDNSCache() Clears both the positive (successful DNS lookups) and negative (failed DNS lookups) cache.
void	clearHostRemappings() Removes all hostname remappings.
java.util.Map<java.lang.String,java.lang.String>	getHostRemappings() Returns all host remappings in effect.
java.util.Collection<java.lang.String>	getOriginalHostnames(java.lang.String remappedHost) Returns the original address or addresses that are remapped to the specified remappedHost.
void	remapHost(java.lang.String originalHost, java.lang.String remappedHost) Remaps an individual host.
void	remapHosts(java.util.Map<java.lang.String,java.lang.String> hostRemappings) Replaces the host remappings in the existing list of remappings (if any) with the specified remappings.
void	removeHostRemapping(java.lang.String originalHost) Removes the specified host remapping.
void	setNegativeDNSCacheTimeout(int timeout, java.util.concurrent.TimeUnit timeUnit) Sets the negative (failed DNS lookup) timeout when making DNS lookups.
void	setPositiveDNSCacheTimeout(int timeout, java.util.concurrent.TimeUnit timeUnit) Sets the positive (successful DNS lookup) timeout when making DNS lookups.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.browserup.bup.proxy.dns.HostResolver

resolve

Constructor Detail

BasicHostResolver

public BasicHostResolver()

Method Detail

remapHosts

public void remapHosts(java.util.Map<java.lang.String,java.lang.String> hostRemappings)

Description copied from interface: AdvancedHostResolver

Replaces the host remappings in the existing list of remappings (if any) with the specified remappings. The remappings will be applied in the order specified by the Map's iterator. Note: The original hostnames must exactly match the requested hostname. It is not a domain or regular expression match.

Specified by:

remapHosts in interface AdvancedHostResolver

Parameters:

hostRemappings - Map of <original hostname, remapped hostname>

remapHost

public void remapHost(java.lang.String originalHost,
                      java.lang.String remappedHost)

Description copied from interface: AdvancedHostResolver

Remaps an individual host. If there are any existing remappings, the new remapping will be applied last, after all existing remappings are applied. If there is already a remapping for the specified originalHost, it will be removed before the new remapping is added to the end of the host remapping list (and will therefore be the last remapping applied).

Specified by:

remapHost in interface AdvancedHostResolver

Parameters:

originalHost - Original host to remap. Must exactly match the requested hostname (not a domain or regular expression match).

remappedHost - hostname that will replace originalHost

removeHostRemapping

public void removeHostRemapping(java.lang.String originalHost)

Description copied from interface: AdvancedHostResolver

Removes the specified host remapping. If the remapping does not exist, this method has no effect.

Specified by:

removeHostRemapping in interface AdvancedHostResolver

Parameters:

originalHost - currently-remapped hostname

clearHostRemappings

public void clearHostRemappings()

Description copied from interface: AdvancedHostResolver

Removes all hostname remappings.

Specified by:

clearHostRemappings in interface AdvancedHostResolver

getHostRemappings

public java.util.Map<java.lang.String,java.lang.String> getHostRemappings()

Description copied from interface: AdvancedHostResolver

Returns all host remappings in effect. Iterating over the returned Map is guaranteed to return remappings in the order in which the remappings are actually applied.

Specified by:

getHostRemappings in interface AdvancedHostResolver

Returns:

Map of <original hostname, remapped hostname>

getOriginalHostnames

public java.util.Collection<java.lang.String> getOriginalHostnames(java.lang.String remappedHost)

Description copied from interface: AdvancedHostResolver

Returns the original address or addresses that are remapped to the specified remappedHost. Iterating over the returned Collection is guaranteed to return original mappings in the order in which the remappings are applied.

Specified by:

getOriginalHostnames in interface AdvancedHostResolver

Parameters:

remappedHost - remapped hostname

Returns:

original hostnames that are remapped to the specified remappedHost, or an empty Collection if no remapping is defined to the remappedHost

clearDNSCache

public void clearDNSCache()

Description copied from interface: AdvancedHostResolver

Clears both the positive (successful DNS lookups) and negative (failed DNS lookups) cache.

Specified by:

clearDNSCache in interface AdvancedHostResolver

setPositiveDNSCacheTimeout

public void setPositiveDNSCacheTimeout(int timeout,
                                       java.util.concurrent.TimeUnit timeUnit)

Description copied from interface: AdvancedHostResolver

Sets the positive (successful DNS lookup) timeout when making DNS lookups. Note: The timeUnit parameter does not guarantee the specified precision; implementations may need to reduce precision, depending on the underlying DNS implementation. For example, the Oracle JVM's DNS cache only supports timeouts in whole seconds, so specifying a timeout of 1200ms will result in a timeout of 1 second.

Specified by:

setPositiveDNSCacheTimeout in interface AdvancedHostResolver

Parameters:

timeout - maximum lookup time

timeUnit - units of the timeout value

setNegativeDNSCacheTimeout

public void setNegativeDNSCacheTimeout(int timeout,
                                       java.util.concurrent.TimeUnit timeUnit)

Description copied from interface: AdvancedHostResolver

Sets the negative (failed DNS lookup) timeout when making DNS lookups. Note: The timeUnit parameter does not guarantee the specified precision; implementations may need to reduce precision, depending on the underlying DNS implementation. For example, the Oracle JVM's DNS cache only supports timeouts in whole seconds, so specifying a timeout of 1200ms will result in a timeout of 1 second.

Specified by:

setNegativeDNSCacheTimeout in interface AdvancedHostResolver

Parameters:

timeout - maximum lookup time

timeUnit - units of the timeout value