import be.nikiroo.jvcard.parsers.Format;
import be.nikiroo.jvcard.parsers.Parser;
+import be.nikiroo.jvcard.tui.StringUtils;
/**
* A contact is the information that represent a contact person or organisation.
return Parser.toString(this, format, startingBKey);
}
+ /**
+ * 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:
+ * <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>
+ *
+ * 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);
+ }
+
/**
* Return a {@link String} representation of this contact formated
* accordingly to the given 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, int width) {
+ public String toString(String format, String separator, String padding,
+ int width, boolean unicode, boolean removeAccents) {
StringBuilder builder = new StringBuilder();
- String[] formatFields = format.split("\\|");
- if (width > -1 && separator != null && separator.length() > 0
- && formatFields.length > 1) {
- int swidth = (formatFields.length - 1) * separator.length();
- if (swidth >= width) {
- int num = width / separator.length();
- int remainder = width % separator.length();
-
- if (remainder > 0)
- num++;
-
- while (builder.length() < width) {
- if (builder.length() + separator.length() <= width)
- builder.append(separator);
- else
- builder.append(separator
- .substring(0, (builder.length() + separator
- .length())
- - width));
- }
+ for (String str : toStringArray(format, separator, padding, width,
+ unicode)) {
+ builder.append(str);
+ }
- return builder.toString();
- }
+ return builder.toString();
+ }
- width -= swidth;
+ /**
+ * 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:
+ * <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>
+ *
+ * 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[] 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;
}
- for (String str : toStringArray(format, width)) {
- builder.append(str);
+ List<String> str = new LinkedList<String>();
+
+ 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 builder.toString();
+ return str.toArray(new String[] {});
}
/**
* accordingly to the given format, part by part.
*
* The format is basically a list of field names separated by a pipe and
- * optionally parametrised. See {@link Contact#toString} for more
- * information about the format.
+ * optionally parametrised. 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>
+ *
+ * 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[] toStringArray(String format, int width) {
+ public String[] toStringArray(String format, int width, boolean unicode) {
List<String> str = new LinkedList<String>();
String[] formatFields = format.split("\\|");
int totalSize = 0;
if (width == 0) {
+ for (int i = 0; i < formatFields.length; i++) {
+ str.add("");
+ }
+
return str.toArray(new String[] {});
}
}
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;
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);
}
}
}
return str.toArray(new String[] {});
}
- /**
- * 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 <i>size</i>
- */
- 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;
- }
-
/**
* 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.
}
}
- if (add.length() > 0) {
- list.add(add);
- }
-
+ list.add(add);
return add.length();
}
this.parent.setDirty();
}
- public void setParent(Card parent) {
+ void setParent(Card parent) {
this.parent = parent;
for (Data data : datas) {
data.setParent(this);
}
}
+
+ /**
+ * 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;
+ }
+
+ /**
+ * 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();
+ }
+ }
}
git://git.nikiroo.be / jvcard.git / blobdiff