X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=src%2Fbe%2Fnikiroo%2Fjvcard%2FContact.java;h=08c2a515e563cdfb39aadc7ab84795b1ec1153c6;hb=e4444b0bc462544629d9e7e7ab62b96a4d9cab10;hp=08d5eee0fdcfe25588d37f466293225af6c17217;hpb=a3b510ab4bf89a7a2a05f3851ffe0f030b8a78f4;p=jvcard.git diff --git a/src/be/nikiroo/jvcard/Contact.java b/src/be/nikiroo/jvcard/Contact.java index 08d5eee..08c2a51 100644 --- a/src/be/nikiroo/jvcard/Contact.java +++ b/src/be/nikiroo/jvcard/Contact.java @@ -1,12 +1,17 @@ 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.resources.StringUtils; /** * A contact is the information that represent a contact person or organisation. @@ -14,12 +19,9 @@ import be.nikiroo.jvcard.parsers.Parser; * @author niki * */ -public class Contact { - private List datas; +public class Contact extends BaseClass { private int nextBKey = 1; private Map binaries; - private boolean dirty; - private Card parent; /** * Create a new Contact from the given information. Note that the BKeys data @@ -29,42 +31,10 @@ public class Contact { * the information about the contact */ public Contact(List content) { - this.datas = new LinkedList(); - - 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 informations (note: this is the actual list, be careful). - * - * @return the list of data anout this contact - */ - public List getContent() { - return datas; - } - /** * Return the preferred Data field with the given name, or NULL if none. * @@ -77,7 +47,8 @@ public class Contact { for (Data data : getData(name)) { if (first == null) first = data; - for (TypeInfo type : data.getTypes()) { + for (int index = 0; index < data.size(); index++) { + TypeInfo type = data.get(index); if (type.getName().equals("TYPE") && type.getValue().equals("pref")) { return data; @@ -113,7 +84,7 @@ public class Contact { public List getData(String name) { List found = new LinkedList(); - for (Data data : datas) { + for (Data data : this) { if (data.getName().equals(name)) found.add(data); } @@ -132,7 +103,37 @@ public class Contact { */ public String toString(Format format, int startingBKey) { updateBKeys(false); - return Parser.toString(this, format, startingBKey); + + StringBuilder builder = new StringBuilder(); + for (String line : Parser.toStrings(this, format, startingBKey)) { + builder.append(line); + builder.append("\r\n"); + } + + return builder.toString(); + } + + /** + * Return a {@link String} representation of this contact formated + * accordingly to the given format. + * + * The format is basically a list of field names separated by a pipe and + * optionally parametrised. The parameters allows you to: + *
    + *
  • @x: show only a present/not present info
    • + *
  • @n: limit the size to a fixed value 'n'
    • + *
  • @+: expand the size of this field as much as possible
    • + *
+ * + * Example: "N@10|FN@20|NICK@+|PHOTO@x" + * + * @param format + * the format to use + * + * @return the {@link String} representation + */ + public String toString(String format) { + return toString(format, "|", null, -1, true, false); } /** @@ -142,6 +143,46 @@ public class Contact { * The format is basically a list of field names separated by a pipe and * optionally parametrised. The parameters allows you to: *
    + *
  • @x: (the 'x' is the letter 'x') show only a present/not present info
    • + *
  • @n: limit the size to a fixed value 'n'
    • + *
  • @+: expand the size of this field as much as possible
    • + *
+ * + * Example: "N@10|FN@20|NICK@+|PHOTO@x" + * + * @param format + * the format to use + * @param separator + * the separator {@link String} to use between fields + * @param padding + * 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 + * + * @return the {@link String} representation + */ + public String toString(String format, String separator, String padding, + int width, boolean unicode, boolean removeAccents) { + StringBuilder builder = new StringBuilder(); + + for (String str : toStringArray(format, separator, padding, width, + unicode)) { + builder.append(str); + } + + return builder.toString(); + } + + /** + * Return a {@link String} representation of this contact formated + * accordingly to the given format, part by part. + * + * The format is basically a list of field names separated by a pipe and + * optionally parametrised. The parameters allows you to: + *
    *
  • @x: show only a present/not present info
    • *
  • @n: limit the size to a fixed value 'n'
    • *
  • @+: expand the size of this field as much as possible
    • @@ -153,13 +194,73 @@ public class Contact { * the format to use * @param separator * the separator {@link String} to use between fields + * @param padding + * 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 + * + * @return the {@link String} representation + */ + public String[] toStringArray(String format, String separator, + String padding, int width, boolean unicode) { + if (width > -1) { + int numOfFields = format.split("\\|").length; + if (separator != null) + width -= (numOfFields - 1) * separator.length(); + if (padding != null) + width -= (numOfFields) * (2 * padding.length()); + + if (width < 0) + width = 0; + } + + List str = new LinkedList(); + + boolean first = true; + for (String s : toStringArray(format, width, unicode)) { + if (!first) { + str.add(separator); + } + + if (padding != null) + str.add(padding + s + padding); + else + str.add(s); + + first = false; + } + + return str.toArray(new String[] {}); + } + + /** + * Return a {@link String} representation of this contact formated + * accordingly to the given format, part by part. + * + * The format is basically a list of field names separated by a pipe and + * optionally parametrised. The parameters allows you to: + *
      + *
    • @x: show only a present/not present info
      • + *
    • @n: limit the size to a fixed value 'n'
      • + *
    • @+: expand the size of this field as much as possible
      • + *
    + * + * Example: "N@10|FN@20|NICK@+|PHOTO@x" + * + * @param format + * the format to use + * @param width + * 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 toString(String format, String separator, int width) { - String str = null; + public String[] toStringArray(String format, int width, boolean unicode) { + List str = new LinkedList(); String[] formatFields = format.split("\\|"); String[] values = new String[formatFields.length]; @@ -169,22 +270,11 @@ public class Contact { int totalSize = 0; if (width == 0) { - return ""; - } - - if (width > -1 && separator != null && separator.length() > 0 - && formatFields.length > 1) { - int swidth = (formatFields.length - 1) * separator.length(); - if (swidth >= width) { - str = separator; - while (str.length() < width) { - str += separator; - } - - return str.substring(0, width); + for (int i = 0; i < formatFields.length; i++) { + str.add(""); } - width -= swidth; + return str.toArray(new String[] {}); } for (int i = 0; i < formatFields.length; i++) { @@ -215,11 +305,14 @@ public class Contact { } String value = getPreferredDataValue(field); - if (value == null) + if (value == null) { value = ""; + } else { + value = StringUtils.sanitize(value, unicode); + } if (size > -1) { - value = fixedString(value, size); + value = StringUtils.padString(value, size); } expandedFields[i] = expand; @@ -236,7 +329,7 @@ public class Contact { totalSize += value.length(); } } - + if (width > -1 && totalSize > width) { int toDo = totalSize - width; for (int i = fixedsizeFields.length - 1; toDo > 0 && i >= 0; i--) { @@ -257,7 +350,7 @@ public class Contact { totalSize = width + toDo; } - + if (width > -1 && numOfFieldsToExpand > 0) { int availablePadding = width - totalSize; @@ -269,14 +362,12 @@ public class Contact { if (expandedFields[i]) { if (remainder > 0) { values[i] = values[i] - + new String(new char[remainder]).replace( - '\0', ' '); + + StringUtils.padString("", remainder); remainder = 0; } if (padPerItem > 0) { values[i] = values[i] - + new String(new char[padPerItem]).replace( - '\0', ' '); + + StringUtils.padString("", padPerItem); } } } @@ -284,56 +375,13 @@ public class Contact { totalSize = width; } } - - for (String field : values) { - if (str == null) { - str = field; - } else { - str += separator + field; - } - } - - if (str == null) - str = ""; - if (width > -1) { - str = fixedString(str, width); + int currentSize = 0; + for (int i = 0; i < values.length; i++) { + currentSize += addToList(str, values[i], currentSize, width); } - return str; - } - - /** - * Fix the size of the given {@link String} either with space-padding or by - * shortening it. - * - * @param string - * the {@link String} to fix - * @param size - * the size of the resulting {@link String} - * - * @return the fixed {@link String} of size size - */ - static private String fixedString(String string, int size) { - int length = string.length(); - - if (length > size) - string = string.substring(0, size); - else if (length < size) - string = string - + new String(new char[size - length]).replace('\0', ' '); - - return string; - } - - /** - * Return a {@link String} representation of this contact, in vCard 2.1, - * without BKeys. - * - * @return the {@link String} representation - */ - public String toString() { - return toString(Format.VCard21, -1); + return str.toArray(new String[] {}); } /** @@ -348,7 +396,7 @@ public class Contact { public void updateFrom(Contact vc) { updateBKeys(false); - List newDatas = new LinkedList(vc.datas); + List newDatas = new LinkedList(vc); for (int i = 0; i < newDatas.size(); i++) { Data data = newDatas.get(i); int bkey = Parser.getBKey(data); @@ -359,11 +407,29 @@ public class Contact { } } - this.datas = newDatas; + replaceListContent(newDatas); this.nextBKey = vc.nextBKey; + } - setParent(parent); - setDirty(); + @Override + public String getId() { + return "" + getPreferredDataValue("UID"); + } + + @Override + public String getState() { + return getId(); + } + + /** + * Return a {@link String} representation of this contact, in vCard 2.1, + * without BKeys. + * + * @return the {@link String} representation + */ + @Override + public String toString() { + return toString(Format.VCard21, -1); } /** @@ -382,7 +448,7 @@ public class Contact { binaries = new HashMap(); } - for (Data data : datas) { + for (Data data : this) { if (data.isBinary() && (data.getB64Key() <= 0 || force)) { binaries.put(nextBKey, data); data.resetB64Key(nextBKey++); @@ -390,24 +456,80 @@ public class Contact { } } - public boolean isDirty() { - return dirty; + /** + * 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 + */ + static private List load(List content) { + List datas = new ArrayList(); + + 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; + } + + 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; } /** - * Notify that this element has unsaved changes, and notify its parent of - * the same if any. + * 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. + * + * @param list + * @param add + * @param currentSize + * @param maxSize + * @return */ - protected void setDirty() { - this.dirty = true; - if (this.parent != null) - this.parent.setDirty(); - } + static private int addToList(List list, String add, + int currentSize, int maxSize) { + if (add == null || add.length() == 0) { + if (add != null) + list.add(add); + return 0; + } - public void setParent(Card parent) { - this.parent = parent; - for (Data data : datas) { - data.setParent(this); + if (maxSize > -1) { + if (currentSize < maxSize) { + if (currentSize + add.length() >= maxSize) { + add = add.substring(0, maxSize - currentSize); + } + } else { + add = ""; + } } + + list.add(add); + return add.length(); } }