Android学习笔记(七)ContentProvider

一、废话

  好不容易完成出差任务,又被派到另一个地方出差!苦逼的我!年终奖还不给我发,再不发的话我都快没钱坐车回家了!

二、正文

  今天内容是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文件。

你可能感兴趣的:(android,String,user,null,delete,import)