Package com.browserup.bup.proxy.dns

Class NativeResolver

java.lang.Object

com.browserup.bup.proxy.dns.AbstractHostNameRemapper

com.browserup.bup.proxy.dns.NativeResolver

All Implemented Interfaces:

AdvancedHostResolver, HostResolver

Direct Known Subclasses:

NativeCacheManipulatingResolver

public class NativeResolver
extends AbstractHostNameRemapper
implements AdvancedHostResolver

An AdvancedHostResolver that provides native JVM lookup using InetAddress. This implementation does not provide any cache manipulation. Attempting to manipulate the DNS cache will result in a DEBUG-level log statement and will not raise an exception. The DnsJavaResolver provides support for cache manipulation. If you absolutely need to manipulate the native JVM DNS cache, see NativeCacheManipulatingResolver for details.

Constructor Summary

Constructors

Constructor	Description
NativeResolver()

Method Summary

Modifier and Type	Method	Description
void	clearDNSCache()	Clears both the positive (successful DNS lookups) and negative (failed DNS lookups) cache.
java.util.Collection<java.net.InetAddress>	resolveRemapped(java.lang.String remappedHost)	Resolves the specified remapped host.
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 com.browserup.bup.proxy.dns.AbstractHostNameRemapper

applyRemapping, clearHostRemappings, getHostRemappings, getOriginalHostnames, remapHost, remapHosts, removeHostRemapping, resolve

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.AdvancedHostResolver

clearHostRemappings, getHostRemappings, getOriginalHostnames, remapHost, remapHosts, removeHostRemapping

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

resolve

Constructor Detail

NativeResolver

public NativeResolver()

Method Detail

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

resolveRemapped

public java.util.Collection<java.net.InetAddress> resolveRemapped(java.lang.String remappedHost)

Description copied from class: AbstractHostNameRemapper

Resolves the specified remapped host. Subclasses should provide resolution by implementing this method, rather than overriding HostResolver.resolve(String).

Specified by:

resolveRemapped in class AbstractHostNameRemapper

Parameters:

remappedHost - remapped hostname to resolve

Returns:

resolved InetAddresses, or an empty list if no addresses were found