panda.net.mail.EmailAddress Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of panda-core Show documentation
Panda Core is the core module of Panda Framework, it contains commonly used utility classes similar to apache-commons.
There is a newer version: 1.8.0
package panda.net.mail;

import java.util.ArrayList;
import java.util.List;

import panda.lang.Objects;
import panda.lang.Regexs;
import panda.lang.Strings;

public class EmailAddress {

	/**
	 * RFC822 specials
	 */
	public final static String RFC822 = "()<>@,;:\\\".[]";

	private String address;
	private String personal;

	public EmailAddress(String address) throws EmailException {
		this(address, null);
	}

	public EmailAddress(String address, String personal) throws EmailException {
		if (Strings.isEmpty(address)) {
			throw new EmailException("Empty email address");
		}
		
		if (!Regexs.isEmail(address)) {
			throw new EmailException("Invalid email address: " + address);
		}

		if (Strings.containsAny(personal, "\"<>")) {
			throw new EmailException("Invalid email personal: " + personal);
		}
		
		this.address = Strings.lowerCase(address);
		this.personal = personal;
	}

	/**
	 * @return the personal
	 */
	public String getPersonal() {
		return personal;
	}

	/**
	 * @param personal the personal to set
	 */
	public void setPersonal(String personal) {
		this.personal = personal;
	}

	/**
	 * @return the address
	 */
	public String getAddress() {
		return address;
	}

	/**
	 * @param address the address to set
	 */
	public void setAddress(String address) {
		this.address = address;
	}

	/**
	 * @return the address's domain
	 */
	public String getDomain() {
		return Strings.substringAfter(address, '@');
	}

	@Override
	public int hashCode() {
		return Objects.hash(address, personal);
	}


	/**
	 * @return true if this object is the same as the obj argument; false
	 *         otherwise.
	 */
	@Override
	public boolean equals(Object obj) {
		if (this == obj) {
			return true;
		}
		if (obj == null) {
			return false;
		}
		if (getClass() != obj.getClass()) {
			return false;
		}
		
		EmailAddress rhs = (EmailAddress)obj;
		return Objects.equalsBuilder()
				.append(address, rhs.address)
				.isEquals();
	}

	@Override
	public String toString() {
		return Strings.defaultString(quote(personal)) + "<" + address + ">";
	}

	//-----------------------------------------------------
	public static List parseList(String rcpts) throws EmailException {
		String[] ss = Strings.split(rcpts, ",;");
		List eas = new ArrayList(ss.length);
		for (String s : ss) {
			eas.add(parse(s));
		}
		return eas;
	}
	
	public static EmailAddress parse(String rcpt) throws EmailException {
		String address = null;
		String personal = null;
		
		int a = rcpt.indexOf('<');
		if (a >= 0) {
			int b = rcpt.indexOf('>', a);
			if (b < 0) {
				throw new EmailException("Invalid email address: " + rcpt);
			}
			address = Strings.strip(rcpt.substring(a + 1, b));
			personal = Strings.strip(unquote(rcpt.substring(0, a)));
		}
		else {
			address = Strings.strip(rcpt);
		}
		return new EmailAddress(address, personal);
	}
	
	public static String quote(String s) {
		if (Strings.isEmpty(s)) {
			return s;
		}
		
		int len = s.length();
		boolean needQuoting = false;

		for (int i = 0; i < len; i++) {
			char c = s.charAt(i);
			if (c == '"' || c == '\\') {
				// need to escape them and then quote the whole string
				StringBuilder sb = new StringBuilder(len + 3);
				sb.append('"');
				for (int j = 0; j < len; j++) {
					char cc = s.charAt(j);
					if (cc == '"' || cc == '\\') {
						// Escape the character
						sb.append('\\');
					}
					sb.append(cc);
				}
				sb.append('"');
				return sb.toString();
			}
			else if ((c < 040 && c != '\r' && c != '\n' && c != '\t') || c >= 0177 || RFC822.indexOf(c) >= 0) {
				// These characters cause the string to be quoted
				needQuoting = true;
			}
		}

		if (needQuoting) {
			StringBuilder sb = new StringBuilder(len + 2);
			sb.append('"').append(s).append('"');
			return sb.toString();
		}

		return s;
	}

	public static String unquote(String s) {
		if (Strings.isEmpty(s)) {
			return s;
		}
		
		if (s.startsWith("\"") && s.endsWith("\"")) {
			s = s.substring(1, s.length() - 1);
			// check for any escaped characters
			if (s.indexOf('\\') >= 0) {
				StringBuilder sb = new StringBuilder(s.length()); // approx
				for (int i = 0; i < s.length(); i++) {
					char c = s.charAt(i);
					if (c == '\\' && i < s.length() - 1)
						c = s.charAt(++i);
					sb.append(c);
				}
				s = sb.toString();
			}
		}
		return s;
	}
}