SimpleResolver (dnsjava documentation)

java.lang.Object
- org.xbill.DNS.SimpleResolver

All Implemented Interfaces:

Resolver
```
public class SimpleResolver
extends Object
implements Resolver
```
An implementation of Resolver that sends one query to one server. SimpleResolver handles TCP retries, transaction security (TSIG), and EDNS 0.

Author:

Brian Wellington

See Also:

Resolver, TSIG, OPTRecord

Field Summary

Fields
Modifier and Type Field and Description

static int DEFAULT_EDNS_PAYLOADSIZE
The default EDNS payload size

static int DEFAULT_PORT
The default port to send queries to

Fields
Modifier and Type	Field and Description
`static int`	`DEFAULT_EDNS_PAYLOADSIZE` The default EDNS payload size
`static int`	`DEFAULT_PORT` The default port to send queries to

Constructor Summary

Constructors
Constructor and Description
`SimpleResolver()` Creates a SimpleResolver.
`SimpleResolver(InetAddress host)` Creates a SimpleResolver that will query the specified host
`SimpleResolver(InetSocketAddress host)` Creates a SimpleResolver that will query the specified host
`SimpleResolver(String hostname)` Creates a SimpleResolver that will query the specified host

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`InetSocketAddress`	`getAddress()` Gets the destination address associated with this SimpleResolver.
`OPTRecord`	`getEDNS()` Gets the EDNS information on outgoing messages.
`boolean`	`getIgnoreTruncation()` Gets whether truncated responses will be ignored.
`int`	`getPort()` Gets the port to communicate with on the server
`boolean`	`getTCP()` Gets whether TCP connections will be used by default
`Duration`	`getTimeout()` Gets the amount of time to wait for a response before giving up.
`TSIG`	`getTSIGKey()` Get the TSIG key that messages will be signed with.
`CompletionStage<Message>`	`sendAsync(Message query)` Asynchronously sends a message to a single server, registering a listener to receive a callback on success or exception.
`void`	`setAddress(InetAddress addr)` Sets the address of the server to communicate with (on the default DNS port)
`void`	`setAddress(InetSocketAddress addr)` Sets the address of the server to communicate with.
`static void`	`setDefaultResolver(InetSocketAddress hostname)` Sets the default host (initially localhost) to query
`static void`	`setDefaultResolver(String hostname)` Sets the default host (initially localhost) to query
`void`	`setEDNS(int version, int payloadSize, int flags, List<EDNSOption> options)` Sets the EDNS information on outgoing messages.
`void`	`setEDNS(OPTRecord optRecord)` Sets the EDNS information on outgoing messages.
`void`	`setIgnoreTruncation(boolean flag)` Sets whether truncated responses will be ignored.
`void`	`setLocalAddress(InetAddress addr)` Sets the local address to bind to when sending messages.
`void`	`setLocalAddress(InetSocketAddress addr)` Sets the local address to bind to when sending messages.
`void`	`setPort(int port)` Sets the port to communicate with on the server
`void`	`setTCP(boolean flag)` Sets whether TCP connections will be used by default
`void`	`setTimeout(Duration timeout)` Sets the amount of time to wait for a response before giving up.
`void`	`setTSIGKey(TSIG key)` Specifies the TSIG key that messages will be signed with
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.xbill.DNS.Resolver
send, sendAsync, setEDNS, setEDNS, setTimeout, setTimeout

- Field Detail
  - DEFAULT_PORT
```
public static final int DEFAULT_PORT
```
    The default port to send queries to
    
    See Also:
    
    Constant Field Values
  - DEFAULT_EDNS_PAYLOADSIZE
```
public static final int DEFAULT_EDNS_PAYLOADSIZE
```
    The default EDNS payload size
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - SimpleResolver
```
public SimpleResolver()
               throws UnknownHostException
```
    Creates a SimpleResolver. The host to query is either found by using ResolverConfig, or the default host is used.
    
    Throws:
    
    UnknownHostException - Failure occurred while finding the host
    
    See Also:
    
    ResolverConfig
  - SimpleResolver
```
public SimpleResolver(String hostname)
               throws UnknownHostException
```
    Creates a SimpleResolver that will query the specified host
    
    Throws:
    
    UnknownHostException - Failure occurred while finding the host
  - SimpleResolver
```
public SimpleResolver(InetSocketAddress host)
```
    Creates a SimpleResolver that will query the specified host
  - SimpleResolver
```
public SimpleResolver(InetAddress host)
```
    Creates a SimpleResolver that will query the specified host
- Method Detail
  - getAddress
```
public InetSocketAddress getAddress()
```
    Gets the destination address associated with this SimpleResolver. Messages sent using this SimpleResolver will be sent to this address.
    
    Returns:
    
    The destination address associated with this SimpleResolver.
  - setDefaultResolver
```
public static void setDefaultResolver(InetSocketAddress hostname)
```
    Sets the default host (initially localhost) to query
  - setDefaultResolver
```
public static void setDefaultResolver(String hostname)
```
    Sets the default host (initially localhost) to query
  - getPort
```
public int getPort()
```
    Gets the port to communicate with on the server
    
    Since:
    
    3.2
  - setPort
```
public void setPort(int port)
```
    Description copied from interface: Resolver
    
    Sets the port to communicate with on the server
    
    Specified by:
    
    setPort in interface Resolver
    
    Parameters:
    
    port - The port to send messages to
  - setAddress
```
public void setAddress(InetSocketAddress addr)
```
    Sets the address of the server to communicate with.
    
    Parameters:
    
    addr - The address of the DNS server
  - setAddress
```
public void setAddress(InetAddress addr)
```
    Sets the address of the server to communicate with (on the default DNS port)
    
    Parameters:
    
    addr - The address of the DNS server
  - setLocalAddress
```
public void setLocalAddress(InetSocketAddress addr)
```
    Sets the local address to bind to when sending messages.
    
    Parameters:
    
    addr - The local address to send messages from.
  - setLocalAddress
```
public void setLocalAddress(InetAddress addr)
```
    Sets the local address to bind to when sending messages. A random port will be used.
    
    Parameters:
    
    addr - The local address to send messages from.
  - getTCP
```
public boolean getTCP()
```
    Gets whether TCP connections will be used by default
    
    Since:
    
    3.2
  - setTCP
```
public void setTCP(boolean flag)
```
    Description copied from interface: Resolver
    
    Sets whether TCP connections will be used by default
    
    Specified by:
    
    setTCP in interface Resolver
    
    Parameters:
    
    flag - Indicates whether TCP connections are made
  - getIgnoreTruncation
```
public boolean getIgnoreTruncation()
```
    Gets whether truncated responses will be ignored.
    
    Since:
    
    3.2
  - setIgnoreTruncation
```
public void setIgnoreTruncation(boolean flag)
```
    Description copied from interface: Resolver
    
    Sets whether truncated responses will be ignored. If not, a truncated response over UDP will cause a retransmission over TCP.
    
    Specified by:
    
    setIgnoreTruncation in interface Resolver
    
    Parameters:
    
    flag - Indicates whether truncated responses should be ignored.
  - getEDNS
```
public OPTRecord getEDNS()
```
    Gets the EDNS information on outgoing messages.
    
    Returns:
    
    The current OPTRecord for EDNS or null if EDNS is disabled.
    
    Since:
    
    3.2
  - setEDNS
```
public void setEDNS(OPTRecord optRecord)
```
    Sets the EDNS information on outgoing messages.
    
    Parameters:
    
    optRecord - the OPTRecord for EDNS options or null to disable EDNS.
    
    Since:
    
    3.2
    
    See Also:
    
    setEDNS(int, int, int, List)
  - setEDNS
```
public void setEDNS(int version,
                    int payloadSize,
                    int flags,
                    List<EDNSOption> options)
```
    Description copied from interface: Resolver
    
    Sets the EDNS information on outgoing messages.
    
    Specified by:
    
    setEDNS in interface Resolver
    
    Parameters:
    
    version - The EDNS version to use. 0 indicates EDNS0 and -1 indicates no EDNS.
    
    payloadSize - The maximum DNS packet size that this host is capable of receiving over UDP. If 0 is specified, the default (1280) is used.
    
    flags - EDNS extended flags to be set in the OPT record.
    
    options - EDNS options to be set in the OPT record, specified as a List of OPTRecord.Option elements.
    
    See Also:
    
    OPTRecord
  - getTSIGKey
```
public TSIG getTSIGKey()
```
    Get the TSIG key that messages will be signed with.
    
    Returns:
    
    the TSIG signature for outgoing messages or null if not specified.
    
    Since:
    
    3.2
  - setTSIGKey
```
public void setTSIGKey(TSIG key)
```
    Description copied from interface: Resolver
    
    Specifies the TSIG key that messages will be signed with
    
    Specified by:
    
    setTSIGKey in interface Resolver
    
    Parameters:
    
    key - The key
  - setTimeout
```
public void setTimeout(Duration timeout)
```
    Description copied from interface: Resolver
    
    Sets the amount of time to wait for a response before giving up.
    
    Specified by:
    
    setTimeout in interface Resolver
    
    Parameters:
    
    timeout - The amount of time to wait.
  - getTimeout
```
public Duration getTimeout()
```
    Description copied from interface: Resolver
    
    Gets the amount of time to wait for a response before giving up.
    
    Specified by:
    
    getTimeout in interface Resolver
    
    See Also:
    
    Resolver.setTimeout(Duration)
  - sendAsync
```
public CompletionStage<Message> sendAsync(Message query)
```
    Asynchronously sends a message to a single server, registering a listener to receive a callback on success or exception. Multiple asynchronous lookups can be performed in parallel. Since the callback may be invoked before the function returns, external synchronization is necessary.
    
    Specified by:
    
    sendAsync in interface Resolver
    
    Parameters:
    
    query - The query to send
    
    Returns:
    
    A future that completes when the response has arrived.
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object

Class SimpleResolver

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface org.xbill.DNS.Resolver

Field Detail

DEFAULT_PORT

DEFAULT_EDNS_PAYLOADSIZE

Constructor Detail

SimpleResolver

SimpleResolver

SimpleResolver

SimpleResolver

Method Detail

getAddress

setDefaultResolver

setDefaultResolver

getPort

setPort

setAddress

setAddress

setLocalAddress

setLocalAddress

getTCP

setTCP

getIgnoreTruncation

setIgnoreTruncation

getEDNS

setEDNS

setEDNS

getTSIGKey

setTSIGKey

setTimeout

getTimeout

sendAsync

toString