X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=src%2Fbe%2Fnikiroo%2Fjvcard%2FData.java;h=a0ef2e955889d3bd5ea7f5455ccd5ca0a36f48fb;hb=1c03abafc3987d93fa682e7b8758e51bed8a4faf;hp=993533263eaf6d6f2ab09a2d05339b82f0a4af99;hpb=a3b510ab4bf89a7a2a05f3851ffe0f030b8a78f4;p=jvcard.git

diff --git a/src/be/nikiroo/jvcard/Data.java b/src/be/nikiroo/jvcard/Data.java
index 9935332..a0ef2e9 100644
--- a/src/be/nikiroo/jvcard/Data.java
+++ b/src/be/nikiroo/jvcard/Data.java
@@ -1,30 +1,50 @@
 package be.nikiroo.jvcard;
 
 import java.security.InvalidParameterException;
-import java.util.LinkedList;
 import java.util.List;
 
-public class Data {
+/**
+ * A data is a piece of information present in a {@link Contact}. It is
+ * basically a key/value pair with optional types and an optional group name.
+ * 
+ * @author niki
+ *
+ */
+public class Data extends BaseClass<TypeInfo> {
+	public enum DataPart {
+		FN_FAMILY, FN_GIVEN, FN_ADDITIONAL, // Name
+		FN_PRE, FN_POST, // Pre/Post
+		BDAY_YYYY, BDAY_MM, BDAY_DD, // BDay
+		ADR_PBOX, ADR_EXTENDED, ADR_STREET, ADR_CITY, ADR_REGION, ADR_POSTAL_CODE, ADR_COUNTRY
+		// Address
+	}
+
 	private String name;
 	private String value;
 	private String group;
 	private int b64; // -1 = no, 0 = still not ordered, the rest is order
-	private List<TypeInfo> types;
-	private boolean dirty;
-	private Contact parent;
 
+	/**
+	 * Create a new {@link Data} with the given values.
+	 * 
+	 * @param types
+	 *            the types of this {@link Data}
+	 * @param name
+	 *            its name (<b>MUST NOT</b> be NULL)
+	 * @param value
+	 *            its value (<b>MUST NOT</b> be NULL)
+	 * @param group
+	 *            its group if any (or NULL if none)
+	 */
 	public Data(List<TypeInfo> types, String name, String value, String group) {
-		if (types == null) {
-			types = new LinkedList<TypeInfo>();
-		}
+		super(types);
 
-		this.types = types;
-		this.name = name;
-		this.value = value;
+		this.name = name.toUpperCase();
+		this.value = value.toString(); // crash NOW if null
 		this.group = group;
 
 		b64 = -1;
-		for (TypeInfo type : types) {
+		for (TypeInfo type : this) {
 			if (type.getName().equals("ENCODING")
 					&& type.getValue().equals("b")) {
 				b64 = 0;
@@ -33,26 +53,79 @@ public class Data {
 		}
 	}
 
-	public List<TypeInfo> getTypes() {
-		return types;
-	}
-
+	/**
+	 * Return the name of this {@link Data}
+	 * 
+	 * @return the name
+	 */
 	public String getName() {
 		return name;
 	}
 
+	/**
+	 * Return the value of this {@link Data}
+	 * 
+	 * @return the value
+	 */
 	public String getValue() {
 		return value;
 	}
 
+	/**
+	 * Change the value of this {@link Data}
+	 * 
+	 * @param value
+	 *            the new value
+	 */
+	public void setValue(String value) {
+		if ((value == null && this.value != null)
+				|| (value != null && !value.equals(this.value))) {
+			this.value = value;
+			setDirty();
+		}
+	}
+
+	/**
+	 * Return the group of this {@link Data}
+	 * 
+	 * @return the group
+	 */
 	public String getGroup() {
 		return group;
 	}
 
+	/**
+	 * Change the group of this {@link Data}
+	 * 
+	 * @param group
+	 *            the new group
+	 */
+	public void setGroup(String group) {
+		if ((group == null && this.group != null)
+				|| (group != null && !group.equals(this.group))) {
+			this.group = group;
+			setDirty();
+		}
+	}
+
+	/**
+	 * Return the bkey number of this {@link Data} or -1 if it is not binary.
+	 * 
+	 * @return the bkey or -1
+	 */
 	public int getB64Key() {
 		return b64;
 	}
 
+	/**
+	 * Change the bkey of this {@link Data}
+	 * 
+	 * @param i
+	 *            the new bkey
+	 * 
+	 * @throw InvalidParameterException if the {@link Data} is not binary or if
+	 *        it is but you try to set a negative bkey
+	 */
 	void resetB64Key(int i) {
 		if (!isBinary())
 			throw new InvalidParameterException(
@@ -64,15 +137,22 @@ public class Data {
 		b64 = i;
 	}
 
+	/**
+	 * Check if this {@link Data} is binary
+	 * 
+	 * @return TRUE if it is
+	 */
 	public boolean isBinary() {
 		return b64 >= 0;
 	}
 
-	public boolean isDirty() {
-		return dirty;
+	@Override
+	public String getId() {
+		return "" + name;
 	}
 
-	public void setParent(Contact parent) {
-		this.parent = parent;
+	@Override
+	public String getState() {
+		return "" + name + value + group;
 	}
 }