weiling_shen

Android VCard联系人备份恢复（导入/导出）详解

首先我们简单的看下在Android中联系人的存储结构.

工作环境：android 2.3.3
联系人的主要数据存放在raw_contacts和data表里，它两构成主从表关系。

raw_contacts表结构：

data表结构：

每个联系人在raw_contacts里有一条记录，像地址，名称，email，电话等等数据都在data存放在data里，这样设计的好处是易扩展，比如要增加一个联系人的email地址时，只要在data里增加一条记录。

下面说说我在开发工作中用到的一些联系人的数据。

名字：

Uri: Uri.parse("content://com.android.contacts/data")

PREFIX = "data4"; //名称前缀
MID_NAME = "data5";//中间名
GIVEN_NAME = "data2";//名字
FAMILY_NAME = "data3";//姓氏
MID_PINYIN="data8"; //中间名拼音
String FAMILY_NAME_PINYIN="data9"; //姓氏拼音
String SUFIX = "data6"; //名称后缀
String SUFIX_PINYIN="data7"; //名字拼音

电话：

Uri: Uri.parse("content://com.android.contacts/data/phones"

phone: "data1";//号码

Type: "data2";//这个字段是整形值，指示电话类型

类型对应关系如下：

TYPE_CUSTOM = 0;
TYPE_HOME = 1;
TYPE_MOBILE = 2;
TYPE_WORK = 3;
TYPE_FAX_WORK = 4;
TYPE_FAX_HOME = 5;
TYPE_PAGER = 6;
TYPE_OTHER = 7;

Email：

Uri：Uri.parse("content://com.android.contacts/data/emails")

Email: "data1";//邮箱地址

Type: "data2";//这个字段是整形值，指示Email类型

类型对应关系如下：

TYPE_CUSTOM = 0;
TYPE_HOME = 1;
TYPE_WORK = 2;
TYPE_OTHER = 3;
TYPE_MOBILE = 4;

地址：

Uri：Uri.parse("content://com.android.contacts/data/postals")

STREET="data4";//街道
CITY="data8";//城市
STATE="data7";//州
ZIP_CODE="data9";//邮政编码

Type："data2"；//type的类型如下

TYPE_CUSTOM = 0;
TYPE_HOME = 1;
TYPE_WORK = 2;
TYPE_OTHER = 3;

好的下面开始介绍VCard的导出和导入.

VCard规范通俗点讲，就是让知道规范的人都能认识它.

在使用VCard时，我们需要下载VCard 的jar包

下载后里面会有2个Example {ReadExample.java / WriteExample.java} 。
但是凭借这两个Example，不足以让你更好的完成其他信息的备份和恢复，于是你要看下源码。

其中比较的2个类的源码如下.

  1 /*
  2  * Copyright (C) 2007 The Android Open Source Project
  3  *
  4  * Licensed under the Apache License, Version 2.0 (the "License");
  5  * you may not use this file except in compliance with the License.
  6  * You may obtain a copy of the License at
  7  *
  8  *      http://www.apache.org/licenses/LICENSE-2.0
  9  *
 10  * Unless required by applicable law or agreed to in writing, software
 11  * distributed under the License is distributed on an "AS IS" BASIS,
 12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 13  * See the License for the specific language governing permissions and
 14  * limitations under the License.
 15  */
 16 
 17 package a_vcard.android.syncml.pim.vcard;
 18 
 19 //import android.content.AbstractSyncableContentProvider;
 20 //import android.content.ContentResolver;
 21 //import android.content.ContentUris;
 22 //import android.content.ContentValues;
 23 //import android.net.Uri;
 24 import a_vcard.android.provider.Contacts;
 25 import a_vcard.android.provider.Contacts.ContactMethods;
 26 //import android.provider.Contacts.Extensions;
 27 //import android.provider.Contacts.GroupMembership;
 28 //import android.provider.Contacts.Organizations;
 29 //import android.provider.Contacts.People;
 30 import a_vcard.android.provider.Contacts.Phones;
 31 //import android.provider.Contacts.Photos;
 32 import a_vcard.android.syncml.pim.PropertyNode;
 33 import a_vcard.android.syncml.pim.VNode;
 34 import a_vcard.android.telephony.PhoneNumberUtils;
 35 import a_vcard.android.text.TextUtils;
 36 import a_vcard.android.util.Log;
 37 
 38 import java.util.ArrayList;
 39 import java.util.HashMap;
 40 import java.util.Iterator;
 41 import java.util.List;
 42 import java.util.Locale;
 43 import java.util.Map;
 44 import java.util.Map.Entry;
 45 
 46 /**
 47  * The parameter class of VCardComposer.
 48  * This class standy by the person-contact in
 49  * Android system, we must use this class instance as parameter to transmit to
 50  * VCardComposer so that create vCard string.
 51  */
 52 // TODO: rename the class name, next step
 53 public class ContactStruct {
 54     private static final String LOG_TAG = "ContactStruct";
 55     
 56     // Note: phonetic name probably should be "LAST FIRST MIDDLE" for European languages, and
 57     //       space should be added between each element while it should not be in Japanese.
 58     //       But unfortunately, we currently do not have the data and are not sure whether we should
 59     //       support European version of name ordering.
 60     //
 61     // TODO: Implement the logic described above if we really need European version of
 62     //        phonetic name handling. Also, adding the appropriate test case of vCard would be
 63     //        highly appreciated.
 64     public static final int NAME_ORDER_TYPE_ENGLISH = 0;
 65     public static final int NAME_ORDER_TYPE_JAPANESE = 1;
 66 
 67     /** MUST exist */
 68     public String name;
 69     public String phoneticName;
 70     /** maybe folding */
 71     public List notes = new ArrayList();
 72     /** maybe folding */
 73     public String title;
 74     /** binary bytes of pic. */
 75     public byte[] photoBytes;
 76     /** The type of Photo (e.g. JPEG, BMP, etc.) */
 77     public String photoType;
 78     /** Only for GET. Use addPhoneList() to PUT. */
 79     public List phoneList;
 80     /** Only for GET. Use addContactmethodList() to PUT. */
 81     public List contactmethodList;
 82     /** Only for GET. Use addOrgList() to PUT. */
 83     public List organizationList;
 84     /** Only for GET. Use addExtension() to PUT */
 85     public Map> extensionMap;
 86 
 87     // Use organizationList instead when handling ORG.
 88     @Deprecated
 89     public String company;
 90     
 91     public static class PhoneData {
 92         public int type;
 93         /** maybe folding */
 94         public String data;
 95         public String label;
 96         public boolean isPrimary; 
 97     }
 98 
 99     public static class ContactMethod {
100         // Contacts.KIND_EMAIL, Contacts.KIND_POSTAL
101         public int kind;
102         // e.g. Contacts.ContactMethods.TYPE_HOME, Contacts.PhoneColumns.TYPE_HOME
103         // If type == Contacts.PhoneColumns.TYPE_CUSTOM, label is used.
104         public int type;
105         public String data;
106         // Used only when TYPE is TYPE_CUSTOM.
107         public String label;
108         public boolean isPrimary;
109     }
110     
111     public static class OrganizationData {
112         public int type;
113         public String companyName;
114         public String positionName;
115         public boolean isPrimary;
116     }
117 
118     /**
119      * Add a phone info to phoneList.
120      * @param data phone number
121      * @param type type col of content://contacts/phones
122      * @param label lable col of content://contacts/phones
123      */
124     public void addPhone(int type, String data, String label, boolean isPrimary){
125         if (phoneList == null) {
126             phoneList = new ArrayList();
127         }
128         PhoneData phoneData = new PhoneData();
129         phoneData.type = type;
130         
131         StringBuilder builder = new StringBuilder();
132         String trimed = data.trim();
133         int length = trimed.length();
134         for (int i = 0; i < length; i++) {
135             char ch = trimed.charAt(i);
136             if (('0' <= ch && ch <= '9') || (i == 0 && ch == '+')) {
137                 builder.append(ch);
138             }
139         }
140         phoneData.data = PhoneNumberUtils.formatNumber(builder.toString());
141         phoneData.label = label;
142         phoneData.isPrimary = isPrimary;
143         phoneList.add(phoneData);
144     }
145 
146     /**
147      * Add a contactmethod info to contactmethodList.
148      * @param kind integer value defined in Contacts.java
149      * (e.g. Contacts.KIND_EMAIL)
150      * @param type type col of content://contacts/contact_methods
151      * @param data contact data
152      * @param label extra string used only when kind is Contacts.KIND_CUSTOM.
153      */
154     public void addContactmethod(int kind, int type, String data,
155             String label, boolean isPrimary){
156         if (contactmethodList == null) {
157             contactmethodList = new ArrayList();
158         }
159         ContactMethod contactMethod = new ContactMethod();
160         contactMethod.kind = kind;
161         contactMethod.type = type;
162         contactMethod.data = data;
163         contactMethod.label = label;
164         contactMethod.isPrimary = isPrimary;
165         contactmethodList.add(contactMethod);
166     }
167     
168     /**
169      * Add a Organization info to organizationList.
170      */
171     public void addOrganization(int type, String companyName, String positionName,
172             boolean isPrimary) {
173         if (organizationList == null) {
174             organizationList = new ArrayList();
175         }
176         OrganizationData organizationData = new OrganizationData();
177         organizationData.type = type;
178         organizationData.companyName = companyName;
179         organizationData.positionName = positionName;
180         organizationData.isPrimary = isPrimary;
181         organizationList.add(organizationData);
182     }
183 
184     /**
185      * Set "position" value to the appropriate data. If there's more than one
186      * OrganizationData objects, the value is set to the last one. If there's no
187      * OrganizationData object, a new OrganizationData is created, whose company name is
188      * empty.  
189      * 
190      * TODO: incomplete logic. fix this:
191      * 
192      * e.g. This assumes ORG comes earlier, but TITLE may come earlier like this, though we do not
193      * know how to handle it in general cases...
194      * ----
195      * TITLE:Software Engineer
196      * ORG:Google
197      * ----
198      */
199     public void setPosition(String positionValue) {
200         if (organizationList == null) {
201             organizationList = new ArrayList();
202         }
203         int size = organizationList.size();
204         if (size == 0) {
205             addOrganization(Contacts.OrganizationColumns.TYPE_OTHER, "", null, false);
206             size = 1;
207         }
208         OrganizationData lastData = organizationList.get(size - 1);
209         lastData.positionName = positionValue;
210     }
211     
212     public void addExtension(PropertyNode propertyNode) {
213         if (propertyNode.propValue.length() == 0) {
214             return;
215         }
216         // Now store the string into extensionMap.
217         List list;
218         String name = propertyNode.propName;
219         if (extensionMap == null) {
220             extensionMap = new HashMap>();
221         }
222         if (!extensionMap.containsKey(name)){
223             list = new ArrayList();
224             extensionMap.put(name, list);
225         } else {
226             list = extensionMap.get(name);
227         }        
228         
229         list.add(propertyNode.encode());
230     }
231     
232     private static String getNameFromNProperty(List elems, int nameOrderType) {
233         // Family, Given, Middle, Prefix, Suffix. (1 - 5)
234         int size = elems.size();
235         if (size > 1) {
236             StringBuilder builder = new StringBuilder();
237             boolean builderIsEmpty = true;
238             // Prefix
239             if (size > 3 && elems.get(3).length() > 0) {
240                 builder.append(elems.get(3));
241                 builderIsEmpty = false;
242             }
243             String first, second;
244             if (nameOrderType == NAME_ORDER_TYPE_JAPANESE) {
245                 first = elems.get(0);
246                 second = elems.get(1);
247             } else {
248                 first = elems.get(1);
249                 second = elems.get(0);
250             }
251             if (first.length() > 0) {
252                 if (!builderIsEmpty) {
253                     builder.append(' ');
254                 }
255                 builder.append(first);
256                 builderIsEmpty = false;
257             }
258             // Middle name
259             if (size > 2 && elems.get(2).length() > 0) {
260                 if (!builderIsEmpty) {
261                     builder.append(' ');
262                 }
263                 builder.append(elems.get(2));
264                 builderIsEmpty = false;
265             }
266             if (second.length() > 0) {
267                 if (!builderIsEmpty) {
268                     builder.append(' ');
269                 }
270                 builder.append(second);
271                 builderIsEmpty = false;
272             }
273             // Suffix
274             if (size > 4 && elems.get(4).length() > 0) {
275                 if (!builderIsEmpty) {
276                     builder.append(' ');
277                 }
278                 builder.append(elems.get(4));
279                 builderIsEmpty = false;
280             }
281             return builder.toString();
282         } else if (size == 1) {
283             return elems.get(0);
284         } else {
285             return "";
286         }
287     }
288     
289     public static ContactStruct constructContactFromVNode(VNode node,
290             int nameOrderType) {
291         if (!node.VName.equals("VCARD")) {
292             // Impossible in current implementation. Just for safety.
293             Log.e(LOG_TAG, "Non VCARD data is inserted.");
294             return null;
295         }
296 
297         // For name, there are three fields in vCard: FN, N, NAME.
298         // We prefer FN, which is a required field in vCard 3.0 , but not in vCard 2.1.
299         // Next, we prefer NAME, which is defined only in vCard 3.0.
300         // Finally, we use N, which is a little difficult to parse.
301         String fullName = null;
302         String nameFromNProperty = null;
303 
304         // Some vCard has "X-PHONETIC-FIRST-NAME", "X-PHONETIC-MIDDLE-NAME", and
305         // "X-PHONETIC-LAST-NAME"
306         String xPhoneticFirstName = null;
307         String xPhoneticMiddleName = null;
308         String xPhoneticLastName = null;
309         
310         ContactStruct contact = new ContactStruct();
311 
312         // Each Column of four properties has ISPRIMARY field
313         // (See android.provider.Contacts)
314         // If false even after the following loop, we choose the first
315         // entry as a "primary" entry.
316         boolean prefIsSetAddress = false;
317         boolean prefIsSetPhone = false;
318         boolean prefIsSetEmail = false;
319         boolean prefIsSetOrganization = false;
320         
321         for (PropertyNode propertyNode: node.propList) {
322             String name = propertyNode.propName;
323 
324             if (TextUtils.isEmpty(propertyNode.propValue)) {
325                 continue;
326             }
327             
328             if (name.equals("VERSION")) {
329                 // vCard version. Ignore this.
330             } else if (name.equals("FN")) {
331                 fullName = propertyNode.propValue;
332             } else if (name.equals("NAME") && fullName == null) {
333                 // Only in vCard 3.0. Use this if FN does not exist.
334                 // Though, note that vCard 3.0 requires FN.
335                 fullName = propertyNode.propValue;
336             } else if (name.equals("N")) {
337                 nameFromNProperty = getNameFromNProperty(propertyNode.propValue_vector,
338                         nameOrderType);
339             } else if (name.equals("SORT-STRING")) {
340                 contact.phoneticName = propertyNode.propValue;
341             } else if (name.equals("SOUND")) {
342                 if (propertyNode.paramMap_TYPE.contains("X-IRMC-N") &&
343                         contact.phoneticName == null) {
344                     // Some Japanese mobile phones use this field for phonetic name,
345                     // since vCard 2.1 does not have "SORT-STRING" type.
346                     // Also, in some cases, the field has some ';' in it.
347                     // We remove them.
348                     StringBuilder builder = new StringBuilder();
349                     String value = propertyNode.propValue;
350                     int length = value.length();
351                     for (int i = 0; i < length; i++) {
352                         char ch = value.charAt(i);
353                         if (ch != ';') {
354                             builder.append(ch);
355                         }
356                     }
357                     contact.phoneticName = builder.toString();
358                 } else {
359                     contact.addExtension(propertyNode);
360                 }
361             } else if (name.equals("ADR")) {
362                 List values = propertyNode.propValue_vector;
363                 boolean valuesAreAllEmpty = true;
364                 for (String value : values) {
365                     if (value.length() > 0) {
366                         valuesAreAllEmpty = false;
367                         break;
368                     }
369                 }
370                 if (valuesAreAllEmpty) {
371                     continue;
372                 }
373 
374                 int kind = Contacts.KIND_POSTAL;
375                 int type = -1;
376                 String label = "";
377                 boolean isPrimary = false;
378                 for (String typeString : propertyNode.paramMap_TYPE) {
379                     if (typeString.equals("PREF") && !prefIsSetAddress) {
380                         // Only first "PREF" is considered.
381                         prefIsSetAddress = true;
382                         isPrimary = true;
383                     } else if (typeString.equalsIgnoreCase("HOME")) {
384                         type = Contacts.ContactMethodsColumns.TYPE_HOME;
385                         label = "";
386                     } else if (typeString.equalsIgnoreCase("WORK") || 
387                             typeString.equalsIgnoreCase("COMPANY")) {
388                         // "COMPANY" seems emitted by Windows Mobile, which is not
389                         // specifically supported by vCard 2.1. We assume this is same
390                         // as "WORK".
391                         type = Contacts.ContactMethodsColumns.TYPE_WORK;
392                         label = "";
393                     } else if (typeString.equalsIgnoreCase("POSTAL")) {
394                         kind = Contacts.KIND_POSTAL;
395                     } else if (typeString.equalsIgnoreCase("PARCEL") || 
396                             typeString.equalsIgnoreCase("DOM") ||
397                             typeString.equalsIgnoreCase("INTL")) {
398                         // We do not have a kind or type matching these.
399                         // TODO: fix this. We may need to split entries into two.
400                         // (e.g. entries for KIND_POSTAL and KIND_PERCEL)
401                     } else if (typeString.toUpperCase().startsWith("X-") &&
402                             type < 0) {
403                         type = Contacts.ContactMethodsColumns.TYPE_CUSTOM;
404                         label = typeString.substring(2);
405                     } else if (type < 0) {
406                         // vCard 3.0 allows iana-token. Also some vCard 2.1 exporters
407                         // emit non-standard types. We do not handle their values now.
408                         type = Contacts.ContactMethodsColumns.TYPE_CUSTOM;
409                         label = typeString;
410                     }
411                 }
412                 // We use "HOME" as default
413                 if (type < 0) {
414                     type = Contacts.ContactMethodsColumns.TYPE_HOME;
415                 }
416                                 
417                 // adr-value    = 0*6(text-value ";") text-value
418                 //              ; PO Box, Extended Address, Street, Locality, Region, Postal
419                 //              ; Code, Country Name
420                 String address;
421                 List list = propertyNode.propValue_vector;
422                 int size = list.size();
423                 if (size > 1) {
424                     StringBuilder builder = new StringBuilder();
425                     boolean builderIsEmpty = true;
426                     if (Locale.getDefault().getCountry().equals(Locale.JAPAN.getCountry())) {
427                         // In Japan, the order is reversed.
428                         for (int i = size - 1; i >= 0; i--) {
429                             String addressPart = list.get(i);
430                             if (addressPart.length() > 0) {
431                                 if (!builderIsEmpty) {
432                                     builder.append(' ');
433                                 }
434                                 builder.append(addressPart);
435                                 builderIsEmpty = false;
436                             }
437                         }
438                     } else {
439                         for (int i = 0; i < size; i++) {
440                             String addressPart = list.get(i);
441                             if (addressPart.length() > 0) {
442                                 if (!builderIsEmpty) {
443                                     builder.append(' ');
444                                 }
445                                 builder.append(addressPart);
446                                 builderIsEmpty = false;
447                             }
448                         }
449                     }
450                     address = builder.toString().trim();
451                 } else {
452                     address = propertyNode.propValue; 
453                 }
454                 contact.addContactmethod(kind, type, address, label, isPrimary);
455             } else if (name.equals("ORG")) {
456                 // vCard specification does not specify other types.
457                 int type = Contacts.OrganizationColumns.TYPE_WORK;
458                 boolean isPrimary = false;
459                 
460                 for (String typeString : propertyNode.paramMap_TYPE) {
461                     if (typeString.equals("PREF") && !prefIsSetOrganization) {
462                         // vCard specification officially does not have PREF in ORG.
463                         // This is just for safety.
464                         prefIsSetOrganization = true;
465                         isPrimary = true;
466                     }
467                     // XXX: Should we cope with X- words?
468                 }
469 
470                 List list = propertyNode.propValue_vector; 
471                 int size = list.size();
472                 StringBuilder builder = new StringBuilder();
473                 for (Iterator iter = list.iterator(); iter.hasNext();) {
474                     builder.append(iter.next());
475                     if (iter.hasNext()) {
476                         builder.append(' ');
477                     }
478                 }
479 
480                 contact.addOrganization(type, builder.toString(), "", isPrimary);
481             } else if (name.equals("TITLE")) {
482                 contact.setPosition(propertyNode.propValue);
483             } else if (name.equals("ROLE")) {
484                 contact.setPosition(propertyNode.propValue);
485             } else if (name.equals("PHOTO")) {
486                 // We prefer PHOTO to LOGO.
487                 String valueType = propertyNode.paramMap.getAsString("VALUE");
488                 if (valueType != null && valueType.equals("URL")) {
489                     // TODO: do something.
490                 } else {
491                     // Assume PHOTO is stored in BASE64. In that case,
492                     // data is already stored in propValue_bytes in binary form.
493                     // It should be automatically done by VBuilder (VDataBuilder/VCardDatabuilder) 
494                     contact.photoBytes = propertyNode.propValue_bytes;
495                     String type = propertyNode.paramMap.getAsString("TYPE");
496                     if (type != null) {
497                         contact.photoType = type;
498                     }
499                 }
500             } else if (name.equals("LOGO")) {
501                 // When PHOTO is not available this is not URL,
502                 // we use this instead of PHOTO.
503                 String valueType = propertyNode.paramMap.getAsString("VALUE");
504                 if (valueType != null && valueType.equals("URL")) {
505                     // TODO: do something.
506                 } else if (contact.photoBytes == null) {
507                     contact.photoBytes = propertyNode.propValue_bytes;
508                     String type = propertyNode.paramMap.getAsString("TYPE");
509                     if (type != null) {
510                         contact.photoType = type;
511                     }
512                 }
513             } else if (name.equals("EMAIL")) {
514                 int type = -1;
515                 String label = null;
516                 boolean isPrimary = false;
517                 for (String typeString : propertyNode.paramMap_TYPE) {
518                     if (typeString.equals("PREF") && !prefIsSetEmail) {
519                         // Only first "PREF" is considered.
520                         prefIsSetEmail = true;
521                         isPrimary = true;
522                     } else if (typeString.equalsIgnoreCase("HOME")) {
523                         type = Contacts.ContactMethodsColumns.TYPE_HOME;
524                     } else if (typeString.equalsIgnoreCase("WORK")) {
525                         type = Contacts.ContactMethodsColumns.TYPE_WORK;
526                     } else if (typeString.equalsIgnoreCase("CELL")) {
527                         // We do not have Contacts.ContactMethodsColumns.TYPE_MOBILE yet.
528                         type = Contacts.ContactMethodsColumns.TYPE_CUSTOM;
529                         label = Contacts.ContactMethodsColumns.MOBILE_EMAIL_TYPE_NAME;
530                     } else if (typeString.toUpperCase().startsWith("X-") &&
531                             type < 0) {
532                         type = Contacts.ContactMethodsColumns.TYPE_CUSTOM;
533                         label = typeString.substring(2);
534                     } else if (type < 0) {
535                         // vCard 3.0 allows iana-token.
536                         // We may have INTERNET (specified in vCard spec),
537                         // SCHOOL, etc.
538                         type = Contacts.ContactMethodsColumns.TYPE_CUSTOM;
539                         label = typeString;
540                     }
541                 }
542                 // We use "OTHER" as default.
543                 if (type < 0) {
544                     type = Contacts.ContactMethodsColumns.TYPE_OTHER;
545                 }
546                 contact.addContactmethod(Contacts.KIND_EMAIL,
547                         type, propertyNode.propValue,label, isPrimary);
548             } else if (name.equals("TEL")) {
549                 int type = -1;
550                 String label = null;
551                 boolean isPrimary = false;
552                 boolean isFax = false;
553                 for (String typeString : propertyNode.paramMap_TYPE) {
554                     if (typeString.equals("PREF") && !prefIsSetPhone) {
555                         // Only first "PREF" is considered.
556                         prefIsSetPhone = true;
557                         isPrimary = true;
558                     } else if (typeString.equalsIgnoreCase("HOME")) {
559                         type = Contacts.PhonesColumns.TYPE_HOME;
560                     } else if (typeString.equalsIgnoreCase("WORK")) {
561                         type = Contacts.PhonesColumns.TYPE_WORK;
562                     } else if (typeString.equalsIgnoreCase("CELL")) {
563                         type = Contacts.PhonesColumns.TYPE_MOBILE;
564                     } else if (typeString.equalsIgnoreCase("PAGER")) {
565                         type = Contacts.PhonesColumns.TYPE_PAGER;
566                     } else if (typeString.equalsIgnoreCase("FAX")) {
567                         isFax = true;
568                     } else if (typeString.equalsIgnoreCase("VOICE") ||
569                             typeString.equalsIgnoreCase("MSG")) {
570                         // Defined in vCard 3.0. Ignore these because they
571                         // conflict with "HOME", "WORK", etc.
572                         // XXX: do something?
573                     } else if (typeString.toUpperCase().startsWith("X-") &&
574                             type < 0) {
575                         type = Contacts.PhonesColumns.TYPE_CUSTOM;
576                         label = typeString.substring(2);
577                     } else if (type < 0){
578                         // We may have MODEM, CAR, ISDN, etc...
579                         type = Contacts.PhonesColumns.TYPE_CUSTOM;
580                         label = typeString;
581                     }
582                 }
583                 // We use "HOME" as default
584                 if (type < 0) {
585                     type = Contacts.PhonesColumns.TYPE_HOME;
586                 }
587                 if (isFax) {
588                     if (type == Contacts.PhonesColumns.TYPE_HOME) {
589                         type = Contacts.PhonesColumns.TYPE_FAX_HOME; 
590                     } else if (type == Contacts.PhonesColumns.TYPE_WORK) {
591                         type = Contacts.PhonesColumns.TYPE_FAX_WORK; 
592                     }
593                 }
594 
595                 contact.addPhone(type, propertyNode.propValue, label, isPrimary);
596             } else if (name.equals("NOTE")) {
597                 contact.notes.add(propertyNode.propValue);
598             } else if (name.equals("BDAY")) {
599                 contact.addExtension(propertyNode);
600             } else if (name.equals("URL")) {
601                 contact.addExtension(propertyNode);
602             } else if (name.equals("REV")) {                
603                 // Revision of this VCard entry. I think we can ignore this.
604                 contact.addExtension(propertyNode);
605             } else if (name.equals("UID")) {
606                 contact.addExtension(propertyNode);
607             } else if (name.equals("KEY")) {
608                 // Type is X509 or PGP? I don't know how to handle this...
609                 contact.addExtension(propertyNode);
610             } else if (name.equals("MAILER")) {
611                 contact.addExtension(propertyNode);
612             } else if (name.equals("TZ")) {
613                 contact.addExtension(propertyNode);
614             } else if (name.equals("GEO")) {
615                 contact.addExtension(propertyNode);
616             } else if (name.equals("NICKNAME")) {
617                 // vCard 3.0 only.
618                 contact.addExtension(propertyNode);
619             } else if (name.equals("CLASS")) {
620                 // vCard 3.0 only.
621                 // e.g. CLASS:CONFIDENTIAL
622                 contact.addExtension(propertyNode);
623             } else if (name.equals("PROFILE")) {
624                 // VCard 3.0 only. Must be "VCARD". I think we can ignore this.
625                 contact.addExtension(propertyNode);
626             } else if (name.equals("CATEGORIES")) {
627                 // VCard 3.0 only.
628                 // e.g. CATEGORIES:INTERNET,IETF,INDUSTRY,INFORMATION TECHNOLOGY
629                 contact.addExtension(propertyNode);
630             } else if (name.equals("SOURCE")) {
631                 // VCard 3.0 only.
632                 contact.addExtension(propertyNode);
633             } else if (name.equals("PRODID")) {
634                 // VCard 3.0 only.
635                 // To specify the identifier for the product that created
636                 // the vCard object.
637                 contact.addExtension(propertyNode);
638             } else if (name.equals("X-PHONETIC-FIRST-NAME")) {
639                 xPhoneticFirstName = propertyNode.propValue;
640             } else if (name.equals("X-PHONETIC-MIDDLE-NAME")) {
641                 xPhoneticMiddleName = propertyNode.propValue;
642             } else if (name.equals("X-PHONETIC-LAST-NAME")) {
643                 xPhoneticLastName = propertyNode.propValue;
644             } else {
645                 // Unknown X- words and IANA token.
646                 contact.addExtension(propertyNode);
647             }
648         }
649 
650         if (fullName != null) {
651             contact.name = fullName;
652         } else if(nameFromNProperty != null) {
653             contact.name = nameFromNProperty;
654         } else {
655             contact.name = "";
656         }
657 
658         if (contact.phoneticName == null &&
659                 (xPhoneticFirstName != null || xPhoneticMiddleName != null ||
660                         xPhoneticLastName != null)) {
661             // Note: In Europe, this order should be "LAST FIRST MIDDLE". See the comment around
662             //       NAME_ORDER_TYPE_* for more detail.
663             String first;
664             String second;
665             if (nameOrderType == NAME_ORDER_TYPE_JAPANESE) {
666                 first = xPhoneticLastName;
667                 second = xPhoneticFirstName;
668             } else {
669                 first = xPhoneticFirstName;
670                 second = xPhoneticLastName;
671             }
672             StringBuilder builder = new StringBuilder();
673             if (first != null) {
674                 builder.append(first);
675             }
676             if (xPhoneticMiddleName != null) {
677                 builder.append(xPhoneticMiddleName);
678             }
679             if (second != null) {
680                 builder.append(second);
681             }
682             contact.phoneticName = builder.toString();
683         }
684         
685         // Remove unnecessary white spaces.
686         // It is found that some mobile phone emits  phonetic name with just one white space
687         // when a user does not specify one.
688         // This logic is effective toward such kind of weird data.
689         if (contact.phoneticName != null) {
690             contact.phoneticName = contact.phoneticName.trim();
691         }
692 
693         // If there is no "PREF", we choose the first entries as primary.
694         if (!prefIsSetPhone &&
695                 contact.phoneList != null && 
696                 contact.phoneList.size() > 0) {
697             contact.phoneList.get(0).isPrimary = true;
698         }
699 
700         if (!prefIsSetAddress && contact.contactmethodList != null) {
701             for (ContactMethod contactMethod : contact.contactmethodList) {
702                 if (contactMethod.kind == Contacts.KIND_POSTAL) {
703                     contactMethod.isPrimary = true;
704                     break;
705                 }
706             }
707         }
708         if (!prefIsSetEmail && contact.contactmethodList != null) {
709             for (ContactMethod contactMethod : contact.contactmethodList) {
710                 if (contactMethod.kind == Contacts.KIND_EMAIL) {
711                     contactMethod.isPrimary = true;
712                     break;
713                 }
714             }
715         }
716         if (!prefIsSetOrganization &&
717                 contact.organizationList != null &&
718                 contact.organizationList.size() > 0) {
719             contact.organizationList.get(0).isPrimary = true;
720         }
721         
722         return contact;
723     }
724     
725     public String displayString() {
726         if (name.length() > 0) {
727             return name;
728         }
729         if (contactmethodList != null && contactmethodList.size() > 0) {
730             for (ContactMethod contactMethod : contactmethodList) {
731                 if (contactMethod.kind == Contacts.KIND_EMAIL && contactMethod.isPrimary) {
732                     return contactMethod.data;
733                 }
734             }
735         }
736         if (phoneList != null && phoneList.size() > 0) {
737             for (PhoneData phoneData : phoneList) {
738                 if (phoneData.isPrimary) {
739                     return phoneData.data;
740                 }
741             }
742         }
743         return "";
744     }
745     
746 //    private void pushIntoContentProviderOrResolver(Object contentSomething,
747 //            long myContactsGroupId) {
748 //        ContentResolver resolver = null;
749 //        AbstractSyncableContentProvider provider = null;
750 //        if (contentSomething instanceof ContentResolver) {
751 //            resolver = (ContentResolver)contentSomething;
752 //        } else if (contentSomething instanceof AbstractSyncableContentProvider) {
753 //            provider = (AbstractSyncableContentProvider)contentSomething;
754 //        } else {
755 //            Log.e(LOG_TAG, "Unsupported object came.");
756 //            return;
757 //        }
758 //
759 //        ContentValues contentValues = new ContentValues();
760 //        contentValues.put(People.NAME, name);
761 //        contentValues.put(People.PHONETIC_NAME, phoneticName);
762 //
763 //        if (notes.size() > 1) {
764 //            StringBuilder builder = new StringBuilder();
765 //            for (String note : notes) {
766 //                builder.append(note);
767 //                builder.append("\n");
768 //            }
769 //            contentValues.put(People.NOTES, builder.toString());
770 //        } else if (notes.size() == 1){
771 //            contentValues.put(People.NOTES, notes.get(0));
772 //        }
773 //
774 //        Uri personUri;
775 //        long personId = 0;
776 //        if (resolver != null) {
777 //            personUri = Contacts.People.createPersonInMyContactsGroup(
778 //                    resolver, contentValues);
779 //            if (personUri != null) {
780 //                personId = ContentUris.parseId(personUri);
781 //            }
782 //        } else {
783 //            personUri = provider.nonTransactionalInsert(People.CONTENT_URI, contentValues);
784 //            if (personUri != null) {
785 //                personId = ContentUris.parseId(personUri);
786 //                ContentValues values = new ContentValues();
787 //                values.put(GroupMembership.PERSON_ID, personId);
788 //                values.put(GroupMembership.GROUP_ID, myContactsGroupId);
789 //                Uri resultUri = provider.nonTransactionalInsert(
790 //                        GroupMembership.CONTENT_URI, values);
791 //                if (resultUri == null) {
792 //                    Log.e(LOG_TAG, "Faild to insert the person to MyContact.");
793 //                    provider.nonTransactionalDelete(personUri, null, null);
794 //                    personUri = null;
795 //                }
796 //            }
797 //        }
798 //
799 //        if (personUri == null) {
800 //            Log.e(LOG_TAG, "Failed to create the contact.");
801 //            return;
802 //        }
803 //
804 //        if (photoBytes != null) {
805 //            if (resolver != null) {
806 //                People.setPhotoData(resolver, personUri, photoBytes);
807 //            } else {
808 //                Uri photoUri = Uri.withAppendedPath(personUri, Contacts.Photos.CONTENT_DIRECTORY);
809 //                ContentValues values = new ContentValues();
810 //                values.put(Photos.DATA, photoBytes);
811 //                provider.update(photoUri, values, null, null);
812 //            }
813 //        }
814 //
815 //        long primaryPhoneId = -1;
816 //        if (phoneList != null && phoneList.size() > 0) {
817 //            for (PhoneData phoneData : phoneList) {
818 //                ContentValues values = new ContentValues();
819 //                values.put(Contacts.PhonesColumns.TYPE, phoneData.type);
820 //                if (phoneData.type == Contacts.PhonesColumns.TYPE_CUSTOM) {
821 //                    values.put(Contacts.PhonesColumns.LABEL, phoneData.label);
822 //                }
823 //                // Already formatted.
824 //                values.put(Contacts.PhonesColumns.NUMBER, phoneData.data);
825 //
826 //                // Not sure about Contacts.PhonesColumns.NUMBER_KEY ...
827 //                values.put(Contacts.PhonesColumns.ISPRIMARY, 1);
828 //                values.put(Contacts.Phones.PERSON_ID, personId);
829 //                Uri phoneUri;
830 //                if (resolver != null) {
831 //                    phoneUri = resolver.insert(Phones.CONTENT_URI, values);
832 //                } else {
833 //                    phoneUri = provider.nonTransactionalInsert(Phones.CONTENT_URI, values);
834 //                }
835 //                if (phoneData.isPrimary) {
836 //                    primaryPhoneId = Long.parseLong(phoneUri.getLastPathSegment());
837 //                }
838 //            }
839 //        }
840 //
841 //        long primaryOrganizationId = -1;
842 //        if (organizationList != null && organizationList.size() > 0) {
843 //            for (OrganizationData organizationData : organizationList) {
844 //                ContentValues values = new ContentValues();
845 //                // Currently, we do not use TYPE_CUSTOM.
846 //                values.put(Contacts.OrganizationColumns.TYPE,
847 //                        organizationData.type);
848 //                values.put(Contacts.OrganizationColumns.COMPANY,
849 //                        organizationData.companyName);
850 //                values.put(Contacts.OrganizationColumns.TITLE,
851 //                        organizationData.positionName);
852 //                values.put(Contacts.OrganizationColumns.ISPRIMARY, 1);
853 //                values.put(Contacts.OrganizationColumns.PERSON_ID, personId);
854 //
855 //                Uri organizationUri;
856 //                if (resolver != null) {
857 //                    organizationUri = resolver.insert(Organizations.CONTENT_URI, values);
858 //                } else {
859 //                    organizationUri = provider.nonTransactionalInsert(
860 //                            Organizations.CONTENT_URI, values);
861 //                }
862 //                if (organizationData.isPrimary) {
863 //                    primaryOrganizationId = Long.parseLong(organizationUri.getLastPathSegment());
864 //                }
865 //            }
866 //        }
867 //
868 //        long primaryEmailId = -1;
869 //        if (contactmethodList != null && contactmethodList.size() > 0) {
870 //            for (ContactMethod contactMethod : contactmethodList) {
871 //                ContentValues values = new ContentValues();
872 //                values.put(Contacts.ContactMethodsColumns.KIND, contactMethod.kind);
873 //                values.put(Contacts.ContactMethodsColumns.TYPE, contactMethod.type);
874 //                if (contactMethod.type == Contacts.ContactMethodsColumns.TYPE_CUSTOM) {
875 //                    values.put(Contacts.ContactMethodsColumns.LABEL, contactMethod.label);
876 //                }
877 //                values.put(Contacts.ContactMethodsColumns.DATA, contactMethod.data);
878 //                values.put(Contacts.ContactMethodsColumns.ISPRIMARY, 1);
879 //                values.put(Contacts.ContactMethods.PERSON_ID, personId);
880 //
881 //                if (contactMethod.kind == Contacts.KIND_EMAIL) {
882 //                    Uri emailUri;
883 //                    if (resolver != null) {
884 //                        emailUri = resolver.insert(ContactMethods.CONTENT_URI, values);
885 //                    } else {
886 //                        emailUri = provider.nonTransactionalInsert(
887 //                                ContactMethods.CONTENT_URI, values);
888 //                    }
889 //                    if (contactMethod.isPrimary) {
890 //                        primaryEmailId = Long.parseLong(emailUri.getLastPathSegment());
891 //                    }
892 //                } else {  // probably KIND_POSTAL
893 //                    if (resolver != null) {
894 //                        resolver.insert(ContactMethods.CONTENT_URI, values);
895 //                    } else {
896 //                        provider.nonTransactionalInsert(
897 //                                ContactMethods.CONTENT_URI, values);
898 //                    }
899 //                }
900 //            }
901 //        }
902 //
903 //        if (extensionMap != null && extensionMap.size() > 0) {
904 //            ArrayList contentValuesArray;
905 //            if (resolver != null) {
906 //                contentValuesArray = new ArrayList();
907 //            } else {
908 //                contentValuesArray = null;
909 //            }
910 //            for (Entry> entry : extensionMap.entrySet()) {
911 //                String key = entry.getKey();
912 //                List list = entry.getValue();
913 //                for (String value : list) {
914 //                    ContentValues values = new ContentValues();
915 //                    values.put(Extensions.NAME, key);
916 //                    values.put(Extensions.VALUE, value);
917 //                    values.put(Extensions.PERSON_ID, personId);
918 //                    if (resolver != null) {
919 //                        contentValuesArray.add(values);
920 //                    } else {
921 //                        provider.nonTransactionalInsert(Extensions.CONTENT_URI, values);
922 //                    }
923 //                }
924 //            }
925 //            if (resolver != null) {
926 //                resolver.bulkInsert(Extensions.CONTENT_URI,
927 //                        contentValuesArray.toArray(new ContentValues[0]));
928 //            }
929 //        }
930 //
931 //        if (primaryPhoneId >= 0 || primaryOrganizationId >= 0 || primaryEmailId >= 0) {
932 //            ContentValues values = new ContentValues();
933 //            if (primaryPhoneId >= 0) {
934 //                values.put(People.PRIMARY_PHONE_ID, primaryPhoneId);
935 //            }
936 //            if (primaryOrganizationId >= 0) {
937 //                values.put(People.PRIMARY_ORGANIZATION_ID, primaryOrganizationId);
938 //            }
939 //            if (primaryEmailId >= 0) {
940 //                values.put(People.PRIMARY_EMAIL_ID, primaryEmailId);
941 //            }
942 //            if (resolver != null) {
943 //                resolver.update(personUri, values, null, null);
944 //            } else {
945 //                provider.nonTransactionalUpdate(personUri, values, null, null);
946 //            }
947 //        }
948 //    }
949 //
950 //    /**
951 //     * Push this object into database in the resolver.
952 //     */
953 //    public void pushIntoContentResolver(ContentResolver resolver) {
954 //        pushIntoContentProviderOrResolver(resolver, 0);
955 //    }
956 //
957 //    /**
958 //     * Push this object into AbstractSyncableContentProvider object.
959 //     */
960 //    public void pushIntoAbstractSyncableContentProvider(
961 //            AbstractSyncableContentProvider provider, long myContactsGroupId) {
962 //        boolean successful = false;
963 //        provider.beginTransaction();
964 //        try {
965 //            pushIntoContentProviderOrResolver(provider, myContactsGroupId);
966 //            successful = true;
967 //        } finally {
968 //            provider.endTransaction(successful);
969 //        }
970 //    }
971     
972     public boolean isIgnorable() {
973         return TextUtils.isEmpty(name) &&
974                 TextUtils.isEmpty(phoneticName) &&
975                 (phoneList == null || phoneList.size() == 0) &&
976                 (contactmethodList == null || contactmethodList.size() == 0);
977     }
978 }

   1 /*
   2  * Copyright (C) 2006 The Android Open Source Project
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *      http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16 
  17 package a_vcard.android.provider;
  18 
  19 //import com.android.internal.R;
  20 
  21 //import android.content.ContentResolver;
  22 //import android.content.ContentUris;
  23 //import android.content.ContentValues;
  24 //import android.content.Context;
  25 //import android.content.Intent;
  26 //import android.database.Cursor;
  27 //import android.graphics.Bitmap;
  28 //import android.graphics.BitmapFactory;
  29 //import android.net.Uri;
  30 //import android.text.TextUtils;
  31 //import android.util.Log;
  32 //import android.widget.ImageView;
  33 
  34 //import java.io.ByteArrayInputStream;
  35 //import java.io.InputStream;
  36 
  37 /**
  38  * The Contacts provider stores all information about contacts.
  39  */
  40 public class Contacts {
  41     private static final String TAG = "Contacts";
  42     
  43     public static final String AUTHORITY = "contacts";
  44 
  45 //    /**
  46 //     * The content:// style URL for this provider
  47 //     */
  48 //    public static final Uri CONTENT_URI =
  49 //        Uri.parse("content://" + AUTHORITY);
  50 
  51     /** Signifies an email address row that is stored in the ContactMethods table */
  52     public static final int KIND_EMAIL = 1;
  53     /** Signifies a postal address row that is stored in the ContactMethods table */
  54     public static final int KIND_POSTAL = 2;
  55     /** Signifies an IM address row that is stored in the ContactMethods table */
  56     public static final int KIND_IM = 3;
  57     /** Signifies an Organization row that is stored in the Organizations table */
  58     public static final int KIND_ORGANIZATION = 4;
  59     /** Signifies an Phone row that is stored in the Phones table */
  60     public static final int KIND_PHONE = 5;
  61 
  62     /**
  63      * no public constructor since this is a utility class
  64      */
  65     private Contacts() {}
  66 
  67 //    /**
  68 //     * Columns from the Settings table that other columns join into themselves.
  69 //     */
  70 //    public interface SettingsColumns {
  71 //        /**
  72 //         * The _SYNC_ACCOUNT to which this setting corresponds. This may be null.
  73 //         * Type: TEXT
  74 //         */
  75 //        public static final String _SYNC_ACCOUNT = "_sync_account";
  76 //
  77 //        /**
  78 //         * The key of this setting.
  79 //         * Type: TEXT
  80 //         */
  81 //        public static final String KEY = "key";
  82 //
  83 //        /**
  84 //         * The value of this setting.
  85 //         * Type: TEXT
  86 //         */
  87 //        public static final String VALUE = "value";
  88 //    }
  89 //
  90 //    /**
  91 //     * The settings over all of the people
  92 //     */
  93 //    public static final class Settings implements BaseColumns, SettingsColumns {
  94 //        /**
  95 //         * no public constructor since this is a utility class
  96 //         */
  97 //        private Settings() {}
  98 //
  99 //        /**
 100 //         * The content:// style URL for this table
 101 //         */
 102 //        public static final Uri CONTENT_URI =
 103 //            Uri.parse("content://contacts/settings");
 104 //
 105 //        /**
 106 //         * The directory twig for this sub-table
 107 //         */
 108 //        public static final String CONTENT_DIRECTORY = "settings";
 109 //
 110 //        /**
 111 //         * The default sort order for this table
 112 //         */
 113 //        public static final String DEFAULT_SORT_ORDER = "key ASC";
 114 //
 115 //        /**
 116 //         * A setting that is used to indicate if we should sync down all groups for the
 117 //         * specified account. For this setting the _SYNC_ACCOUNT column must be set.
 118 //         * If this isn't set then we will only sync the groups whose SHOULD_SYNC column
 119 //         * is set to true.
 120 //         * 
 121 //         * This is a boolean setting. It is true if it is set and it is anything other than the
 122 //         * emptry string or "0".
 123 //         */
 124 //        public static final String SYNC_EVERYTHING = "syncEverything";
 125 //
 126 //        public static String getSetting(ContentResolver cr, String account, String key) {
 127 //            // For now we only support a single account and the UI doesn't know what
 128 //            // the account name is, so we're using a global setting for SYNC_EVERYTHING.
 129 //            // Some day when we add multiple accounts to the UI this should honor the account
 130 //            // that was asked for.
 131 //            String selectString;
 132 //            String[] selectArgs;
 133 //            if (false) {
 134 //                selectString = (account == null)
 135 //                        ? "_sync_account is null AND key=?"
 136 //                        : "_sync_account=? AND key=?";
 137 //                selectArgs = (account == null)
 138 //                ? new String[]{key}
 139 //                : new String[]{account, key};
 140 //            } else {
 141 //                selectString = "key=?";
 142 //                selectArgs = new String[] {key};
 143 //            }
 144 //            Cursor cursor = cr.query(Settings.CONTENT_URI, new String[]{VALUE},
 145 //                    selectString, selectArgs, null);
 146 //            try {
 147 //                if (!cursor.moveToNext()) return null;
 148 //                return cursor.getString(0);
 149 //            } finally {
 150 //                cursor.close();
 151 //            }
 152 //        }
 153 //
 154 //        public static void setSetting(ContentResolver cr, String account, String key,
 155 //                String value) {
 156 //            ContentValues values = new ContentValues();
 157 //            // For now we only support a single account and the UI doesn't know what
 158 //            // the account name is, so we're using a global setting for SYNC_EVERYTHING.
 159 //            // Some day when we add multiple accounts to the UI this should honor the account
 160 //            // that was asked for.
 161 //            //values.put(_SYNC_ACCOUNT, account);
 162 //            values.put(KEY, key);
 163 //            values.put(VALUE, value);
 164 //            cr.update(Settings.CONTENT_URI, values, null, null);
 165 //        }
 166 //    }
 167 //
 168     /**
 169      * Columns from the People table that other tables join into themselves.
 170      */
 171     public interface PeopleColumns {
 172         /**
 173          * The person's name.
 174          * 
Type: TEXT
 175          */
 176         public static final String NAME = "name";
 177 
 178         /**
 179          * Phonetic equivalent of the person's name, in a locale-dependent
 180          * character set (e.g. hiragana for Japanese).
 181          * Used for pronunciation and/or collation in some languages.
 182          * Type: TEXT
 183          */
 184         public static final String PHONETIC_NAME = "phonetic_name";
 185         
 186         /**
 187          * The display name. If name is not null name, else if number is not null number,
 188          * else if email is not null email.
 189          * Type: TEXT
 190          */
 191         public static final String DISPLAY_NAME = "display_name";
 192 
 193         /**
 194          * The field for sorting list phonetically. The content of this field
 195          * may not be human readable but phonetically sortable.
 196          * Type: TEXT
 197          * @hide Used only in Contacts application for now.
 198          */
 199         public static final String SORT_STRING = "sort_string";
 200         
 201         /**
 202          * Notes about the person.
 203          * Type: TEXT
 204          */
 205         public static final String NOTES = "notes";
 206 
 207         /**
 208          * The number of times a person has been contacted
 209          * Type: INTEGER
 210          */
 211         public static final String TIMES_CONTACTED = "times_contacted";
 212 
 213         /**
 214          * The last time a person was contacted.
 215          * Type: INTEGER
 216          */
 217         public static final String LAST_TIME_CONTACTED = "last_time_contacted";
 218 
 219         /**
 220          * A custom ringtone associated with a person. Not always present.
 221          * Type: TEXT (URI to the ringtone)
 222          */
 223         public static final String CUSTOM_RINGTONE = "custom_ringtone";
 224 
 225         /**
 226          * Whether the person should always be sent to voicemail. Not always
 227          * present.
 228          * Type: INTEGER (0 for false, 1 for true)
 229          */
 230         public static final String SEND_TO_VOICEMAIL = "send_to_voicemail";
 231 
 232         /**
 233          * Is the contact starred?
 234          * Type: INTEGER (boolean)
 235          */
 236         public static final String STARRED = "starred";
 237 
 238         /**
 239          * The server version of the photo
 240          * Type: TEXT (the version number portion of the photo URI)
 241          */
 242         public static final String PHOTO_VERSION = "photo_version";       
 243     }
 244 //
 245 //    /**
 246 //     * This table contains people.
 247 //     */
 248 //    public static final class People implements BaseColumns, SyncConstValue, PeopleColumns,
 249 //            PhonesColumns, PresenceColumns {
 250 //        /**
 251 //         * no public constructor since this is a utility class
 252 //         */
 253 //        private People() {}
 254 //
 255 //        /**
 256 //         * The content:// style URL for this table
 257 //         */
 258 //        public static final Uri CONTENT_URI =
 259 //            Uri.parse("content://contacts/people");
 260 //
 261 //        /**
 262 //         * The content:// style URL for filtering people by name. The filter
 263 //         * argument should be passed as an additional path segment after this URI.
 264 //         */
 265 //        public static final Uri CONTENT_FILTER_URI =
 266 //            Uri.parse("content://contacts/people/filter");
 267 //
 268 //        /**
 269 //         * The content:// style URL for the table that holds the deleted
 270 //         * contacts.
 271 //         */
 272 //        public static final Uri DELETED_CONTENT_URI =
 273 //            Uri.parse("content://contacts/deleted_people");
 274 //
 275 //        /**
 276 //         * The content:// style URL for filtering people that have a specific
 277 //         * E-mail or IM address. The filter argument should be passed as an
 278 //         * additional path segment after this URI. This matches any people with
 279 //         * at least one E-mail or IM {@link ContactMethods} that match the
 280 //         * filter.
 281 //         *
 282 //         * Not exposed because we expect significant changes in the contacts
 283 //         * schema and do not want to have to support this.
 284 //         * @hide
 285 //         */
 286 //        public static final Uri WITH_EMAIL_OR_IM_FILTER_URI =
 287 //            Uri.parse("content://contacts/people/with_email_or_im_filter");
 288 //
 289 //        /**
 290 //         * The MIME type of {@link #CONTENT_URI} providing a directory of
 291 //         * people.
 292 //         */
 293 //        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/person";
 294 //
 295 //        /**
 296 //         * The MIME type of a {@link #CONTENT_URI} subdirectory of a single
 297 //         * person.
 298 //         */
 299 //        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/person";
 300 //
 301 //        /**
 302 //         * The default sort order for this table
 303 //         */
 304 //        public static final String DEFAULT_SORT_ORDER = People.NAME + " ASC";
 305 //
 306 //        /**
 307 //         * The ID of the persons preferred phone number.
 308 //         * Type: INTEGER (foreign key to phones table on the _ID field)
 309 //         */
 310 //        public static final String PRIMARY_PHONE_ID = "primary_phone";
 311 //
 312 //        /**
 313 //         * The ID of the persons preferred email.
 314 //         * Type: INTEGER (foreign key to contact_methods table on the
 315 //         * _ID field)
 316 //         */
 317 //        public static final String PRIMARY_EMAIL_ID = "primary_email";
 318 //
 319 //        /**
 320 //         * The ID of the persons preferred organization.
 321 //         * Type: INTEGER (foreign key to organizations table on the
 322 //         * _ID field)
 323 //         */
 324 //        public static final String PRIMARY_ORGANIZATION_ID = "primary_organization";
 325 //
 326 //        /**
 327 //         * Mark a person as having been contacted.
 328 //         *
 329 //         * @param resolver the ContentResolver to use
 330 //         * @param personId the person who was contacted
 331 //         */
 332 //        public static void markAsContacted(ContentResolver resolver, long personId) {
 333 //            Uri uri = ContentUris.withAppendedId(CONTENT_URI, personId);
 334 //            uri = Uri.withAppendedPath(uri, "update_contact_time");
 335 //            ContentValues values = new ContentValues();
 336 //            // There is a trigger in place that will update TIMES_CONTACTED when
 337 //            // LAST_TIME_CONTACTED is modified.
 338 //            values.put(LAST_TIME_CONTACTED, System.currentTimeMillis());
 339 //            resolver.update(uri, values, null, null);
 340 //        }
 341 //
 342 //        /**
 343 //         * @hide Used in vCard parser code.
 344 //         */
 345 //        public static long tryGetMyContactsGroupId(ContentResolver resolver) {
 346 //            Cursor groupsCursor = resolver.query(Groups.CONTENT_URI, GROUPS_PROJECTION,
 347 //                    Groups.SYSTEM_ID + "='" + Groups.GROUP_MY_CONTACTS + "'", null, null);
 348 //            if (groupsCursor != null) {
 349 //                try {
 350 //                    if (groupsCursor.moveToFirst()) {
 351 //                        return groupsCursor.getLong(0);
 352 //                    }
 353 //                } finally {
 354 //                    groupsCursor.close();
 355 //                }
 356 //            }
 357 //            return 0;
 358 //        }
 359 //
 360 //        /**
 361 //         * Adds a person to the My Contacts group.
 362 //         *
 363 //         * @param resolver the resolver to use
 364 //         * @param personId the person to add to the group
 365 //         * @return the URI of the group membership row
 366 //         * @throws IllegalStateException if the My Contacts group can't be found
 367 //         */
 368 //        public static Uri addToMyContactsGroup(ContentResolver resolver, long personId) {
 369 //            long groupId = tryGetMyContactsGroupId(resolver);
 370 //            if (groupId == 0) {
 371 //                throw new IllegalStateException("Failed to find the My Contacts group");
 372 //            }
 373 //
 374 //            return addToGroup(resolver, personId, groupId);
 375 //        }
 376 //
 377 //        /**
 378 //         * Adds a person to a group referred to by name.
 379 //         *
 380 //         * @param resolver the resolver to use
 381 //         * @param personId the person to add to the group
 382 //         * @param groupName the name of the group to add the contact to
 383 //         * @return the URI of the group membership row
 384 //         * @throws IllegalStateException if the group can't be found
 385 //         */
 386 //        public static Uri addToGroup(ContentResolver resolver, long personId, String groupName) {
 387 //            long groupId = 0;
 388 //            Cursor groupsCursor = resolver.query(Groups.CONTENT_URI, GROUPS_PROJECTION,
 389 //                    Groups.NAME + "=?", new String[] { groupName }, null);
 390 //            if (groupsCursor != null) {
 391 //                try {
 392 //                    if (groupsCursor.moveToFirst()) {
 393 //                        groupId = groupsCursor.getLong(0);
 394 //                    }
 395 //                } finally {
 396 //                    groupsCursor.close();
 397 //                }
 398 //            }
 399 //
 400 //            if (groupId == 0) {
 401 //                throw new IllegalStateException("Failed to find the My Contacts group");
 402 //            }
 403 //
 404 //            return addToGroup(resolver, personId, groupId);
 405 //        }
 406 //
 407 //        /**
 408 //         * Adds a person to a group.
 409 //         *
 410 //         * @param resolver the resolver to use
 411 //         * @param personId the person to add to the group
 412 //         * @param groupId the group to add the person to
 413 //         * @return the URI of the group membership row
 414 //         */
 415 //        public static Uri addToGroup(ContentResolver resolver, long personId, long groupId) {
 416 //            ContentValues values = new ContentValues();
 417 //            values.put(GroupMembership.PERSON_ID, personId);
 418 //            values.put(GroupMembership.GROUP_ID, groupId);
 419 //            return resolver.insert(GroupMembership.CONTENT_URI, values);
 420 //        }
 421 //
 422 //        private static final String[] GROUPS_PROJECTION = new String[] {
 423 //            Groups._ID,
 424 //        };
 425 //
 426 //        /**
 427 //         * Creates a new contacts and adds it to the "My Contacts" group.
 428 //         *
 429 //         * @param resolver the ContentResolver to use
 430 //         * @param values the values to use when creating the contact
 431 //         * @return the URI of the contact, or null if the operation fails
 432 //         */
 433 //        public static Uri createPersonInMyContactsGroup(ContentResolver resolver,
 434 //                ContentValues values) {
 435 //
 436 //            Uri contactUri = resolver.insert(People.CONTENT_URI, values);
 437 //            if (contactUri == null) {
 438 //                Log.e(TAG, "Failed to create the contact");
 439 //                return null;
 440 //            }
 441 //
 442 //            if (addToMyContactsGroup(resolver, ContentUris.parseId(contactUri)) == null) {
 443 //                resolver.delete(contactUri, null, null);
 444 //                return null;
 445 //            }
 446 //            return contactUri;
 447 //        }
 448 //
 449 //        public static Cursor queryGroups(ContentResolver resolver, long person) {
 450 //            return resolver.query(GroupMembership.CONTENT_URI, null, "person=?",
 451 //                    new String[]{String.valueOf(person)}, Groups.DEFAULT_SORT_ORDER);
 452 //        }
 453 //
 454 //        /**
 455 //         * Set the photo for this person. data may be null
 456 //         * @param cr the ContentResolver to use
 457 //         * @param person the Uri of the person whose photo is to be updated
 458 //         * @param data the byte[] that represents the photo
 459 //         */
 460 //        public static void setPhotoData(ContentResolver cr, Uri person, byte[] data) {
 461 //            Uri photoUri = Uri.withAppendedPath(person, Contacts.Photos.CONTENT_DIRECTORY);
 462 //            ContentValues values = new ContentValues();
 463 //            values.put(Photos.DATA, data);
 464 //            cr.update(photoUri, values, null, null);
 465 //        }
 466 //
 467 //        /**
 468 //         * Opens an InputStream for the person's photo and returns the photo as a Bitmap.
 469 //         * If the person's photo isn't present returns the placeholderImageResource instead.
 470 //         * @param person the person whose photo should be used
 471 //         */
 472 //        public static InputStream openContactPhotoInputStream(ContentResolver cr, Uri person) {
 473 //            Uri photoUri = Uri.withAppendedPath(person, Contacts.Photos.CONTENT_DIRECTORY);
 474 //            Cursor cursor = cr.query(photoUri, new String[]{Photos.DATA}, null, null, null);
 475 //            try {
 476 //                if (!cursor.moveToNext()) {
 477 //                    return null;
 478 //                }
 479 //                byte[] data = cursor.getBlob(0);
 480 //                if (data == null) {
 481 //                    return null;
 482 //                }
 483 //                return new ByteArrayInputStream(data);
 484 //            } finally {
 485 //                cursor.close();
 486 //            }
 487 //        }
 488 //
 489 //        /**
 490 //         * Opens an InputStream for the person's photo and returns the photo as a Bitmap.
 491 //         * If the person's photo isn't present returns the placeholderImageResource instead.
 492 //         * @param context the Context
 493 //         * @param person the person whose photo should be used
 494 //         * @param placeholderImageResource the image resource to use if the person doesn't
 495 //         *   have a photo
 496 //         * @param options the decoding options, can be set to null
 497 //         */
 498 //        public static Bitmap loadContactPhoto(Context context, Uri person,
 499 //                int placeholderImageResource, BitmapFactory.Options options) {
 500 //            if (person == null) {
 501 //                return loadPlaceholderPhoto(placeholderImageResource, context, options);
 502 //            }
 503 //
 504 //            InputStream stream = openContactPhotoInputStream(context.getContentResolver(), person);
 505 //            Bitmap bm = stream != null ? BitmapFactory.decodeStream(stream, null, options) : null;
 506 //            if (bm == null) {
 507 //                bm = loadPlaceholderPhoto(placeholderImageResource, context, options);
 508 //            }
 509 //            return bm;
 510 //        }
 511 //
 512 //        private static Bitmap loadPlaceholderPhoto(int placeholderImageResource, Context context,
 513 //                BitmapFactory.Options options) {
 514 //            if (placeholderImageResource == 0) {
 515 //                return null;
 516 //            }
 517 //            return BitmapFactory.decodeResource(context.getResources(),
 518 //                    placeholderImageResource, options);
 519 //        }
 520 
 521         /**
 522          * A sub directory of a single person that contains all of their Phones.
 523          */
 524         public static final class Phones implements BaseColumns, PhonesColumns,
 525                 PeopleColumns {
 526             /**
 527              * no public constructor since this is a utility class
 528              */
 529             private Phones() {}
 530 
 531             /**
 532              * The directory twig for this sub-table
 533              */
 534             public static final String CONTENT_DIRECTORY = "phones";
 535 
 536             /**
 537              * The default sort order for this table
 538              */
 539             public static final String DEFAULT_SORT_ORDER = "number ASC";
 540         }
 541 
 542         /**
 543          * A subdirectory of a single person that contains all of their
 544          * ContactMethods.
 545          */
 546         public static final class ContactMethods
 547                 implements BaseColumns, ContactMethodsColumns, PeopleColumns {
 548             /**
 549              * no public constructor since this is a utility class
 550              */
 551             private ContactMethods() {}
 552 
 553             /**
 554              * The directory twig for this sub-table
 555              */
 556             public static final String CONTENT_DIRECTORY = "contact_methods";
 557 
 558             /**
 559              * The default sort order for this table
 560              */
 561             public static final String DEFAULT_SORT_ORDER = "data ASC";
 562         }
 563 
 564 //        /**
 565 //         * The extensions for a person
 566 //         */
 567 //        public static class Extensions implements BaseColumns, ExtensionsColumns {
 568 //            /**
 569 //             * no public constructor since this is a utility class
 570 //             */
 571 //            private Extensions() {}
 572 //
 573 //            /**
 574 //             * The directory twig for this sub-table
 575 //             */
 576 //            public static final String CONTENT_DIRECTORY = "extensions";
 577 //
 578 //            /**
 579 //             * The default sort order for this table
 580 //             */
 581 //            public static final String DEFAULT_SORT_ORDER = "name ASC";
 582 //
 583 //            /**
 584 //             * The ID of the person this phone number is assigned to.
 585 //             * Type: INTEGER (long)
 586 //             */
 587 //            public static final String PERSON_ID = "person";
 588 //        }
 589 //    }
 590 //
 591 //    /**
 592 //     * Columns from the groups table.
 593 //     */
 594 //    public interface GroupsColumns {
 595 //        /**
 596 //         * The group name.
 597 //         * Type: TEXT
 598 //         */
 599 //        public static final String NAME = "name";
 600 //
 601 //        /**
 602 //         * Notes about the group.
 603 //         * Type: TEXT
 604 //         */
 605 //        public static final String NOTES = "notes";
 606 //
 607 //        /**
 608 //         * Whether this group should be synced if the SYNC_EVERYTHING settings is false
 609 //         * for this group's account.
 610 //         * Type: INTEGER (boolean)
 611 //         */
 612 //        public static final String SHOULD_SYNC = "should_sync";
 613 //
 614 //        /**
 615 //         * The ID of this group if it is a System Group, null otherwise.
 616 //         * Type: TEXT
 617 //         */
 618 //        public static final String SYSTEM_ID = "system_id";
 619 //    }
 620 //
 621 //    /**
 622 //     * This table contains the groups for an account.
 623 //     */
 624 //    public static final class Groups
 625 //            implements BaseColumns, SyncConstValue, GroupsColumns {
 626 //        /**
 627 //         * no public constructor since this is a utility class
 628 //         */
 629 //        private Groups() {}
 630 //
 631 //        /**
 632 //         * The content:// style URL for this table
 633 //         */
 634 //        public static final Uri CONTENT_URI =
 635 //            Uri.parse("content://contacts/groups");
 636 //
 637 //        /**
 638 //         * The content:// style URL for the table that holds the deleted
 639 //         * groups.
 640 //         */
 641 //        public static final Uri DELETED_CONTENT_URI =
 642 //            Uri.parse("content://contacts/deleted_groups");
 643 //
 644 //        /**
 645 //         * The MIME type of {@link #CONTENT_URI} providing a directory of
 646 //         * groups.
 647 //         */
 648 //        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/contactsgroup";
 649 //
 650 //        /**
 651 //         * The MIME type of a {@link #CONTENT_URI} subdirectory of a single
 652 //         * group.
 653 //         */
 654 //        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/contactsgroup";
 655 //
 656 //        /**
 657 //         * The default sort order for this table
 658 //         */
 659 //        public static final String DEFAULT_SORT_ORDER = NAME + " ASC";
 660 //
 661 //        /**
 662 //         *
 663 //         */
 664 //        public static final String GROUP_ANDROID_STARRED = "Starred in Android";
 665 //
 666 //        /**
 667 //         * The "My Contacts" system group.
 668 //         */
 669 //        public static final String GROUP_MY_CONTACTS = "Contacts";
 670 //    }
 671 //
 672     /**
 673      * Columns from the Phones table that other columns join into themselves.
 674      */
 675     public interface PhonesColumns {
 676         /**
 677          * The type of the the phone number.
 678          * Type: INTEGER (one of the constants below)
 679          */
 680         public static final String TYPE = "type";
 681 
 682         public static final int TYPE_CUSTOM = 0;
 683         public static final int TYPE_HOME = 1;
 684         public static final int TYPE_MOBILE = 2;
 685         public static final int TYPE_WORK = 3;
 686         public static final int TYPE_FAX_WORK = 4;
 687         public static final int TYPE_FAX_HOME = 5;
 688         public static final int TYPE_PAGER = 6;
 689         public static final int TYPE_OTHER = 7;
 690 
 691         /**
 692          * The user provided label for the phone number, only used if TYPE is TYPE_CUSTOM.
 693          * Type: TEXT
 694          */
 695         public static final String LABEL = "label";
 696 
 697         /**
 698          * The phone number as the user entered it.
 699          * Type: TEXT
 700          */
 701         public static final String NUMBER = "number";
 702 
 703         /**
 704          * The normalized phone number
 705          * Type: TEXT
 706          */
 707         public static final String NUMBER_KEY = "number_key";
 708 
 709         /**
 710          * Whether this is the primary phone number
 711          * Type: INTEGER (if set, non-0 means true)
 712          */
 713         public static final String ISPRIMARY = "isprimary";
 714     }
 715 //
 716 //    /**
 717 //     * This table stores phone numbers and a reference to the person that the
 718 //     * contact method belongs to. Phone numbers are stored separately from
 719 //     * other contact methods to make caller ID lookup more efficient.
 720 //     */
 721 //    public static final class Phones
 722 //            implements BaseColumns, PhonesColumns, PeopleColumns {
 723 //        /**
 724 //         * no public constructor since this is a utility class
 725 //         */
 726 //        private Phones() {}
 727 //
 728 //        public static final CharSequence getDisplayLabel(Context context, int type,
 729 //                CharSequence label, CharSequence[] labelArray) {
 730 //            CharSequence display = "";
 731 //
 732 //            if (type != People.Phones.TYPE_CUSTOM) {
 733 //                CharSequence[] labels = labelArray != null? labelArray
 734 //                        : context.getResources().getTextArray(
 735 //                                com.android.internal.R.array.phoneTypes);
 736 //                try {
 737 //                    display = labels[type - 1];
 738 //                } catch (ArrayIndexOutOfBoundsException e) {
 739 //                    display = labels[People.Phones.TYPE_HOME - 1];
 740 //                }
 741 //            } else {
 742 //                if (!TextUtils.isEmpty(label)) {
 743 //                    display = label;
 744 //                }
 745 //            }
 746 //            return display;
 747 //        }
 748 //
 749 //        public static final CharSequence getDisplayLabel(Context context, int type,
 750 //                CharSequence label) {
 751 //            return getDisplayLabel(context, type, label, null);
 752 //        }
 753 //
 754 //        /**
 755 //         * The content:// style URL for this table
 756 //         */
 757 //        public static final Uri CONTENT_URI =
 758 //            Uri.parse("content://contacts/phones");
 759 //
 760 //        /**
 761 //         * The content:// style URL for filtering phone numbers
 762 //         */
 763 //        public static final Uri CONTENT_FILTER_URL =
 764 //            Uri.parse("content://contacts/phones/filter");
 765 //
 766 //        /**
 767 //         * The MIME type of {@link #CONTENT_URI} providing a directory of
 768 //         * phones.
 769 //         */
 770 //        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/phone";
 771 //
 772 //        /**
 773 //         * The MIME type of a {@link #CONTENT_URI} subdirectory of a single
 774 //         * phone.
 775 //         */
 776 //        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/phone";
 777 //
 778 //        /**
 779 //         * The default sort order for this table
 780 //         */
 781 //        public static final String DEFAULT_SORT_ORDER = "name ASC";
 782 //
 783 //        /**
 784 //         * The ID of the person this phone number is assigned to.
 785 //         * Type: INTEGER (long)
 786 //         */
 787 //        public static final String PERSON_ID = "person";
 788 //    }
 789 //
 790 //    public static final class GroupMembership implements BaseColumns, GroupsColumns {
 791 //        /**
 792 //         * no public constructor since this is a utility class
 793 //         */
 794 //        private GroupMembership() {}
 795 //
 796 //        /**
 797 //         * The content:// style URL for this table
 798 //         */
 799 //        public static final Uri CONTENT_URI =
 800 //            Uri.parse("content://contacts/groupmembership");
 801 //
 802 //        /**
 803 //         * The content:// style URL for this table
 804 //         */
 805 //        public static final Uri RAW_CONTENT_URI =
 806 //            Uri.parse("content://contacts/groupmembershipraw");
 807 //
 808 //        /**
 809 //         * The directory twig for this sub-table
 810 //         */
 811 //        public static final String CONTENT_DIRECTORY = "groupmembership";
 812 //        /**
 813 //         * The MIME type of {@link #CONTENT_URI} providing a directory of all
 814 //         * person groups.
 815 //         */
 816 //        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/contactsgroupmembership";
 817 //
 818 //        /**
 819 //         * The MIME type of a {@link #CONTENT_URI} subdirectory of a single
 820 //         * person group.
 821 //         */
 822 //        public static final String CONTENT_ITEM_TYPE =
 823 //                "vnd.android.cursor.item/contactsgroupmembership";
 824 //
 825 //        /**
 826 //         * The default sort order for this table
 827 //         */
 828 //        public static final String DEFAULT_SORT_ORDER = "group_id ASC";
 829 //
 830 //        /**
 831 //         * The row id of the accounts group.
 832 //         * Type: TEXT
 833 //         */
 834 //        public static final String GROUP_ID = "group_id";
 835 //
 836 //        /**
 837 //         * The sync id of the group.
 838 //         * Type: TEXT
 839 //         */
 840 //        public static final String GROUP_SYNC_ID = "group_sync_id";
 841 //
 842 //        /**
 843 //         * The account of the group.
 844 //         * Type: TEXT
 845 //         */
 846 //        public static final String GROUP_SYNC_ACCOUNT = "group_sync_account";
 847 //
 848 //        /**
 849 //         * The row id of the person.
 850 //         * Type: TEXT
 851 //         */
 852 //        public static final String PERSON_ID = "person";
 853 //    }
 854 //
 855     /**
 856      * Columns from the ContactMethods table that other tables join into
 857      * themseleves.
 858      */
 859     public interface ContactMethodsColumns {
 860         /**
 861          * The kind of the the contact method. For example, email address,
 862          * postal address, etc.
 863          * Type: INTEGER (one of the values below)
 864          */
 865         public static final String KIND = "kind";
 866 
 867         /**
 868          * The type of the contact method, must be one of the types below.
 869          * Type: INTEGER (one of the values below)
 870          */
 871         public static final String TYPE = "type";
 872         public static final int TYPE_CUSTOM = 0;
 873         public static final int TYPE_HOME = 1;
 874         public static final int TYPE_WORK = 2;
 875         public static final int TYPE_OTHER = 3;
 876 
 877         /**
 878          * @hide This is temporal. TYPE_MOBILE should be added to TYPE in the future.
 879          */
 880         public static final int MOBILE_EMAIL_TYPE_INDEX = 2;
 881 
 882         /**
 883          * @hide This is temporal. TYPE_MOBILE should be added to TYPE in the future.
 884          * This is not "mobile" but "CELL" since vCard uses it for identifying mobile phone.
 885          */
 886         public static final String MOBILE_EMAIL_TYPE_NAME = "_AUTO_CELL";
 887 
 888         /**
 889          * The user defined label for the the contact method.
 890          * Type: TEXT
 891          */
 892         public static final String LABEL = "label";
 893 
 894         /**
 895          * The data for the contact method.
 896          * Type: TEXT
 897          */
 898         public static final String DATA = "data";
 899 
 900         /**
 901          * Auxiliary data for the contact method.
 902          * Type: TEXT
 903          */
 904         public static final String AUX_DATA = "aux_data";
 905 
 906         /**
 907          * Whether this is the primary organization
 908          * Type: INTEGER (if set, non-0 means true)
 909          */
 910         public static final String ISPRIMARY = "isprimary";
 911     }
 912 //
 913 //    /**
 914 //     * This table stores all non-phone contact methods and a reference to the
 915 //     * person that the contact method belongs to.
 916 //     */
 917 //    public static final class ContactMethods
 918 //            implements BaseColumns, ContactMethodsColumns, PeopleColumns {
 919 //        /**
 920 //         * The column with latitude data for postal locations
 921 //         * Type: REAL
 922 //         */
 923 //        public static final String POSTAL_LOCATION_LATITUDE = DATA;
 924 //
 925 //        /**
 926 //         * The column with longitude data for postal locations
 927 //         * Type: REAL
 928 //         */
 929 //        public static final String POSTAL_LOCATION_LONGITUDE = AUX_DATA;
 930 //
 931 //        /**
 932 //         * The predefined IM protocol types. The protocol can either be non-present, one
 933 //         * of these types, or a free-form string. These cases are encoded in the AUX_DATA
 934 //         * column as:
 935 //         *  - null
 936 //         *  - pre:
 937 //         *  - custom:
 938 //         */
 939 //        public static final int PROTOCOL_AIM = 0;
 940 //        public static final int PROTOCOL_MSN = 1;
 941 //        public static final int PROTOCOL_YAHOO = 2;
 942 //        public static final int PROTOCOL_SKYPE = 3;
 943 //        public static final int PROTOCOL_QQ = 4;
 944 //        public static final int PROTOCOL_GOOGLE_TALK = 5;
 945 //        public static final int PROTOCOL_ICQ = 6;
 946 //        public static final int PROTOCOL_JABBER = 7;
 947 //
 948 //        public static String encodePredefinedImProtocol(int protocol) {
 949 //            return "pre:" + protocol;
 950 //        }
 951 //
 952 //        public static String encodeCustomImProtocol(String protocolString) {
 953 //            return "custom:" + protocolString;
 954 //        }
 955 //
 956 //        public static Object decodeImProtocol(String encodedString) {
 957 //            if (encodedString == null) {
 958 //                return null;
 959 //            }
 960 //
 961 //            if (encodedString.startsWith("pre:")) {
 962 //                return Integer.parseInt(encodedString.substring(4));
 963 //            }
 964 //
 965 //            if (encodedString.startsWith("custom:")) {
 966 //                return encodedString.substring(7);
 967 //            }
 968 //
 969 //            throw new IllegalArgumentException(
 970 //                    "the value is not a valid encoded protocol, " + encodedString);
 971 //        }
 972 //
 973 //        /**
 974 //         * This looks up the provider name defined in
 975 //         * {@link android.provider.Im.ProviderNames} from the predefined IM protocol id.
 976 //         * This is used for interacting with the IM application.
 977 //         *
 978 //         * @param protocol the protocol ID
 979 //         * @return the provider name the IM app uses for the given protocol, or null if no
 980 //         * provider is defined for the given protocol
 981 //         * @hide
 982 //         */
 983 //        public static String lookupProviderNameFromId(int protocol) {
 984 //            switch (protocol) {
 985 //                case PROTOCOL_GOOGLE_TALK:
 986 //                    return Im.ProviderNames.GTALK;
 987 //                case PROTOCOL_AIM:
 988 //                    return Im.ProviderNames.AIM;
 989 //                case PROTOCOL_MSN:
 990 //                    return Im.ProviderNames.MSN;
 991 //                case PROTOCOL_YAHOO:
 992 //                    return Im.ProviderNames.YAHOO;
 993 //                case PROTOCOL_ICQ:
 994 //                    return Im.ProviderNames.ICQ;
 995 //                case PROTOCOL_JABBER:
 996 //                    return Im.ProviderNames.JABBER;
 997 //                case PROTOCOL_SKYPE:
 998 //                    return Im.ProviderNames.SKYPE;
 999 //                case PROTOCOL_QQ:
1000 //                    return Im.ProviderNames.QQ;
1001 //            }
1002 //            return null;
1003 //        }
1004 //
1005 //        /**
1006 //         * no public constructor since this is a utility class
1007 //         */
1008 //        private ContactMethods() {}
1009 //
1010 //        public static final CharSequence getDisplayLabel(Context context, int kind,
1011 //                int type, CharSequence label) {
1012 //            CharSequence display = "";
1013 //            switch (kind) {
1014 //                case KIND_EMAIL: {
1015 //                    if (type != People.ContactMethods.TYPE_CUSTOM) {
1016 //                        CharSequence[] labels = context.getResources().getTextArray(
1017 //                                com.android.internal.R.array.emailAddressTypes);
1018 //                        try {
1019 //                            display = labels[type - 1];
1020 //                        } catch (ArrayIndexOutOfBoundsException e) {
1021 //                            display = labels[ContactMethods.TYPE_HOME - 1];
1022 //                        }
1023 //                    } else {
1024 //                        if (!TextUtils.isEmpty(label)) {
1025 //                            if (label.toString().equals(MOBILE_EMAIL_TYPE_NAME)) {
1026 //                                display =
1027 //                                    context.getString(
1028 //                                            com.android.internal.R.string.mobileEmailTypeName);
1029 //                            } else {
1030 //                                display = label;
1031 //                            }
1032 //                        }
1033 //                    }
1034 //                    break;
1035 //                }
1036 //
1037 //                case KIND_POSTAL: {
1038 //                    if (type != People.ContactMethods.TYPE_CUSTOM) {
1039 //                        CharSequence[] labels = context.getResources().getTextArray(
1040 //                                com.android.internal.R.array.postalAddressTypes);
1041 //                        try {
1042 //                            display = labels[type - 1];
1043 //                        } catch (ArrayIndexOutOfBoundsException e) {
1044 //                            display = labels[ContactMethods.TYPE_HOME - 1];
1045 //                        }
1046 //                    } else {
1047 //                        if (!TextUtils.isEmpty(label)) {
1048 //                            display = label;
1049 //                        }
1050 //                    }
1051 //                    break;
1052 //                }
1053 //
1054 //                default:
1055 //                    display = context.getString(R.string.untitled);
1056 //            }
1057 //            return display;
1058 //        }
1059 //
1060 //        /**
1061 //         * Add a longitude and latitude location to a postal address.
1062 //         *
1063 //         * @param context the context to use when updating the database
1064 //         * @param postalId the address to update
1065 //         * @param latitude the latitude for the address
1066 //         * @param longitude the longitude for the address
1067 //         */
1068 //        public void addPostalLocation(Context context, long postalId,
1069 //                double latitude, double longitude) {
1070 //            final ContentResolver resolver = context.getContentResolver();
1071 //            // Insert the location
1072 //            ContentValues values = new ContentValues(2);
1073 //            values.put(POSTAL_LOCATION_LATITUDE, latitude);
1074 //            values.put(POSTAL_LOCATION_LONGITUDE, longitude);
1075 //            Uri loc = resolver.insert(CONTENT_URI, values);
1076 //            long locId = ContentUris.parseId(loc);
1077 //
1078 //            // Update the postal address
1079 //            values.clear();
1080 //            values.put(AUX_DATA, locId);
1081 //            resolver.update(ContentUris.withAppendedId(CONTENT_URI, postalId), values, null, null);
1082 //        }
1083 //
1084 //        /**
1085 //         * The content:// style URL for this table
1086 //         */
1087 //        public static final Uri CONTENT_URI =
1088 //            Uri.parse("content://contacts/contact_methods");
1089 //
1090 //        /**
1091 //         * The content:// style URL for sub-directory of e-mail addresses.
1092 //         */
1093 //        public static final Uri CONTENT_EMAIL_URI =
1094 //            Uri.parse("content://contacts/contact_methods/email");
1095 //
1096 //        /**
1097 //         * The MIME type of {@link #CONTENT_URI} providing a directory of
1098 //         * phones.
1099 //         */
1100 //        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/contact-methods";
1101 //
1102 //        /**
1103 //         * The MIME type of a {@link #CONTENT_EMAIL_URI} sub-directory of\
1104 //         * multiple {@link Contacts#KIND_EMAIL} entries.
1105 //         */
1106 //        public static final String CONTENT_EMAIL_TYPE = "vnd.android.cursor.dir/email";
1107 //
1108 //        /**
1109 //         * The MIME type of a {@link #CONTENT_EMAIL_URI} sub-directory of\
1110 //         * multiple {@link Contacts#KIND_POSTAL} entries.
1111 //         */
1112 //        public static final String CONTENT_POSTAL_TYPE = "vnd.android.cursor.dir/postal-address";
1113 //
1114 //        /**
1115 //         * The MIME type of a {@link #CONTENT_URI} sub-directory of a single
1116 //         * {@link Contacts#KIND_EMAIL} entry.
1117 //         */
1118 //        public static final String CONTENT_EMAIL_ITEM_TYPE = "vnd.android.cursor.item/email";
1119 //
1120 //        /**
1121 //         * The MIME type of a {@link #CONTENT_URI} sub-directory of a single
1122 //         * {@link Contacts#KIND_POSTAL} entry.
1123 //         */
1124 //        public static final String CONTENT_POSTAL_ITEM_TYPE
1125 //                = "vnd.android.cursor.item/postal-address";
1126 //
1127 //        /**
1128 //         * The MIME type of a {@link #CONTENT_URI} sub-directory of a single
1129 //         * {@link Contacts#KIND_IM} entry.
1130 //         */
1131 //        public static final String CONTENT_IM_ITEM_TYPE = "vnd.android.cursor.item/jabber-im";
1132 //
1133 //        /**
1134 //         * The default sort order for this table
1135 //         */
1136 //        public static final String DEFAULT_SORT_ORDER = "name ASC";
1137 //
1138 //        /**
1139 //         * The ID of the person this contact method is assigned to.
1140 //         * Type: INTEGER (long)
1141 //         */
1142 //        public static final String PERSON_ID = "person";
1143 //    }
1144 //
1145 //    /**
1146 //     * The IM presence columns with some contacts specific columns mixed in.
1147 //     */
1148 //    public interface PresenceColumns extends Im.CommonPresenceColumns {
1149 //        /**
1150 //         * The IM service the presence is coming from. Formatted using either
1151 //         * {@link Contacts.ContactMethods#encodePredefinedImProtocol} or
1152 //         * {@link Contacts.ContactMethods#encodeCustomImProtocol}.
1153 //         * Type: STRING
1154 //         */
1155 //        public static final String IM_PROTOCOL = "im_protocol";
1156 //
1157 //        /**
1158 //         * The IM handle the presence item is for. The handle is scoped to
1159 //         * the {@link #IM_PROTOCOL}.
1160 //         * Type: STRING
1161 //         */
1162 //        public static final String IM_HANDLE = "im_handle";
1163 //
1164 //        /**
1165 //         * The IM account for the local user that the presence data came from.
1166 //         * Type: STRING
1167 //         */
1168 //        public static final String IM_ACCOUNT = "im_account";
1169 //    }
1170 //
1171 //    /**
1172 //     * Contains presence information about contacts.
1173 //     * @hide
1174 //     */
1175 //    public static final class Presence
1176 //            implements BaseColumns, PresenceColumns, PeopleColumns {
1177 //        /**
1178 //         * The content:// style URL for this table
1179 //         */
1180 //        public static final Uri CONTENT_URI =
1181 //            Uri.parse("content://contacts/presence");
1182 //
1183 //        /**
1184 //         * The ID of the person this presence item is assigned to.
1185 //         * Type: INTEGER (long)
1186 //         */
1187 //        public static final String PERSON_ID = "person";
1188 //
1189 //        /**
1190 //         * Gets the resource ID for the proper presence icon.
1191 //         *
1192 //         * @param status the status to get the icon for
1193 //         * @return the resource ID for the proper presence icon
1194 //         */
1195 //        public static final int getPresenceIconResourceId(int status) {
1196 //            switch (status) {
1197 //                case Contacts.People.AVAILABLE:
1198 //                    return com.android.internal.R.drawable.presence_online;
1199 //
1200 //                case Contacts.People.IDLE:
1201 //                case Contacts.People.AWAY:
1202 //                    return com.android.internal.R.drawable.presence_away;
1203 //
1204 //                case Contacts.People.DO_NOT_DISTURB:
1205 //                    return com.android.internal.R.drawable.presence_busy;
1206 //
1207 //                case Contacts.People.INVISIBLE:
1208 //                    return com.android.internal.R.drawable.presence_invisible;
1209 //
1210 //                case Contacts.People.OFFLINE:
1211 //                default:
1212 //                    return com.android.internal.R.drawable.presence_offline;
1213 //            }
1214 //        }
1215 //
1216 //        /**
1217 //         * Sets a presence icon to the proper graphic
1218 //         *
1219 //         * @param icon the icon to to set
1220 //         * @param serverStatus that status
1221 //         */
1222 //        public static final void setPresenceIcon(ImageView icon, int serverStatus) {
1223 //            icon.setImageResource(getPresenceIconResourceId(serverStatus));
1224 //        }
1225 //    }
1226 //
1227     /**
1228      * Columns from the Organizations table that other columns join into themselves.
1229      */
1230     public interface OrganizationColumns {
1231         /**
1232          * The type of the organizations.
1233          * Type: INTEGER (one of the constants below)
1234          */
1235         public static final String TYPE = "type";
1236 
1237         public static final int TYPE_CUSTOM = 0;
1238         public static final int TYPE_WORK = 1;
1239         public static final int TYPE_OTHER = 2;
1240 
1241         /**
1242          * The user provided label, only used if TYPE is TYPE_CUSTOM.
1243          * Type: TEXT
1244          */
1245         public static final String LABEL = "label";
1246 
1247         /**
1248          * The name of the company for this organization.
1249          * Type: TEXT
1250          */
1251         public static final String COMPANY = "company";
1252 
1253         /**
1254          * The title within this organization.
1255          * Type: TEXT
1256          */
1257         public static final String TITLE = "title";
1258 
1259         /**
1260          * The person this organization is tied to.
1261          * Type: TEXT
1262          */
1263         public static final String PERSON_ID = "person";
1264 
1265         /**
1266          * Whether this is the primary organization
1267          * Type: INTEGER (if set, non-0 means true)
1268          */
1269         public static final String ISPRIMARY = "isprimary";
1270     }
1271 //
1272 //    /**
1273 //     * A sub directory of a single person that contains all of their Phones.
1274 //     */
1275 //    public static final class Organizations implements BaseColumns, OrganizationColumns {
1276 //        /**
1277 //         * no public constructor since this is a utility class
1278 //         */
1279 //        private Organizations() {}
1280 //
1281 //        public static final CharSequence getDisplayLabel(Context context, int type,
1282 //                CharSequence label) {
1283 //            CharSequence display = "";
1284 //
1285 //            if (type != TYPE_CUSTOM) {
1286 //                CharSequence[] labels = context.getResources().getTextArray(
1287 //                        com.android.internal.R.array.organizationTypes);
1288 //                try {
1289 //                    display = labels[type - 1];
1290 //                } catch (ArrayIndexOutOfBoundsException e) {
1291 //                    display = labels[Organizations.TYPE_WORK - 1];
1292 //                }
1293 //            } else {
1294 //                if (!TextUtils.isEmpty(label)) {
1295 //                    display = label;
1296 //                }
1297 //            }
1298 //            return display;
1299 //        }
1300 //
1301 //        /**
1302 //         * The content:// style URL for this table
1303 //         */
1304 //        public static final Uri CONTENT_URI =
1305 //            Uri.parse("content://contacts/organizations");
1306 //
1307 //        /**
1308 //         * The directory twig for this sub-table
1309 //         */
1310 //        public static final String CONTENT_DIRECTORY = "organizations";
1311 //
1312 //        /**
1313 //         * The default sort order for this table
1314 //         */
1315 //        public static final String DEFAULT_SORT_ORDER = "company, title, isprimary ASC";
1316 //    }
1317 //
1318 //    /**
1319 //     * Columns from the Photos table that other columns join into themselves.
1320 //     */
1321 //    public interface PhotosColumns {
1322 //        /**
1323 //         * The _SYNC_VERSION of the photo that was last downloaded
1324 //         * Type: TEXT
1325 //         */
1326 //        public static final String LOCAL_VERSION = "local_version";
1327 //
1328 //        /**
1329 //         * The person this photo is associated with.
1330 //         * Type: TEXT
1331 //         */
1332 //        public static final String PERSON_ID = "person";
1333 //
1334 //        /**
1335 //         * non-zero if a download is required and the photo isn't marked as a bad resource.
1336 //         * You must specify this in the columns in order to use it in the where clause.
1337 //         * Type: INTEGER(boolean)
1338 //         */
1339 //        public static final String DOWNLOAD_REQUIRED = "download_required";
1340 //
1341 //        /**
1342 //         * non-zero if this photo is known to exist on the server
1343 //         * Type: INTEGER(boolean)
1344 //         */
1345 //        public static final String EXISTS_ON_SERVER = "exists_on_server";
1346 //
1347 //        /**
1348 //         * Contains the description of the upload or download error from
1349 //         * the previous attempt. If null then the previous attempt succeeded.
1350 //         * Type: TEXT
1351 //         */
1352 //        public static final String SYNC_ERROR = "sync_error";
1353 //
1354 //        /**
1355 //         * The image data, or null if there is no image.
1356 //         * Type: BLOB
1357 //         */
1358 //        public static final String DATA = "data";
1359 //
1360 //    }
1361 //
1362 //    /**
1363 //     * The photos over all of the people
1364 //     */
1365 //    public static final class Photos implements BaseColumns, PhotosColumns, SyncConstValue {
1366 //        /**
1367 //         * no public constructor since this is a utility class
1368 //         */
1369 //        private Photos() {}
1370 //
1371 //        /**
1372 //         * The content:// style URL for this table
1373 //         */
1374 //        public static final Uri CONTENT_URI =
1375 //            Uri.parse("content://contacts/photos");
1376 //
1377 //        /**
1378 //         * The directory twig for this sub-table
1379 //         */
1380 //        public static final String CONTENT_DIRECTORY = "photo";
1381 //
1382 //        /**
1383 //         * The default sort order for this table
1384 //         */
1385 //        public static final String DEFAULT_SORT_ORDER = "person ASC";
1386 //    }
1387 //
1388 //    public interface ExtensionsColumns {
1389 //        /**
1390 //         * The name of this extension. May not be null. There may be at most one row for each name.
1391 //         * Type: TEXT
1392 //         */
1393 //        public static final String NAME = "name";
1394 //
1395 //        /**
1396 //         * The value of this extension. May not be null.
1397 //         * Type: TEXT
1398 //         */
1399 //        public static final String VALUE = "value";
1400 //    }
1401 //
1402 //    /**
1403 //     * The extensions for a person
1404 //     */
1405 //    public static final class Extensions implements BaseColumns, ExtensionsColumns {
1406 //        /**
1407 //         * no public constructor since this is a utility class
1408 //         */
1409 //        private Extensions() {}
1410 //
1411 //        /**
1412 //         * The content:// style URL for this table
1413 //         */
1414 //        public static final Uri CONTENT_URI =
1415 //            Uri.parse("content://contacts/extensions");
1416 //
1417 //        /**
1418 //         * The MIME type of {@link #CONTENT_URI} providing a directory of
1419 //         * phones.
1420 //         */
1421 //        public static final String CONTENT_TYPE = "vnd.android.cursor.dir/contact_extensions";
1422 //
1423 //        /**
1424 //         * The MIME type of a {@link #CONTENT_URI} subdirectory of a single
1425 //         * phone.
1426 //         */
1427 //        public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/contact_extensions";
1428 //        /**
1429 //         * The default sort order for this table
1430 //         */
1431 //        public static final String DEFAULT_SORT_ORDER = "person, name ASC";
1432 //
1433 //        /**
1434 //         * The ID of the person this phone number is assigned to.
1435 //         * Type: INTEGER (long)
1436 //         */
1437 //        public static final String PERSON_ID = "person";
1438 //    }
1439 //
1440 //    /**
1441 //     * Contains helper classes used to create or manage {@link android.content.Intent Intents}
1442 //     * that involve contacts.
1443 //     */
1444 //    public static final class Intents {
1445 //        /**
1446 //         * This is the intent that is fired when a search suggestion is clicked on.
1447 //         */
1448 //        public static final String SEARCH_SUGGESTION_CLICKED =
1449 //                "android.provider.Contacts.SEARCH_SUGGESTION_CLICKED";
1450 //
1451 //        /**
1452 //         * This is the intent that is fired when a search suggestion for dialing a number
1453 //         * is clicked on.
1454 //         */
1455 //        public static final String SEARCH_SUGGESTION_DIAL_NUMBER_CLICKED =
1456 //                "android.provider.Contacts.SEARCH_SUGGESTION_DIAL_NUMBER_CLICKED";
1457 //
1458 //        /**
1459 //         * This is the intent that is fired when a search suggestion for creating a contact
1460 //         * is clicked on.
1461 //         */
1462 //        public static final String SEARCH_SUGGESTION_CREATE_CONTACT_CLICKED =
1463 //                "android.provider.Contacts.SEARCH_SUGGESTION_CREATE_CONTACT_CLICKED";
1464 //
1465 //        /**
1466 //         * Starts an Activity that lets the user pick a contact to attach an image to.
1467 //         * After picking the contact it launches the image cropper in face detection mode.
1468 //         */
1469 //        public static final String ATTACH_IMAGE =
1470 //                "com.android.contacts.action.ATTACH_IMAGE";
1471 //
1472 //        /**
1473 //         * Takes as input a data URI with a mailto: or tel: scheme. If a single
1474 //         * contact exists with the given data it will be shown. If no contact
1475 //         * exists, a dialog will ask the user if they want to create a new
1476 //         * contact with the provided details filled in. If multiple contacts
1477 //         * share the data the user will be prompted to pick which contact they
1478 //         * want to view.
1479 //         * 1480 // 1481 // 1482 // 1483 // 1484 // 1485 // 1486 // 1487 // 1488 // 1489 // 1490 // 1491 // 1492 // 1493 // 1494 // 1495 // 1496 // 1497 // 1498 // 1499 // 1500 // 1501 // 1502 // 1503 // 1504 // 1505 // 1506 // 1507 // 1508 // 1509 // 1510 // 1511 // 1512 // 1513 // 1514 // 1515 // 1516 // 1517 // 1518 // 1519 // 1520 // 1521 // 1522 // 1523 // 1524 // 1525 // 1526 // 1527 // 1528 // 1529 // 1530 // 1531 // 1532 // 1533 // 1534 // 1535 // 1536 // 1537 // 1538 // 1539 // 1540 // 1541 // 1542 // 1543 // 1544 // 1545 // 1546 // 1547 // 1548 // 1549 // 1550 // 1551 // 1552 // 1553 // 1554 // 1555 // 1556 // 1557 // 1558 // 1559 // 1560 // 1561 // 1562 // 1563 // 1564 // 1565 // 1566 // 1567 // 1568 // 1569 // 1570 // 1571 // 1572 // 1573 // 1574 // 1575 // 1576 // 1577 // 1578 // 1579 // 1580 // 1581 // 1582 // 1583 // 1584 // 1585 // 1586 // 1587 // 1588 // 1589 // 1590 // 1591 // 1592 // 1593 // 1594 // 1595 // 1596 // 1597 // 1598 // 1599 // 1600 // 1601 // 1602 // 1603 // 1604 // 1605 // 1606 // 1607 // 1608 // 1609 // 1610 // 1611 // 1612 // 1613 // 1614 // 1615 // 1616 // 1617 // 1618 // 1619 // 1620 // 1621 // 1622 // 1623 // 1624 // 1625 // 1626 // 1627 // 1628 // 1629 // 1630 // 1631 // 1632 // 1633 // 1634 // 1635 // 1636 // 1637 // 1638 // 1639 // 1640 // 1641 // 1642 // 1643 // 1644 // 1645 // 1646 // 1647 // 1648 // 1649 // 1650 // 1651 // 1652 // 1653 // 1654 // 1655 // 1656 // 1657 // 1658 // 1659 // 1660 // 1661 // 1662 // 1663 // 1664 // 1665 // 1666 // 1667 // 1668 // 1669 // 1670 // 1671 // 1672 // 1673 // 1674 // 1675 // 1676 // 1677 // 1678 // 1679 // 1680 // 1681 // 1682 // 1683 // 1684 // 1685 // 1686 // 1687 // 1688 // 1689 // 1690 // 1691 // 1692 // 1693 // 1694 // 1695 // 1696 // 1697 // 1698 // 1699 // 1700 // 1701 // 1702 // 1703 // 1704 // 1705 // 1706 // 1707 // 1708 // 1709 // 1710 // 1711 // 1712 // 1713 // 1714 // 1715 // 1716 // 1717 // 1718 // 1719 // 1720 // 1721 // 1722 // 1723 // 1724 // 1725 // 1726 // 1727 // 1728 // 1729 // 1730 // 1731 // 1732 // 1733 // 1734 // 1735 // 1736 // 1737 // 1738 // 1739 // 1740 // 1741 // 1742 // 1743 // 1744 // 1745 // 1746 // 1747 // 1748 // 1749 // 1750 // 1751 // 1752 // 1753 // 1754 // 1755 // 1756 // 1757 // 1758 // 1759 // 1760 // 1761 // 1762 // 1763 // 1764 // 1765 // 1766 // 1767 // 1768 // 1769 }

最后附上导入导出的方法
* For mailto: URIs, the scheme specific portion must be a * raw email address, such as one built using * {@link Uri#fromParts(String, String, String)}. *

* For tel: URIs, the scheme specific portion is compared * to existing numbers using the standard caller ID lookup algorithm. * The number must be properly encoded, for example using * {@link Uri#fromParts(String, String, String)}. *

* Any extras from the {@link Insert} class will be passed along to the * create activity if there are no contacts to show. *

* Passing true for the {@link #EXTRA_FORCE_CREATE} extra will skip * prompting the user when the contact doesn't exist. */ public static final String SHOW_OR_CREATE_CONTACT = "com.android.contacts.action.SHOW_OR_CREATE_CONTACT"; /** * Used with {@link #SHOW_OR_CREATE_CONTACT} to force creating a new * contact if no matching contact found. Otherwise, default behavior is * to prompt user with dialog before creating. *

* Type: BOOLEAN */ public static final String EXTRA_FORCE_CREATE = "com.android.contacts.action.FORCE_CREATE"; /** * Used with {@link #SHOW_OR_CREATE_CONTACT} to specify an exact * description to be shown when prompting user about creating a new * contact. *

* Type: STRING */ public static final String EXTRA_CREATE_DESCRIPTION = "com.android.contacts.action.CREATE_DESCRIPTION"; /** * Intents related to the Contacts app UI. */ public static final class UI { /** * The action for the default contacts list tab. */ public static final String LIST_DEFAULT = "com.android.contacts.action.LIST_DEFAULT"; /** * The action for the contacts list tab. */ public static final String LIST_GROUP_ACTION = "com.android.contacts.action.LIST_GROUP"; /** * When in LIST_GROUP_ACTION mode, this is the group to display. */ public static final String GROUP_NAME_EXTRA_KEY = "com.android.contacts.extra.GROUP"; /** * The action for the all contacts list tab. */ public static final String LIST_ALL_CONTACTS_ACTION = "com.android.contacts.action.LIST_ALL_CONTACTS"; /** * The action for the contacts with phone numbers list tab. */ public static final String LIST_CONTACTS_WITH_PHONES_ACTION = "com.android.contacts.action.LIST_CONTACTS_WITH_PHONES"; /** * The action for the starred contacts list tab. */ public static final String LIST_STARRED_ACTION = "com.android.contacts.action.LIST_STARRED"; /** * The action for the frequent contacts list tab. */ public static final String LIST_FREQUENT_ACTION = "com.android.contacts.action.LIST_FREQUENT"; /** * The action for the "strequent" contacts list tab. It first lists the starred * contacts in alphabetical order and then the frequent contacts in descending * order of the number of times they have been contacted. */ public static final String LIST_STREQUENT_ACTION = "com.android.contacts.action.LIST_STREQUENT"; /** * A key for to be used as an intent extra to set the activity * title to a custom String value. */ public static final String TITLE_EXTRA_KEY = "com.android.contacts.extra.TITLE_EXTRA"; /** * Activity Action: Display a filtered list of contacts *

* Input: Extra field {@link #FILTER_TEXT_EXTRA_KEY} is the text to use for * filtering *

* Output: Nothing. */ public static final String FILTER_CONTACTS_ACTION = "com.android.contacts.action.FILTER_CONTACTS"; /** * Used as an int extra field in {@link #FILTER_CONTACTS_ACTION} * intents to supply the text on which to filter. */ public static final String FILTER_TEXT_EXTRA_KEY = "com.android.contacts.extra.FILTER_TEXT"; } /** * Convenience class that contains string constants used * to create contact {@link android.content.Intent Intents}. */ public static final class Insert { /** The action code to use when adding a contact */ public static final String ACTION = Intent.ACTION_INSERT; /** * If present, forces a bypass of quick insert mode. */ public static final String FULL_MODE = "full_mode"; /** * The extra field for the contact name. *

Type: String

*/ public static final String NAME = "name"; /** * The extra field for the contact phonetic name. *

Type: String

*/ public static final String PHONETIC_NAME = "phonetic_name"; /** * The extra field for the contact company. *

Type: String

*/ public static final String COMPANY = "company"; /** * The extra field for the contact job title. *

Type: String

*/ public static final String JOB_TITLE = "job_title"; /** * The extra field for the contact notes. *

Type: String

*/ public static final String NOTES = "notes"; /** * The extra field for the contact phone number. *

Type: String

*/ public static final String PHONE = "phone"; /** * The extra field for the contact phone number type. *

Type: Either an integer value from {@link android.provider.Contacts.PhonesColumns PhonesColumns}, * or a string specifying a custom label.

*/ public static final String PHONE_TYPE = "phone_type"; /** * The extra field for the phone isprimary flag. *

Type: boolean

*/ public static final String PHONE_ISPRIMARY = "phone_isprimary"; /** * The extra field for an optional second contact phone number. *

Type: String

*/ public static final String SECONDARY_PHONE = "secondary_phone"; /** * The extra field for an optional second contact phone number type. *

Type: Either an integer value from {@link android.provider.Contacts.PhonesColumns PhonesColumns}, * or a string specifying a custom label.

*/ public static final String SECONDARY_PHONE_TYPE = "secondary_phone_type"; /** * The extra field for an optional third contact phone number. *

Type: String

*/ public static final String TERTIARY_PHONE = "tertiary_phone"; /** * The extra field for an optional third contact phone number type. *

Type: Either an integer value from {@link android.provider.Contacts.PhonesColumns PhonesColumns}, * or a string specifying a custom label.

*/ public static final String TERTIARY_PHONE_TYPE = "tertiary_phone_type"; /** * The extra field for the contact email address. *

Type: String

*/ public static final String EMAIL = "email"; /** * The extra field for the contact email type. *

Type: Either an integer value from {@link android.provider.Contacts.ContactMethodsColumns ContactMethodsColumns} * or a string specifying a custom label.

*/ public static final String EMAIL_TYPE = "email_type"; /** * The extra field for the email isprimary flag. *

Type: boolean

*/ public static final String EMAIL_ISPRIMARY = "email_isprimary"; /** * The extra field for an optional second contact email address. *

Type: String

*/ public static final String SECONDARY_EMAIL = "secondary_email"; /** * The extra field for an optional second contact email type. *

Type: Either an integer value from {@link android.provider.Contacts.ContactMethodsColumns ContactMethodsColumns} * or a string specifying a custom label.

*/ public static final String SECONDARY_EMAIL_TYPE = "secondary_email_type"; /** * The extra field for an optional third contact email address. *

Type: String

*/ public static final String TERTIARY_EMAIL = "tertiary_email"; /** * The extra field for an optional third contact email type. *

Type: Either an integer value from {@link android.provider.Contacts.ContactMethodsColumns ContactMethodsColumns} * or a string specifying a custom label.

*/ public static final String TERTIARY_EMAIL_TYPE = "tertiary_email_type"; /** * The extra field for the contact postal address. *

Type: String

*/ public static final String POSTAL = "postal"; /** * The extra field for the contact postal address type. *

Type: Either an integer value from {@link android.provider.Contacts.ContactMethodsColumns ContactMethodsColumns} * or a string specifying a custom label.

*/ public static final String POSTAL_TYPE = "postal_type"; /** * The extra field for the postal isprimary flag. *

Type: boolean

*/ public static final String POSTAL_ISPRIMARY = "postal_isprimary"; /** * The extra field for an IM handle. *

Type: String

*/ public static final String IM_HANDLE = "im_handle"; /** * The extra field for the IM protocol *

Type: the result of {@link Contacts.ContactMethods#encodePredefinedImProtocol} * or {@link Contacts.ContactMethods#encodeCustomImProtocol}.

*/ public static final String IM_PROTOCOL = "im_protocol"; /** * The extra field for the IM isprimary flag. *

Type: boolean

*/ public static final String IM_ISPRIMARY = "im_isprimary"; } } alt="复制代码" width="0" height="0">

  1 package com.hh.assistant.app.vo;
  2 
  3 import java.io.BufferedReader;
  4 import java.io.FileInputStream;
  5 import java.io.FileNotFoundException;
  6 import java.io.FileOutputStream;
  7 import java.io.IOException;
  8 import java.io.InputStreamReader;
  9 import java.io.OutputStreamWriter;
 10 import java.io.UnsupportedEncodingException;
 11 import java.util.ArrayList;
 12 import java.util.List;
 13 
 14 import a_vcard.android.provider.Contacts;
 15 import a_vcard.android.syncml.pim.VDataBuilder;
 16 import a_vcard.android.syncml.pim.VNode;
 17 import a_vcard.android.syncml.pim.vcard.ContactStruct;
 18 import a_vcard.android.syncml.pim.vcard.ContactStruct.ContactMethod;
 19 import a_vcard.android.syncml.pim.vcard.ContactStruct.PhoneData;
 20 import a_vcard.android.syncml.pim.vcard.VCardComposer;
 21 import a_vcard.android.syncml.pim.vcard.VCardException;
 22 import a_vcard.android.syncml.pim.vcard.VCardParser;
 23 import android.app.Activity;
 24 import android.content.ContentUris;
 25 import android.content.ContentValues;
 26 import android.database.Cursor;
 27 import android.net.Uri;
 28 import android.os.Environment;
 29 import android.provider.ContactsContract;
 30 import android.provider.ContactsContract.CommonDataKinds.Email;
 31 import android.provider.ContactsContract.CommonDataKinds.Phone;
 32 import android.provider.ContactsContract.CommonDataKinds.StructuredName;
 33 import android.provider.ContactsContract.RawContacts;
 34 import android.provider.ContactsContract.RawContacts.Data;
 35 import android.widget.Toast;
 36 
 37 
 38 /**
 39  * 联系人信息包装类
 40  * 
 41  * @author LW
 42  * 
 43  */
 44 public class ContactInfo {
 45 
 46     /** MUST exist */
 47     private String name; // 姓名
 48     
 49     /** 联系人电话信息 */
 50     public static class PhoneInfo{
 51         /** 联系电话类型 */
 52         public int type;
 53         /** 联系电话 */
 54         public String number;
 55     }
 56     
 57     /** 联系人邮箱信息 */
 58     public static class EmailInfo{
 59         /** 邮箱类型 */
 60         public int type;
 61         /** 邮箱 */
 62         public String email;
 63     }
 64     
 65     private List phoneList = new ArrayList(); // 联系号码
 66     private List email = new ArrayList(); // Email
 67 
 68     /**
 69      * 构造联系人信息
 70      * @param name 联系人姓名 
 71      */
 72     public ContactInfo(String name) {
 73         this.name = name;
 74     }
 75     
 76     /** 姓名 */
 77     public String getName() {
 78         return name;
 79     }
 80     /** 姓名 */
 81     public ContactInfo setName(String name) {
 82         this.name = name;
 83         return this;
 84     }
 85     /** 联系电话信息 */
 86     public List getPhoneList() {
 87         return phoneList;
 88     }
 89     /** 联系电话信息 */
 90     public ContactInfo setPhoneList(List phoneList) {
 91         this.phoneList = phoneList;
 92         return this;
 93     }
 94     /** 邮箱信息 */
 95     public List getEmail() {
 96         return email;
 97     }
 98     /** 邮箱信息 */
 99     public ContactInfo setEmail(List email) {
100         this.email = email;
101         return this;
102     }
103 
104     @Override
105     public String toString() {
106         return "{name: "+name+", number: "+phoneList+", email: "+email+"}";
107     }
108     
109     /**
110      * 联系人
111      *         备份/还原操作
112      * @author LW
113      *
114      */
115     public static class ContactHandler {
116 
117         private static ContactHandler instance_ = new ContactHandler();
118         
119         /** 获取实例 */
120         public static ContactHandler getInstance(){
121             return instance_;
122         }
123         
124         /**
125          * 获取联系人指定信息
126          * @param projection 指定要获取的列数组, 获取全部列则设置为null
127          * @return
128          * @throws Exception
129          */
130         public Cursor queryContact(Activity context, String[] projection){
131             // 获取联系人的所需信息
132             Cursor cur = context.getContentResolver().query(ContactsContract.Contacts.CONTENT_URI, projection, null, null, null);
133             return cur;
134         }
135         
136         /**
137          * 获取联系人信息
138          * @param context
139          * @return
140          */
141         public List getContactInfo(Activity context){
142             List infoList = new ArrayList();
143             
144             Cursor cur = queryContact(context, null);
145             
146             if(cur.moveToFirst()){
147                 do{
148                     
149                     // 获取联系人id号
150                     String id = cur.getString(cur.getColumnIndex(ContactsContract.Contacts._ID));
151                     // 获取联系人姓名
152                     String displayName = cur.getString(cur.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
153                     ContactInfo info = new ContactInfo(displayName);// 初始化联系人信息
154                     
155                     // 查看联系人有多少电话号码, 如果没有返回0
156                     int phoneCount = cur.getInt(cur.getColumnIndex(ContactsContract.Contacts.HAS_PHONE_NUMBER));
157                     
158                     if(phoneCount>0){
159                         
160                         Cursor phonesCursor = context.getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, ContactsContract.CommonDataKinds.Phone.CONTACT_ID + "=" + id , null, null);
161                         
162                         if(phonesCursor.moveToFirst()) {
163                             List phoneNumberList = new ArrayList();
164                             do{
165                                 // 遍历所有电话号码
166                                 String phoneNumber = phonesCursor.getString(phonesCursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
167                                 // 对应的联系人类型
168                                 int type = phonesCursor.getInt(phonesCursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.TYPE));
169                                 
170                                 // 初始化联系人电话信息
171                                 ContactInfo.PhoneInfo phoneInfo = new ContactInfo.PhoneInfo();
172                                 phoneInfo.type=type;
173                                 phoneInfo.number=phoneNumber;
174                                 
175                                 phoneNumberList.add(phoneInfo);
176                             }while(phonesCursor.moveToNext());
177                             // 设置联系人电话信息
178                             info.setPhoneList(phoneNumberList);
179                         }
180                     }
181                     
182                     // 获得联系人的EMAIL
183                     Cursor emailCur = context.getContentResolver().query(ContactsContract.CommonDataKinds.Email.CONTENT_URI, null, ContactsContract.CommonDataKinds.Email.CONTACT_ID+"="+id, null, null);
184                     
185                     if(emailCur.moveToFirst()){
186                         List emailList = new ArrayList();
187                         do{
188                             // 遍历所有的email
189                             String email = emailCur.getString(emailCur.getColumnIndex(ContactsContract.CommonDataKinds.Email.DATA1));
190                             int type = emailCur.getInt(emailCur.getColumnIndex(ContactsContract.CommonDataKinds.Email.TYPE));
191                             
192                             // 初始化联系人邮箱信息
193                             ContactInfo.EmailInfo emailInfo=new ContactInfo.EmailInfo();
194                             emailInfo.type=type;    // 设置邮箱类型
195                             emailInfo.email=email;    // 设置邮箱地址
196                             
197                             emailList.add(emailInfo);
198                         }while(emailCur.moveToNext());
199                         
200                         info.setEmail(emailList);
201                     }
202                     
203                     //Cursor postalCursor = getContentResolver().query(ContactsContract.CommonDataKinds.StructuredPostal.CONTENT_URI, null, ContactsContract.CommonDataKinds.StructuredPostal.CONTACT_ID + "=" + id, null, null);
204                     infoList.add(info);
205                 }while(cur.moveToNext());
206             }
207             return infoList;
208         }
209         
210         /**
211          * 备份联系人
212          */
213         public void backupContacts(Activity context, List infos){
214             
215             try {
216                 
217                 String path = Environment.getExternalStorageDirectory() + "/contacts.vcf";
218                 
219                 OutputStreamWriter writer = new OutputStreamWriter(new FileOutputStream(path),"UTF-8");
220                 
221                 VCardComposer composer = new VCardComposer();
222                 
223                 for (ContactInfo info : infos)
224                 {
225                     ContactStruct contact = new ContactStruct();
226                     contact.name = info.getName();
227                     // 获取联系人电话信息, 添加至 ContactStruct 
228                     List numberList = info
229                             .getPhoneList();
230                     for (ContactInfo.PhoneInfo phoneInfo : numberList)
231                     {
232                         contact.addPhone(phoneInfo.type, phoneInfo.number,
233                                 null, true);
234                     }
235                     // 获取联系人Email信息, 添加至 ContactStruct 
236                     List emailList = info.getEmail();
237                     for (ContactInfo.EmailInfo emailInfo : emailList)
238                     {
239                         contact.addContactmethod(Contacts.KIND_EMAIL,
240                                 emailInfo.type, emailInfo.email, null, true);
241                     }
242                     String vcardString = composer.createVCard(contact,
243                             VCardComposer.VERSION_VCARD30_INT);
244                     writer.write(vcardString);
245                     writer.write("\n");
246                     
247                     writer.flush();
248                 }
249                 writer.close();
250             
251             } catch (UnsupportedEncodingException e) {
252                 e.printStackTrace();
253             } catch (FileNotFoundException e) {
254                 e.printStackTrace();
255             } catch (VCardException e) {
256                 e.printStackTrace();
257             } catch (IOException e) {
258                 e.printStackTrace();
259             }
260             
261             Toast.makeText(context, "备份成功！", Toast.LENGTH_SHORT).show();
262         }
263         
264         
265         /**
266          * 获取vCard文件中的联系人信息 
267          * @return 
268          */
269         public List restoreContacts() throws Exception {
270             List contactInfoList = new ArrayList();
271             
272             VCardParser parse = new VCardParser();
273             VDataBuilder builder = new VDataBuilder();
274             String file = Environment.getExternalStorageDirectory() + "/contacts.vcf";
275             
276             BufferedReader reader = new BufferedReader(new InputStreamReader(new FileInputStream(file), "UTF-8"));
277             
278             String vcardString = "";
279             String line;
280             while((line = reader.readLine()) != null) {
281                 vcardString += line + "\n";
282             }
283             reader.close();
284             
285             boolean parsed = parse.parse(vcardString, "UTF-8", builder);
286             
287             if(!parsed){
288                 throw new VCardException("Could not parse vCard file: "+ file);
289             }
290             
291             List pimContacts = builder.vNodeList;
292             
293             for (VNode contact : pimContacts) {
294                 
295                 ContactStruct contactStruct=ContactStruct.constructContactFromVNode(contact, 1);
296                 // 获取备份文件中的联系人电话信息
297                 List phoneDataList = contactStruct.phoneList;
298                 List phoneInfoList = new ArrayList();
299                 for(PhoneData phoneData : phoneDataList){
300                     ContactInfo.PhoneInfo phoneInfo = new ContactInfo.PhoneInfo();
301                     phoneInfo.number=phoneData.data;
302                     phoneInfo.type=phoneData.type;
303                     phoneInfoList.add(phoneInfo);
304                 }
305                 
306                 // 获取备份文件中的联系人邮箱信息
307                 List emailList = contactStruct.contactmethodList;
308                 List emailInfoList = new ArrayList();
309                 // 存在 Email 信息
310                 if (null!=emailList)
311                 {
312                     for (ContactMethod contactMethod : emailList)
313                     {
314                         if (Contacts.KIND_EMAIL == contactMethod.kind)
315                         {
316                             ContactInfo.EmailInfo emailInfo = new ContactInfo.EmailInfo();
317                             emailInfo.email = contactMethod.data;
318                             emailInfo.type = contactMethod.type;
319                             emailInfoList.add(emailInfo);
320                         }
321                     }
322                 }
323                 ContactInfo info = new ContactInfo(contactStruct.name).setPhoneList(phoneInfoList).setEmail(emailInfoList);
324                 contactInfoList.add(info);
325             }
326             
327             return contactInfoList;
328         }
329 
330         
331         /**
332          * 向手机中录入联系人信息
333          * @param info 要录入的联系人信息
334          */
335         public void addContacts(Activity context, ContactInfo info){
336             ContentValues values = new ContentValues();
337             //首先向RawContacts.CONTENT_URI执行一个空值插入，目的是获取系统返回的rawContactId
338             Uri rawContactUri = context.getContentResolver().insert(RawContacts.CONTENT_URI, values);
339             long rawContactId = ContentUris.parseId(rawContactUri);
340             
341             //往data表入姓名数据
342             values.clear();
343             values.put(Data.RAW_CONTACT_ID, rawContactId);
344             values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);
345             values.put(StructuredName.GIVEN_NAME, info.getName());
346             context.getContentResolver().insert(
347                     android.provider.ContactsContract.Data.CONTENT_URI, values);
348             
349             // 获取联系人电话信息
350             List phoneList = info.getPhoneList();
351             /** 录入联系电话 */
352             for (ContactInfo.PhoneInfo phoneInfo : phoneList) {
353                 values.clear();
354                 values.put(android.provider.ContactsContract.Contacts.Data.RAW_CONTACT_ID, rawContactId);
355                 values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
356                 // 设置录入联系人电话信息
357                 values.put(Phone.NUMBER, phoneInfo.number);
358                 values.put(Phone.TYPE, phoneInfo.type);
359                 // 往data表入电话数据
360                 context.getContentResolver().insert(
361                         android.provider.ContactsContract.Data.CONTENT_URI, values);
362             }
363             
364             // 获取联系人邮箱信息
365             List emailList = info.getEmail();
366             
367             /** 录入联系人邮箱信息 */
368             for (ContactInfo.EmailInfo email : emailList) {
369                 values.clear();
370                 values.put(android.provider.ContactsContract.Contacts.Data.RAW_CONTACT_ID, rawContactId);
371                 values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);
372                 // 设置录入的邮箱信息
373                 values.put(Email.DATA, email.email);
374                 values.put(Email.TYPE, email.type);
375                 // 往data表入Email数据
376                 context.getContentResolver().insert(
377                         android.provider.ContactsContract.Data.CONTENT_URI, values);
378             }
379             
380         }
381         
382     }
383 }

 1 // 获取联系人处理实例
 2         ContactInfo.ContactHandler handler=ContactInfo.ContactHandler.getInstance();
 3         
 4         switch (id) {
 5         case R.id.save_linkman:
 6             // 获取要备份的信息
 7             List _infoList = handler.getContactInfo(this);
 8             handler.backupContacts(this, _infoList);    // 备份联系人信息
 9             break;
10 
11         case R.id.restore_linkman:    // 恢复
12             try {
13                 // 获取要恢复的联系人信息
14                 List infoList = handler.restoreContacts();
15                 for (ContactInfo contactInfo : infoList) {
16                     // 恢复联系人
17                     handler.addContacts(this, contactInfo);
18                 }
19                 
20                 Toast.makeText(this, "导入联系人信息成功!", Toast.LENGTH_LONG);
21                 
22             } catch (Exception e) {
23                 Toast.makeText(this, "导入联系人信息失败!", Toast.LENGTH_SHORT).show();
24                 e.printStackTrace();
25             }
26             
27             break;
28         }

你可能感兴趣的:(vcard)

vCard和MECARD格式 Naix1573 vCard MECARD 前端
vcard和MECARD都是电子名片的格式，这几篇文章介绍都很详细。MECARD格式的电子名片简单介绍：链接1链接2vCard格式：链接------------------------------------------------分割线------------------------------------------补充一个只有微信扫码时会出现的问题：不管是vCard还是MECARD，也不管v
如何恢复华为手机中丢失的通讯录（使用时光机） winfredzhang 工具软件华为通讯录手机华为云
1、登录：https://cloud.huawei.com/2、如果忘记密码，可使用手机登录。1）手机中“华为帐号”。2）扫描网页二维码，3）进入系统。3、点击“设置”.4、点击“联系人时光机”。5、选择需要还原的记录按“还原”.6、打开通讯禄将还原的记录，全选，导出城vcard文件。7、通过pc端的微信发送给自己，直接在手机中的“文件传输助手”中点击打开即可。8、注意：导入到手机中的联系人可能存
蓝牙电话本协议（PBAP）金陵驿网络协议蓝牙信息与通信信号处理网络协议
目录1、PBAP概念2、PBAP角色介绍3、PBAP应用场景4、PBAP名词介绍5、PBAP虚拟文件夹结构6、PBAP特性（Feature）1、PBAP概念PBAP(PhoneBookAccessProfile)：电话本访问协议用于访问电话本对象（通过Vcard形式），是基于客户端/服务器的模型，一般是
vCard文件解析 - 正则素还真人
主讲一下，区别于其他博客的vCard文件解析，一种通用的解析方式-正则！！！一开始也是毛都不知道，啥时vCard？？其实就是通讯录中，某一个联系人导出时生成的vcf文件。其导出文件（如xiaoming.vcf）文本展现如下：BEGIN:VCARDVERSION:4.0N:xiaomingFN:ForrestGumpORG:BubbaGumpShrimpCo.TITLE:ShrimpManPHOTO
全面解读txt excel word转vcard/vcf并导入手机通讯录方法未来自主研究中心
现实生活中的问题：经常会有人问如下问题：（1）怎么把我TXT或者Excel里面联系人批量导入手机通讯录？（2）如何把手机号导入我的安卓或者苹果手机？（3）我这有成千上万个手机号但是不知道怎么导入手机通讯录啊，怎么办？等等。TXT、Excel、Word导入手机通讯录的原理解析：作为生活中的大众，对于不懂计算机编程的吃瓜群众，这个问题时常会萦绕心头，久久挥之不去，上网查询一番后，发现网上的软件不能解决
20181119日程宜人安心
要事第一去括号，去分母解方程备课，今日算术题安排，晚自习安排天气与气候备课周末作业算术本练习卷批改班级通讯录电子文档整理转vcard文件导入手机瞳瞳音频整理到优盘跳绳1500次15分钟班会ppt制作
XMPPFramework(四)电子名片 O乞力马扎罗的雪O
前面向大家介绍了好友列表,那么个人的用户信息:头像、邮箱、住址啊等等,这些信息在哪呢?这时候我们就需要先认识下面几个类了://电子名片模块@property(nonatomic,strong)XMPPvCardTempModule*vCardTempModule;//电子名片本地存储器@property(nonatomic,strong)XMPPvCardCoreDataStorage*vCard
m.444lu.co show.php,PHP生成的Vcard:更改字符編碼，可以顯示重音字符。 weixin_39550937 m.444lu.co show.php
我使用一個PHP類來生成vcard:http://www.troywolf.com/articles/php/class_vcard/。Butaccentedcharacterdonotshowproperly.Iguessthisisrelatedtothecharacterencoding,butIhavebeenunabletofindawaytochangeit.但有重音的角色沒有表現得很
随笔记录——批量导入vCard格式联系人到Outlook weixin_30273175 shell
网上有从Outlook批量导出Vcard格式的教程说明，但是关于如何将Vcard格式的联系人批量导入到Outlook的教程几乎没有。我在网上找到了以下这些操作步骤，成功了，在这里分享。1，把所有Vcards文件放在一个文件夹内，例如C:\vcards；2，打开Outlook的VBA编辑器（ALT+F11呼出）；3，单击“工具”–>“引用”，勾中“WindowsScriptHostObjectMod
【宏】解决vcard乱码&批量导入outlook 某呆啊 vCard outlook 乱码联系人
如果不是某人用的国产手机，我还真不知道现在好多国产手机联系人的导出格式居然是vcf。而且，中文姓名都乱码了。而且而且outlook不支持批量将这一坨一坨的vcf文件导入。没办法，上网搜了一通，问题一一解决。1、vcard乱码。有个叫做VCFEncoding的小程序，操作很简单，打开一看便知，几秒钟就让好多坨乱码的vcard姓名显示正常了。点击下载2、将vcard批量导入outlook。（1）打开o
联系人导出vcard_如何在Outlook 2013中将多个联系人导出到多个vCard或单个vCard culiyuan8310 csv excel python windows eclipse
联系人导出vcardWe’veshownyouhowtoexportacontacttoandimportacontactfromavCard(.vcf)file.However,whatifyouwanttoexportmultiplecontactsatthesametimetomultiplevCardfilesorevenasinglevCardfile?我们已经向您展示了如何将联系人导出
Go语言学习笔记结构体部分 qq_41032328 golang 学习算法
Go学习笔记结构体声明方法结构体初始化练习10.1vcard.go：练习10.2personex1.go：练习10.3point.go：练习10.4rectangle.go：结构体的标签匿名字段和内嵌结构体匿名字段内嵌结构体结构体的方法定义方法调用方法非结构体的方法练习10.6employee_salary.go外部包的方法结构体的内嵌类型练习10.8inheritance_car.go多重继承练
二维码名片制作：MECARD 和 vCard runsong911 二维码 vCard
二维码名片制作：MECARD和vCard的格式定义MECARD基本定义字段定义示例vCardvCard数据格式的标识符vCard基础格式定义vCard数据行格式预定义类型的用法BEGIN,ENDSOURCENAMEPROFILE基本类型FNNNICKNAMEPHOTOBDAY通讯地址类型ADRLABEL电信通信类型TELEMAILMAILER地理类型TZGEO组织类型TITLEROLELOGOAG
css实现卡片的左上角有一个三角形的遮盖效果图拉呀 elemenui vue css ui
需求:卡片的左上角有一个绿色的三角形标签,用来区分状态实现:.vCard{position:relative;overflow:hidden;}.vCard::before{content:"";position:absolute;top:0;left:0;width:0;height:0;border-bottom:20pxsolidtransparent;border-left:20pxsol
android vcard 与 vcalendar 需求实现丶随心 android android string object null file ui
一、背景Android自带的MMS应用，无论是短信和彩信都显得单调，使用起来比较麻烦，可扩展性不好。MMS应用实际上不支持非媒体附件，所有的附件都必须是可以呈现的媒体文件。做过featurephone的兄弟应该知道，一般彩信都会有个附件列表功能。在slide中显示的图片或者文字，需要具备“播放”属性。而附件列表中的附件，是追加的，不参与“播放”类似与电子邮件中的附件。而android自带的MMS应
微信扫一扫添加联系人阿飞_1217
资源利用1.微信自带添加联系人的功能。2.vCard电子名片vCard是一种电子名片的标准化文件格式，和纸质名片类似。BEGIN:VCARD#代表这是个vCard文件(必须)VERSION:3.0#vCard标准的版本(可选)N:Gump;Forrest#姓;名FN:ForrestGump#姓名的标准显示方式ORG:BubbaGumpShrimpCo.#所属公司或组织TITLE:ShrimpMan
将联系人从Mac或PC计算机传输到iPhone或iPad 暮雨烟尘12
默认情况下，iTunes或iCloud将批量同步您的联系人，几乎无法控制该过程。通过iMazing（http://www.imazing.cc/），可以轻松地将联系人从您的计算机传输到iPhone，或者相反-安全地共享联系人，无需同步，只需点击几下即可完成云外部。iMazing支持从以下位置导入联系人：vCard文件-电子名片的标准格式。这个指南是谁？任何想要将联系人转移到他们的iPhone，iP
十三、AOSP-通讯录导入无休止符 AOSP-android 8.x源码定制 android 架构
.一、vcf文件制作二、adb导入方法三、删除导入的提示一、vcf文件制作BEGIN:VCARDVERSION:2.1N:cc;ff;;;FN:ffccTEL;CELL:1-375-667-8808END:VCARD二、adb导入方法将制作好的vcf文件“contacts.vcf”保存到sd的Music目录下运行如下adb命令adbshellamstart--user0-t"text/x-vcar
流量卡自虐超强
流量卡「【注意事项】《办理流量卡时请认真看活动内容，这些流量卡基本都是包邮的，如果不包邮可能就是当地签收快递要的储存费用》【vivo粉卡】《http://topic.vivo.com.cn/vcard/TP1fa74b00-bcb5-11e8-9cd1-2f9aabea5e45/index.html》【无限流量卡】《http://m.10010.com/scaffold-show/infinite
Mac通讯录导入软件——Importer for Contacts Mac 初九_d30b
ImporterforContactsMac版是一款Mac上非常实用的应用软件。ImporterforContactsMac版可以进行通讯录导入，功能十分强大，ImporterforContactsmac版支持将Excel文件，CSV文件和制表符分隔的文件导入到苹果的联系人应用程序中。同时还可以将联系人导出转换为vCard文件，是一款功能齐全的通讯录导入软件。软件功能：联系人导入器提供以下功能：导
使用vCard规范用java生成名片二维码扫一扫自动保存联系人到手机我和程序猿的日常
vCard介绍vCard是电子名片的文件格式标准。它一般附加在电子邮件之后，但也可以用于其它场合（如在互联网上相互交换）。vCard可包含的信息有：姓名、地址资讯、电话号码、URL，logo，相片等。vCard（或称做Versitcard）最早是由Versit联盟于1995年提出的，当时联盟成员包括苹果公司，AT&T科技（后来的朗讯），IBM及西门子。在1996年十二月，格式的拥有权移至互联网邮件
2020-12-24自我反思驿动的风
1、今天我快乐吗？如果没有，原因是什么？6分，今天有个成人来咨询，经前期介绍及后期的谈单，最终没有成交。2、今天学到什么？如果没有，原因是什么？学到通过QQ邮箱将通讯录EXCEL表转成CSV格式文件，再转为VCard文件，保存到手机通讯录，最终将通讯录添加到微信上。为接下来的社群营销作准备。听音频，社群营销第一课，如何引流刘润的《商业洞察30讲》，解决问题，首先要定义问题，学会提出好问题，其二，要
vcard书目录我可梦
vcard格式简介VCard数据格式的标识符–VCARDvCard数据格式行:类型[;参数]:值vCard预定义类型的用法-BEGIN和END类型vCard预定义类型的用法-标识类型vCard预定义类型的用法-联系方式vCard预定义类型的用法-地理类型vCard预定义类型的用法-组织类型vCard预定义类型的用法-解释类型vCard预定义类型的用法-Security类型vCard预定义类型的用法
VUE读取Vcard文件,并获取/筛选想要的内容享有盛誉之名前端
我是Vcard文件，安卓通讯录，test.vcf，它的固定格式，文件内容如下（里面有四个联系人）：然后我是要获取里面的内容（因为我与后台交互是数据传输，也就是JSON方式），所以我需要获得我需要的姓名N和电话号码CELL就行。首先我们要做的事读取这个Vcard文件，参考这个可以实现文件读写（任何后缀的文件，类似txt）：https://blog.csdn.net/Make_Progress365/
前端JS/VUE如何生成文件--导出任意后缀的文件享有盛誉之名前端
有个需求是在前端由用户输入姓名+电话，然后生成一个Vcard，也就是.vcf格式文件,就是导入手机的通讯录中，这个做手机测试的都知道。其实不一定是.vcf格式的文件，其他的格式文件也可以，如.txt等。首先Vcard格式是什么样的，这个hello.vcf内容：BEGIN:VCARDVERSION:3.0N:张三FN:张三TEL;TYPE=CELL:13838380438END:VCARD我们把这个
解决vcard乱码&批量导入outlook ts_rfl
[分享]【宏】解决vcard乱码&批量导入outlook[复制链接]如果不是某人用的国产手机，我还真不知道现在好多国产手机联系人的导出格式居然是vcf。而且，中文姓名都乱码了。而且而且outlook不支持批量将这一坨一坨的vcf文件导入。没办法，上网搜了一通，问题一一解决。1、vcard乱码。有个叫做VCFEncoding的小程序，操作很简单，打开一看便知，几秒钟就让好多坨乱码的vcard姓名显示
django项目实战vCard博客 junh_wang Python Web
文章目录准备项目创建app程序准备留言簿留言簿后台管理留言簿前台提交前台HTML与视图整合templates模板呈现static静态资源文件管理模板继承博客功能实现模型编写标签`django-taggit`标签实现相关日志功能启用数据模型的后台管理图片上传前端页面数据绑定日志列表视图配置数据绑定自定义Manager封装日志详情页URL地址多样化配置日志图片显示tinymce富文本编辑器整合分页侧边
XMPP - 名片 LonlyCat
名片(vCard)属于XMPP扩展协议XEP-0054部分。每一个名片模块的实例都包含了一个用户实例的所有身份信息。虽然针对单纯集成XMPP实现IM功能的应用来说可能并不是很需要用到这部分协议，但是作为纯使用XMPP协议开发的应用来说这个模块就显得很有必要了。(举个栗子：Facebook与FacebookMessenger)XMPPFramework中的vCard如果我们想要在XMPPFramew
android关于蓝牙不能传送APK文件哼着无旋律的歌 Android平台
可以在packages/apps/Bluetooth/src/com/android/bluetooth/opp/Constants.java里修改publicstaticfinalString[]ACCEPTABLE_SHARE_INBOUND_TYPES=newString[]{"image/*","video/*","audio/*","text/x-vcard","text/plain",
SyncML资源汇总 islq 学习笔记
NEW:vCard标准vCardOverviewPEAR中的一个vCard解析与生成的类PHPvCardclassv2.0SF.net上的vCardPHP项目VCard通信薄格式说明syncml协议(SyncMLSyncProtocol)1.1版本中文版官方文档下载（英文版）一、Linux伊甸园---技术文档:SyncML简介内容:SyncML协议简述SyncML底层通讯SyncML同步协议Syn
Java实现的简单双向Map，支持重复Value superlxw1234 java 双向map
关键字：Java双向Map、DualHashBidiMap 有个需求，需要根据即时修改Map结构中的Value值，比如，将Map中所有value=V1的记录改成value=V2，key保持不变。数据量比较大，遍历Map性能太差，这就需要根据Value先找到Key，然后去修改。即：既要根据Key找Value，又要根据Value
PL/SQL触发器基础及例子百合不是茶 oracle数据库触发器 PL/SQL编程
触发器的简介; 触发器的定义就是说某个条件成立的时候，触发器里面所定义的语句就会被自动的执行。因此触发器不需要人为的去调用，也不能调用。触发器和过程函数类似过程函数必须要调用, 一个表中最多只能有12个触发器类型的,触发器和过程函数相似触发器不需要调用直接执行, 触发时间：指明触发器何时执行，该值可取： before：表示在数据库动作之前触发
[时空与探索]穿越时空的一些问题 comsci 问题
我们还没有进行过任何数学形式上的证明,仅仅是一个猜想..... 这个猜想就是; 任何有质量的物体(哪怕只有一微克)都不可能穿越时空,该物体强行穿越时空的时候,物体的质量会与时空粒子产生反应,物体会变成暗物质,也就是说,任何物体穿越时空会变成暗物质..(暗物质就我的理
easy ui datagrid上移下移一行商人shang js 上移下移 easyui datagrid
/** * 向上移动一行 * * @param dg * @param row */ function moveupRow(dg, row) { var datagrid = $(dg); var index = datagrid.datagrid("getRowIndex", row); if (isFirstRow(dg, row)) {
Java反射 oloz 反射
本人菜鸟，今天恰好有时间，写写博客，总结复习一下java反射方面的知识，欢迎大家探讨交流学习指教首先看看java中的Class package demo; public class ClassTest { /*先了解java中的Class*/ public static void main(String[] args) { //任何一个类都
springMVC 使用JSR-303 Validation验证杨白白 spring mvc
JSR-303是一个数据验证的规范，但是spring并没有对其进行实现，Hibernate Validator是实现了这一规范的，通过此这个实现来讲SpringMVC对JSR-303的支持。 JSR-303的校验是基于注解的，首先要把这些注解标记在需要验证的实体类的属性上或是其对应的get方法上。登录需要验证类 public class Login { @NotEmpty
log4j 香水浓 log4j
log4j.rootCategory=DEBUG, STDOUT, DAILYFILE, HTML, DATABASE #log4j.rootCategory=DEBUG, STDOUT, DAILYFILE, ROLLINGFILE, HTML #console log4j.appender.STDOUT=org.apache.log4j.ConsoleAppender log4
使用ajax和history.pushState无刷新改变页面URL agevs jquery 框架 Ajax html5 chrome
表现如果你使用chrome或者firefox等浏览器访问本博客、github.com、plus.google.com等网站时，细心的你会发现页面之间的点击是通过ajax异步请求的，同时页面的URL发生了了改变。并且能够很好的支持浏览器前进和后退。是什么有这么强大的功能呢？ HTML5里引用了新的API，history.pushState和history.replaceState，就是通过
centos中文乱码 AILIKES centos OS ssh
一、CentOS系统访问 g.cn ，发现中文乱码。于是用以前的方式：yum -y install fonts-chinese CentOS系统安装后，还是不能显示中文字体。我使用 gedit 编辑源码，其中文注释也为乱码。后来，终于找到以下方法可以解决，需要两个中文支持的包： fonts-chinese-3.02-12.
触发器 baalwolf 触发器
触发器(trigger)：监视某种情况，并触发某种操作。触发器创建语法四要素：1.监视地点(table) 2.监视事件(insert/update/delete) 3.触发时间(after/before) 4.触发事件(insert/update/delete) 语法： create trigger triggerName after/before
JS正则表达式的i m g bijian1013 JavaScript 正则表达式
g:表示全局（global)模式，即模式将被应用于所有字符串，而非在发现第一个匹配项时立即停止。 i:表示不区分大小写（case-insensitive）模式，即在确定匹配项时忽略模式与字符串的大小写。 m:表示
HTML5模式和Hashbang模式 bijian1013 JavaScript AngularJS Hashbang模式 HTML5模式
我们可以用$locationProvider来配置$location服务（可以采用注入的方式，就像AngularJS中其他所有东西一样）。这里provider的两个参数很有意思，介绍如下。 html5Mode 一个布尔值，标识$location服务是否运行在HTML5模式下。 ha
[Maven学习笔记六]Maven生命周期 bit1129 maven
从mvn test的输出开始说起当我们在user-core中执行mvn test时，执行的输出如下： /software/devsoftware/jdk1.7.0_55/bin/java -Dmaven.home=/software/devsoftware/apache-maven-3.2.1 -Dclassworlds.conf=/software/devs
【Hadoop七】基于Yarn的Hadoop Map Reduce容错 bit1129 hadoop
运行于Yarn的Map Reduce作业，可能发生失败的点包括 Task Failure Application Master Failure Node Manager Failure Resource Manager Failure 1. Task Failure 任务执行过程中产生的异常和JVM的意外终止会汇报给Application Master。僵死的任务也会被A
记一次数据推送的异常解决端口解决 ronin47 记一次数据推送的异常解决
　　需求：从db获取数据然后推送到B 程序开发完成，上jboss,刚开始报了很多错，逐一解决，可最后显示连接不到数据库。机房的同事说可以ping 通。　　自已画了个图，逐一排除，把linux 防火墙　和　setenforce　设置最低。　　　service iptables stop
巧用视错觉-UI更有趣 brotherlamp UI ui视频 ui教程 ui自学 ui资料
我们每个人在生活中都曾感受过视错觉（optical illusion）的魅力。视错觉现象是双眼跟我们开的一个玩笑，而我们往往还心甘情愿地接受我们看到的假象。其实不止如此，视觉错现象的背后还有一个重要的科学原理——格式塔原理。格式塔原理解释了人们如何以视觉方式感觉物体，以及图像的结构，视角，大小等要素是如何影响我们的视觉的。在下面这篇文章中，我们首先会简单介绍一下格式塔原理中的基本概念，
线段树-poj1177-N个矩形求边长（离散化+扫描线） bylijinnan 数据结构算法线段树
package com.ljn.base; import java.util.Arrays; import java.util.Comparator; import java.util.Set; import java.util.TreeSet; /** * POJ 1177 (线段树+离散化+扫描线)，题目链接为http://poj.org/problem?id=1177
HTTP协议详解 chicony http协议
引言
Scala设计模式 chenchao051 设计模式 scala
Scala设计模式我的话：在国外网站上看到一篇文章，里面详细描述了很多设计模式，并且用Java及Scala两种语言描述，清晰的让我们看到各种常规的设计模式，在Scala中是如何在语言特性层面直接支持的。基于文章很nice，我利用今天的空闲时间将其翻译，希望大家能一起学习，讨论。翻译
安装mysql daizj mysql 安装
安装mysql (1)删除linux上已经安装的mysql相关库信息。rpm -e xxxxxxx --nodeps (强制删除) 执行命令rpm -qa |grep mysql 检查是否删除干净 (2)执行命令 rpm -i MySQL-server-5.5.31-2.el
HTTP状态码大全 dcj3sjt126com http状态码
完整的 HTTP 1.1规范说明书来自于RFC 2616，你可以在http://www.talentdigger.cn/home/link.php?url=d3d3LnJmYy1lZGl0b3Iub3JnLw%3D%3D在线查阅。HTTP 1.1的状态码被标记为新特性，因为许多浏览器只支持 HTTP 1.0。你应只把状态码发送给支持 HTTP 1.1的客户端，支持协议版本可以通过调用request
asihttprequest上传图片 dcj3sjt126com ASIHTTPRequest
NSURL *url =@"yourURL"; ASIFormDataRequest*currentRequest =[ASIFormDataRequest requestWithURL:url]; [currentRequest setPostFormat:ASIMultipartFormDataPostFormat];[currentRequest se
C语言中，关键字static的作用 e200702084 C++c C#
在C语言中，关键字static有三个明显的作用： 1)在函数体，局部的static变量。生存期为程序的整个生命周期，（它存活多长时间）；作用域却在函数体内（它在什么地方能被访问（空间））。一个被声明为静态的变量在这一函数被调用过程中维持其值不变。因为它分配在静态存储区，函数调用结束后并不释放单元，但是在其它的作用域的无法访问。当再次调用这个函数时，这个局部的静态变量还存活，而且用在它的访
win7/8使用curl geeksun win7
1. WIN7/8下要使用curl，需要下载curl-7.20.0-win64-ssl-sspi.zip和Win64OpenSSL_Light-1_0_2d.exe。下载地址： http://curl.haxx.se/download.html 请选择不带SSL的版本，否则还需要安装SSL的支持包 2. 可以给Windows增加c
Creating a Shared Repository; Users Sharing The Repository hongtoushizi git
转载自： http://www.gitguys.com/topics/creating-a-shared-repository-users-sharing-the-repository/ Commands discussed in this section: git init –bare git clone git remote git pull git p
Java实现字符串反转的8种或9种方法 Josh_Persistence 异或反转递归反转二分交换反转 java字符串反转栈反转
注：对于第7种使用异或的方式来实现字符串的反转，如果不太看得明白的，可以参照另一篇博客： http://josh-persistence.iteye.com/blog/2205768 /** * */ package com.wsheng.aggregator.algorithm.string; import java.util.Stack; /**
代码实现任意容量倒水问题 home198979 PHP 算法倒水
形象化设计模式实战 HELLO!架构 redis命令源码解析倒水问题：有两个杯子，一个A升，一个B升，水有无限多，现要求利用这两杯子装C
Druid datasource zhb8015 druid
推荐大家使用数据库连接池 DruidDataSource. http://code.alibabatech.com/wiki/display/Druid/DruidDataSource DruidDataSource经过阿里巴巴数百个应用一年多生产环境运行验证，稳定可靠。它最重要的特点是：监控、扩展和性能。下载和Maven配置看这里： http
两种启动监听器ApplicationListener和ServletContextListener spjich java spring 框架
引言:有时候需要在项目初始化的时候进行一系列工作，比如初始化一个线程池，初始化配置文件，初始化缓存等等，这时候就需要用到启动监听器，下面分别介绍一下两种常用的项目启动监听器 ServletContextListener 特点: 依赖于sevlet容器，需要配置web.xml 使用方法: public class StartListener implements
JavaScript Rounding Methods of the Math object 何不笑 JavaScript Math
The next group of methods has to do with rounding decimal values into integers. Three methods — Math.ceil(), Math.floor(), and Math.round() — handle rounding in differen

按字母分类： A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 其他