import be.nikiroo.jvcard.TypeInfo;
public class Vcard21Parser {
- public static List<Contact> parse(Iterable<String> textData) {
+ /**
+ * Load the given data from under the given {@link Format}.
+ *
+ * @param lines
+ * the input to load from
+ * @param format
+ * the {@link Format} to load as
+ *
+ * @return the list of elements
+ */
+ public static List<Contact> parseContact(Iterable<String> textData) {
Iterator<String> lines = textData.iterator();
List<Contact> contacts = new LinkedList<Contact>();
- List<Data> datas = null;
+ List<String> datas = null;
String nextRawLine = null;
if (lines.hasNext()) {
String line = rawLine.toString();
if (line.equals("BEGIN:VCARD")) {
- datas = new LinkedList<Data>();
+ datas = new LinkedList<String>();
} else if (line.equals("END:VCARD")) {
if (datas == null) {
// BAD INPUT FILE. IGNORE.
System.err
.println("VCARD Parser warning: END:VCARD seen before any VCARD:BEGIN");
} else {
- contacts.add(new Contact(datas));
+ contacts.add(new Contact(parseData(datas)));
}
} else {
if (datas == null) {
System.err
.println("VCARD Parser warning: data seen before any VCARD:BEGIN");
} else {
- List<TypeInfo> types = new LinkedList<TypeInfo>();
- String name = "";
- String value = "";
- String group = "";
-
- if (line.contains(":")) {
- String rest = line.split(":")[0];
- value = line.substring(rest.length() + 1);
-
- if (rest.contains(";")) {
- String tab[] = rest.split(";");
- name = tab[0];
-
- for (int i = 1; i < tab.length; i++) {
- if (tab[i].contains("=")) {
- String tname = tab[i].split("=")[0];
- String tvalue = tab[i].substring(tname
- .length() + 1);
- types.add(new TypeInfo(tname, tvalue));
- } else {
- types.add(new TypeInfo(tab[i], ""));
- }
- }
- } else {
- name = rest;
- }
- } else {
- name = line;
- }
-
- if (name.contains(".")) {
- group = name.split("\\.")[0];
- name = name.substring(group.length() + 1);
- }
-
- datas.add(new Data(types, name, value, group));
+ datas.add(line);
}
}
}
return contacts;
}
- // -1 = no bkeys
- public static String toString(Contact contact, int startingBKey) {
- StringBuilder builder = new StringBuilder();
-
- builder.append("BEGIN:VCARD");
- builder.append("\r\n");
- builder.append("VERSION:2.1");
- builder.append("\r\n");
- for (int indexData = 0; indexData < contact.size(); indexData++) {
- Data data = contact.get(indexData);
- if (data.getGroup() != null && !data.getGroup().trim().equals("")) {
- builder.append(data.getGroup().trim());
- builder.append('.');
- }
- builder.append(data.getName());
- for (int indexType = 0; indexType < data.size(); indexType++) {
- TypeInfo type = data.get(indexType);
- builder.append(';');
- builder.append(type.getName());
- if (type.getValue() != null
- && !type.getValue().trim().equals("")) {
- builder.append('=');
- builder.append(type.getValue());
+ /**
+ * Load the given data from under the given {@link Format}.
+ *
+ * @param lines
+ * the input to load from
+ * @param format
+ * the {@link Format} to load as
+ *
+ * @return the list of elements
+ */
+ public static List<Data> parseData(Iterable<String> textData) {
+ List<Data> datas = new LinkedList<Data>();
+
+ for (String line : textData) {
+ List<TypeInfo> types = new LinkedList<TypeInfo>();
+ String name = "";
+ String value = "";
+ String group = "";
+
+ if (line.contains(":")) {
+ int colIndex = line.indexOf(':');
+ String rest = line.substring(0, colIndex);
+ value = line.substring(colIndex + 1);
+
+ if (rest.contains(";")) {
+ String tab[] = rest.split(";");
+ name = tab[0];
+
+ for (int i = 1; i < tab.length; i++) {
+ if (tab[i].contains("=")) {
+ int equIndex = tab[i].indexOf('=');
+ String tname = tab[i].substring(0, equIndex);
+ String tvalue = tab[i].substring(equIndex + 1);
+ types.add(new TypeInfo(tname, tvalue));
+ } else {
+ types.add(new TypeInfo(tab[i], ""));
+ }
+ }
+ } else {
+ name = rest;
}
+ } else {
+ name = line;
}
- builder.append(':');
- // TODO: bkey!
- builder.append(data.getValue());
- builder.append("\r\n");
+ if (name.contains(".")) {
+ int dotIndex = name.indexOf('.');
+ group = name.substring(0, dotIndex);
+ name = name.substring(dotIndex + 1);
+ }
+
+ datas.add(new Data(types, name, value, group));
}
- builder.append("END:VCARD");
- builder.append("\r\n");
- return builder.toString();
+ return datas;
}
- public static String toString(Card card) {
- StringBuilder builder = new StringBuilder();
+ /**
+ * Return a {@link String} representation of the given {@link Card}, line by
+ * line.
+ *
+ * @param card
+ * the card to convert
+ *
+ * @return the {@link String} representation
+ */
+ public static List<String> toStrings(Card card) {
+ List<String> lines = new LinkedList<String>();
- for (int index = 0; index < card.size(); index++) {
- builder.append(toString(card.get(index), -1));
+ for (Contact contact : card) {
+ lines.addAll(toStrings(contact, -1));
}
- builder.append("\r\n");
+ return lines;
+ }
+
+ /**
+ * Return a {@link String} representation of the given {@link Contact}, line
+ * by line.
+ *
+ * @param card
+ * the contact to convert
+ *
+ * @param startingBKey
+ * the starting BKey number (all the other will follow) or -1 for
+ * no BKey
+ *
+ * @return the {@link String} representation
+ */
+ public static List<String> toStrings(Contact contact, int startingBKey) {
+ List<String> lines = new LinkedList<String>();
+
+ lines.add("BEGIN:VCARD");
+ lines.add("VERSION:2.1");
+ for (Data data : contact) {
+ lines.addAll(toStrings(data));
+ }
+ lines.add("END:VCARD");
+
+ return lines;
+ }
+
+ /**
+ * Return a {@link String} representation of the given {@link Data}, line by
+ * line.
+ *
+ * @param data
+ * the data to convert
+ *
+ * @return the {@link String} representation
+ */
+ public static List<String> toStrings(Data data) {
+ List<String> lines = new LinkedList<String>();
+
+ StringBuilder dataBuilder = new StringBuilder();
+ if (data.getGroup() != null && !data.getGroup().trim().equals("")) {
+ dataBuilder.append(data.getGroup().trim());
+ dataBuilder.append('.');
+ }
+ dataBuilder.append(data.getName());
+ for (TypeInfo type : data) {
+ dataBuilder.append(';');
+ dataBuilder.append(type.getName());
+ if (type.getValue() != null && !type.getValue().trim().equals("")) {
+ dataBuilder.append('=');
+ dataBuilder.append(type.getValue());
+ }
+ }
+ dataBuilder.append(':');
+
+ // TODO: bkey!
+ dataBuilder.append(data.getValue());
+
+ // RFC says: Content lines SHOULD be folded to a maximum width of 75
+ // octets -> since it is SHOULD, we will just cut it as 74/75 chars
+ // depending if the last one fits in one char (note: chars != octet)
+ boolean continuation = false;
+ while (dataBuilder.length() > 0) {
+ int stop = 74;
+ if (continuation)
+ stop--; // the space takes 1
+ if (dataBuilder.length() > stop) {
+ char car = dataBuilder.charAt(stop - 1);
+ // RFC forbids cutting a character in 2
+ if (Character.isHighSurrogate(car)) {
+ stop++;
+ }
+ }
+
+ stop = Math.min(stop, dataBuilder.length());
+ if (continuation) {
+ lines.add(' ' + dataBuilder.substring(0, stop));
+ } else {
+ lines.add(dataBuilder.substring(0, stop));
+ }
+ dataBuilder.delete(0, stop);
+
+ continuation = true;
+ }
- return builder.toString();
+ return lines;
}
/**