使用 ContentProvider 共享数据 访问与添加通讯录

1. 统一的数据访问方式

当应用继承ContentProvider类,并重写该类用于提供数据和存储数据的方法,就可以向其他应用共享其数据。

文件的操作模式中,通过指定文件的操作模式为Context.MODE_WORLD_READABLE 或Context.MODE_WORLD_WRITEABLE同样可以对外共享数据,

但数据的访问方式会因数据存储的方式而不同,如:采用xml文件对外共享数据,需要进行xml解析来读写数据;

采用sharedpreferences共享数据,需要使用sharedpreferences API读写数据。

而使用ContentProvider共享数据的好处是统一了数据访问方式。

通俗一点,例如我要访问另一个应用怎么来描述我的需求呢?有种方式可向 Webservice 那样,统一一种描述语言,大家靠这个来互相理解。但是太麻烦了。现在的情况远远好于应用 Webservice 的场景,因为,应用们都在一部手机上,大家都归 Android 操作系统老大管。于是好办!

甲应用说中文,说:我想得到联系人“13999999” 的详细信息。

乙应用来做大洋彼岸,说:I want to get contacts, "13999999r" for more information.

丁说ri语,高呼呀嘛蝶。

这是在要求访问“通讯录”应用啊,是属于另一个应用了,在另一个进程里。难道我做一个“通信录”程序,为了要让别人访问我,我还得提供“中文”、“英文”、“ri文”三种访问模式?这没法搞了,于是由 Android 牵头,大家商议统一描述语言,于是弄出个 Uri。

那么以后这种需求 Android 规定,大家统一说一样的语言:

content://com.android.contacts/data/phones/filter/13999999

“通讯录”程序中需要提供一种对指定模式的 Uri 的解析机制,并且这种解析机制要注册在操作系统中,随时工作。

例如,只要解析到了“data/phones/filter/13999999” 这种模式,它立马截取出 “13999999” 然后再自己的持久化库中去找寻详细信息,再返回回去。


2. 继承 ContentProviter

public class PersonContentProvider extends ContentProvider;

和 Activity 一样, ContentProviter 属于 Android 的一种组件

3. 注册内容提供者

AndroidManifest.xml

<provider android:name=".PersonContentProvider"

android:authorities="wjh.android.provider.personprovider" />

android:name : 指向内容提供者的类

android:authorities : 应用中的一个唯一的字符串标识。可以将它看作域名。在本应用或其它应用中,可以通过这个域名来访问内容提供者。

4. ContentProvider 中的方法、

/**

* 其它应用可以通过此方法对内容提供者删除数据

*/

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

return 0;

}

/**

* 其它应用可以通过此方法对内容提供者添加数据

*/

public Uri insert(Uri uri, ContentValues contentValues)

/**

* 其它应用可以通过此方法对内容提供者查询数据

*/

public Cursor query(Uri uri, String[] arg1, String arg2, String[] arg3,

String arg4)

/**

* 其它应用可以通过此方法对内容提供者更新数据

*/

public int update(Uri arg0, ContentValues arg1, String arg2, String[] arg3)

/**

* 内容类型

*/

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”。

5. URI

Uri代表了要操作的数据,Uri主要包含了两部分信息:

1. 需要操作的ContentProvider

2. 对ContentProvider中的什么数据进行操作,

一个 Uri 由以下几部分组成

scheme --> content:// (此 scheme 仅表示内容提供者的 scheme)

主机名或 Authority -->wjh.android.provider.personprovider

路径 --> person/10/name

组合成一个完整的 Uri 为:content://wjh.android.provider.personprovider/person/10/name

路径虽然可以随便定义,但为了方便其它人理解,应该遵循一定的命名规则:

要操作person表中id为10的记录,可以构建这样的路径:/person/10

要操作person表中id为10的记录的name字段, person/10/name

要操作person表中的所有记录,可以构建这样的路径:/person

要操作xxx表中的记录,可以构建这样的路径:/xxx

当然要操作的数据不一定来自数据库,也可以是文件、xml或网络等其他存储方式,如下:

要操作xml文件中person节点下的name节点,可以构建这样的路径:/person/name

将字符串转换成Uri,可以使用Uri类中的parse()方法,如下:

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

UriMatcher : 用于 Uri 匹配

UriMatcher.addURI : 添加一个 Uri 匹配模式

UriMatcher,match : 匹配Uri , 返回 Boolean 。

ContentUris :用于对 uri 进行字符操作

ContentUris.withAppendedId(uri, append) : 给 uri 添加一个 ID

ContentUris.parseId : 从 Uri 中解析出 ID

6. ContentResolver : 用于操作 ContentProvider

当外部应用需要对 ContentProvider 中的数据进行添加、删除、修改和查询操作时,可以使用ContentResolver类来完成,

要获取ContentResolver 对象,可以使用Activity提供的getContentResolver()方法。

ContentResolver 类提供了与ContentProvider类相同签名的四个方法:

该方法用于往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)

这些方法的第一个参数为Uri,

代表要操作的ContentProvider和对其中的什么数据进行操作,

假设给定的是: Uri.parse(“content://cn.itcast.providers.personprovider/person/10”),

那么将会对主机名为cn.itcast.providers.personprovider的ContentProvider进行操作,

操作的数据为person表中id为10的记录。

其中主机名是要访问的应用在 AndroidManifest.xml 所注册的 provider 的 authorities 属性


7. 代码示例:

应用一:内容提供者所在的应用

1, AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
   package="wjh.android.db" android:versionCode="1" android:versionName="1.0">
   <application android:icon="@drawable/icon" android:label="@string/app_name">
  	   <uses-library android:name="android.test.runner" />
	   <activity android:name=".MainActivity" android:label="@string/app_name">
		<intent-filter>
			<action android:name="android.intent.action.MAIN" />
			<category android:name="android.intent.category.LAUNCHER" />
		</intent-filter>
	  </activity>
	  <provider android:name=".PersonContentProvider"   <!-- 注册内容提供者  -->
			android:authorities="wjh.android.provider.personprovider" />
   </application>
   <uses-sdk android:minSdkVersion="8" />
</manifest>


2. 准备:数据库(这只是内容提供者的一种形式,还可以是操作文件,如 XML 等等)
public class DBOpenHandler extends SQLiteOpenHelper {
	/**
	 * @param context 当前应用上下文
	 */
	public DBOpenHandler(Context context) {
		super(context, "myAndroid.db", null, 2);
	}
	@Override
	public void onCreate(SQLiteDatabase db) {
		String sql_createTable = "CREATE TABLE person (personid integer primary key autoincrement, name)";
		db.execSQL(sql_createTable);
	}
	@Override
	public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
		String sql = "ALTER TABLE person ADD phone";
		db.execSQL(sql);
		db.execSQL("ALTER TABLE person ADD amount integer");
	}
}


3. TContentProvider

/**
 * 内容提供者
 */
public class PersonContentProvider extends ContentProvider {
	private static final UriMatcher MATCHER = new UriMatcher(UriMatcher.NO_MATCH);
	private static final int PERSONS = 1;
	private static final int PERSON = 2;
	private DBOpenHandler dbOpenHandler;
	
	// 静态初始化 Uri 匹配模式
	static {
		// content://wjh.android.provider.personprovider/person : 表示对 person 表所有数据进行操作
		MATCHER.addURI("wjh.android.provider.personprovider", "person", PERSONS);
		
		// content://wjh.android.provider.personprovider/person/3 : 表示对 Perosn 表 Id 为 3 的单体记录进行操作
		MATCHER.addURI("wjh.android.provider.personprovider", "person/#", PERSON);
	}
	
	/**
	 * 其它应用可以通过此方法对内容提供者删除数据
	 */
	public int delete(Uri uri, String selection, String[] selectionArgs) {
		SQLiteDatabase db = dbOpenHandler.getWritableDatabase();
		int num = 0;
		switch (MATCHER.match(uri)) {
		case PERSONS :
			num = db.delete("person", selection, selectionArgs);
			break;
		case PERSON:
			long id = ContentUris.parseId(uri);
			String where ="personid=" + id;
			if(selection != null && !"".equals(selection)) {
				where = where + "and" + selection;
			}
			num = db.delete("person", where, selectionArgs);
			break;
		default :
			throw new IllegalArgumentException("Unkown Uri :" + uri);
		}
		return num;
	}
	
	/**
	 * 获取内容提供者内容的类型
	 */
	@Override
	public String getType(Uri uri) {
		SQLiteDatabase db = dbOpenHandler.getWritableDatabase();
		switch (MATCHER.match(uri)) {
		case PERSONS :
			// vnd.android.cursor.dir : 集合类型
			return "vnd.android.cursor.dir/person";
		case PERSON:
			// vnd.android.cursor.item : 单条记录
			return "vnd.android.cursor.item/person";
		default :
			throw new IllegalArgumentException("Unkown Uri :" + uri);
		}
	}
	/**
	 * 其它应用可以通过此方法对内容提供者添加数据
	 */
	public Uri insert(Uri uri, ContentValues contentValues) {
		SQLiteDatabase db = dbOpenHandler.getWritableDatabase();
		switch (MATCHER.match(uri)) {
		case PERSONS :
			long rowid = db.insert("person", "name", contentValues);
			return ContentUris.withAppendedId(uri, rowid);
		default :
			throw new IllegalArgumentException("Unkown Uri :" + uri);
		}
	}
	public boolean onCreate() {
		dbOpenHandler = new DBOpenHandler(getContext());
		return true;
	}
	/**
	 * 其它应用可以通过此方法对内容提供者查询数据
	 */
	public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
			String sortOrder) {
		SQLiteDatabase db = dbOpenHandler.getWritableDatabase();
		switch (MATCHER.match(uri)) {
		case PERSONS :
			return db.query("person", projection, selection, selectionArgs, null, null, sortOrder);
		case PERSON:
			long id = ContentUris.parseId(uri);
			String where ="personid=" + id;
			if(selection != null && !"".equals(selection)) {
				where = where + "and" + selection;
			}
			return db.query("person", projection, where, selectionArgs, null, null, sortOrder);
		default :
			throw new IllegalArgumentException("Unkown Uri :" + uri);
		}
	}
	/**
	 * 其它应用可以通过此方法对内容提供者更新数据
	 */
	public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
		SQLiteDatabase db = dbOpenHandler.getWritableDatabase();
		int num = 0;
		switch (MATCHER.match(uri)) {
		case PERSONS :
			num = db.update("person", values, selection, selectionArgs);
			break;
		case PERSON:
			long id = ContentUris.parseId(uri);
			String where ="personid=" + id;
			if(selection != null && !"".equals(selection)) {
				where = where + "and" + selection;
			}
			num = db.update("person", values, where, selectionArgs);
			break;
		default :
			throw new IllegalArgumentException("Unkown Uri :" + uri);
		}
		return num;
	}
}


应用二:用于测试访问应用一的内容提供者

1, AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="wjh.android.other"
      android:versionCode="1"
      android:versionName="1.0">
    
    <application android:icon="@drawable/icon" android:label="@string/app_name">
        <uses-library android:name="android.test.runner" />
        <activity android:name=".OtherActivity"
                  android:label="@string/app_name">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
    
    <uses-sdk android:minSdkVersion="7" />
	<instrumentation android:name="android.test.InstrumentationTestRunner"
		android:targetPackage="wjh.android.other" android:label="Tests for My App" />
</manifest>



2,TestContentProvider : 测试类,测试访问应用一的内容提供者

public class TestContentProvider extends AndroidTestCase {
	private static final String TAG = "TestContentProvider";
	
	/**
	 * 添加
	 */
	public void testSave() throws Throwable {
		ContentResolver contentResolver  = this.getContext().getContentResolver();
		
		String uriStr = "content://wjh.android.provider.personprovider/person";
		Uri uri = Uri.parse(uriStr);
		
		ContentValues values = new ContentValues();
		values.put("name", "XXX");
		values.put("phone", "135123456");
		values.put("amount", "22222222222");
		
		uri = contentResolver.insert(uri, values );
		Log.i(TAG, uri.toString());
	}
	/**
	 * 更新
	 */
	public void testUpdate() throws Throwable {
		ContentResolver contentResolver  = this.getContext().getContentResolver();
		
		String uriStr = "content://wjh.android.provider.personprovider/person/3";
		Uri uri = Uri.parse(uriStr);
		
		ContentValues values = new ContentValues();
		values.put("name", "XXX");
		values.put("phone", "135123456");
		values.put("amount", "4444444");
		
		contentResolver.update(uri, values, null, null);
	}
	
	/**
	 * 查找
	 */
	public void testFind() throws Throwable {
		ContentResolver contentResolver  = this.getContext().getContentResolver();
		
		String uriStr = "content://wjh.android.provider.personprovider/person";
		Uri uri = Uri.parse(uriStr);
		
		Cursor cursor = contentResolver.query(uri, null, null, null, "personid asc");
		
		// 打印在日志信息上
		while(cursor.moveToNext()) {
			int personId = cursor.getInt(cursor.getColumnIndex("name"));
			String name = cursor.getString(cursor.getColumnIndex("name"));
			String phone = cursor.getString(cursor.getColumnIndex("phone"));
			int amount = cursor.getInt(cursor.getColumnIndex("amount"));
			Log.i(TAG, "Person [amount=" + amount + ", id=" + personId + ", name=" + name
				+ ", phone=" + phone + "]");
			
		}
	}
	
	/**
	 * 删除
	 */
	public void testDelete() throws Throwable {
		ContentResolver contentResolver  = this.getContext().getContentResolver();
		
		String uriStr = "content://wjh.android.provider.personprovider/person/3";
		Uri uri = Uri.parse(uriStr);
		
		contentResolver.delete(uri, null, null);
	}
}



8. 监听内容提供者的数据变化

1. 内容提供者在数据发送更新时,需要发出一条更新通知,来通知注册在此URI上的访问者。

getContext().getContentResolver().notifyChange(uri, null);

例:在上例中,为 insert、update、delete方法执行成功后,发出更新通知

public Uri insert(Uri uri, ContentValues contentValues) {
	SQLiteDatabase db = dbOpenHandler.getWritableDatabase();
	
	switch (MATCHER.match(uri)) {
	case PERSONS :
		long rowid = db.insert("person", "name", contentValues);
		
		// 由内容提供者发出内容更新的通知。
		getContext().getContentResolver().notifyChange(uri, null);
	
		return ContentUris.withAppendedId(uri, rowid);
	default :
		throw new IllegalArgumentException("Unkown Uri :" + uri);
        }
}


2. 访问者需要监听内容提供者的通知

需要调用 ContentResolver 的 registerContentObserver 方法来注册一个监听器

registerContentObserver(Uri uri, boolean notifyForDescendents, ContentObserver observer)

@param uri :监听哪个 uri

@param notifyForDescendents : true

@param ContentObserver : 使用哪个监听器来处理更新事务

示例:

public class OtherActivity extends Activity {
    private static final String TAG = "OtherActivity";
	
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.main);
        String uriStr = "content://wjh.android.provider.personprovider/person";
	Uri uri = Uri.parse(uriStr);
	// 注册对 content://wjh.android.provider.personprovider/person 内容更新的观察
        getContentResolver().registerContentObserver(uri, true, new PersonContenObserver(new Handler()));
    }
    
    /**
     * 更新监察者。
     */
    private final class PersonContenObserver extends ContentObserver {
		
    	public PersonContenObserver(Handler handler) {
			super(handler);
	}
		
	@Override
	public void onChange(boolean selfChange) {
		ContentResolver contentResolver  = getContentResolver();
		String uriStr = "content://wjh.android.provider.personprovider/person";
		Uri uri = Uri.parse(uriStr);
		Cursor cursor = contentResolver.query(uri, null, null, null, "personid asc");
		while(cursor.moveToNext()) {
			int personId = cursor.getInt(cursor.getColumnIndex("name"));
			String name = cursor.getString(cursor.getColumnIndex("name"));
			String phone = cursor.getString(cursor.getColumnIndex("phone"));
			int amount = cursor.getInt(cursor.getColumnIndex("amount"));
			
			// 将获取的数据通过日志信息打印出来 ,实际应用中,可以用于同步应用中的数据
			Log.i(TAG, "Person [amount=" + amount + ", id=" + personId + ", name=" + name
				+ ", phone=" + phone + "]");
			
		}
		super.onChange(selfChange);
	}
  }
}

 

实际应用,“通讯录” 数据读取、添加联系人信息

** 查看通讯录数据库:

首先启动模拟器、再打开“File Explorer” 视图,

依次展开:data -- data -- com.android.providers.contacts(注意和 com.android.contacts 区分) -- databases,如图:


点击右上角的导出图标,如图:

将数据库文件导出到电脑磁盘上。

然后,你需要拥有一个能打开 SQLite 数据库的工具。例如我用的 SQLite Expert Personal。可以在网上搜索下载。

打开数据库后,就比较纠结了,需要观察表结构。如果确实看得比较纠结,干脆甩开,以免打击学习激情。

或者一狠心,自己写一个管理联系人的程序,弄个自己的通讯录数据库。

raw_contacts 表: 联系人 ID

data表 : 联系人的数据表。通过raw_contacts_id 与 raw_contacts 表联系

存放的联系人信息如:手机号、姓名、Email 等。

联系人的每一项数据,都会在 data 表产生一条记录。例如,记录手机号的是单独一条记录,记录 Email 的是单独一条记录。并且都用 data1 字段来存放。

也就是说,联系人的所有重要信息,都以单独记录的方式,保存在这张表里的 data1字段。用 raw_contacts_id 来描述信息所属的联系人。用 mimitype_id 来描述 data1 字段存储的数据类型(是 Email 数据么?手机号数据么?座机数据么?)。

假如data1要存放的数据是 “由几个数据组合起来的” ,例如:姓名中的 FirstName 和 LastName。

那么就往后存到 data2、data3 里面。组合起来的完整姓名存放在 data1

区分这条数据到底是短信数据、电话数据、Emai等,则是依靠 mimitype_id 字段来区分

mimitype_id 其实是 mimitypes 的外键。观察此表得知:1 表示 email、6 表示姓名、5 表示电话号码。

data2:也用来说明 data1。例如,如果是此记录记录的数据是电话号码,那么若是住宅电话,此字段为1;手机号码为2;单位电话为3......

这些字段的意义很重要,建议读者花10分钟大致看一眼(强烈建议不要花太多时间去研究这个,意义不大),再结合后面的程序,相信会很容易理解。

既然知道了数据存放的方式了,知道它们的字段的名称了,表名也知道了。(当然,编程时我们尽量使用 Android 提供的常量。否则也许今天写的程序,用到了某某字段,睡一觉起来 Android 升完级,不认了。)

好了,sql 语句的几个要素都成立了。要存取联系人好了做吧。

当然啦,这个过程要通过 “联系人” 对外提供的接口来完成,毕竟这个程序是人家的,这个表也是人家的,我们不能直接访问第三方程序的数据库。要提供这个接口的方式可多了,ContentProvider 无疑是最佳的选择。

说穿了,其实就是我们在我们的程序中,组拼出我们需要的 sql 语句,通过 ContentProvider 通信机制,将 sql 语句送到 “联系人”程序去执行而已。并不神奇和复杂,不是么?


calls表:存放的呼叫记录。在《Android--删除某联系人的通话记录》中需要操作它

源码在:

${对应版本SDK源码目录}/ContactsProvider/src/com/android/providers/contacts/ContactsProvider2.java

可以通过查看源码,获知 Uri

...

matcher.addURI(ContactsContract.AUTHORITY, "data", DATA);

matcher.addURI(ContactsContract.AUTHORITY, "data/#", DATA_ID);

matcher.addURI(ContactsContract.AUTHORITY, "data/phones", PHONES);

matcher.addURI(ContactsContract.AUTHORITY, "data/phones/#", PHONES_ID);

matcher.addURI(ContactsContract.AUTHORITY, "data/phones/filter", PHONES_FILTER);

matcher.addURI(ContactsContract.AUTHORITY, "data/phones/filter/*", PHONES_FILTER);

matcher.addURI(ContactsContract.AUTHORITY, "data/emails", EMAILS);

matcher.addURI(ContactsContract.AUTHORITY, "data/emails/#", EMAILS_ID);

matcher.addURI(ContactsContract.AUTHORITY, "data/emails/lookup/*", EMAILS_LOOKUP);

matcher.addURI(ContactsContract.AUTHORITY, "data/emails/filter", EMAILS_FILTER);

matcher.addURI(ContactsContract.AUTHORITY, "data/emails/filter/*", EMAILS_FILTER);

matcher.addURI(ContactsContract.AUTHORITY, "data/postals", POSTALS);

matcher.addURI(ContactsContract.AUTHORITY, "data/postals/#", POSTALS_ID);

...

要按照电话号码获取某一个联系人可以使用:

Uri uri = Uri.parse("content://com.android.contacts/data/phones/filter/151016899999");

** 示例代码:(上代码之前,最好的建议是:边看这个例子,边打开数据库和源码瞅瞅,对 ContentProvider 的理解会深入很多)

1. AndroidManifest.xml 加入权限

<uses-permission android:name="android.permission.READ_CONTACTS" />

<uses-permission android:name="android.permission.WRITE_CONTACTS" />

2.

package wjh.android.contact;
import java.util.ArrayList;
import android.content.ContentProviderOperation;
import android.content.ContentProviderResult;
import android.content.ContentResolver;
import android.content.ContentUris;
import android.content.ContentValues;
import android.database.Cursor;
import android.net.Uri;
import android.provider.ContactsContract;
import android.provider.ContactsContract.RawContacts;
import android.provider.ContactsContract.CommonDataKinds.Email;
import android.provider.ContactsContract.CommonDataKinds.Phone;
import android.provider.ContactsContract.CommonDataKinds.StructuredName;
import android.provider.ContactsContract.Contacts.Data;
import android.test.AndroidTestCase;
import android.util.Log;
/**
 * 通讯录操作示例
 *
 */
public class ContactTest extends AndroidTestCase {
	private static final String TAG = "ContactTest";
	/**
	 * 获取通讯录中所有的联系人
	 */
	public void testGetContacts() throws Throwable {
		ContentResolver contentResolver = this.getContext().getContentResolver();
		String uriStr = "content://com.android.contacts/contacts";
		Uri uri = Uri.parse(uriStr);
		Cursor cursor = contentResolver.query(uri, null, null, null, null);
		// 遍历联系人
		while (cursor.moveToNext()) {
			// 联系人 ID
			int contactId = cursor.getInt(cursor.getColumnIndex(ContactsContract.Contacts._ID));
			// 联系人显示名称
			String name = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
			
			// 联系人电话号码需要对另一个表进行查询,所以用到另一个 uri:content://com.android.contacts/data/phones 
			Cursor phones = getContext().getContentResolver().query(
					                        ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
					                        null,
					                        ContactsContract.CommonDataKinds.Phone.CONTACT_ID + " = "   // 根据上一步获取的联系人 id 来查询
							                                         + contactId, null, null);   
			String phone = "";
			while (phones.moveToNext()) {
                                // "data1"字段,所以此处也可以直接写 "data1",但不推荐
				phone = phones.getString(phones.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
			}
			
			// 再查询 Email。uri 为 : content://com.android.contacts/data/emails 
			Cursor emails = getContext().getContentResolver().query(
					                       ContactsContract.CommonDataKinds.Email.CONTENT_URI,
					                       null,
					                       ContactsContract.CommonDataKinds.Email.CONTACT_ID + " = "
							                                        + contactId, null, null);
			while (emails.moveToNext()) {
                                /* 一样是 "data1" 字段。现在明白了吧?一个联系人的信息,其实被分成了好几条记录来保存,data1分别保存了各种重要的信息。
                                 * 是时候参照打开数据库我前面所说,去瞄一眼它的表结构了!
                                 */
				String emailAddress = emails.getString(emails.getColumnIndex(ContactsContract.CommonDataKinds.Email.DATA));
				Log.i("RongActivity", "emailAddress=" + emailAddress);
			}
			emails.close();
			Log.i(TAG, "Contact [contactId= "+ contactId +"name=" + name + ", phone=" + phone + "]");
		}
	}
	
	/**
	 * 首先向RawContacts.CONTENT_URI执行一个空值插入,目的是获取系统返回的rawContactId 
	 * 这时后面插入data表的依据,只有执行空值插入,才能使插入的联系人在通讯录里面可见
	 */
	public void testInsert() {
		ContentValues values = new ContentValues();
		//首先向RawContacts.CONTENT_URI执行一个空值插入(raw_contacts 表), 为了获取生成的联系人 ID
		Uri rawContactUri = this.getContext().getContentResolver().insert(RawContacts.CONTENT_URI, values);
		
		//然后获取系统返回的rawContactId , 就是新加入的这个联系人的 ID
		long rawContactId = ContentUris.parseId(rawContactUri);
		
		 /* Andorid 中,将联系人的姓名、电话、Email 
		  * 分别存放在 data 表的同一个字段的三条记录当中
		  * 因此要  Insert 三次 */		
		
		//往data表入姓名数据
		values.clear();
		
		// raw_contacts_id 字段,是 raw_contacts表id 的外键,用于说明此记录属于哪一个联系人
		values.put(Data.RAW_CONTACT_ID, rawContactId); 
		
		// mimitype_id 字段,用于描述此数据的类型,电话号码?Email?....
		values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);   // 注意查看第二个参数的常量值
		
		values.put(StructuredName.GIVEN_NAME, "文白菜");   // 这个名字真好听
		this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
		
		//往data表入电话数据
		values.clear();
		values.put(Data.RAW_CONTACT_ID, rawContactId);
		
		values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE); 
		values.put(Phone.NUMBER, "15101689230");
		values.put(Phone.TYPE, Phone.TYPE_MOBILE);
		this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
		
		//往data表入Email数据
		values.clear();
		values.put(Data.RAW_CONTACT_ID, rawContactId);
		values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);
		values.put(Email.DATA, "wenlin56@sina.com");
		values.put(Email.TYPE, Email.TYPE_WORK);
		this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
	}
	/**
	 * 在同一个事务当中保存联系人
	 */
	public void testSave() throws Throwable{
		//文档位置:reference/android/provider/ContactsContract.RawContacts.html
		ArrayList<ContentProviderOperation> ops = new ArrayList<ContentProviderOperation>();
		
		int rawContactInsertIndex = ops.size();
		ops.add(ContentProviderOperation.newInsert(RawContacts.CONTENT_URI)
				                          .withValue(RawContacts.ACCOUNT_TYPE, null)
				                          .withValue(RawContacts.ACCOUNT_NAME, null)
				                          .build());
		//文档位置:reference/android/provider/ContactsContract.Data.html
		ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.CONTENT_URI)
				                          .withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)
				                          .withValue(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE)
				                          .withValue(StructuredName.GIVEN_NAME, "文萝卜")
				                          .build());
		// 更新手机号码:Data.RAW_CONTACT_ID 获取上一条语句插入联系人时产生的 ID
		ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.CONTENT_URI)
				                          .withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)
		                                          .withValue(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE)
		                                          .withValue(Phone.NUMBER, "15101689231")  // "data1"
		                                          .withValue(Phone.TYPE, Phone.TYPE_MOBILE)
		                                          .withValue(Phone.LABEL, "手机号")
		                                          .build());
		ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.CONTENT_URI)
				                          .withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)
		                                          .withValue(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE)
		                                          .withValue(Email.DATA, "wenlin56@yahoo.cn")
		                                          .withValue(Email.TYPE, Email.TYPE_WORK)
		                                          .build());
		
		// 批量插入 -- 在同一个事务当中
		ContentProviderResult[] results = this.getContext().getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops);
		for(ContentProviderResult result : results){
			Log.i(TAG, result.uri.toString());
		}
	}
}


  1. }
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值