ContentProvider入门

Author Avatar
ChangQin 4月 22, 2017

基本概念

1.什么是Content Provider(内容提供器)

Content Provider主要用于在不同的应用程序之间实现数据共享的功能，它提供了一套完整的机制，允许一个应用程序访问另一个程序中的数据，还能保证被访问数据的安全性。

2.ContentResolver简介

Content providers是以类似数据库中表的方式将数据暴露。它提供了一系列方法用于对数据进行CRUD操作，其中insert()方法用于添加数据，delete()方法用于删除数据，update()方法用于更新数据，query()方法用于查询数据。它进行CRUD的时候是以Uri参数进行的。

3.什么是Uri

Uri一般由四部分组成。

  • 前缀 固定格式为”content://“
  • 标识 为了唯一性，一般使用应用程序的包名来表示
  • 表名 例如”content://com.example.demo/user”
  • 如果Uri中含有某一条记录的id，则可以这样表示”content://com.example.demo/user/1”，代表访问user表中id为1的那一条数据

因为内容Uri的格式只有两种，有id和没id，所以我们可以用通配符来匹配这两种格式所有的Uri

  • *：表示匹配任意长度的任意字符。
  • #： 表示匹配任意长度的数字。
    所以一个能够匹配任意表内容的Uri就可以写成”content://com.example.demo/*”。
    所以一个能够匹配sser表任意一条数据的Uri就可以写成”content://com.example.demo/user/#”。

4.什么是UriMatcher

是一个工具类，专门用来匹配Uri，主要方法有两个

  • addURI
    这个方法接受3个参数，分别把authority、path和一个自定义代码传进去。
    authority一般为包名，path为表名。
  • match
    这个方法接受Uri作为参数，返回能够匹配这个Uri对象所对应的自定义代码，利用这个代码，我们可以判断调用者希望访问的是哪张表。

编码实现

1.创建内容提供器的步骤
新建一个ProviderDemo项目和新建一个类，继承自ContentProvider。重写它的子类方法。
android studio用户可以直接使用new -> other -> Content Provider实现。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
public class MyContentProvider extends ContentProvider {
    public static final int USER_DIR = 0;
	
    public static final int USER_ITEM = 1;
    public static final String AUTHORITY = "com.example.changqin.provider";
    private DbHelper mDbHelper;
    private static UriMatcher uriMatcher;
    static {
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        uriMatcher.addURI(AUTHORITY, "user", USER_DIR);
        uriMatcher.addURI(AUTHORITY, "user/#", USER_ITEM);
    }
    @Override
    public boolean onCreate() {
        mDbHelper = new DbHelper(getContext(), "school", null, 1);
        return true;
    }
    public MyContentProvider() {
    }
    @Override
    public String getType(Uri uri) {
        switch (uriMatcher.match(uri)) {
            case USER_DIR:
                return "vnd.android.cursor.dir/cnd.com.example.changqin.provider.user";
            case USER_ITEM:
                return "vnd.android.cursor.item/cnd.com.example.changqin.provider.user";
        }
        return null;
    }
    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        SQLiteDatabase db = mDbHelper.getWritableDatabase();
        int result = 0;
        switch (uriMatcher.match(uri)) {
            case USER_DIR:
                result = db.delete("user", selection, selectionArgs);
                break;
            case USER_ITEM:
                String id = uri.getPathSegments().get(1);
                result = db.delete("user", "id=?", new String[]{id});
                break;
        }
        return result;
    }
    @Override
    public Uri insert(Uri uri, ContentValues values) {
        SQLiteDatabase db = mDbHelper.getWritableDatabase();
        Uri uriReturn = null;
        switch (uriMatcher.match(uri)) {
            case USER_DIR:
            case USER_ITEM:
                long newUserId = db.insert("user", null, values);
                uriReturn = Uri.parse("content://" + AUTHORITY + "/user/" + newUserId);
                break;
        }
        return uriReturn;
    }
    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
                        String[] selectionArgs, String sortOrder) {
        SQLiteDatabase db = mDbHelper.getReadableDatabase();
        Cursor cursor = null;
        switch (uriMatcher.match(uri)) {
            case USER_DIR:
                cursor = db.query("user", projection, selection, selectionArgs, null, null, sortOrder);
                break;
            case USER_ITEM:
                String userId = uri.getPathSegments().get(1);
                cursor = db.query("user", projection, "id=?", new String[]{userId}, null, null, sortOrder);
                break;
            default:
                break;
        }
        return cursor;
    }
    @Override
    public int update(Uri uri, ContentValues values, String selection,
                      String[] selectionArgs) {
        SQLiteDatabase db = mDbHelper.getWritableDatabase();
        int result = 0;
        switch (uriMatcher.match(uri)) {
            case USER_DIR:
                result = db.update("user", values, selection, selectionArgs);
            case USER_ITEM:
                String id = uri.getPathSegments().get(1);
                result = db.update("user", values, "id=?", new String[]{id});
        }
        return result;
    }
}

2.query方法解释，其他同理
因为我们已经创建过数据库了，在query方法中，获取SQLiteDatabase的实例，然后用uriMatcher.match(uri)方法可以进行判断，用户希望访问的是哪一张表，然后按照数据库的方法，进行查询，然后返回Cursor就可以了。

uri.getPathSegments().get(1)
这个方法返回的是一个List，例如我们请求的Uri是”content://com.example.demo/user/1”，这个方法会将最后一个”/“后面的数据进行list存储，所以上面方法get(1)取得的就是1这个id。

3.附DbHelper类

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
public class DbHelper extends SQLiteOpenHelper {
    private static final String CREATE_USER = "create table user ("
            + "id integer primary key autoincrement ,"
            + " username text,"
            + "password text"
            + ")";
    private static String user0 = "insert into user(username,password)values('wcq','qqq')";
    private static String user1 = "insert into user(username,password)values('wcq123','qqq123')";
    private static String user2 = "insert into user(username,password)values('hyx','548')";
    private static String user3 = "insert into user(username,password)values('xhkda','7891')";
    public DbHelper(Context context, String name, SQLiteDatabase.CursorFactory factory,
                    int version) {
        super(context, name, factory, version);
    }
    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_USER);
        db.execSQL(user0);
        db.execSQL(user1);
        db.execSQL(user2);
        db.execSQL(user3);
    }
    @Override
    public void onUpgrade(SQLiteDatabase sqLiteDatabase, int i, int i1) {
    }
}

4.创建ProviderTest项目，编写代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
Button quary_data = (Button) findViewById(R.id.btn_query);
        quary_data.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Uri uri = Uri.parse("content://com.example.changqin.provider/user/1");
                //Cursor cursor = getContentResolver().query(uri, null, "id=?", new String[]{"1"}, null);
                Cursor cursor = getContentResolver().query(uri, null, null, null, null);
                if (cursor != null) {
                    while (cursor.moveToNext()){
                        int userId = cursor.getInt(0);
                        String username = cursor.getString(1);
                        String password = cursor.getString(2);
                        Log.e("wcq",userId+" "+username+" "+password);
                    }
                    cursor.close();
                }
            }
        });

查看控制台可以看到，我们成功的访问了ProviderDemo中数据库的数据。

Paste_Image.png

5.其他的操作和查询差不多，基本入门知识就先讲解到这里。

Powered by Hexo
Theme - Material