svn commit: r1061739 - in /james/mailet/api/trunk/src/main/java/org/apache/mailet: HostAddress.java MailetContext.java

[bago]

Author: bago
Date: Fri Jan 21 11:08:23 2011
New Revision: 1061739

URL: http://svn.apache.org/viewvc?rev=1061739&view=rev
Log:
Mark older dns lookup methods as deprecated (MAILET-35)

Modified:
    james/mailet/api/trunk/src/main/java/org/apache/mailet/HostAddress.java
    james/mailet/api/trunk/src/main/java/org/apache/mailet/MailetContext.java

Modified: 
james/mailet/api/trunk/src/main/java/org/apache/mailet/HostAddress.java
URL: 
http://svn.apache.org/viewvc/james/mailet/api/trunk/src/main/java/org/apache/mailet/HostAddress.java?rev=1061739&r1=1061738&r2=1061739&view=diff
==============================================================================
--- james/mailet/api/trunk/src/main/java/org/apache/mailet/HostAddress.java 
(original)
+++ james/mailet/api/trunk/src/main/java/org/apache/mailet/HostAddress.java Fri 
Jan 21 11:08:23 2011
@@ -25,6 +25,7 @@ package org.apache.mailet;
  * the name of a URL as well as its corresponding host name.
  * 
  * @since Mailet API v2.3
+ * @deprecated
  */
 public class HostAddress extends javax.mail.URLName {
     private String hostname;

Modified: 
james/mailet/api/trunk/src/main/java/org/apache/mailet/MailetContext.java
URL: 
http://svn.apache.org/viewvc/james/mailet/api/trunk/src/main/java/org/apache/mailet/MailetContext.java?rev=1061739&r1=1061738&r2=1061739&view=diff
==============================================================================
--- james/mailet/api/trunk/src/main/java/org/apache/mailet/MailetContext.java 
(original)
+++ james/mailet/api/trunk/src/main/java/org/apache/mailet/MailetContext.java 
Fri Jan 21 11:08:23 2011
@@ -261,6 +261,8 @@ public interface MailetContext {
      *     
      * @param domain the domain name whose mail handling hosts are requested
      * @return the sorted mail-handling hostnames for the domain
+     * 
+     * @deprecated use the generic dnsLookup method
      */
     Collection<String> getMailServers(String domain);
     
@@ -276,6 +278,8 @@ public interface MailetContext {
      * @param domain the domain whose mail handling SMTP host addresses are 
requested
      * @return an Iterator over HostAddress, in proper order of priority, or
      *         an empty iterator if no hosts are found
+     *         
+     * @deprecated use the generic dnsLookup method
      */
     Iterator<HostAddress> getSMTPHostAddresses(String domain);
 
@@ -358,6 +362,7 @@ public interface MailetContext {
 
     /**
      * Lookups the DNS system for a given record type.
+     * In case of MX records the returned List will be sorted using the 
priority score, ascending.
      * 
      * @param name the host/domain name to lookup
      * @param type the "IN" record type to lookup