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(); }