本博客基于android7.1版本分析&＃xff0c;仅用于沟通学习使用

上一篇博客介绍了 android导出vCard联系人流程 紧接着我们在这篇博客来看看它是如何导入一个vCard联系人的。

整体流程总结

1. 通过在contacts联系人中界面跳转&＃xff0c;我们跳转到了 DocumentsActivity 界面并选择我们需要导入的以 .vcf 结尾的vCard文件&＃xff0c;将Uri以intent的方式返回给ImportVCardActivity。
2. 通过readUriToLocalUri方法将uri指向的文件copy到本地临时目录。
3. 启动一个线程开始解析文件&＃xff0c;并指定vCard类型为 text/x-vcard 版本为2.1&＃xff0c;后面就只会创建2.1版本对应的解析器&＃xff0c;所以其它版本的vCard导入可能会出现问题。
4. 然后通过VCardParserImpl_V21来具体解析文件中的每一行&＃xff0c;最后通过VCardEntryCommitter.pushIntoContentResolver批量插入contacts的数据库

几个重点类的作用

• ImportVCardActivity &＃xff1a; 一个中间控制类&＃xff0c;它控制了界面dialog、notification、service、thread的启动和消失
• VCardParserImpl_V21 &＃xff1a; 负责vCard2.1版本内容的逐行解析
• VCardEntryConstructor &＃xff1a; 负责将解析出来的数据以VCardEntry的形式暂存在内存中
• VCardEntryCommitter &＃xff1a; 负责将解析出来的数据存储到contacts数据库中

整体操作图

整体流程图

部分重点方法介绍

VCardParserImpl_V21

/*** * vcard &＃61; "BEGIN" [ws] ":" [ws] "VCARD" [ws] 1*CRLF* items *CRLF* "END" [ws] ":" [ws] "VCARD"* * &＃64;return False when reaching end of file.*/private boolean parseOneVCard() throws IOException, VCardException {// reset for this entire vCard.mCurrentEncoding &＃61; DEFAULT_ENCODING; //8BITmCurrentCharset &＃61; DEFAULT_CHARSET; //UTF-8boolean allowGarbage &＃61; false;if (!readBeginVCard(allowGarbage)) {return false;}for (VCardInterpreter interpreter : mInterpreterList) {interpreter.onEntryStarted(); //解析vCard中一个联系人开始标志}parseItems();//逐行解析for (VCardInterpreter interpreter : mInterpreterList) {interpreter.onEntryEnded(); //解析完vCard中一个联系人结束标志}return true;}

protected boolean readBeginVCard(boolean allowGarbage) throws IOException, VCardException {// TODO: use consructPropertyLine().String line;do {while (true) {line &＃61; getLine();if (line &＃61;&＃61; null) {return false;} else if (line.trim().length() > 0) {break;}}final String[] strArray &＃61; line.split(":", 2);final int length &＃61; strArray.length;// Although vCard 2.1/3.0 specification does not allow lower cases,// we found vCard file emitted by some external vCard expoter have such// invalid Strings.// e.g. BEGIN:vCardif (length &＃61;&＃61; 2 && strArray[0].trim().equalsIgnoreCase("BEGIN")&& strArray[1].trim().equalsIgnoreCase("VCARD")) { //判断是否是开头&＃xff1f;return true;} else if (!allowGarbage) {throw new VCardException("Expected String \"BEGIN:VCARD\" did not come "&＃43; "(Instead, \"" &＃43; line &＃43; "\" came)");}} while (allowGarbage);throw new VCardException("Reached where must not be reached.");}

/** item &＃61; [groups "."] name [params] ":" value CRLF / [groups "."] "ADR"* [params] ":" addressparts CRLF / [groups "."] "ORG" [params] ":" orgparts* CRLF / [groups "."] "N" [params] ":" nameparts CRLF / [groups "."]* "AGENT" [params] ":" vcard CRLF*/protected boolean parseItem() throws IOException, VCardException {// Reset for an item.mCurrentEncoding &＃61; DEFAULT_ENCODING;final String line &＃61; getNonEmptyLine();final VCardProperty propertyData &＃61; constructPropertyData(line);final String propertyNameUpper &＃61; propertyData.getName().toUpperCase();final String propertyRawValue &＃61; propertyData.getRawValue();if (propertyNameUpper.equals(VCardConstants.PROPERTY_BEGIN)) {if (propertyRawValue.equalsIgnoreCase("VCARD")) {handleNest();} else {throw new VCardException("Unknown BEGIN type: " &＃43; propertyRawValue);}} else if (propertyNameUpper.equals(VCardConstants.PROPERTY_END)) {if (propertyRawValue.equalsIgnoreCase("VCARD")) {return true; // Ended.} else {throw new VCardException("Unknown END type: " &＃43; propertyRawValue);}} else {parseItemInter(propertyData, propertyNameUpper);}return false;}

private void parseItemInter(VCardProperty property, String propertyNameUpper)throws IOException, VCardException {String propertyRawValue &＃61; property.getRawValue();if (propertyNameUpper.equals(VCardConstants.PROPERTY_AGENT)) {handleAgent(property);} else if (isValidPropertyName(propertyNameUpper)) {if (propertyNameUpper.equals(VCardConstants.PROPERTY_VERSION) &&!propertyRawValue.equals(getVersionString())) {throw new VCardVersionException("Incompatible version: " &＃43; propertyRawValue &＃43; " !&＃61; " &＃43; getVersionString());}handlePropertyValue(property, propertyNameUpper); //解析里面每个属性} else {throw new VCardException("Unknown property name: \"" &＃43; propertyNameUpper &＃43; "\"");}}