Android ContentProvider

在自己的应用程序中访问其他应用程序的数据,只需要获取到该应用程序的内容Uri,然后借助ContentResolver进行CRUD操作就可以了.那些提供外部访问接口的应用程序都是如何实现这种功能的,怎样保证数据的安全性,使得隐私数据不会泄露出去.
1.创建内容提供器的步骤
可以通过新建一个类继承ContentProvider的方式来创建一个自己的内容提供器,ContentProvider共有6个抽象方法,我们在使用子类继承它的时候需要将这6个抽象方法全部重写,代码如下:

public class MyProvider extends ContentProvider {
    @Override
    public boolean onCreate() {
        return false;
    }

    @Override
    public Cursor query( Uri uri, String[] strings, String s, String[] strings1, String s1) {
        return null;
    }

    @Override
    public String getType( Uri uri) {
        return null;
    }

    @Override
    public Uri insert( Uri uri, ContentValues contentValues) {
        return null;
    }

    @Override
    public int delete( Uri uri, String s, String[] strings) {
        return 0;
    }

    @Override
    public int update( Uri uri, ContentValues contentValues, String s, String[] strings) {
        return 0;
    }
}

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

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

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

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

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

getType()方法,根据传入的内容URI来返回相应的MIME类型.

可以看到,几乎每一个方法都会带有Uri这个参数,这个参数也是调用ContentResolver的增删改查方法时传递过来的,而现在,我们需要对传入的Uri参数进行解析,从中分析出调用方期望访问的表和数据.
一个标准的内容URI是这样写的:

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

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

content://com.example.app.procider/table1/1

这就表示调用方期望访问的是com.example.app这个应用的table1表中id为1的数据

内容URI的格式主要就只有以上两种,以路径结尾就表示期望访问该表中所有的数据,以id结尾就表示期望访问该表中拥有相应id的数据,我们可以使用通配符的方式来分别匹配这两种格式的内容URI,规则如下
*:表示匹配任意长度的任意字符
#:表示匹配任意长度的数字
所以,一个能够匹配任意表的内容URI的格式就可以这样写:

content://com.example.app.procider/*

而一个能够匹配table1表中任意一行数据的内容URI格式就可以这样写:

content://com.example.app.procider/table1/#

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

public class MyProvider extends ContentProvider {
    public static final int TABLE1_DIR = 0;
    public static final int TABLE1_ITEM = 1;
    public static final int TABLE2_DIR = 2;
    public static final int TABLE2_ITEM = 3;
    private static UriMatcher uriMatcher;
    static{
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        uriMatcher.addURI("com.example.app.provider", "table1", TABLE1_DIR);
        uriMatcher.addURI("com.example.app.provider", "table1/#", TABLE1_ITEM);
        uriMatcher.addURI("com.example.app.provider", "table2", TABLE2_DIR);
        uriMatcher.addURI("com.example.app.provider", "table2/#", TABLE1_ITEM);
    }
    ...
    @Override
    public Cursor query( Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
        switch(uriMatcher.match(uri)){
            case TABLE1_DIR:
                //查询table1表中的所有数据
                break;
        case TABLE1_ITEM:
                //查询table1表中的单条数据
                break;
        case TABLE2_DIR:
                //查询table2表中的所有数据
                break;
        case TABLE2_ITEM
                //查询table2表中的单条数据
                break;
        default:
            break;
        }
        ...
    }
    ...
}

可以看到,MyProvider中新增了4个整型常量,其中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()方法和query()方法一样,都会携带Uri这个参数,然后同样利用UriMatcher的match()方法判断出调用方期望访问的是哪张表,再对该表中的数据进行相应的操作就可以了.
除此之外还有一个getType()方法,它是所有的内容提供器都必须提供的一个方法,用于获取Uri对象所对应的MIME类型.一个内容URI所对应的MIME字符串主要有3个部分组成,Android对这3个部分做了如下格式规定:

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

所以对于content://com.example.app.procider/table1这个内容URI,它所对应的MIME类型就可以写成:
vnd.android.cursor.dir/vnd.com.example.app.provider.table1
对于content://com.example.app.procider/table1/1这个内容URI,它所对应的MIME类型就可以写成:
vnd.android.cursor.item/vnd.com.example.app.provider.table1

现在继续完善MyProvider的内容,实现getType()方法中的逻辑,代码如下:

public class MyProvider extends ContentProvider {
    ...
    @Override
    public String getType(Uri uri){
        switch(uriMatcher.match(uri)){
            case TABLE1_DIR:
                return "vnd.android.cursor.dir/vnd.com.example.app.provider.table1";
            case TABLE1_ITEM:
                return "vnd.android.cursor.item/vnd.com.example.app.provider.table1";
            case TABLE2_DIR:
                return "vnd.android.cursor.dir/vnd.com.example.app.provider.table2";
            case TABLE2_ITEM:
                return "vnd.android.cursor.item/vnd.com.example.app.provider.table2";
            default:
                break;
        }
        return null;
    }
}