X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=src%2Fbe%2Fnikiroo%2Fjvcard%2FData.java;h=0484adef9c5b339d270c7b8ad6256a80625299d3;hb=f04a32e97c847d7e2551037a4d5f6a070879215c;hp=63362332004fede408a44ee37d2fc3460fa0a64d;hpb=3634193b7a8927e68a3ae3d38fff4f6bd36c4ee5;p=jvcard.git diff --git a/src/be/nikiroo/jvcard/Data.java b/src/be/nikiroo/jvcard/Data.java index 6336233..0484ade 100644 --- a/src/be/nikiroo/jvcard/Data.java +++ b/src/be/nikiroo/jvcard/Data.java @@ -1,22 +1,25 @@ package be.nikiroo.jvcard; import java.security.InvalidParameterException; +import java.util.LinkedList; import java.util.List; /** - * A data is a piece of information present in a {@link Contact}. It is + * A {@link 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. + *

+ * A {@link Data} can also be binary encoded: in this case, it has an associated + * BKey number to identify it. * * @author niki - * */ public class Data extends BaseClass { public enum DataPart { FN_FAMILY, FN_GIVEN, FN_ADDITIONAL, // Name FN_PRE, FN_POST, // Pre/Post BDAY_YYYY, BDAY_MM, BDAY_DD, // BDay + // Address: ADR_PBOX, ADR_EXTENDED, ADR_STREET, ADR_CITY, ADR_REGION, ADR_POSTAL_CODE, ADR_COUNTRY - // Address } private String name; @@ -68,7 +71,7 @@ public class Data extends BaseClass { * @return the value */ public String getValue() { - return value; + return unescape(value); } /** @@ -78,6 +81,25 @@ public class Data extends BaseClass { * the new value */ public void setValue(String value) { + setRawValue(escape(value)); + } + + /** + * Return the raw value of this {@link Data} + * + * @return the raw value + */ + public String getRawValue() { + return value; + } + + /** + * Change the raw value of this {@link Data} + * + * @param value + * the new raw value + */ + public void setRawValue(String value) { if ((value == null && this.value != null) || (value != null && !value.equals(this.value))) { this.value = value; @@ -85,6 +107,45 @@ public class Data extends BaseClass { } } + /** + * Return the {@link List} of comma-listed values from this {@link Data}. + * + * @return the {@link List} of values + */ + public List getValues() { + return getList(','); + } + + /** + * Set the {@link List} of comma-listed values from this {@link Data}. + * + * @param values + * the {@link List} of values + */ + public void setValues(List values) { + setList(values, ','); + } + + /** + * Return the {@link List} of semi-column-listed fields from this + * {@link Data}. + * + * @return the {@link List} of values + */ + public List getFields() { + return getList(';'); + } + + /** + * Set the {@link List} of comma-listed values from this {@link Data}. + * + * @param values + * the {@link List} of values + */ + public void setFields(List values) { + setList(values, ';'); + } + /** * Return the group of this {@link Data} * @@ -110,13 +171,45 @@ public class Data extends BaseClass { /** * Return the bkey number of this {@link Data} or -1 if it is not binary. + *

+ * For binary data, as long as the BKey is not processed, it will be 0. * - * @return the bkey or -1 + * @return the bkey, 0 or -1 */ public int getB64Key() { return b64; } + /** + * Check if this {@link Data} is binary (in this case, the BKey will be + * present). + * + * @return TRUE if it is + */ + public boolean isBinary() { + return b64 >= 0; + } + + /** + * Return the preferred value of this {@link Data}, or + * {@link Integer#MAX_VALUE} if none. + * + * @return the preferred value + */ + public int getPreferred() { + for (TypeInfo type : this) { + if (type.getName().equals("PRE")) { + try { + return Integer.parseInt(type.getValue()); + } catch (NumberFormatException e) { + e.printStackTrace(); + } + } + } + + return Integer.MAX_VALUE; + } + /** * Change the bkey of this {@link Data} * @@ -138,27 +231,65 @@ public class Data extends BaseClass { } /** - * Check if this {@link Data} is binary + * Return the {@link List} of sep-listed values from this {@link String} + * data. + *

+ * Will take the backslash character into account (i.e., a backslash can + * escape the given separator). * - * @return TRUE if it is + * @param value + * the data + * + * @param the + * separator + * + * @return the {@link List} of values */ - public boolean isBinary() { - return b64 >= 0; + private List getList(char sep) { + List rep = new LinkedList(); + + if (value != null && value.length() > 0) { + int last = 0; + for (int i = 0; i < value.length(); i++) { + if (value.charAt(i) == sep + && (i == 0 || value.charAt(i - 1) != '\\')) { + rep.add(value.substring(last, i)); + last = i + 1; + } + } + + if (last < value.length()) + rep.add(value.substring(last)); + } + + return rep; } /** - * Check if this {@link Data} has the "preferred" flag. + * Create the {@link String}-encoded {@link List} of sep-listed values from + * the given values. + * + * @param values + * the {@link List} of values * - * @return TRUE if it has + * @param sep + * the separator + * + * @return the {@link String} */ - public boolean isPreferred() { - for (TypeInfo type : this) { - if (type.getName().equals("TYPE") && type.getValue().equals("pref")) { - return true; - } + private void setList(List values, char sep) { + StringBuilder builder = new StringBuilder(); + boolean first = true; + for (String value : values) { + if (!first) + builder.append(sep); + + builder.append(escape(value)); + + first = false; } - return false; + value = builder.toString(); } @Override @@ -170,4 +301,17 @@ public class Data extends BaseClass { public String getState() { return ("" + name + value + group).replace(' ', '_'); } + + @Override + public String toString() { + String out = name + ": " + value; + if (group != null && !group.isEmpty()) { + out += " (" + group + ")"; + } + if (b64 >= 0) { + out += " [" + b64 + "]"; + } + + return out; + } }