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