码迷,mamicode.com
首页 > 移动开发 > 详细

Android学习笔记(二十)——自定义内容提供器

时间:2016-04-25 00:23:23      阅读:272      评论:0      收藏:0      [点我收藏+]

标签:

   //此系列博文是《第一行Android代码》的学习笔记,如有错漏,欢迎指正!

  如果我们想要实现跨程序共享数据的功能,官方推荐的方式就是使用内容提供器,可以通过新建一个类去继承 ContentProvider 的方式来创建一个自己的内容提供器:

 

一、继承ContentProvider的六个方法:

  ContentProvider 类中有六个抽象方法,我们需要使用子类去继承它,并重写六个方法,我们先来认识这六个类。新建 MyProvider继承自 ContentProvide,代码如下所示:

技术分享
 1 public class MyProvider extends ContentProvider {
 2     @Override
 3     public boolean onCreate() {
 4         return false;
 5     }
 6 
 7     @Override
 8     public Cursor query(Uri uri, String[] projection, String selection,String[] selectionArgs, String sortOrder) {
 9         return null;
10     }
11 
12     @Override
13     public Uri insert(Uri uri, ContentValues values) {
14         return null;
15     }
16 
17     @Override
18     public int update(Uri uri, ContentValues values, String selection,String[] selectionArgs) {
19         return 0;
20     }
21 
22     @Override
23     public int delete(Uri uri, String selection, String[] selectionArgs) {
24         return 0;
25     }
26     
27     @Override
28     public String getType(Uri uri) {
29         return null;
30     }
31 }
View Code

  1)onCreate():
    初始化内容提供器的时候调用。通常会在这里完成对数据库的创建和升级等操作,返回 true 表示内容提供器初始化成功,返回 false 则表示失败。注意,只有当存在ContentResolver 尝试访问我们程序中的数据时,内容提供器才会被初始化。

  2)query():
    从内容提供器中查询数据。使用 uri 参数来确定查询哪张表,projection参数用于确定查询哪些列,selection和 selectionArgs参数用于约束查询哪些行,sortOrder 参数用于对结果进行排序,查询的结果存放在 Cursor 对象中返回。

  3)insert():
    向内容提供器中添加一条数据。使用 uri 参数来确定要添加到的表,待添加的数据保存在 values 参数中。添加完成后,返回一个用于表示这条新记录的 URI。

  4)update():
    更新内容提供器中已有的数据。使用 uri 参数来确定更新哪一张表中的数据,新数据保存在 values 参数中,selection 和 selectionArgs 参数用于约束更新哪些行,受影响的行数将作为返回值返回。

  5)delete():
    从内容提供器中删除数据。使用 uri 参数来确定删除哪一张表中的数据,selection和 selectionArgs参数用于约束删除哪些行,被删除的行数将作为返回值返回。

  6)getType():
    根据传入的内容 URI来返回相应的 MIME类型。

 

二、使用UriMatcher类:

  我们知道,一个标准的内容 URI写法是这样的:

content://com.example.app.provider/table1

这就表示调用方期望访问的是 com.example.app 这个应用的 table1 表中的数据。除此之外,我们还可以在这个内容 URI的后面加上一个 id,如下所示:

content://com.example.app.provider/table1/ 

这就表示调用方期望访问的是 com.example.app 这个应用的 table1表中 id 为 1的数据。我们可以使用通配符的方式来分别匹配这两种格式的内容 URI,规则如下:
  1)*:表示匹配任意长度的任意字符;
  2)#:表示匹配任意长度的数字。

所以,一个能够匹配任意表的内容 URI格式就可以写成: content://com.example.app.provider/*  而一个能够匹配 table1表中任意一行数据的内容 URI格式就可以写成:
content://com.example.app.provider/table1/#。

  接着, 我们再借助UriMatcher这个类就可以轻松地实现匹配内容URI的功能。 UriMatcher中提供了一个 addURI()方法,这个方法接收三个参数,可以分别把权限、路径和一个标志传进去。这样,当调用 UriMatcher 的 match()方法时,就可以将一个 Uri 对象传入,返回值是某个能够匹配这个 Uri 对象所对应的标志,利用这个标志,我们就可以判断出调用方期望访问的是哪张表中的数据了。我们修改 MyProvider中的代码,如下所示:

技术分享
 1 public class MyProvider extends ContentProvider {
 2 
 3     public static final int TABLE1_DIR = 0;
 4     public static final int TABLE1_ITEM = 1;
 5     public static final int TABLE2_DIR = 2;
 6     public static final int TABLE2_ITEM = 3;
 7 
 8     private static UriMatcher uriMatcher;
 9     static {
10         uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
11         uriMatcher.addURI("com.example.app.provider", "table1", TABLE1_DIR);
12         uriMatcher.addURI("com.example.app.provider ", "table1/#", TABLE1_ITEM);
13         uriMatcher.addURI("com.example.app.provider ", "table2", TABLE2_ITEM);
14         uriMatcher.addURI("com.example.app.provider ", "table2/#", TABLE2_ITEM);
15     }
16 
17     @Override
18     public boolean onCreate() {
19         return false;
20     }
21 
22     @Override
23     public Cursor query(Uri uri, String[] projection, String selection,String[] selectionArgs, String sortOrder) {
24         switch (uriMatcher.match(uri)) {
25             case TABLE1_DIR:
26                 //  查询table1 表中的所有数据
27                 break;
28             case TABLE1_ITEM:
29                 //  查询table1 表中的单条数据
30                 break;
31             case TABLE2_DIR:
32                 //  查询table2 表中的所有数据
33                 break;
34             case TABLE2_ITEM:
35                 //  查询table2 表中的单条数据
36                 break;
37             default:
38                 break;
39         }
40     }
41 
42     @Override
43     public Uri insert(Uri uri, ContentValues values) {
44         return null;
45     }
46 
47     @Override
48     public int update(Uri uri, ContentValues values, String selection,String[] selectionArgs) {
49         return 0;
50     }
51 
52     @Override
53     public int delete(Uri uri, String selection, String[] selectionArgs) {
54         return 0;
55     }
56 
57     @Override
58     public String getType(Uri uri) {
59         return null;
60     }
61 }
View Code

  代码中我们在MyProvider 中新增了四个整型常量,其中 TABLE1_DIR 表示访问 table1 表中的所有数据,TABLE1_ITEM 表示访问 table1 表中的单条数据,TABLE2_DIR 表示访问table2 表中的所有数据,TABLE2_ITEM 表示访问 table2 表中的单条数据。接着在静态代码块里我们创建了 UriMatcher 的实例,并调用 addURI()方法,将期望匹配的内容 URI 格式传递进去,注意这里传入的路径参数是可以使用通配符的。然后当 query()方法被调用的时候,就会通过 UriMatcher 的 match()方法对传入的 Uri 对象进行匹配,如果发现 UriMatcher 中某个内容 URI格式成功匹配了该 Uri 对象,则会返回相应的自定义代码,然后我们就可以判断出调用方期望访问的到底是什么数据了。 而insert()、update()、delete()这几个方法的实现也是差不多的,它们都会携带 Uri 这个参数,我们同样可以利用 UriMatcher 的 match()方法判断出调用方期望访问的是哪张表,然后对该表中的数据进行相应的操作就可以了。

  最后我们还得完成getType()方法的逻辑。getType()方法是所有的内容提供器都必须提供的一个方法, 用于获取 Uri 对象所对应的 MIME类型。一个内容 URI所对应的 MIME字符串主要由三部分组成,Android对这三个部分做了如下格式规定:

  1)必须以 vnd 开头;
  2) 如果内容 URI 以路径结尾,则后接 android.cursor.dir/,如果内容 URI 以 id 结尾,则后接 android.cursor.item/;
  3)最后接上 vnd.<authority>.<path>。

  所以,对于  content://com.example.app.provider/table1  这个内容 URI,它所对应的 MIME类型就可以写成: vnd.android.cursor.dir/vnd.com.example.app.provider.table1对于 content://com.example.app.provider/table1/1 这个内容 URI,它所对应的 MIME类型就可以写成: vnd.android.cursor.item/vnd. com.example.app.provider.table  最后,我们完成getType()的逻辑如下:

技术分享
 1 @Override
 2     public String getType(Uri uri) {
 3         switch (uriMatcher.match(uri)) {
 4             case TABLE1_DIR:
 5                 return "vnd.android.cursor.dir/vnd.com.example.app.provider.table1";
 6             case TABLE1_ITEM:
 7                 return "vnd.android.cursor.item/vnd.com.example.app.provider.table1";
 8             case TABLE2_DIR:
 9                 return "vnd.android.cursor.dir/vnd.com.example.app.provider.table2";
10             case TABLE2_ITEM:
11                 return "vnd.android.cursor.item/vnd.com.example.app.provider.table2";
12             default:
13                 break;
14         }
15     }
View Code

  至此,一个完整的内容提供器就创建完成了,由于内容提供器接受完Uri对象后的操作是自定义的,所以我们可以控制哪些数据可以被访问,哪些不可以,我们自然不会允许隐私数据被访问。

 

  //End.

  

Android学习笔记(二十)——自定义内容提供器

标签:

原文地址:http://www.cnblogs.com/Vincent-Bryan/p/5424909.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!