package be.nikiroo.jvcard;
+import java.io.File;
+import java.io.IOException;
+import java.util.ArrayList;
import java.util.HashMap;
import java.util.LinkedList;
import java.util.List;
import java.util.Map;
+import java.util.UUID;
import be.nikiroo.jvcard.parsers.Format;
import be.nikiroo.jvcard.parsers.Parser;
-import be.nikiroo.jvcard.tui.StringUtils;
+import be.nikiroo.utils.StringUtils;
/**
* A contact is the information that represent a contact person or organisation.
+ * <p>
+ * Each {@link Data} inside can be binary encoded or not: if it is binary
+ * encoded, it has an active BKey number (not -1) associated to it (of value 0
+ * if still not sorted, or unique for the whole {@link Contact} if already
+ * processed).
*
* @author niki
- *
*/
-public class Contact {
- private List<Data> datas;
+public class Contact extends BaseClass<Data> {
private int nextBKey = 1;
private Map<Integer, Data> binaries;
- private boolean dirty;
- private Card parent;
/**
* Create a new Contact from the given information. Note that the BKeys data
* the information about the contact
*/
public Contact(List<Data> content) {
- this.datas = new LinkedList<Data>();
-
- boolean fn = false;
- boolean n = false;
- for (Data data : content) {
- if (data.getName().equals("N")) {
- n = true;
- } else if (data.getName().equals("FN")) {
- fn = true;
- }
-
- if (!data.getName().equals("VERSION")) {
- datas.add(data);
- }
- }
-
- // required fields:
- if (!n) {
- datas.add(new Data(null, "N", "", null));
- }
- if (!fn) {
- datas.add(new Data(null, "FN", "", null));
- }
-
+ super(load(content));
updateBKeys(true);
}
/**
- * Return the number of {@link Data} present in this {@link Contact}.
- *
- * @return the number of {@link Data}s
- */
- public int size() {
- return datas.size();
- }
-
- /**
- * Return the {@link Data} at index <i>index</i>.
- *
- * @param index
- * the index of the {@link Data} to find
- *
- * @return the {@link Data}
- *
- * @throws IndexOutOfBoundsException
- * if the index is < 0 or >= {@link Contact#size()}
- */
- public Data get(int index) {
- return datas.get(index);
- }
-
- /**
- * Return the preferred Data field with the given name, or NULL if none.
+ * Return the preferred Data field with the given name, the first one if
+ * none is preferred, or NULL if none at all.
*
* @param name
* the name to look for
- * @return the Data field, or NULL
+ *
+ * @return the {@link Data} field, or NULL
*/
public Data getPreferredData(String name) {
- Data first = null;
+ Data pref = null;
+ int ipref = Integer.MAX_VALUE;
for (Data data : getData(name)) {
- if (first == null)
- first = data;
- for (int index = 0; index < data.size(); index++) {
- TypeInfo type = data.get(index);
- if (type.getName().equals("TYPE")
- && type.getValue().equals("pref")) {
- return data;
- }
- }
+ if (pref == null)
+ pref = data;
+
+ if (data.getPreferred() < ipref)
+ pref = data;
}
- return first;
+ return pref;
}
/**
* Return the value of the preferred data field with this name, or NULL if
- * none (you cannot differentiate a NULL value and no value).
+ * none (you cannot differentiate a NULL value and no value with this method
+ * -- for that, check {@link Contact#getPreferredData(String)}).
*
* @param name
* the name to look for
* Get the Data fields that share the given name.
*
* @param name
- * the name to ook for
+ * the name to look for
* @return a list of Data fields with this name
*/
public List<Data> getData(String name) {
List<Data> found = new LinkedList<Data>();
- for (Data data : datas) {
+ for (Data data : this) {
if (data.getName().equals(name))
found.add(data);
}
return found;
}
- /**
- * Return a {@link String} representation of this contact.
- *
- * @param format
- * the {@link Format} to use
- * @param startingBKey
- * the starting BKey or -1 for no BKeys
- * @return the {@link String} representation
- */
- public String toString(Format format, int startingBKey) {
- updateBKeys(false);
- return Parser.toString(this, format, startingBKey);
- }
-
/**
* Return a {@link String} representation of this contact formated
* accordingly to the given format.
*
+ * <p>
* The format is basically a list of field names separated by a pipe and
- * optionally parametrised. The parameters allows you to:
+ * optionally parametrised with the 'at' (@) symbol. The parameters allows
+ * you to:
* <ul>
* <li>@x: show only a present/not present info</li>
* <li>@n: limit the size to a fixed value 'n'</li>
* <li>@+: expand the size of this field as much as possible</li>
* </ul>
+ * </p>
+ *
+ * <p>
+ * In case of lists or multiple-fields values, you can select a specific
+ * list or field with:
+ * <ul>
+ * <li>FIELD@(0): select the first value in a list</li>
+ * <li>FIELD@[1]: select the second field in a multiple-fields value</li>
+ * </ul>
+ * </p>
*
- * Example: "N@10|FN@20|NICK@+|PHOTO@x"
+ * <p>
+ * You can also add a fixed text if it starts with a simple-quote (').
+ * </p>
+ *
+ * <p>
+ * Example: "'Contact: |N@10|FN@20|NICK@+|PHOTO@x"
+ * </p>
*
* @param format
* the format to use
+ * @param separator
+ * the separator {@link String} to use between fields
*
* @return the {@link String} representation
*/
- public String toString(String format) {
- return toString(format, "|", null, -1, true, false);
+ public String toString(String format, String separator) {
+ return toString(format, separator, null, -1, true);
}
/**
* Return a {@link String} representation of this contact formated
* accordingly to the given format.
*
+ * <p>
* The format is basically a list of field names separated by a pipe and
* optionally parametrised. The parameters allows you to:
* <ul>
- * <li>@x: (the 'x' is the letter 'x') show only a present/not present info</li>
+ * <li>@x: show only a present/not present info</li>
* <li>@n: limit the size to a fixed value 'n'</li>
* <li>@+: expand the size of this field as much as possible</li>
* </ul>
+ * </p>
+ *
+ * <p>
+ * In case of lists or multiple-fields values, you can select a specific
+ * list or field with:
+ * <ul>
+ * <li>FIELD@(0): select the first value in a list</li>
+ * <li>FIELD@[1]: select the second field in a multiple-fields value</li>
+ * </ul>
+ * </p>
*
- * Example: "N@10|FN@20|NICK@+|PHOTO@x"
+ * <p>
+ * You can also add a fixed text if it starts with a simple-quote (').
+ * </p>
+ *
+ * <p>
+ * Example: "'Contact: |N@10|FN@20|NICK@+|PHOTO@x"
+ * </p>
*
* @param format
* the format to use
* the {@link String} to use for left and right padding
* @param width
* a fixed width or -1 for "as long as needed"
- *
* @param unicode
- * allow Uniode or only ASCII characters
+ * allow Unicode or only ASCII characters
*
* @return the {@link String} representation
*/
public String toString(String format, String separator, String padding,
- int width, boolean unicode, boolean removeAccents) {
+ int width, boolean unicode) {
StringBuilder builder = new StringBuilder();
for (String str : toStringArray(format, separator, padding, width,
* Return a {@link String} representation of this contact formated
* accordingly to the given format, part by part.
*
+ * <p>
* The format is basically a list of field names separated by a pipe and
* optionally parametrised. The parameters allows you to:
* <ul>
* <li>@n: limit the size to a fixed value 'n'</li>
* <li>@+: expand the size of this field as much as possible</li>
* </ul>
+ * </p>
*
- * Example: "N@10|FN@20|NICK@+|PHOTO@x"
+ * <p>
+ * In case of lists or multiple-fields values, you can select a specific
+ * list or field with:
+ * <ul>
+ * <li>FIELD@(0): select the first value in a list</li>
+ * <li>FIELD@[1]: select the second field in a multiple-fields value</li>
+ * </ul>
+ * </p>
+ *
+ * <p>
+ * You can also add a fixed text if it starts with a simple-quote (').
+ * </p>
+ *
+ * <p>
+ * Example: "'Contact: |N@10|FN@20|NICK@+|PHOTO@x"
+ * </p>
*
* @param format
* the format to use
* Return a {@link String} representation of this contact formated
* accordingly to the given format, part by part.
*
+ * <p>
* The format is basically a list of field names separated by a pipe and
* optionally parametrised. The parameters allows you to:
* <ul>
* <li>@n: limit the size to a fixed value 'n'</li>
* <li>@+: expand the size of this field as much as possible</li>
* </ul>
+ * </p>
*
- * Example: "N@10|FN@20|NICK@+|PHOTO@x"
+ * <p>
+ * In case of lists or multiple-fields values, you can select a specific
+ * list or field with:
+ * <ul>
+ * <li>FIELD@(0): select the first value in a list</li>
+ * <li>FIELD@[1]: select the second field in a multiple-fields value</li>
+ * </ul>
+ * </p>
+ *
+ * <p>
+ * You can also add a fixed text if it starts with a simple-quote (').
+ * </p>
+ *
+ * <p>
+ * Example: "'Contact: |N@10|FN@20|NICK@+|PHOTO@x"
+ * </p>
*
* @param format
* the format to use
* a fixed width or -1 for "as long as needed"
* @param unicode
* allow Uniode or only ASCII characters
- *
+ *
* @return the {@link String} representation
*/
public String[] toStringArray(String format, int width, boolean unicode) {
int size = -1;
boolean binary = false;
boolean expand = false;
+ int fieldNum = -1;
+ int valueNum = -1;
- if (field.contains("@")) {
+ if (field.length() > 0 && field.charAt(0) != '\''
+ && field.contains("@")) {
String[] opts = field.split("@");
if (opts.length > 0)
field = opts[0];
} else if (opt.equals("+")) {
expand = true;
numOfFieldsToExpand++;
+ } else if (opt.length() > 0 && opt.charAt(0) == '(') {
+ try {
+ opt = opt.substring(1, opt.length() - 1);
+ valueNum = Integer.parseInt(opt);
+ } catch (Exception e) {
+ }
+ } else if (opt.length() > 0 && opt.charAt(0) == '[') {
+ try {
+ opt = opt.substring(1, opt.length() - 1);
+ fieldNum = Integer.parseInt(opt);
+ } catch (Exception e) {
+ }
} else {
try {
size = Integer.parseInt(opt);
- } catch (Exception e) {
+ } catch (NumberFormatException e) {
}
}
}
}
- String value = getPreferredDataValue(field);
+ String value = null;
+ if (field.length() > 0 && field.charAt(0) == '\'') {
+ value = field.substring(1);
+ } else if (valueNum >= 0) {
+ List<String> vv = getPreferredData(field).getValues();
+ if (valueNum < vv.size()) {
+ value = vv.get(valueNum);
+ }
+ } else if (fieldNum >= 0) {
+ List<String> ff = getPreferredData(field).getFields();
+ if (fieldNum < ff.size()) {
+ value = ff.get(fieldNum);
+ }
+ } else {
+ // we don't need the *data* in binary mode...
+ if (binary)
+ value = getData(field).size() > 0 ? "x" : null;
+ else
+ value = getPreferredDataValue(field);
+ }
+
if (value == null) {
value = "";
} else {
public void updateFrom(Contact vc) {
updateBKeys(false);
- List<Data> newDatas = new LinkedList<Data>(vc.datas);
+ List<Data> newDatas = new LinkedList<Data>(vc);
for (int i = 0; i < newDatas.size(); i++) {
Data data = newDatas.get(i);
int bkey = Parser.getBKey(data);
}
}
- this.datas = newDatas;
+ replaceListContent(newDatas);
this.nextBKey = vc.nextBKey;
-
- setParent(parent);
- setDirty();
}
- /**
- * Delete this {@link Contact} from its parent {@link Card} if any.
- *
- * @return TRUE in case of success
- */
- public boolean delete() {
- if (parent != null) {
- List<Contact> list = parent.getContactsList();
- for (int i = 0; i < list.size(); i++) {
- if (list.get(i) == this) {
- list.remove(i);
- parent.setDirty();
- return true;
- }
- }
- }
-
- return false;
+ @Override
+ public String getId() {
+ return "" + getPreferredDataValue("UID");
}
- /**
- * Check if this {@link Contact} has unsaved changes.
- *
- * @return TRUE if it has
- */
- public boolean isDirty() {
- return dirty;
+ @Override
+ public String getState() {
+ return getId();
}
/**
- * Return a {@link String} representation of this contact, in vCard 2.1,
- * without BKeys.
+ * Return a simple {@link String} representation of this contact without
+ * BKeys.
*
* @return the {@link String} representation
*/
@Override
public String toString() {
- return toString(Format.VCard21, -1);
+ return "[Contact: " + getPreferredDataValue("FN") + "]";
}
/**
binaries = new HashMap<Integer, Data>();
}
- for (Data data : datas) {
+ for (Data data : this) {
if (data.isBinary() && (data.getB64Key() <= 0 || force)) {
binaries.put(nextBKey, data);
data.resetB64Key(nextBKey++);
}
/**
- * Notify that this element has unsaved changes, and notify its parent of
- * the same if any.
+ * Load the data from the given {@link File} under the given {@link Format}.
+ *
+ * @param file
+ * the {@link File} to load from
+ * @param format
+ * the {@link Format} to load as
+ *
+ * @return the list of elements
+ * @throws IOException
+ * in case of IO error
*/
- protected void setDirty() {
- this.dirty = true;
- if (this.parent != null)
- this.parent.setDirty();
- }
+ static private List<Data> load(List<Data> content) {
+ List<Data> datas = new ArrayList<Data>();
- /**
- * Notify this element <i>and all its descendants</i> that it is in pristine
- * state (as opposed to dirty).
- */
- void setPristine() {
- dirty = false;
- for (Data data : datas) {
- data.setPristine();
- }
- }
+ boolean fn = false;
+ boolean n = false;
+ boolean uid = false;
+ if (content != null) {
+ for (Data data : content) {
+ if (data.getName().equals("N")) {
+ n = true;
+ } else if (data.getName().equals("FN")) {
+ fn = true;
+ } else if (data.getName().equals("UID")) {
+ uid = true;
+ }
- /**
- * Set the parent of this {@link Contact} <i>and all its descendants</i>.
- *
- * @param parent
- * the new parent
- */
- void setParent(Card parent) {
- this.parent = parent;
- for (Data data : datas) {
- data.setParent(this);
+ if (!data.getName().equals("VERSION")) {
+ datas.add(data);
+ }
+ }
}
+
+ // required fields:
+ if (!n) // required since vCard 3.0, supported in 2.1
+ datas.add(new Data(null, "N", "", null));
+ if (!fn) // not required anymore but still supported in 4.0
+ datas.add(new Data(null, "FN", "", null));
+ if (!uid) // supported by vCard, required by this program
+ datas.add(new Data(null, "UID", UUID.randomUUID().toString(), null));
+
+ return datas;
}
/**
* Add a {@link String} to the given {@link List}, but make sure it does not
* exceed the maximum size, and truncate it if needed to fit.
+ * <p>
+ * Will always add one and only one {@link String} (potentially empty) at
+ * the end of <tt>list</tt>.
*
* @param list
+ * the list to add to
* @param add
+ * the {@link String} to (either fully or partially) add
* @param currentSize
+ * the current total size (managed outside of this method)
* @param maxSize
- * @return
+ * the maximum size that cannot be exceeded (or -1 for
+ * "no maximum") -- if the maximum size would be exceeded by
+ * adding this {@link String}, only a part of it will be added;
+ * if the maximum size is already reached or exceeded (should not
+ * happen because of this method), an empty {@link String} will
+ * be added
+ *
+ * @return the number of characters added (the size of the last
+ * {@link String} in <tt>list</tt>)
*/
static private int addToList(List<String> list, String add,
int currentSize, int maxSize) {
list.add(add);
return add.length();
}
-
}