Contact.java

/*
    This file is part of Project MAXS.

    MAXS and its modules is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    MAXS is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with MAXS.  If not, see <http://www.gnu.org/licenses/>.
 */

package org.projectmaxs.shared.global.messagecontent;

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

import android.os.Parcel;

public class Contact extends AbstractElement {
	private final String mDisplayName;
	private final List<ContactNumber> mNumbers = new ArrayList<ContactNumber>(1);

	private String mLookupKey;
	private String mNickname;

	public Contact() {
		mDisplayName = null;
	}

	public Contact(String displayName) {
		mDisplayName = displayName;
	}

	public Contact(String displayName, String lookupKey) {
		mDisplayName = displayName;
		mLookupKey = lookupKey;
	}

	private Contact(Parcel in) {
		mDisplayName = in.readString();
		in.readList(mNumbers, ContactNumber.class.getClassLoader());
		mLookupKey = in.readString();
		mNickname = in.readString();
	}

	public void addNumber(String number, int type, String label, boolean superPrimary) {
		mNumbers.add(new ContactNumber(number, type, label, superPrimary));
	}

	public Contact addNumber(String number) {
		mNumbers.add(new ContactNumber(number));
		return this;
	}

	/**
	 * Check if the contact has at least one number
	 * 
	 * @return true if the contact has at least one number
	 */
	public boolean hasNumbers() {
		return mNumbers.size() > 0;
	}

	public ContactNumber getBestNumber(ContactNumber.NumberType numberType) {
		return ContactNumber.getBest(mNumbers, numberType);
	}

	public List<ContactNumber> getNumbers() {
		return mNumbers;
	}

	public void setNickname(String nickname) {
		mNickname = nickname;
	}

	public String getDisplayName() {
		return mDisplayName;
	}

	public String getLookupKey() {
		return mLookupKey;
	}

	/**
	 * Get a new Contact with minimal information set. That is, only display
	 * name and lookup key are set.
	 * 
	 * This method needs to have lookup key set or it will throw an Exception.
	 * 
	 * @return A new contact with minimal information set.
	 */
	public Contact getMinimal() {
		if (mLookupKey == null) throw new IllegalStateException("lookup key not set");
		return new Contact(mDisplayName, mLookupKey);
	}

	@Override
	public int describeContents() {
		return 0;
	}

	@Override
	public void writeToParcel(Parcel dest, int flags) {
		dest.writeString(mDisplayName);
		dest.writeList(mNumbers);
		dest.writeString(mLookupKey);
		dest.writeString(mNickname);
	}

	public static final Creator<Contact> CREATOR = new Creator<Contact>() {

		@Override
		public Contact createFromParcel(Parcel source) {
			return new Contact(source);
		}

		@Override
		public Contact[] newArray(int size) {
			return new Contact[size];
		}

	};

	@Override
	public String toString() {
		StringBuilder sb = new StringBuilder();
		sb.append("Contact ");
		sb.append("name=" + (mDisplayName == null ? "noName" : mDisplayName));

		ContactNumber number = getBestNumber(null);
		if (number != null) sb.append(" bestNumber='" + number.toString() + "'");

		return sb.toString();
	}
}