org.apache.james.services
Interface DNSServer

All Known Implementing Classes:
DNSServer

public interface DNSServer

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.


Field Summary
static java.lang.String ROLE
          The component role used by components implementing this service
 
Method Summary
 java.util.Collection findMXRecords(java.lang.String hostname)
          Get a priority-sorted collection of DNS MX records for a given hostname TODO: Change this to a list, as not all collections are sortable
 java.util.Iterator getSMTPHostAddresses(java.lang.String domainName)
          Performs DNS lookups as needed to find servers which should or might support SMTP.
 

Field Detail

ROLE

static final java.lang.String ROLE
The component role used by components implementing this service

See Also:
Constant Field Values
Method Detail

findMXRecords

java.util.Collection findMXRecords(java.lang.String hostname)

Get a priority-sorted collection of DNS MX records for a given hostname

TODO: Change this to a list, as not all collections are sortable

Parameters:
hostname - the hostname to check
Returns:
collection of strings representing MX record values.

getSMTPHostAddresses

java.util.Iterator getSMTPHostAddresses(java.lang.String domainName)
Performs DNS lookups as needed to find servers which should or might support SMTP. Returns one SMTPHostAddresses for each such host discovered by DNS. If no host is found for domainName, the Iterator returned will be empty and the first call to hasNext() will return false.

Parameters:
domainName - the String domain for which SMTP host addresses are sought.
Returns:
an Enumeration in which the Objects returned by next() are instances of SMTPHostAddresses.


Copyright © 2002-2007 The Apache Software Foundation. All Rights Reserved.