登录
当前位置： 首页 > 编程笔记 >

android基础总结篇之八：创建及调用自己的ContentProvider

上官凯歌
2023-03-14
本文向大家介绍android基础总结篇之八：创建及调用自己的ContentProvider，包括了android基础总结篇之八：创建及调用自己的ContentProvider的使用技巧和注意事项，需要的朋友参考一下

今天我们来讲解一下如何创建及调用自己的ContentProvider。

在前面两篇文章中我们分别讲了如何读写联系人和短消息，相信大家对于ContentProvider的操作方法已经有了一定程度的了解。在有些场合，除了操作ContentProvider之外，我们还有可能需要创建自己的ContentProvider，来提供信息共享的服务，这就要求我们很好的掌握ContentProvider的创建及使用技巧。下面我们就由表及里的逐步讲解每个步骤。

在正式开始实例演示之前，我们先来了解以下两个知识点：

授权：

在Android中，每一个ContentProvider都会用类似于域名的字符串来注册自己，我们成为授权(authority)。这个唯一标识的字符串是此ContentProvider可提供的一组URI的基础，有了这个基础，才能够向外界提供信息的共享服务。

授权是在AndroidManifest.xml中完成的，每一个ContentProvider必须在此声明并授权，方式如下：

<provider android:name=".SomeProvider" 
  android:authorities="com.your-company.SomeProvider"/>

上面的<provider>元素指明了ContentProvider的提供者是“SomeProvider”这个类，并为其授权，授权的基础URI为“com.your-company.SomeProvider”。有了这个授权信息，系统可以准确的定位到具体的ContentProvider，从而使访问者能够获取到指定的信息。这和浏览Web页面的方式很相似，“SomeProvider”就像一台具体的服务器，而“com.your-company.SomeProvider”就像注册的域名，相信大家对这个概念并不陌生，由此联想一下就可以了解ContentProvider授权的作用了。（需要注意的是，除了Android内置应用程序之外，第三方程序应尽量使用以上方式的完全限定的授权名。）

MIME类型：

就像网站返回给定URL的MIME（Multipurpose Internet Mail Extensions，多用途Internet邮件扩展）类型一样（这使浏览器能够用正确的程序来查看内容），ContentProvider还负责返回给定URI的MIME类型。根据MIME类型规范，MIME类型包含两部分：类型和子类型。例如：text/html，text/css，text/xml等等。

Android也遵循类似的约定来定义MIME类型。

对于单条记录，MIME类型类似于：

vnd.android.cursor.item/vnd.your-company.content-type

而对于记录的集合，MIME类型类似于：

vnd.android.cursor.dir/vnd.your-company.comtent-type

其中的vnd表示这些类型和子类型具有非标准的、供应商特定的形式；content-type可以根据ContentProvider的功能来定，比如日记的ContentProvider可以为note，日程安排的ContentProvider可以为schedule，等等。

了解了以上两个知识点之后，我们就结合实例来演示一下具体的过程。

我们将会创建一个记录person信息的ContentProvider，实现对person的CRUD操作，访问者可以通过下面路径操作我们的ContentProvider：

访问者可以通过“[BASE_URI]/persons”来操作person集合，也可以通过“[BASE_URI]/persons/#”的形式操作单个person。
我们创建一个person的ContentProvider需要两个步骤：

1.创建PersonProvider类：

我们需要继承ContentProvider类，实现onCreate、query、insert、update、delete和getType这几个方法。具体代码如下：

package com.scott.provider; 
 
import android.content.ContentProvider; 
import android.content.ContentUris; 
import android.content.ContentValues; 
import android.content.UriMatcher; 
import android.database.Cursor; 
import android.database.sqlite.SQLiteDatabase; 
import android.net.Uri; 
 
public class PersonProvider extends ContentProvider { 
 
  private static final UriMatcher matcher; 
  private DBHelper helper; 
  private SQLiteDatabase db; 
   
  private static final String AUTHORITY = "com.scott.provider.PersonProvider"; 
  private static final int PERSON_ALL = 0; 
  private static final int PERSON_ONE = 1; 
   
  public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd.scott.person"; 
  public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/vnd.scott.person"; 
   
  //数据改变后立即重新查询 
  private static final Uri NOTIFY_URI = Uri.parse("content://" + AUTHORITY + "/persons"); 
   
  static { 
    matcher = new UriMatcher(UriMatcher.NO_MATCH); 
     
    matcher.addURI(AUTHORITY, "persons", PERSON_ALL);  //匹配记录集合 
    matcher.addURI(AUTHORITY, "persons/#", PERSON_ONE); //匹配单条记录 
  } 
   
  @Override 
  public boolean onCreate() { 
    helper = new DBHelper(getContext()); 
    return true; 
  } 
 
  @Override 
  public String getType(Uri uri) { 
    int match = matcher.match(uri); 
    switch (match) { 
    case PERSON_ALL: 
      return CONTENT_TYPE; 
    case PERSON_ONE: 
      return CONTENT_ITEM_TYPE; 
    default: 
      throw new IllegalArgumentException("Unknown URI: " + uri); 
    } 
  } 
   
  @Override 
  public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { 
    db = helper.getReadableDatabase(); 
    int match = matcher.match(uri); 
    switch (match) { 
    case PERSON_ALL: 
      //doesn't need any code in my provider. 
      break; 
    case PERSON_ONE: 
      long _id = ContentUris.parseId(uri); 
      selection = "_id = ?"; 
      selectionArgs = new String[]{String.valueOf(_id)}; 
      break; 
    default: 
      throw new IllegalArgumentException("Unknown URI: " + uri); 
    } 
    return db.query("person", projection, selection, selectionArgs, null, null, sortOrder); 
  } 
 
  @Override 
  public Uri insert(Uri uri, ContentValues values) { 
    int match = matcher.match(uri); 
    if (match != PERSON_ALL) { 
      throw new IllegalArgumentException("Wrong URI: " + uri); 
    } 
    db = helper.getWritableDatabase(); 
    if (values == null) { 
      values = new ContentValues(); 
      values.put("name", "no name"); 
      values.put("age", "1"); 
      values.put("info", "no info."); 
    } 
    long rowId = db.insert("person", null, values); 
    if (rowId > 0) { 
      notifyDataChanged(); 
      return ContentUris.withAppendedId(uri, rowId); 
    } 
    return null; 
  } 
 
  @Override 
  public int delete(Uri uri, String selection, String[] selectionArgs) { 
    db = helper.getWritableDatabase(); 
    int match = matcher.match(uri); 
    switch (match) { 
    case PERSON_ALL: 
      //doesn't need any code in my provider. 
      break; 
    case PERSON_ONE: 
      long _id = ContentUris.parseId(uri); 
      selection = "_id = ?"; 
      selectionArgs = new String[]{String.valueOf(_id)}; 
    } 
    int count = db.delete("person", selection, selectionArgs); 
    if (count > 0) { 
      notifyDataChanged(); 
    } 
    return count; 
  } 
 
  @Override 
  public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { 
    db = helper.getWritableDatabase(); 
    int match = matcher.match(uri); 
    switch (match) { 
    case PERSON_ALL: 
      //doesn't need any code in my provider. 
      break; 
    case PERSON_ONE: 
      long _id = ContentUris.parseId(uri); 
      selection = "_id = ?"; 
      selectionArgs = new String[]{String.valueOf(_id)}; 
      break; 
    default: 
      throw new IllegalArgumentException("Unknown URI: " + uri); 
    } 
    int count = db.update("person", values, selection, selectionArgs); 
    if (count > 0) { 
      notifyDataChanged(); 
    } 
    return count; 
  } 
 
  //通知指定URI数据已改变 
  private void notifyDataChanged() { 
    getContext().getContentResolver().notifyChange(NOTIFY_URI, null);     
  } 
}

在PersonProvider中，我们定义了授权地址为“com.scott.provider.PersonProvider”，相信大家在前面也有所了解了。基于这个授权，我们使用了一个UriMatcher对其路径进行匹配，“[BASE_URI]/persons"和“[BASE_URI]/persons/#”这两种路径我们在上面也介绍过，分别对应记录集合和单个记录的操作。在query、insert、update和delete方法中我们根据UriMatcher匹配结果来判断该URI是操作记录集合还是单条记录，从而采取不同的处理方法。在getType方法中，我们会根据匹配的结果返回不同的MIME类型，这一步是不能缺少的，比如我们在query方法中有可能是查询全部集合，有可能是查询单条记录，那么我们返回的Cursor或是集合类型，或是单条记录，这个跟getType返回的MIME类型是一致的，就好像浏览网页一样，指定的url返回的信息是什么类型，那么浏览器就应该接收到对应的MIME类型。另外，我们注意到，上面代码中，在insert、update、delete方法中都调用了notifyDataChanged方法，这个方法中仅有的一步操作就是通知“[BASE_URI]/persons"的访问者，数据发生改变了，应该重新加载了。

在我们的PersonProvider中，我们用到了Person、DBHelper类，代码如下：

package com.scott.provider; 
 
public class Person { 
  public int _id; 
  public String name; 
  public int age; 
  public String info; 
   
  public Person() { 
  } 
   
  public Person(String name, int age, String info) { 
    this.name = name; 
    this.age = age; 
    this.info = info; 
  } 
} 
[java] view plain copy
package com.scott.provider; 
 
import android.content.Context; 
import android.database.sqlite.SQLiteDatabase; 
import android.database.sqlite.SQLiteOpenHelper; 
 
public class DBHelper extends SQLiteOpenHelper { 
 
  private static final String DATABASE_NAME = "provider.db"; 
  private static final int DATABASE_VERSION = 1; 
   
  public DBHelper(Context context) { 
    super(context, DATABASE_NAME, null, DATABASE_VERSION); 
  } 
 
  @Override 
  public void onCreate(SQLiteDatabase db) { 
    String sql = "CREATE TABLE IF NOT EXISTS person" + 
        "(_id INTEGER PRIMARY KEY AUTOINCREMENT, name VARCHAR, age INTEGER, info TEXT)"; 
    db.execSQL(sql); 
  } 
 
  @Override 
  public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { 
    db.execSQL("DROP TABLE IF EXISTS person"); 
    onCreate(db); 
  } 
}

最后，要想让这个ContentProvider生效，我们需要在AndroidManifest.xml中声明并为其授权，如下所示：

<provider android:name=".PersonProvider" 
  android:authorities="com.scott.provider.PersonProvider" 
  android:multiprocess="true"/>

其中，android:multiprocess代表是否允许多进程操作。另外我们也可以为其声明相应的权限，对应的属性是：android:permission。

2.调用PersonProvider类：

完成了person的ContentProvider后，下面我们来看一下如何访问它。这一步我们在MainActivity中完成，看下面代码：

package com.scott.provider; 
 
import java.util.ArrayList; 
 
import android.app.Activity; 
import android.content.ContentResolver; 
import android.content.ContentUris; 
import android.content.ContentValues; 
import android.database.Cursor; 
import android.database.CursorWrapper; 
import android.net.Uri; 
import android.os.Bundle; 
import android.os.Handler; 
import android.os.Message; 
import android.view.View; 
import android.widget.ListView; 
import android.widget.SimpleCursorAdapter; 
 
 
public class MainActivity extends Activity { 
   
  private ContentResolver resolver; 
  private ListView listView; 
   
  private static final String AUTHORITY = "com.scott.provider.PersonProvider"; 
  private static final Uri PERSON_ALL_URI = Uri.parse("content://" + AUTHORITY + "/persons"); 
   
  private Handler handler = new Handler() { 
    public void handleMessage(Message msg) { 
      //update records. 
      requery(); 
    }; 
  }; 
   
  @Override 
  public void onCreate(Bundle savedInstanceState) { 
    super.onCreate(savedInstanceState); 
    setContentView(R.layout.main); 
 
    resolver = getContentResolver(); 
    listView = (ListView) findViewById(R.id.listView); 
     
    //为PERSON_ALL_URI注册变化通知 
    getContentResolver().registerContentObserver(PERSON_ALL_URI, true, new PersonObserver(handler)); 
  } 
   
  /** 
   * 初始化 
   * @param view 
   */ 
  public void init(View view) { 
    ArrayList<Person> persons = new ArrayList<Person>(); 
     
    Person person1 = new Person("Ella", 22, "lively girl"); 
    Person person2 = new Person("Jenny", 22, "beautiful girl"); 
    Person person3 = new Person("Jessica", 23, "sexy girl"); 
    Person person4 = new Person("Kelly", 23, "hot baby"); 
    Person person5 = new Person("Jane", 25, "pretty woman"); 
     
    persons.add(person1); 
    persons.add(person2); 
    persons.add(person3); 
    persons.add(person4); 
    persons.add(person5); 
 
    for (Person person : persons) { 
      ContentValues values = new ContentValues(); 
      values.put("name", person.name); 
      values.put("age", person.age); 
      values.put("info", person.info); 
      resolver.insert(PERSON_ALL_URI, values); 
    } 
  } 
   
  /** 
   * 查询所有记录 
   * @param view 
   */ 
  public void query(View view) { 
//   Uri personOneUri = ContentUris.withAppendedId(PERSON_ALL_URI, 1);查询_id为1的记录 
    Cursor c = resolver.query(PERSON_ALL_URI, null, null, null, null); 
     
    CursorWrapper cursorWrapper = new CursorWrapper(c) { 
       
      @Override 
      public String getString(int columnIndex) { 
        //将简介前加上年龄 
        if (getColumnName(columnIndex).equals("info")) { 
          int age = getInt(getColumnIndex("age")); 
          return age + " years old, " + super.getString(columnIndex); 
        } 
        return super.getString(columnIndex); 
      } 
    }; 
     
    //Cursor须含有"_id"字段 
    SimpleCursorAdapter adapter = new SimpleCursorAdapter(this, android.R.layout.simple_list_item_2, 
        cursorWrapper, new String[]{"name", "info"}, new int[]{android.R.id.text1, android.R.id.text2}); 
    listView.setAdapter(adapter); 
     
    startManagingCursor(cursorWrapper); //管理Cursor 
  } 
   
  /** 
   * 插入一条记录 
   * @param view 
   */ 
  public void insert(View view) { 
    Person person = new Person("Alina", 26, "attractive lady"); 
    ContentValues values = new ContentValues(); 
    values.put("name", person.name); 
    values.put("age", person.age); 
    values.put("info", person.info); 
    resolver.insert(PERSON_ALL_URI, values); 
  } 
   
  /** 
   * 更新一条记录 
   * @param view 
   */ 
  public void update(View view) { 
    Person person = new Person(); 
    person.name = "Jane"; 
    person.age = 30; 
    //将指定name的记录age字段更新为30 
    ContentValues values = new ContentValues(); 
    values.put("age", person.age); 
    resolver.update(PERSON_ALL_URI, values, "name = ?", new String[]{person.name}); 
     
    //将_id为1的age更新为30 
//   Uri updateUri = ContentUris.withAppendedId(PERSON_ALL_URI, 1); 
//   resolver.update(updateUri, values, null, null); 
  } 
   
  /** 
   * 删除一条记录 
   * @param view 
   */ 
  public void delete(View view) { 
    //删除_id为1的记录 
    Uri delUri = ContentUris.withAppendedId(PERSON_ALL_URI, 1); 
    resolver.delete(delUri, null, null); 
     
    //删除所有记录 
//   resolver.delete(PERSON_ALL_URI, null, null); 
  } 
   
  /** 
   * 重新查询 
   */ 
  private void requery() { 
    //实际操作中可以查询集合信息后Adapter.notifyDataSetChanged(); 
    query(null); 
  } 
}

我们看到，在上面的代码中，分别对应每一种情况进行测试，相对较为简单。我们主要讲一下registerContentObserver这一环节。

在前面的PersonProvider我们也提到，在数据更改后，会向指定的URI访问者发出通知，以便于更新查询记录。大家注意，仅仅是ContentProvider出力还不够，我们还需要在访问者中注册一个ContentObserver，才能够接收到这个通知。下面我们创建一个

PersonObserver：
package com.scott.provider; 
 
import android.database.ContentObserver; 
import android.os.Handler; 
import android.os.Message; 
import android.util.Log; 
 
public class PersonObserver extends ContentObserver { 
 
  public static final String TAG = "PersonObserver"; 
  private Handler handler; 
   
  public PersonObserver(Handler handler) { 
    super(handler); 
    this.handler = handler; 
  } 
   
  @Override 
  public void onChange(boolean selfChange) { 
    super.onChange(selfChange); 
    Log.i(TAG, "data changed, try to requery."); 
    //向handler发送消息,更新查询记录 
    Message msg = new Message(); 
    handler.sendMessage(msg); 
  } 
}

这样一来，当ContentProvider发来通知之后，我们就能立即接收到，从而向handler发送一条消息，重新查询记录，使我们能够看到最新的记录信息。

最后，我们要在AndroidManifest.xml中为MainActivity添加MIME类型过滤器，告诉系统MainActivity可以处理的信息类型：

<!-- MIME类型 --> 
<intent-filter> 
  <data android:mimeType="vnd.android.cursor.dir/vnd.scott.person"/> 
</intent-filter> 
<intent-filter> 
  <data android:mimeType="vnd.android.cursor.item/vnd.scott.person"/> 
</intent-filter>

这样就完成了访问者的代码，我们来看一下效果：

鉴于操作类型太多，我在这里就不再展示了，大家可以自己试一试。

原文链接：http://blog.csdn.net/liuhe688/article/details/7050868

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持小牛知识库。

 类似资料：
  • android基础总结篇之一：Activity生命周期

    本文向大家介绍android基础总结篇之一：Activity生命周期，包括了android基础总结篇之一：Activity生命周期的使用技巧和注意事项，需要的朋友参考一下 近来回顾了一下关于Activity的生命周期，参看了相关书籍和官方文档，也有了不小的收获，对于以前的认知有了很大程度上的改善，在这里和大家分享一下。 熟悉javaEE的朋友们都了解servlet技术，我们想要实现一个自己的ser

  • java基础之数组常用操作总结(必看篇)

    本文向大家介绍java基础之数组常用操作总结(必看篇)，包括了java基础之数组常用操作总结(必看篇)的使用技巧和注意事项，需要的朋友参考一下 常用的对数组进行的操作 1、求数组中最大值，最小值 思路：假设下标为0的元素是最大值，遍历数组，依次跟max进行比较，如果有元素比这个max还大，则把这个值赋给max。最小值同样 2、查找数组中是否存在某个元素 （2）、用二分查找法查找数组中是否存在某个元

  • 如何为Docker创建自己的基础映像？

    问题内容： 根据Docker文档，要构建自己的映像，您必须始终使用指令指定基本映像。 显然，Docker索引中有很多图像可供选择，但是如果我想构建自己的图像怎么办？那可能吗？ 如果我理解正确，该映像是在Ubuntu上构建的，并且我想尝试使用Debian映像。另外，我想真正了解Docker的工作原理，该映像对我来说仍然是一个黑匣子。 编辑： 有关创建基本映像的官方文档 问题答案： 您可以看一下如何创

  • 用 Composer构建自己的 PHP 框架之基础准备

    本文向大家介绍用 Composer构建自己的 PHP 框架之基础准备，包括了用 Composer构建自己的 PHP 框架之基础准备的使用技巧和注意事项，需要的朋友参考一下 『Composer 一统天下的时代已经到来！』 ——白岩松 “一个时代结束了,另一个时代开始了。” Framework Interoperability Group（框架可互用性小组），简称 FIG，成立于 2009 年。FIG

  • ASP.NET MVC小结之基础篇（二）

    本文向大家介绍ASP.NET MVC小结之基础篇（二），包括了ASP.NET MVC小结之基础篇（二）的使用技巧和注意事项，需要的朋友参考一下 整理除了这个笔记，共享一下子，基本MVC的所有东西都介绍了，但是都是很基础的东西。本来打算一篇发表完的，但是发现东西有点多，所以分成了两篇文章，这是最后一篇了！ 1.ASP.NET MVC请求过程 　　1 2.Controller 　　(1) 控制器在AS

  • ASP.NET MVC小结之基础篇（一）

    本文向大家介绍ASP.NET MVC小结之基础篇（一），包括了ASP.NET MVC小结之基础篇（一）的使用技巧和注意事项，需要的朋友参考一下 前言：前几天要准备一个演讲，所以准备了MVC的一些基本的东西，以前也使用过MVC,但是只是使用，而不是去了解，所以趁着这个机会好好的把别人的MVC视频看了一下(是一个微软的MVP会员发布的视频，相信有些人都看过)，整理除了这个笔记，共享一下子，基本MVC的

相关阅读

ASP.NET MVC小结之基础篇（二）ASP.NET MVC小结之基础篇（一）java  基础知识之IO总结JavaScript基础知识及常用方法总结Docker学习之常用的基础命令总结

相关文章

基础的数据结构quicklist基础的数据结构ziplist基础的数据结构skiplist基础的数据结构SDSJavaScript基础之语法

相关问答

从trait调用自己的方法AnyLogic如何创建我自己的类并从行人模型调用它们？Jsoup-如何使用自动关闭创建我自己的标记Spring在表中使用错误的引用创建自己的列使用自己的方法结果再次调用Spring Controller方法

相关工具

《Go编程基础》《Julia 编程基础》应用之间调用诗篇在线建站系统手拉手业务基础平台

相关文档

C/C++ 技术面试基础知识总结前端基础知识小结鸟哥的 Linux 私房菜：基础学习篇 第四版Spark 性能调优总结Delphi 基础教程
快捷导航： 新手教程 算法原理 架构设计 Java进阶 数据库进阶 大厂专栏 面试经验 编程笔记 编程问答 所有专题 文档资料 工具软件 电子书籍 小牛导航
在线工具： 房贷计算器 个税计算器 Linux命令查询 Json格式化 正则表达式 颜色转换 AES加解密 SHA1加密 MD5加密 毒鸡汤 字数统计 随机密码生成 进制转换 Base64编解码 励志句子
Copyright © 2019-2024 小牛知识库@xnip.cn. All Rights Reserved.