org.apache.james.dnsservice.api

Interface DNSService

All Known Implementing Classes:

DNSJavaService

public interface DNSService

Provides abstraction for DNS resolutions. The interface is Mail specific. It may be a good idea to make the interface more generic or expose commonly needed DNS methods.

Method Summary

Methods

Modifier and Type	Method and Description
Collection<String>	findMXRecords(String hostname) Return a prioritized unmodifiable list of host handling mail for the domain.
Collection<String>	findTXTRecords(String hostname) Get a collection of DNS TXT Records
InetAddress[]	getAllByName(String host) Resolve the given hostname to an array of InetAddress based on the DNS Server.
InetAddress	getByName(String host) Resolve the given hostname to an InetAddress based on the DNS Server.
String	getHostName(InetAddress addr) Resolve the given InetAddress to an host name based on the DNS Server.
InetAddress	getLocalHost() Resolve the local hostname of the machine and returns it.

Method Detail

findMXRecords

Collection<String> findMXRecords(String hostname)
                                 throws TemporaryResolutionException

Return a prioritized unmodifiable list of host handling mail for the domain.

First lookup MX hosts, then MX hosts of the CNAME address, and if no server is found return the IP of the hostname

Parameters:

hostname - domain name to look up

Returns:

a unmodifiable list of handling servers corresponding to this mail domain name

Throws:

TemporaryResolutionException - get thrown on temporary problems

findTXTRecords

Collection<String> findTXTRecords(String hostname)

Get a collection of DNS TXT Records

Parameters:

hostname - The hostname to check

Returns:

collection of strings representing TXT record values

getAllByName

InetAddress[] getAllByName(String host)
                           throws UnknownHostException

Resolve the given hostname to an array of InetAddress based on the DNS Server. It should not take into account the hostnames defined in the local host table

Returns:

An array of InetAddress

Throws:

UnknownHostException

getByName

InetAddress getByName(String host)
                      throws UnknownHostException

Resolve the given hostname to an InetAddress based on the DNS Server. It should not take into account the hostnames defined in the local host table

Returns:

The resolved InetAddress or null if not resolved

Throws:

UnknownHostException

getLocalHost

InetAddress getLocalHost()
                         throws UnknownHostException

Resolve the local hostname of the machine and returns it. It relies on the hostname defined in the local host table

Returns:

The local InetAddress of the machine.

Throws:

UnknownHostException

getHostName

String getHostName(InetAddress addr)

Resolve the given InetAddress to an host name based on the DNS Server. It should not take into account the hostnames defined in the local host table

Returns:

The resolved hostname String or null if not resolved