    View Javadoc
    1   package org.apache.commons.net.smtp;
    2
    3   /* ====================================================================
    4    * The Apache Software License, Version 1.1
    5    *
    6    * Copyright (c) 2001 The Apache Software Foundation.  All rights
    7    * reserved.
    8    *
    9    * Redistribution and use in source and binary forms, with or without
    10   * modification, are permitted provided that the following conditions
    11   * are met:
    12   *
    13   * 1. Redistributions of source code must retain the above copyright
    14   *    notice, this list of conditions and the following disclaimer.
    15   *
    16   * 2. Redistributions in binary form must reproduce the above copyright
    17   *    notice, this list of conditions and the following disclaimer in
    18   *    the documentation and/or other materials provided with the
    19   *    distribution.
    20   *
    21   * 3. The end-user documentation included with the redistribution,
    22   *    if any, must include the following acknowledgment:
    23   *       "This product includes software developed by the
    24   *        Apache Software Foundation (http://www.apache.org/)."
    25   *    Alternately, this acknowledgment may appear in the software itself,
    26   *    if and wherever such third-party acknowledgments normally appear.
    27   *
    28   * 4. The names "Apache" and "Apache Software Foundation" and
    29   *    "Apache Commons" must not be used to endorse or promote products
    30   *    derived from this software without prior written permission. For
    31   *    written permission, please contact apache@apache.org.
    32   *
    33   * 5. Products derived from this software may not be called "Apache",
    34   *    nor may "Apache" appear in their name, without
    35   *    prior written permission of the Apache Software Foundation.
    36   *
    37   * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
    38   * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
    39   * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
    40   * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
    41   * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    42   * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
    43   * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
    44   * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
    45   * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
    46   * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
    47   * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
    48   * SUCH DAMAGE.
    49   * ====================================================================
    50   *
    51   * This software consists of voluntary contributions made by many
    52   * individuals on behalf of the Apache Software Foundation.  For more
    53   * information on the Apache Software Foundation, please see
    54   * <http://www.apache.org/>;.
    55   */
    56
    57  import java.util.Enumeration;
    58  import java.util.Vector;
    59
    60  /****
    61   * A class used to represent forward and reverse relay paths.  The
    62   * SMTP MAIL command requires a reverse relay path while the SMTP RCPT
    63   * command requires a forward relay path.  See RFC 821 for more details.
    64   * In general, you will not have to deal with relay paths.
    65   * <p>
    66   * <p>
    67   * @author Daniel F. Savarese
    68   * @see SMTPClient
    69   ***/
    70
    71  public final class RelayPath
    72  {
    73      Vector _path;
    74      String _emailAddress;
    75
    76      /****
    77       * Create a relay path with the specified email address as the ultimate
    78       * destination.
    79       * <p>
    80       * @param emailAddress The destination email address.
    81       ***/
    82      public RelayPath(String emailAddress)
    83      {
    84          _path = new Vector();
    85          _emailAddress = emailAddress;
    86      }
    87
    88      /****
    89       * Add a mail relay host to the relay path.  Hosts are added left to
    90       * right.  For example, the following will create the path
    91       * <code><b> < @bar.com,@foo.com:foobar@foo.com > </b></code>
    92       * <pre>
    93       * path = new RelayPath("foobar@foo.com");
    94       * path.addRelay("bar.com");
    95       * path.addRelay("foo.com");
    96       * </pre>
    97       * <p>
    98       * @param hostname The host to add to the relay path.
    99       ***/
    100     public void addRelay(String hostname)
    101     {
    102         _path.addElement(hostname);
    103     }
    104
    105     /****
    106      * Return the properly formatted string representation of the relay path.
    107      * <p>
    108      * @return The properly formatted string representation of the relay path.
    109      ***/
    110     public String toString()
    111     {
    112         StringBuffer buffer = new StringBuffer();
    113         Enumeration hosts;
    114
    115         buffer.append('<');
    116
    117         hosts = _path.elements();
    118
    119         if (hosts.hasMoreElements())
    120         {
    121             buffer.append('@');
    122             buffer.append((String)hosts.nextElement());
    123
    124             while (hosts.hasMoreElements())
    125             {
    126                 buffer.append(",@");
    127                 buffer.append((String)hosts.nextElement());
    128             }
    129             buffer.append(':');
    130         }
    131
    132         buffer.append(_emailAddress);
    133         buffer.append('>');
    134
    135         return buffer.toString();
    136     }
    137
    138 }

This page was automatically generated by Maven