ContentProvider

一、标注

　　转载自http://www.cnblogs.com/cxcco/archive/2012/01/07/2315711.html，尊重原创！

二、正文

　　今天内容是ContentProvider——如果做过电话薄应用程序的人肯定都用过这个类，那ContentProvider到底是个什么东西，有什么用，如何用呢?

　　1、 ContentProvider是个啥?

　　　　ContentProvider——内容提供者。它是一个类，这个类主要是对Android系统中进行共享的数据进行包装，并提供了一组统一的访问接口供其他程序调用。这些被共享的数据，可以使系统自己的也可以使我们个人应用程序中的数据。

　　2、为什么要有ContentProvider这个类?

　　　　在Android中，数据的存储有很多种方式，最常用的就是SQLite和XML文件方式。在不同的应用程序间，其实数据是不能直接被相互访问和操作的，在这种情况下，ContentProvider很好的被用来解决了不同应用程序间数据共享的问题。

　　　　其实在Android系统中，已经为我们提供了许多ContentProvider，如：Contacts、Browser、CallLog、Settings等等。那么，Android系统中提供了这么多的ContentProvider，另外还有我们自己公开的共享数据，我们在写程序的时候，怎么才能让我们的应用程序知道去哪儿取、如何取这些数据呢?我们自然的会想到URI。

　　3、 URI是个啥?在ContentProvider中有什么用处?URI中的几个方法。

　　　　URI（Uniform Resource Identifier）——统一资源定位符，URI在ContentProvider中代表了要操做的数据。

　　　　在Android系统中通常的URI格式为：content://LiB.cprovider.myprovider.Users/User/21

　　　　在万维网访问时通常用的URI格式为：http://www.XXXX.com/AAA/123

- content://——schema，这个是Android中已经定义好的一个标准。我个人一直认为这和我们的http://有异曲同工之妙，都是代表的协议。
- LiB.cprovider.myprovider.Users——authority（主机名），用于唯一标识这个ContentProvider，外部调用者通过这个authority来找到它。相当于www.XXXX.com，代表的是我们ContentProvider所在的”域名”，这个”域名”在我们Android中一定要是唯一的，否则系统怎么能知道该找哪一个Provider呢?所以一般情况下，建议采用完整的包名加类名来标识这个ContentProvider的authority。
- /User/21——路径，用来标识我们要操作的数据。/user/21表示的意思是——找到User中id为21的记录。其实这个相当于/AAA/123。

　　　　综上所述，content://LiB.cprovider.myprovider.Users/User/21所代表的URI的意思为：标识LiB.cprovider.myprovider中Users表中_ID为21的User项。

　　　　通过上面的介绍，我想大家都知道URI到底是如何标识我们的ContentProvider了，我们就来看看Android系统中为我们提供了些有关操作URI的方法吧。

- ContentUris类——操作URI

withAppendedId(builder, id)——在builder最后加上id组成URI。

Uri uri = ContentUris.withAppendedId(User.CONTENT_URI, id);

　　　　　　parseId(uri)——用于从URI中提取出ID值。

long returnID = ContentUris.parseId(User.CONTENT_URI);

- UriMatcher类——匹配URI

　　　　addURI(authority, path, code)——为UriMatcher添加规则，并在匹配成功后返回code值，否则返回构造函数中传入的默认值，一般为UriMatcher.NO_MATCH

　　　　参数解释：authority——主机名，path——路径，code——匹配后返回的值

uriMatcher.addURI(Users.AUTHORITY, "User", USER);

　　4、 ContentProvider中公开的几个方法

- public boolean onCreate()：该方法在ContentProvider创建后就会被调用，Android系统运行后，ContentProvider只有在被第一次使用它时才会被创建。
- public Uri insert(Uri uri, ContentValues values)：外部应用程序通过这个方法向 ContentProvider添加数据。
  - uri——标识操作数据的URI
  - values——需要添加数据的键值对
- public int delete(Uri uri, String selection, String[] selectionArgs)：外部应用程序通过这个方法从 ContentProvider中删除数据。
  - uri——标识操作数据的URI
  - selection——构成筛选添加的语句，如"id=1" 或者 "id=?"
  - selectionArgs——对应selection的两种情况可以传入null 或者 new String[]{"1"}
- public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs)：外部应用程序通过这个方法对 ContentProvider中的数据进行更新。
  - values——对应需要更新的键值对，键为对应共享数据中的字段，值为对应的修改值
  - 其余参数同delete方法
- public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)：外部应用程序通过这个方法从ContentProvider中获取数据，并返回一个Cursor对象。
  - projection——需要从Contentprovider中选择的字段，如果为空，则返回的Cursor将包含所有的字段。
  - sortOrder——默认的排序规则
  - 其余参数同delete方法　　　　
- public String getType(Uri uri)：该方法用于返回当前Url所代表数据的MIME类型。
  - 如果操作的数据属于集合类型，那么MIME类型字符串应该以vnd.android.cursor.dir/开头，例如：要得到所有user记录的Uri为content:// LiB.cprovider.myprovider.Users /User，那么返回的MIME类型字符串应该为："vnd.android.cursor.dir/user"。
  - 如果要操作的数据属于非集合类型数据，那么MIME类型字符串应该以vnd.android.cursor.item/开头，例如：得到id为21的user记录，Uri为content:// LiB.cprovider.myprovider.Users /User/21，那么返回的MIME类型字符串为："vnd.android.cursor.item/user"。

　　5、如何公开我自己的数据?

　　　　看了那么多，如何才能够把我们自己的数据公开出来给别的程序使用呢？

　　　　首先，继承ContentProvider并重写它的几个抽象方法

View Code

  1  package LiB.cprovider;
  2  
  3  import java.util.HashMap;
  4  
  5  import LiB.cprovider.Users.User;
  6  import android.content.ContentProvider;
  7  import android.content.ContentUris;
  8  import android.content.ContentValues;
  9  import android.content.UriMatcher;
 10  import android.database.Cursor;
 11  import android.database.sqlite.SQLiteDatabase;
 12  import android.database.sqlite.SQLiteQueryBuilder;
 13  import android.net.Uri;
 14  import android.text.TextUtils;
 15  
 16  public class myprovider extends ContentProvider {
 17  
 18      private DBHelper dbHelper;
 19      private static final UriMatcher uriMatcher;
 20      private static final int USER = 1;
 21      private static final int USER_ID = 2;
 22      private static HashMap<String, String> maps;
 23      static {
 24          // 当没有匹配成功是时，返回NO_MATCH的值
 25          uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
 26          // 匹配Users表中的所有User，匹配成功后返回USER整数值
 27  // content://LiB.cprovider.myprovider.Users/User
 28          uriMatcher.addURI(Users.AUTHORITY, "User", USER);
 29          // 匹配Users表中指定ID的User项，匹配成功后返回USER_ID整数值
 30  // content://LiB.cprovider.myprovider.Users/User/21
 31          uriMatcher.addURI(Users.AUTHORITY, "User/#", USER_ID);
 32  
 33          maps = new HashMap<String, String>();
 34          maps.put(User._ID, User._ID);
 35          maps.put(User.NAME, User.NAME);
 36          maps.put(User.SEX, User.SEX);
 37          maps.put(User.AGE, User.AGE);
 38      }
 39  
 40      @Override
 41      public int delete(Uri uri, String selection, String[] selectionArgs) {
 42          SQLiteDatabase db = dbHelper.getWritableDatabase();
 43          int count = 0;
 44          switch (uriMatcher.match(uri)) {
 45          case USER:
 46              count = db.delete(DBHelper.DATATABLE_NAME, selection, selectionArgs);
 47              break;
 48          case USER_ID:
 49              String noteId = uri.getPathSegments().get(1);
 50              count = db.delete(DBHelper.DATATABLE_NAME, User._ID
 51                      + "="
 52                      + noteId
 53                      + (!TextUtils.isEmpty(selection) ? " AND (" + selection
 54                              + ')' : ""), selectionArgs);
 55              break;
 56          default:
 57              throw new IllegalArgumentException();
 58          }
 59          this.getContext().getContentResolver().notifyChange(uri, null);
 60          return count;
 61      }
 62      
 63      @Override
 64      public String getType(Uri uri) {
 65          return null;
 66      }
 67  
 68      @Override
 69      public Uri insert(Uri uri, ContentValues values) {
 70          SQLiteDatabase db = dbHelper.getWritableDatabase();
 71          // User.NAME不能为空
 72          long _id = db.insert(DBHelper.DATATABLE_NAME, User.NAME, values);
 73          if (_id > 0) {
 74              Uri uri1 = ContentUris.withAppendedId(User.CONTENT_URI, _id);
 75              this.getContext().getContentResolver().notifyChange(uri1, null);
 76              return uri1;
 77          }
 78          return null;
 79      }
 80  
 81      @Override
 82      public boolean onCreate() {
 83          dbHelper = new DBHelper(this.getContext());
 84          return true;
 85      }
 86  
 87      @Override
 88      public Cursor query(Uri uri, String[] projection, String selection,
 89              String[] selectionArgs, String sortOrder) {
 90          SQLiteQueryBuilder sqb = new SQLiteQueryBuilder();
 91          switch (uriMatcher.match(uri)) {
 92          case USER:
 93              sqb.setTables(DBHelper.DATATABLE_NAME);
 94              sqb.setProjectionMap(maps);
 95              break;
 96          case USER_ID:
 97              sqb.setTables(DBHelper.DATATABLE_NAME);
 98              sqb.setProjectionMap(maps);
 99              sqb.appendWhere(User._ID + "=" + uri.getPathSegments().get(1));
100              break;
101          default:
102              throw new IllegalArgumentException();
103          }
104          SQLiteDatabase db = dbHelper.getReadableDatabase();
105          Cursor cursor = sqb.query(db, projection, selection, selectionArgs,
106                  null, null, null);
107          cursor.setNotificationUri(getContext().getContentResolver(), uri);
108          return cursor;
109      }
110  
111      @Override
112      public int update(Uri uri, ContentValues values, String selection,
113              String[] selectionArgs) {
114          SQLiteDatabase db = dbHelper.getWritableDatabase();
115          int count;
116          switch (uriMatcher.match(uri)) {
117          case USER:
118              count = db.update(DBHelper.DATATABLE_NAME, values, selection,
119                      selectionArgs);
120              break;
121          case USER_ID:
122              String noteId = uri.getPathSegments().get(1);
123              count = db.update(DBHelper.DATATABLE_NAME, values, User._ID
124                      + "="
125                      + noteId
126                      + (!TextUtils.isEmpty(selection) ? " AND (" + selection+ ')' : ""), selectionArgs);
127              break;
128          default:
129              throw new IllegalArgumentException();
130          }
131          getContext().getContentResolver().notifyChange(uri, null);
132          return count;
133      }
134  }

　　　　然后，定义我们自己的数据存储（记住，在我们公开的数据中，一定要有个_ID字段，因为在Android中，数据的存储方式是以一个表格的形式存储的，_ID字段唯一标示了每项数据，所以常规做法是将我们的类继承自BaseColumns类，关于这个类请查看官方帮助文档）

View Code

 1  package LiB.cprovider;
 2  
 3  import android.net.Uri;
 4  import android.provider.BaseColumns;
 5  //在BaseColumns中就已经包含了我们所必须的_ID字段，具体的可以查看帮助文档
 6  //下面的类组成了一个含有User项的Users表，每一项就是一个User对象，每个对象含有name,sex,age等属性
 7  public final class Users 
 8  {
 9      //请务必记住，这个AUTHORITY一定要和你在配置文件中配置的一样
10      public static final String AUTHORITY="LiB.cprovider.myprovider.Users";
11      private Users(){}
12      //包含的项
13      public static final class User implements BaseColumns{
14      private User(){}
15      //标识URI
16      public static final Uri CONTENT_URI=Uri.parse("content://"+AUTHORITY+"/User");
17      //类型
18      public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd.LiB.Users";
19      public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.item/vnd.LiB.Users";   
20      // 表字段常量
21      public static final String NAME = "name";    // 姓名
22      public static final String SEX= "sex"; // 性别
23      public static final String AGE = "age";     //年龄
24  }
25  }

　　　然后在AndroidManifest.xml中对我们的Provider进行注册

View Code

 1 <?xml version="1.0" encoding="utf-8"?>
 2  <manifest xmlns:android="http://schemas.android.com/apk/res/android"
 3      package="LiB.cprovider" android:versionCode="1" android:versionName="1.0">
 4      <uses-sdk android:minSdkVersion="9" />
 5  
 6      <application android:icon="@drawable/icon" android:label="@string/app_name">
 7          <activity android:name=".Android_ContentProviderDemoActivity"
 8              android:label="@string/app_name">
 9              <intent-filter>
10                  <action android:name="android.intent.action.MAIN" />
11                  <category android:name="android.intent.category.LAUNCHER" />
12              </intent-filter>
13          </activity>
14          <provider 
15  android:name=".myprovider" 
16          android:authorities="LiB.cprovider.myprovider.Users">
17          </provider>
18      </application>
19  </manifest>

　在AndroidManifest.xml文件中，配置provider节时一定要注意android:name为你的继承自ContentProvider的那个类的类名，android:authorities与你在定义自己的数据存储时所定义的AUTHORITIES字段一定要相等，虽然这个字段值可以随意，但是非常强烈的建议你采用包名加类名的方式类命名。

　　6、怎么操作我自己的数据呢?

　　　　为了方便我们操作ContentProvider，Android系统为我们提供了ContentResolver类。我们可以使用getContentResolver()方法返回一个ContentResolver对象，并使用它与ContentProvider对应的方法来进行操作。

View Code

 1     // 删除方法
 2      private void delete(int id) {
 3          Uri uri = ContentUris.withAppendedId(User.CONTENT_URI, id);
 4          // 使用getContentResolver()获取ContentResolver对象，并使用它的delete()方法进行数据删除操作
 5          getContentResolver().delete(uri, null, null);
 6          System.out.println("del");
 7      }
 8  
 9      // 更新
10      private void update(int id) {
11          Uri uri = ContentUris.withAppendedId(User.CONTENT_URI, id);
12          ContentValues values = new ContentValues();
13          values.put(User.NAME, "LiB");
14          values.put(User.SEX, "male");
15          values.put(User.AGE, 20+id);
16          // 使用getContentResolver()获取ContentResolver对象，并使用它的update()方法进行数据更新操作
17          getContentResolver().update(uri, values, null, null);
18          System.out.println("update...");
19      }
20  
21      // 查询
22      private void query() {
23          // 需要查询的列名
24          String[] PROJECTION = new String[] { 
25                  User._ID,
26                  User.NAME, 
27                  User.SEX, 
28                  User.AGE 
29          };
30          // 此处也可以使用Cursor c = managedQuery(User.CONTENT_URI, PROJECTION, null,
31  // null, null);方法来进行查询操作
32          Cursor c = getContentResolver().query(User.CONTENT_URI, PROJECTION,
33                  null, null, null);
34          if (c.moveToFirst()) {
35              for (int i = 0; i < c.getCount(); i++) {
36                  c.moveToPosition(i);
37                  String name = c.getString(1);
38                  String sex = c.getString(2);
39                  int age = c.getInt(3);
40                  // 输出日志
41                  Log.i("query", name + ":" + sex + ":" + age);
42              }
43          }
44          System.out.println("query...");
45      }
46  
47      // 插入
48      private void insert(int id) {
49          Uri uri = User.CONTENT_URI;
50          ContentValues values = new ContentValues();
51          values.put(User.NAME, "ZMR_"+id);
52          values.put(User.SEX, "female");
53          values.put(User.AGE, 20+id);
54          // 使用getContentResolver()获取ContentResolver对象，并使用它的insert()方法进行数据插入操作
55          getContentResolver().insert(uri, values);
56          System.out.println("insert");
57      }

三、总结

　　其实在Android中，系统已经为我们提供了许多的ContentProvider了，我们通常情况下是不需要去自定义ContentProvider的。但是，为了更好的理解ContentProvider，自己来实现一个ContentProvider是非常必要的。同时，在Android中，数据的存储方式有很多种，在上面的例子中提到了有SQLite和XML方式，下一篇笔记将介绍如何操作XML文件。

posted @ 2013-04-09 11:32 little_star 阅读(255) 评论(0) 编辑收藏举报

会员力量，点亮园子希望

刷新页面返回顶部

little_star

ContentProvider

一、标注

二、正文

1、 ContentProvider是个啥?

2、 为什么要有ContentProvider这个类?

3、 URI是个啥?在ContentProvider中有什么用处?URI中的几个方法。

ContentUris类——操作URI

UriMatcher类——匹配URI

4、 ContentProvider中公开的几个方法

5、 如何公开我自己的数据?

6、 怎么操作我自己的数据呢?

三、总结

公告

　　1、 ContentProvider是个啥?

　　2、为什么要有ContentProvider这个类?

　　3、 URI是个啥?在ContentProvider中有什么用处?URI中的几个方法。

ContentUris类——操作URI　　

　　4、 ContentProvider中公开的几个方法

　　5、如何公开我自己的数据?

　　6、怎么操作我自己的数据呢?