Android读取系统联系人

使用 ContentProvider共享数据：

当应用继承 ContentProvider 类，并重写该类用于提供数据和存储数据的方法，就能够向其余应用共享其数据。虽 然使用其余方法也能够对外共享数据，但数据访问方式会因数据存储的方式而不一样，如：采用文件方式对外 共享数据，须要进行文件操做读写数据；采用 sharedpreferences 共享数据，须要使用 sharedpreferences API 读写数据。而使用 ContentProvider 共享数据的好处是 统一了数据访问方式 。

当应用须要经过 ContentProvider 对外共享数据时，第一步须要继承 ContentProvider 并重写下面方法：

public class PersonContentProvider extends ContentProvider{

public boolean onCreate()

public Uri insert(Uri uri, ContentValues values)

public int delete(Uri uri, String selection, String[] selectionArgs)

public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)

public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)

public String getType(Uri uri) }

第二步须要在 AndroidManifest.xml 使用 <provider> 对该 ContentProvider 进行配置，为了能让其余应用找到该 ContentProvider ， ContentProvider 采用了 authorities （主机名 / 域名）对它进行惟一标识，你能够把 ContentProvider 看做是一个网站（想一想，网站也是提供数据者）， authorities 就是他的域名：

<manifest .... >

<application android:icon="@drawable/icon" android:label="@string/app_name">

<provider android:name=".PersonContentProvider" android:authorities="cn.itcast.provider.personprovider"/>

</application>

</manifest>

注意：一旦应用继承了 ContentProvider 类，后面咱们就会把这个应用称为 ContentProvider （内容提供者）。

l

Uri 介绍：

Uri 表明了要操做的数据， Uri 主要包含了两部分信息： 1 》须要操做的 ContentProvider ， 2 》对 ContentProvider 中 的什么数据进行操做，一个 Uri 由如下几部分组成：

l

ContentProvider （内容提供者）的 scheme 已经由 Android 所规定， scheme 为： content://

主机名（或叫 Authority ）用于惟一标识这个 ContentProvider ，外部调用者能够根据这个标识来找到它。

路径（ path ）能够用来表示咱们要操做的数据，路径的构建应根据业务而定，以下 :

要操做 person 表中 id 为 10 的记录，能够构建这样的路径 :/person/10

要操做 person 表中 id 为 10 的记录的 name 字段， person/10/name

要操做 person 表中的全部记录，能够构建这样的路径 :/person

要操做 xxx 表中的记录，能够构建这样的路径 :/xxx

固然要操做的数据不必定来自数据库，也能够是文件等他存储方式，以下 :

要操做 xml 文件中 person 节点下的 name 节点，能够构建这样的路径： /person/name

若是要把一个字符串转换成 Uri ，可使用 Uri 类中的 parse() 方法，以下：

Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person")

l UriMatcher 类使用介绍：

由于 Uri 表明了要操做的数据，因此咱们很常常须要解析 Uri ，并从 Uri 中获取数据。 Android 系统提供了两个用于操 做 Uri 的工具类，分别为 UriMatcher 和 ContentUris 。掌握它们的使用，会便于咱们的开发工做。

UriMatcher 类用于匹配 Uri ，它的用法以下：

首先第一步把你须要匹配 Uri 路径所有给注册上，以下：

// 常量 UriMatcher.NO_MATCH 表示不匹配任何路径的返回码

UriMatcher sMatcher = new UriMatcher(UriMatcher.NO_MATCH);

// 若是 match() 方法匹配 content://cn.itcast.provider.personprovider/person 路径，返回匹配码为 1

sMatcher.addURI( “ cn.itcast.provider.personprovider ” , “ person ” , 1);// 添加须要匹配 uri ，若是匹配就会返回匹配码

// 若是 match() 方法匹配 content://cn.itcast.provider.personprovider/person/230 路径，返回匹配码为 2

sMatcher.addURI(“cn.itcast.provider.personprovider”, “person/#”, 2); //# 号为通配符

switch (sMatcher.match( Uri.parse("content://cn.itcast.provider.personprovider/person/10" ) )) {

case 1

break;

case 2

break;

default:// 不匹配

break;

}

注册完须要匹配的 Uri 后，就可使用 sMatcher.match(uri) 方法对输入的 Uri 进行匹配，若是匹配就返回匹配码， 匹配码是调用 addURI() 方法传入的第三个参数，假设匹配 content://cn.itcast.provider.personprovider/person 路径，返回的匹配码为 1

l ContentUris 类使用介绍：

ContentUris 类用于获取 Uri 路径后面的 ID 部分，它有两个比较实用的方法：

withAppendedId(uri, id) 用于为路径加上 ID 部分：

Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person")

Uri resultUri = ContentUris.withAppendedId(uri, 10);

// 生成后的 Uri 为： content://cn.itcast.provider.personprovider/person/10

parseId(uri) 方法用于从路径中获取 ID 部分：

Uri uri = Uri.parse("content://cn.itcast.provider.personprovider/person/10")

long personid = ContentUris.parseId(uri);// 获取的结果为 :10

l 使用 ContentProvider 共享数据：

ContentProvider 类主要方法的做用：

public boolean onCreate()

该方法在 ContentProvider 建立后就会被调用， Android 在系统启动时就会建立 ContentProvider 。

public Uri insert(Uri uri, ContentValues values)

该方法用于供外部应用往 ContentProvider 添加数据。

public int delete(Uri uri, String selection, String[] selectionArgs)

该方法用于供外部应用从 ContentProvider 删除数据。

public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)

该方法用于供外部应用更新 ContentProvider 中的数据。

public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)

该方法用于供外部应用从 ContentProvider 中获取数据。

public String getType(Uri uri)

该方法用于返回当前 Url 所表明数据的 MIME 类型。若是操做的数据属于集合类型，那么 MIME 类型字符串应该以 vnd.android.cursor.dir/ 开头，例如：要获得全部 person 记录的 Uri 为 content://cn.itcast.provider.personprovider/person ，那么返回的 MIME 类型字符串应该为： “ vnd.android.cursor.dir/person ” 。若是要操做的数据属于单一数据，那么 MIME 类型字符串应该以 vnd.android.cursor.item/ 开头，例如：获得 id 为 10 的 person 记录， Uri 为 content://cn.itcast.provider.personprovider/person/10 ，那么返回的 MIME 类型字符串应该为： “ vnd.android.cursor.item/person ” 。

l 使用 ContentResolver 操做 ContentProvider 中的数据：

当外部应用须要对 ContentProvider 中的数据进行添加、删除、修改和查询操做时，可使用 ContentResolver 类 来完成，要获取 ContentResolver 对象，可使用 Activity 提供的 getContentResolver() 方法。 ContentResolver 类提供了与 ContentProvider 类相同签名的四个方法：

public Uri insert(Uri uri, ContentValues values)

该方法用于往 ContentProvider 添加数据。

public int delete(Uri uri, String selection, String[] selectionArgs)

该方法用于从 ContentProvider 删除数据。

public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)

该方法用于更新 ContentProvider 中的数据。

public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)

该方法用于从ContentProvider中获取数据。

//代码

ContentResolver cr = getContentResolver();  //向联系人插入数据 ContentValues cValue = new ContentValues();  Uri uri = cr.insert(ContactsContract.RawContacts.CONTENT_URI, cValue);  Long raw_contact_id = ContentUris.parseId(uri);  cValue.clear();  //插入联系人  cValue.put(StructuredName.RAW_CONTACT_ID, raw_contact_id); cValue.put(StructuredName.DISPLAY_NAME, "Breath");  cValue.put(StructuredName.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);  uri = cr.insert(ContactsContract.Data.CONTENT_URI, cValue);  cValue.clear(); //插入联系电话 cValue.put(Phone.RAW_CONTACT_ID, raw_contact_id); cValue.put(Phone.NUMBER, "1389746423"); cValue.put(Phone.MIMETYPE, Phone.CONTENT_ITEM_TYPE); uri = cr.insert(ContactsContract.Data.CONTENT_URI, cValue);   Log.i("Info", "插入数据"); 

//代码

ContentResolver cr = getContentResolver(); Cursor c = cr.query(Contacts.CONTENT_URI,         new String[]{Contacts._ID, Contacts.DISPLAY_NAME},                          null,                         null,                          null); if (c != null){          while(c.moveToNext()){
        Log.i("info", "username : " + c.getString(c.getColumnIndex(Contacts.DISPLAY_NAME)));                  int id = c.getInt(c.getColumnIndex(Contacts._ID));                        //根据联系人ID查询出联系人的电话号码                    Cursor cc = cr.query(Phone.CONTENT_URI,                                      new String[]{Phone.NUMBER, Phone.TYPE},                           
            Phone.CONTACT_ID + "=" + id,                                      null,                                      null);                     if(cc != null){                         while(cc.moveToNext()){                                 int type = cc.getInt(cc.getColumnIndex(Phone.TYPE));                   
                String phone = cc.getString(cc.getColumnIndex(Phone.NUMBER));                                  switch (type){                                          case Phone.TYPE_HOME:
                        Log.i("info", "Phone_Home :" + phone);                                                  break;                                          case Phone.TYPE_MOBILE:
                        Log.i("info", "Phone_Mobile :" + phone);                                                  break;                              }
            }
            cc.close();          }         //根据联系人ID查询出联系人的邮箱地址           Cursor ccc = cr.query(Email.CONTENT_URI,                      new String[]{Email.DATA,Email.TYPE},                      Email._ID + "=" + id,                      null,                      null);          if(ccc != null){              while (ccc.moveToNext()){                 int type = ccc.getInt(ccc.getColumnIndex(Email.TYPE));                   String email = ccc.getString(ccc.getColumnIndex(Email.DATA));                  switch (type){                     case Email.TYPE_HOME:
                        Log.i("info", "Email_Home : " + email);                          break;                      case Email.TYPE_WORK:
                        Log.i("info", "Email_Work : " + email);                          break;                   }
            }
            ccc.close();          }
    }
    c.close(); }