net.lightbody.bmp.proxy.dns

Class DnsJavaResolver

java.lang.Object

net.lightbody.bmp.proxy.dns.AbstractHostNameRemapper

net.lightbody.bmp.proxy.dns.DnsJavaResolver

All Implemented Interfaces:

AdvancedHostResolver, HostResolver

public class DnsJavaResolver
extends AbstractHostNameRemapper
implements AdvancedHostResolver

An AdvancedHostResolver that uses dnsjava to perform DNS lookups. This implementation provides full cache manipulation capabilities.

Constructor Summary

Constructors

Constructor and Description
DnsJavaResolver()

Method Summary

Modifier and Type	Method and Description
void	clearDNSCache() Clears both the positive (successful DNS lookups) and negative (failed DNS lookups) cache.
protected Collection<InetAddress>	resolveHostByType(String host, int type) Resolves the specified host using dnsjava, retrieving addresses of the specified type.
Collection<InetAddress>	resolveRemapped(String remappedHost) Resolves the specified remapped host.
void	setNegativeDNSCacheTimeout(int timeout, TimeUnit timeUnit) Sets the negative (failed DNS lookup) timeout when making DNS lookups.
void	setPositiveDNSCacheTimeout(int timeout, TimeUnit timeUnit) Sets the positive (successful DNS lookup) timeout when making DNS lookups.

Methods inherited from class net.lightbody.bmp.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 net.lightbody.bmp.proxy.dns.AdvancedHostResolver

clearHostRemappings, getHostRemappings, getOriginalHostnames, remapHost, remapHosts, removeHostRemapping

Methods inherited from interface net.lightbody.bmp.proxy.dns.HostResolver

resolve

Constructor Detail

DnsJavaResolver

public DnsJavaResolver()

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,
                                       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,
                                       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 Collection<InetAddress> resolveRemapped(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

resolveHostByType

protected Collection<InetAddress> resolveHostByType(String host,
                                                    int type)

Resolves the specified host using dnsjava, retrieving addresses of the specified type.

Parameters:

host - hostname to resolve

type - one of Type, typically Type.A (IPv4) or Type.AAAA (IPv6).

Returns:

resolved addresses, or an empty collection if no addresses could be resolved