[关闭]
@coder-pig 2015-08-22T04:20:10.000000Z 字数 8027 阅读 1081

Android基础入门教程——4.4.1 ContentProvider初探

Android基础入门教程


本节引言:

本节给大家带来的是Android四大组件中的最后一个——ContentProvider(内容提供者),可能部分读者
有疑问了,"Android不是有五大组件的吗?还有个Intent呢?"对的,Intent也是很重要的,但是他
只是维系这几个组件间的纽带!Intent我们下一章会讲解!说会这个ContentProvider,我们什么时候
会用到他呢?有下面这两种:

  • 1.我们想在自己的应用中访问别的应用,或者说一些ContentProvider暴露给我们的一些数据,
    比如手机联系人,短信等!我们想对这些数据进行读取或者修改,这就需要用到ContentProvider了!
  • 2.我们自己的应用,想把自己的一些数据暴露出来,给其他的应用进行读取或操作,我们也可以用
    到ContentProvider,另外我们可以选择要暴露的数据,就避免了我们隐私数据的的泄露!

好像好流弊的样子,其实用起来也很简单,下面我们来对ContentProvider进行学习~
官方文档ContentProvider
本节我们来讲解下ContentProvder的概念,给大家写几个常用的使用系统ContentProvider的示例,
以及自定义ContentProvider!


1.ContentProvider概念讲解:


2.使用系统提供的ContentProvider

其实很多时候我们用到ContentProvider并不是自己暴露自己的数据,更多的时候通过
ContentResolver来读取其他应用的信息,最常用的莫过于读取系统APP,信息,联系人,
多媒体信息等!如果你想来调用这些ContentProvider就需要自行查阅相关的API资料了!
另外,不同的版本,可能对应着不同的URL!这里给出如何获取URL与对应的数据库表的字段,
这里以最常用的联系人为例,其他自行google~
①来到系统源码文件下:all-src.rar -> TeleponeProvider -> AndroidManifest.xml查找对应API
②打开模拟器的file exploer/data/data/com.android.providers.contacts/databases/contact2.db
导出后使用SQLite图形工具查看,三个核心的表:raw_contact表data表mimetypes表
下面演示一些基本的操作示例:


1)简单的读取收件箱信息:

核心代码:

  1. private void getMsgs(){
  2. Uri uri = Uri.parse("content://sms/");
  3. ContentResolver resolver = getContentResolver();
  4. //获取的是哪些列的信息
  5. Cursor cursor = resolver.query(uri, new String[]{"address","date","type","body"}, null, null, null);
  6. while(cursor.moveToNext())
  7. {
  8. String address = cursor.getString(0);
  9. String date = cursor.getString(1);
  10. String type = cursor.getString(2);
  11. String body = cursor.getString(3);
  12. System.out.println("地址:" + address);
  13. System.out.println("时间:" + date);
  14. System.out.println("类型:" + type);
  15. System.out.println("内容:" + body);
  16. System.out.println("======================");
  17. }
  18. cursor.close();
  19. }

别忘了,往AndroidManifest.xml加入读取收件箱的权限:

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

运行结果:

部分运行结果如下:


2)简单的往收件箱里插入一条信息

核心代码:

  1. private void insertMsg() {
  2. ContentResolver resolver = getContentResolver();
  3. Uri uri = Uri.parse("content://sms/");
  4. ContentValues conValues = new ContentValues();
  5. conValues.put("address", "123456789");
  6. conValues.put("type", 1);
  7. conValues.put("date", System.currentTimeMillis());
  8. conValues.put("body", "no zuo no die why you try!");
  9. resolver.insert(uri, conValues);
  10. Log.e("HeHe", "短信插入完毕~");
  11. }

运行结果:

注意事项:

上述代码在4.4以下都可以实现写入短信的功能,而5.0上就无法写入,原因是:
从5.0开始,默认短信应用外的软件不能以写入短信数据库的形式发短信!


3)简单的读取手机联系人

核心代码:

  1. private void getContacts(){
  2. //①查询raw_contacts表获得联系人的id
  3. ContentResolver resolver = getContentResolver();
  4. Uri uri = ContactsContract.CommonDataKinds.Phone.CONTENT_URI;
  5. //查询联系人数据
  6. cursor = resolver.query(uri, null, null, null, null);
  7. while(cursor.moveToNext())
  8. {
  9. //获取联系人姓名,手机号码
  10. String cName = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
  11. String cNum = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
  12. System.out.println("姓名:" + cName);
  13. System.out.println("号码:" + cNum);
  14. System.out.println("======================");
  15. }
  16. cursor.close();
  17. }

别忘了加读联系人的权限:

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

运行结果:

部分运行结果如下:


4)查询指定电话的联系人信息

核心代码:

  1. private void queryContact(String number){
  2. Uri uri = Uri.parse("content://com.android.contacts/data/phones/filter/" + number);
  3. ContentResolver resolver = getContentResolver();
  4. Cursor cursor = resolver.query(uri, new String[]{"display_name"}, null, null, null);
  5. if (cursor.moveToFirst()) {
  6. String name = cursor.getString(0);
  7. System.out.println(number + "对应的联系人名称:" + name);
  8. }
  9. cursor.close();
  10. }

运行结果:


5)添加一个新的联系人

核心代码:

  1. private void AddContact() throws RemoteException, OperationApplicationException {
  2. //使用事务添加联系人
  3. Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");
  4. Uri dataUri = Uri.parse("content://com.android.contacts/data");
  5. ContentResolver resolver = getContentResolver();
  6. ArrayList<ContentProviderOperation> operations = new ArrayList<ContentProviderOperation>();
  7. ContentProviderOperation op1 = ContentProviderOperation.newInsert(uri)
  8. .withValue("account_name", null)
  9. .build();
  10. operations.add(op1);
  11. //依次是姓名,号码,邮编
  12. ContentProviderOperation op2 = ContentProviderOperation.newInsert(dataUri)
  13. .withValueBackReference("raw_contact_id", 0)
  14. .withValue("mimetype", "vnd.android.cursor.item/name")
  15. .withValue("data2", "Coder-pig")
  16. .build();
  17. operations.add(op2);
  18. ContentProviderOperation op3 = ContentProviderOperation.newInsert(dataUri)
  19. .withValueBackReference("raw_contact_id", 0)
  20. .withValue("mimetype", "vnd.android.cursor.item/phone_v2")
  21. .withValue("data1", "13798988888")
  22. .withValue("data2", "2")
  23. .build();
  24. operations.add(op3);
  25. ContentProviderOperation op4 = ContentProviderOperation.newInsert(dataUri)
  26. .withValueBackReference("raw_contact_id", 0)
  27. .withValue("mimetype", "vnd.android.cursor.item/email_v2")
  28. .withValue("data1", "779878443@qq.com")
  29. .withValue("data2", "2")
  30. .build();
  31. operations.add(op4);
  32. //将上述内容添加到手机联系人中~
  33. resolver.applyBatch("com.android.contacts", operations);
  34. Toast.makeText(getApplicationContext(), "添加成功", Toast.LENGTH_SHORT).show();
  35. }

运行结果:

别忘了权限:

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

3.自定义ContentProvider

我们很少会自己来定义ContentProvider,因为我们很多时候都不希望自己应用的数据暴露给
其他应用,虽然这样,学习如何ContentProvider还是有必要的,多一种数据传输的方式,是吧~
这是之前画的一个流程图:

接下来我们就来一步步实现:

在开始之前我们先要创建一个数据库创建类(数据库内容后面会讲~):

DBOpenHelper.java

  1. public class DBOpenHelper extends SQLiteOpenHelper {
  2. final String CREATE_SQL = "CREATE TABLE test(_id INTEGER PRIMARY KEY AUTOINCREMENT,name)";
  3. public DBOpenHelper(Context context, String name, CursorFactory factory,
  4. int version) {
  5. super(context, name, null, 1);
  6. }
  7. @Override
  8. public void onCreate(SQLiteDatabase db) {
  9. db.execSQL(CREATE_SQL);
  10. }
  11. @Override
  12. public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {
  13. // TODO Auto-generated method stub
  14. }
  15. }

Step 1:自定义ContentProvider类,实现onCreate(),getType(),根据需求重写对应的增删改查方法:

NameContentProvider.java

  1. public class NameContentProvider extends ContentProvider {
  2. //初始化一些常量
  3. private static UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);
  4. private DBOpenHelper dbOpenHelper;
  5. //为了方便直接使用UriMatcher,这里addURI,下面再调用Matcher进行匹配
  6. static{
  7. matcher.addURI("com.jay.example.providers.myprovider", "test", 1);
  8. }
  9. @Override
  10. public boolean onCreate() {
  11. dbOpenHelper = new DBOpenHelper(this.getContext(), "test.db", null, 1);
  12. return true;
  13. }
  14. @Override
  15. public Cursor query(Uri uri, String[] projection, String selection,
  16. String[] selectionArgs, String sortOrder) {
  17. return null;
  18. }
  19. @Override
  20. public String getType(Uri uri) {
  21. return null;
  22. }
  23. @Override
  24. public Uri insert(Uri uri, ContentValues values) {
  25. switch(matcher.match(uri))
  26. {
  27. //把数据库打开放到里面是想证明uri匹配完成
  28. case 1:
  29. SQLiteDatabase db = dbOpenHelper.getReadableDatabase();
  30. long rowId = db.insert("test", null, values);
  31. if(rowId > 0)
  32. {
  33. //在前面已有的Uri后面追加ID
  34. Uri nameUri = ContentUris.withAppendedId(uri, rowId);
  35. //通知数据已经发生改变
  36. getContext().getContentResolver().notifyChange(nameUri, null);
  37. return nameUri;
  38. }
  39. }
  40. return null;
  41. }
  42. @Override
  43. public int delete(Uri uri, String selection, String[] selectionArgs) {
  44. return 0;
  45. }
  46. @Override
  47. public int update(Uri uri, ContentValues values, String selection,
  48. String[] selectionArgs) {
  49. return 0;
  50. }
  51. }

Step 2:AndroidManifest.xml中为ContentProvider进行注册:

  1. <!--属性依次为:全限定类名,用于匹配的URI,是否共享数据 -->
  2. <provider android:name="com.jay.example.bean.NameContentProvider"
  3. android:authorities="com.jay.example.providers.myprovider"
  4. android:exported="true" />

好的,作为ContentProvider的部分就完成了!


接下来,创建一个新的项目,我们来实现ContentResolver的部分,我们直接通过按钮点击插入一条数据:

MainActivity.java

  1. public class MainActivity extends Activity {
  2. private Button btninsert;
  3. @Override
  4. protected void onCreate(Bundle savedInstanceState) {
  5. super.onCreate(savedInstanceState);
  6. setContentView(R.layout.activity_main);
  7. btninsert = (Button) findViewById(R.id.btninsert);
  8. //读取contentprovider 数据
  9. final ContentResolver resolver = this.getContentResolver();
  10. btninsert.setOnClickListener(new OnClickListener() {
  11. @Override
  12. public void onClick(View v) {
  13. ContentValues values = new ContentValues();
  14. values.put("name", "测试");
  15. Uri uri = Uri.parse("content://com.jay.example.providers.myprovider/test");
  16. resolver.insert(uri, values);
  17. Toast.makeText(getApplicationContext(), "数据插入成功", Toast.LENGTH_SHORT).show();
  18. }
  19. });
  20. }
  21. }

如何使用?
好吧,代码还是蛮简单的,先运行作为ContentProvider的项目,接着再运行ContentResolver的项目,
点击按钮插入一条数据,然后打开file exploer将ContentProvider的db数据库取出,用图形查看工具
查看即可发现插入数据,时间关系,就不演示结果了~


4.通过ContentObserver监听ContentProvider的数据变化

使用指南

运行程序后,晾一边,收到短信后,可以在logcat上看到该条信息的内容,可以根据自己的需求
将Activtiy改做Service,而在后台做这种事情~


本节小结:

好的,关于ContentProvider的初探就到这里,本节我们学习了:
ContentProvider的概念以及流程,使用系统提供的一些ContentProvider,以及定制自己的ContentProvider,
最后还讲解了通过ContentObserver监听ContentProvider的数据变化,ContentProvider的内容就掌握得差不多
了,下一节我们来走走文档看下有什么不知道的~谢谢

添加新批注
在作者公开此批注前,只有你和作者可见。
回复批注