Invitee.java

/*
 * Copyright 2010 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package com.springsource.greenhouse.invite;

import com.springsource.greenhouse.utils.EmailUtils;

/**
 * A person an invite should be, or has been sent to.
 * Someone you would like to see join our community.
 * @author Keith Donald
 */
public final class Invitee {

	private final String firstName;
	
	private final String lastName;
	
	private final String email;

	public Invitee(String firstName, String lastName, String email) {
		this.firstName = firstName;
		this.lastName = lastName;
		if (!EmailUtils.isEmail(email)) {
			throw new IllegalArgumentException("'" + email +  "' is not a valid email address");
		}
		this.email = email;
	}

	/**
	 * The first name of the person.
	 */
	public String getFirstName() {
		return firstName;
	}

	/**
	 * The last name of the person.
	 */
	public String getLastName() {
		return lastName;
	}

	/**
	 * The email address the invite should be sent to.
	 */
	public String getEmail() {
		return email;
	}

	/**
	 * Parse an Invitee instance from a String in the format <code>[firstName] [lastName] <email></code>.
	 * For example: Bob Sanders <bob@sanders.com>.
	 * The first name and last name fields are optional.
	 * If only one name field is provided, it is parsed as the firstName.
	 * @param inviteeString the invitee string to parse
	 * @return the parsed Invitee
	 * @throws IllegalArgumentException if parsing failed due to a format error
	 */
	public static Invitee valueOf(String inviteeString) {
		if (inviteeString == null || inviteeString.length() == 0) {
			throw new IllegalArgumentException("The Invitee string to parse cannot be null or empty");
		}
		String[] pieces = inviteeString.trim().split("[<>]");
		if (pieces.length == 1) {
			return new Invitee(pieces[0]);	
		} else if (pieces.length == 2) {
			String[] name = pieces[0].trim().split(" ");
			String email = pieces[1];
			if (name.length == 1) {
				if (name[0].length() == 0) {
					return new Invitee(email);
				} else {
					return new Invitee(name[0], email);
				}
			} else if (name.length == 2) {
				return new Invitee(name[0], name[1], pieces[1]);
			}
		}
		throw new IllegalArgumentException("Unable to parse invalid invitee string '" + inviteeString + "'");		
	}

	public String toString() {
		if (firstName == null && lastName == null) {
			return email;
		}
		StringBuilder builder = new StringBuilder();
		if (firstName != null) {
			builder.append(firstName);
			builder.append(' ');
		}
		if (lastName != null) {
			builder.append(lastName);
			builder.append(' ');
		}
		builder.append('<').append(email).append('>');
		return builder.toString();
	}
	
	// internal helpers
	
	private Invitee(String email) {
		this(null, null, email);
	}

	private Invitee(String firstName, String email) {
		this(firstName, null, email);
	}

}