org.xbill.DNS
Class ExtendedResolver

java.lang.Object
  |
  +--org.xbill.DNS.ExtendedResolver

public class ExtendedResolver

extends Object

implements Resolver

An implementation of Resolver that can send queries to multiple servers, sending the queries multiple times if necessary.

See Also:

Resolver

Constructor Summary

ExtendedResolver()
Creates a new Extended Resolver.

ExtendedResolver(Resolver[] res)
Creates a new Extended Resolver

ExtendedResolver(String[] servers)
Creates a new Extended Resolver

Method Summary

void	addResolver(Resolver r) Adds a new resolver to be used by this ExtendedResolver
void	deleteResolver(Resolver r) Deletes a resolver used by this ExtendedResolver
Resolver	getResolver(int i) Returns the i'th resolver used by this ExtendedResolver
Resolver[]	getResolvers() Returns all resolvers used by this ExtendedResolver
Message	send(Message query) Sends a message, and waits for a response.
Object	sendAsync(Message query, ResolverListener listener) Asynchronously sends a message, registering a listener to receive a callback Multiple asynchronous lookups can be performed in parallel.
void	setEDNS(int level) Sets the EDNS version used on outgoing messages (only 0 is meaningful)
void	setIgnoreTruncation(boolean flag) Sets whether truncated responses will be returned
void	setLoadBalance(boolean flag) Sets whether the servers should be load balanced.
void	setPort(int port) Sets the port to communicate with on the servers
void	setTCP(boolean flag) Sets whether TCP connections will be sent by default
void	setTimeout(int secs) Sets the amount of time to wait for a response before giving up
void	setTSIGKey(Name name, byte[] key) Specifies the TSIG key that messages will be signed with
void	setTSIGKey(String key) Specifies the TSIG key (with the same name as the local host) that messages will be signed with
void	setTSIGKey(String name, String key) Specifies the TSIG key that messages will be signed with

Methods inherited from class java.lang.Object

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

Constructor Detail

ExtendedResolver

public ExtendedResolver()
                 throws UnknownHostException

Creates a new Extended Resolver. FindServer is used to locate the servers for which SimpleResolver contexts should be initialized.

Throws:

UnknownHostException - Failure occured initializing SimpleResolvers

See Also:

SimpleResolver, FindServer

ExtendedResolver

public ExtendedResolver(String[] servers)
                 throws UnknownHostException

Creates a new Extended Resolver

Parameters:

servers - An array of server names for which SimpleResolver contexts should be initialized.

Throws:

UnknownHostException - Failure occured initializing SimpleResolvers

See Also:

SimpleResolver

ExtendedResolver

public ExtendedResolver(Resolver[] res)
                 throws UnknownHostException

Creates a new Extended Resolver

Parameters:

res - An array of pre-initialized Resolvers is provided.

Throws:

UnknownHostException - Failure occured initializing SimpleResolvers

See Also:

SimpleResolver

Method Detail

setPort

public void setPort(int port)

Sets the port to communicate with on the servers

Specified by:

setPort in interface Resolver

setTCP

public void setTCP(boolean flag)

Sets whether TCP connections will be sent by default

Specified by:

setTCP in interface Resolver

setIgnoreTruncation

public void setIgnoreTruncation(boolean flag)

Sets whether truncated responses will be returned

Specified by:

setIgnoreTruncation in interface Resolver

setEDNS

public void setEDNS(int level)

Sets the EDNS version used on outgoing messages (only 0 is meaningful)

Specified by:

setEDNS in interface Resolver

setTSIGKey

public void setTSIGKey(Name name,
                       byte[] key)

Specifies the TSIG key that messages will be signed with

Specified by:

setTSIGKey in interface Resolver

setTSIGKey

public void setTSIGKey(String name,
                       String key)

Specifies the TSIG key that messages will be signed with

Specified by:

setTSIGKey in interface Resolver

setTSIGKey

public void setTSIGKey(String key)

Specifies the TSIG key (with the same name as the local host) that messages will be signed with

Specified by:

setTSIGKey in interface Resolver

setTimeout

public void setTimeout(int secs)

Sets the amount of time to wait for a response before giving up

Specified by:

setTimeout in interface Resolver

send

public Message send(Message query)
             throws IOException

Sends a message, and waits for a response. Multiple servers are queried, and queries are sent multiple times until either a successful response is received, or it is clear that there is no successful response.

Specified by:

send in interface Resolver

Returns:

The response

sendAsync

public Object sendAsync(Message query,
                        ResolverListener listener)

Asynchronously sends a message, registering a listener to receive a callback Multiple asynchronous lookups can be performed in parallel.

Specified by:

sendAsync in interface Resolver

Returns:

An identifier

getResolver

public Resolver getResolver(int i)

Returns the i'th resolver used by this ExtendedResolver

getResolvers

public Resolver[] getResolvers()

Returns all resolvers used by this ExtendedResolver

addResolver

public void addResolver(Resolver r)

Adds a new resolver to be used by this ExtendedResolver

deleteResolver

public void deleteResolver(Resolver r)

Deletes a resolver used by this ExtendedResolver

setLoadBalance

public void setLoadBalance(boolean flag)

Sets whether the servers should be load balanced.

Parameters:

flag - If true, servers will be tried in round-robin order. If false, servers will always be queried in the same order.