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