Performance improvement:

[jvcard.git] / src / be / nikiroo / jvcard / parsers / Parser.java

package be.nikiroo.jvcard.parsers;

import java.io.BufferedReader;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStreamReader;
import java.security.InvalidParameterException;
import java.util.LinkedList;
import java.util.List;

import be.nikiroo.jvcard.Card;
import be.nikiroo.jvcard.Contact;
import be.nikiroo.jvcard.Data;

public class Parser {

	/**
	 * Load the data from the given {@link File} under the given {@link Format}.
	 * 
	 * @param file
	 *            the input to load from
	 * @param format
	 *            the {@link Format} to load as
	 * 
	 * @return the list of elements
	 * 
	 * @throws IOException
	 *             in case of IO error
	 */
	public static List<Contact> parseContact(File file, Format format)
			throws IOException {
		List<String> lines = null;

		if (file != null && file.exists()) {
			BufferedReader buffer = new BufferedReader(new InputStreamReader(
					new FileInputStream(file), "UTF-8"));
			lines = new LinkedList<String>();
			for (String line = buffer.readLine(); line != null; line = buffer
					.readLine()) {
				lines.add(line);
			}
			buffer.close();
		}

		if (lines == null)
			return new LinkedList<Contact>();

		return parseContact(lines, format);
	}

	/**
	 * Load the given data from under the given {@link Format}.
	 * 
	 * @param lines
	 *            the input to load from
	 * @param format
	 *            the {@link Format} to load as
	 * 
	 * @return the list of elements
	 */
	public static List<Contact> parseContact(List<String> lines, Format format) {
		switch (format) {
		case VCard21:
			return Vcard21Parser.parseContact(lines);
		case Abook:
			return AbookParser.parseContact(lines);

		default:
			throw new InvalidParameterException("Unknown format: "
					+ format.toString());
		}
	}

	/**
	 * Write the given {@link Card} in the {@link Appendable}.
	 * 
	 * @param writer
	 *            the {@link Appendable}
	 * @param card
	 *            the {@link Card} to write
	 * @param format
	 *            the {@link Format} to export to
	 * 
	 * @throws IOException
	 *             in case of IO error
	 */
	public static void write(Appendable writer, Format format, Card card)
			throws IOException {
		switch (format) {
		case VCard21:
			Vcard21Parser.write(writer, card);
			break;
		case Abook:
			AbookParser.write(writer, card);
			break;
		default:
			throw new InvalidParameterException("Unknown format: "
					+ format.toString());
		}
	}

	/**
	 * Write the given {@link Contact} in the {@link Appendable}.
	 * 
	 * @param writer
	 *            the {@link Appendable}
	 * @param contact
	 *            the {@link Contact} to write
	 * @param startingBKey
	 *            the starting BKey number (all the other will follow) or -1 for
	 *            no BKey
	 * @param format
	 *            the {@link Format} to export to
	 * 
	 * @throws IOException
	 *             in case of IO error
	 */
	public static void write(Appendable writer, Contact contact, Format format,
			int startingBKey) throws IOException {
		switch (format) {
		case VCard21:
			Vcard21Parser.write(writer, contact, startingBKey);
			break;
		case Abook:
			AbookParser.write(writer, contact, startingBKey);
			break;
		default:
			throw new InvalidParameterException("Unknown format: "
					+ format.toString());
		}
	}

	// return -1 if no bkey
	public static int getBKey(Data data) {
		if (data.isBinary() && data.getValue().startsWith("<HIDDEN_")) {
			try {
				int bkey = Integer.parseInt(data.getValue()
						.replace("<HIDDEN_", "").replace(">", ""));
				if (bkey < 0)
					throw new InvalidParameterException(
							"All bkeys MUST be positive");
				return bkey;
			} catch (NumberFormatException nfe) {
			}
		}

		return -1;
	}

	static String generateBKeyString(int bkey) {
		if (bkey < 0)
			throw new InvalidParameterException("All bkeys MUST be positive");

		return "<HIDDEN_" + bkey + ">";
	}
}