四大组件之 ContentProvider

前言:学习ContentProvider 需要明白 3个问题,ContentProvider 是什么?ContentProvider 拿来干什么?ContentProvider 怎么用?带着问题学习,你会更高效。


ContentProvider 是什么?
    ContentProvider 是一种数据共享型组件,用于向其他组件乃至其他应用共享数据。ContentProvider 同样无法被用户直接感知,对于一个ContentProvider 组件来说,它的内部需要实现增删改查四种操作,在它的内部维持着一个数据集合,这个数据集合既可以通过数据库来实现,也可以采用其他任何类型来实现,比如List 和Map。ContentProvider 对数据集合的具体实现并没有任何要求。需要注意的是ContentProvider 内部的 insert、delete、update和 query 方法需要处理好线程同步,因为这几个方法是在Binder 线程池中被调用的,同时ContentProvider 也不需手动要停止。它提供了一套完整的机制,允许一个程序访问另一个程序中的数据,同时还能保证被访数据的安全性。目前,使用内容提供器是Android实现跨程序共享数据的标准方式。


和SharedPreferences存储的区别:
      不同于文件存储和SharedPreferences存储中的两种全局可读写操作模式,内容提供器可以选择只对哪一部分数据进行共享,从而保证我们程序中的隐私数据不会有泄漏的风险。


ContentProvider 拿来干什么?
应用场景
    1.我们想在自己的应用中访问别的应用,或者说一些ContentProvider暴露给我们的一些数据,比如手机联系人,短信等,我们想对这些数据进行读取或者修改,这就需要用到ContentProvider了!
    2.我们自己的应用,想把自己的一些数据暴露出来,给其他的应用进行读取或操作,我们也可以用 到ContentProvider,另外我们可以选择要暴露的数据,就避免了我们隐私数据的的泄露!


ContentProvider 怎么使用?
ContentResolver的基本用法
    对于每一个应用程序来说,如果想要访问内容提供器中共享的数据,就一定要借助ContentResolve类,可以通过Context中的getContentResolver()方法获取到该类的实例。ContentResolver中提供了一系列的方法用于对数据进行CRUD操作,
        ContentResolver中的增删改查方法都是不接收表名参数的,而是使用一个Uri参数代替,这个参数被称为内容URI。内容URI给内容提供器中的数据建立了唯一标识符,它主要由两部分组成,权限(authority)和路径(path)。

authority(即访问权限)
    权限是用于对不同的应用程序做区分的,一般为了避免冲突,都会采用程序包名的方式来进行命名。比如某个程序的包名是com.example.app,那么该程序对应的权限就可以命为com.example.app. provider。

path(路劲)
    路径则是用于对同一应用程序中不同的表做区分的,通常都会添加到权限的后面。比如某个程序的数据库里存在两张表,table1和table2,这时就可以将路径分别命名为/table1和/table2,然后把权限和路径进行组合,内容URI就变成了com.example.app.provider/table1和com.example.app.provider/table2。不过,目前还很难辨认出这两个字符串就是两个内容URI,我们还需要在字符串的头部加上协议声明。

因此,内容URI最标准的格式写法如下:

content://com.example.app.provider/table1
content://com.example.app.provider/table2
    由上可知,内容URI可以非常清楚地表达出我们想要访问哪个程序中哪张表里的数据。也正是因此,ContentResolver中的增删改查方法才都接收Uri对象作为参数,因为使用表名的话系统将无法得知我们期望访问的是哪个应用程序里的表。

Uri对象
    在得到了内容URI字符串之后,我们还需要将它解析成Uri对象才可以作为参数传入。解析的方法也相当简单,代码如下所示:
Uri uri = Uri.parse("content://com.example.app.provider/table1")

    只需要调用Uri.parse()方法,就可以将内容URI字符串解析成Uri对象了。现在我们就可以使用这个Uri对象来查询table1表中的数据了,代码如下所示:

Cursor cursor = getContentResolver().query(
uri,
projection,
selection,
selectionArgs,
sortOrder);
    这些参数和SQLiteDatabase中query()方法里的参数很像,但总体来说要简单一些,毕竟这是在访问其他程序中的数据,没必要构建过于复杂的查询语句。下表对使用到的这部分参数进行了详细的解释。

这些参数和SQLiteDatabase中query()方法里的参数很像,但总体来说要简单一些,毕竟这是在访问其他程序中的数据,没必要构建过于复杂的查询语句。下表对使用到的这部分参数进行了详细的解释。


query()方法参数

对应SQL部分

描述

uri

from table_name

指定查询某个应用程序下的某一张表

projection

select column1, column2

指定查询的列名

selection

where column = value

指定where的约束条件

selectionArgs

-

为where中的占位符提供具体的值

orderBy

order by column1, column2

指定查询结果的排序方式


查询数据

    查询完成后返回的仍然是一个Cursor对象,这时我们就可以将数据从Cursor对象中逐个读取出来了。读取的思路仍然是通过移动游标的位置来遍历Cursor的所有行,然后再取出每一行中相应列的数据,代码如下所示:

    if(cursor!=null){
        while (cursor.moveToNext()) {
            String column1 = cursor.getString(cursor.getColumnIndex("column1"));
            int    column2 = cursor.getInt(cursor.getColumnIndex("column2"));
        }
        cursor.close();
    }
}
添加数据

   代码如下所示:

ContentValues values = new ContentValues();
values.put("column1", "text");
values.put("column2", 1);
getContentResolver().insert(uri, values);
    可以看到,仍然是将待添加的数据组装到ContentValues中,然后调用ContentResolver的insert()方法,将Uri和ContentValues作为参数传入即可。
更新数据

    现在如果我们想要更新这条新添加的数据,把column1的值清空,可以借助ContentResolver的update()方法实现,代码如下所示:

ContentValues values = new ContentValues();
values.put("column1", "");
getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new String[] {"text", "1"});
删除数据

    注意上述代码使用了selection和selectionArgs参数来对想要更新的数据进行约束,以防止所有的行都会受影响。最后,可以调用ContentResolver的delete()方法将这条数据删除掉,代码如下所示:

getContentResolver().delete(uri, "column2 = ?", new String[] { "1" });
ContentProvider中两个重要的概念(数据模型和URI)
  1.数据模型
   ContentProvider将其存储的数据以数据表的形式提供给访问者。在数据表中,每一行为一条记录,而每一列为具有特定类型和意义的字段。每一条数据记录都包括一个"_ID"数据列,该字段唯一标识一个记录。
  2.URI

   每一个ContentProvider都对外提供了一个自身数据集的唯一标识,这个唯一标识就是URI。若一个ContentProvider管理多个数据集,这个ContentProvider将会为每个数据集分配一个独立且唯一的URI。所有的ContentProvider的URI都以”content://"开头,其中“content:"用来标识ContentProvider所管理的schema,schema是Android中已经定义好的一个标准,与http://类似,都是代表的协议。

在manifest中注册

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.databasetest"
    android:versionCode="1"
    android:versionName="1.0" >
    ……
    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        ……
        <provider
            android:name="com.example.databasetest.DatabaseProvider"
            android:authorities="com.example.databasetest.provider"
            android:enable="true"
            android:exported="true">
        </provider>
    </application>
</manifest>
name:内容提供器名称
authorities:内容提供器访问权限,是ContentProvider 的唯一标识,通过这个属性外部应用就可以访问我们的ContentProvider
enable:是否启用该内容提供器
exported:是否允许外部程序访问该内容提供器
permission:自定义权限

权限还可细分为 android:readPermission 和 android:writePermission 权限,即读权限和写权限,如果分别申明了读权限和写权限,则外界应用必须一次声明相应的权限才可以进行读/写操作,否则外界应用会异常终止。


自定义内容提供器步骤及相关解释

    前面已经提到过,如果想要实现跨程序共享数据的功能,官方推荐的方式就是使用内容提供器,可以通过新建一个类去继承ContentProvider的方式来创建一个自己的内容提供器。ContentProvider类中有六个抽象方法,我们在使用子类继承它的时候,需要将这六个方法全部重写。新建MyProvider继承自ContentProvider,代码如下所示:

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

	@Override
	public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
		return null;
	}

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

	@Override
	public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
		return 0;
	}
	
	@Override
	public int delete(Uri uri, String selection, String[] selectionArgs) {
		return 0;
	}
	
	@Override
	public String getType(Uri uri) {
		return null;
	}

}
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类型(如图片、视频等)。如果我们的应用不关注这个选项,可以直接在这个方法中返回 null 或者 “*/*”;


    上述 6 个方法都运行在 ContentProvider 的进程中,除 onCreat 由于系统回调并运行在主线程里,其他 5 个方法均由外界回调并运行在 Binder 线程池中。回顾一下,一个标准的内容URI写法是这样的:

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

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

content://com.example.app.provider/table1/1
    这就表示调用方期望访问的是com.example.app这个应用的table1表中id为1的数据。
内容URI的格式主要就只有以上两种,以路径结尾就表示期望访问该表中所有的数据,以id结尾就表示期望访问该表中拥有相应id的数据。
    我们可以使用通配符的方式来分别匹配这两种格式的内容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中的代码,如下所示:

public class MyProvider extends ContentProvider {
        //自定义常量
        //访问table1表中的所有数据
        public static final int TABLE1_DIR  = 0;
        //访问table1表中的单条数据
        public static final int TABLE1_ITEM = 1;
        //访问table2表中的所有数据 
        public static final int TABLE2_DIR  = 2;
        //访问table2表中的单条数据
        public static final int TABLE2_ITEM = 3;

        public static final String AUTHORITY = "com.example.app.provider";

        private static UriMatcher uriMatcher;

        static {
            uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
            uriMatcher.addURI(AUTHORITY, "table1", TABLE1_DIR);//访问table1表中的所有数据
            uriMatcher.addURI(AUTHORITY, "table1/#", TABLE1_ITEM);//访问table1表中的单条数据
            uriMatcher.addURI(AUTHORITY, "table2", TABLE2_ITEM);//访问table2表中的所有数据
            uriMatcher.addURI(AUTHORITY, "table2/#", TABLE2_ITEM);//访问table2表中的单条数据
        }
        ……

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


UriMatcher

     UriMatcher表示一个Uri的匹配器,它会对我们请求的Uri进行匹配,而匹配的格式就是这里我们通过addURI()方法添加格式。


getType()
    它是所有的内容提供器都必须提供的一个方法,用于获取Uri对象所对应的MIME类型。由于在getType()方法里面,我们显示的返回了android平台可以识别的MIME类型,所以在执行query方法返回Cursor对象的时候,系统将不需要再进行验证,从而可以说是节省了系统开销。

   那么何谓android平台可以识别的MIME类型呢?下面来分析一下MIME类型的结构:其实,MIME类型其实就是一个字符串,中间有一个 “/” 来隔开,“/”前面的部分是系统识别的部分,就相当于我们定义一个变量时的变量数据类型,通过这个“数据类型”,系统能够知道我们所要表示的是个什么东西。至于 “/” 后面的部分就是我们自已来随便定义的“变量名”了。

    那么,既然MIME类型就是一个字符串,那么我们的getType( )自然也可以随便返回一个系统不能识别的字符串啦?没错,有些时候我们确实也这样处理,比如说可以这样写:

     public String getType(Uri uri) {
      return getContext().getPackageName(); 
    }
    一个内容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.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;
    }
}

    到这里,一个完整的内容提供器就创建完成了,现在任何一个应用程序都可以使用ContentResolver来访问我们程序中的数据。那么前面所提到的,如何才能保证隐私数据不会泄漏出去呢?其实多亏了内容提供器的良好机制,这个问题在不知不觉中已经被解决了。因为所有的CRUD操作都一定要匹配到相应的内容URI格式才能进行的,而我们当然不可能向UriMatcher中添加隐私数据的URI,所以这部分数据根本无法被外部程序访问到,安全问题也就不存在了。


实现跨程序数据共享Demo

    创建一个DatabaseProvider类,代码如下所示:

public class DataBaseProvider extends ContentProvider {
    //自定义的对外提供的数据内容常量
    public static final int BOOK_DIR = 0;//访问Book表中的所有数据
    public static final int BOOK_ITEM = 1;//访问Book表中的单条数据
    public static final int CATEGORY_DIR = 2;//访问Category表中的所有数据
    public static final int CATEGORY_ITEM = 3;//访问Category表中的单条数据
    //权限
    public static final String AUTHORITY = "com.example.databasetest.provider";

    private static UriMatcher uriMatcher;

    private MyDatabaseHelper myDatabaseHelper;

    //对UriMatcher进行了初始化操作,将期望匹配的几种URI格式添加了进去,即对外提供的匹配路劲,
    static {
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        //参数1:权限 参数2:对外提供的表 参数3:查询整张表还是其中的一条数据
        uriMatcher.addURI(AUTHORITY, "book", BOOK_DIR);
        uriMatcher.addURI(AUTHORITY, "book/#", BOOK_ITEM);
        uriMatcher.addURI(AUTHORITY, "category", CATEGORY_DIR);
        uriMatcher.addURI(AUTHORITY, "category/#", CATEGORY_ITEM);
    }


    @Override
    public boolean onCreate() {
        //在ContentProvider中只能用getContext(),不然访问这个内容提供者的程序会报空指针异常,即找不到对应的Uri
        myDatabaseHelper = new MyDatabaseHelper(getContext(), "BookStore.db", null, 2);

        return true;//然后返回true表示内容提供器初始化成功,这时数据库就已经完成了创建或升级操作。
    }

    /**
     * uriMatcher.match(uri)
     * UriMatcher的match()方法对传入的Uri对象进行匹配,如果发现UriMatcher中某个内容URI格式成功匹配了该Uri对象,则会返回相应的自定义代码,
     * 然后我们就可以判断出调用方期望访问的到底是什么数据了。
     */
    @Nullable
    @Override
    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
        SQLiteDatabase db = myDatabaseHelper.getReadableDatabase();
        Cursor cursor = null;
        switch (uriMatcher.match(uri)) {//根据传入的Uri参数判断出用户想要访问哪张表,
            case BOOK_DIR: {
                cursor = db.query("Book", projection, selection, selectionArgs, null, null, sortOrder);
            }
            break;
            case BOOK_ITEM: {
                //getPathSegments()方法,它会将内容URI权限之后的部分以“/”符号进行分割,并把分割后的结果放入到一个字符串列表中,
                //那这个列表的第0个位置存放的就是路径,第1个位置存放的就是id
                String bookId = uri.getPathSegments().get(1);
                cursor = db.query("Book", projection, "id=?", new String[]{bookId}, null, null, sortOrder);
            }
            break;
            case CATEGORY_DIR: {
                cursor = db.query("Category", projection, selection, selectionArgs, null, null, sortOrder);
            }
            break;
            case CATEGORY_ITEM: {
                String categoryId = uri.getPathSegments().get(1);
                cursor = db.query("Category", projection, "id=?", new String[]{categoryId}, null, null, sortOrder);
            }
            break;
        }
        return cursor;
    }

    /**
     * insert()方法要求返回一个能够表示这条新增数据的URI,
     * 所以我们还需要调用Uri.parse()方法来将一个内容URI解析成Uri对象,当然这个内容URI是以新增数据的id结尾的。
     */
    @Nullable
    @Override
    public Uri insert(Uri uri, ContentValues contentValues) {
        SQLiteDatabase db = myDatabaseHelper.getWritableDatabase();
        Uri uriReturn = null;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR: {
            }
            case BOOK_ITEM: {
                long newBookId = db.insert("Book", null, contentValues);
                uriReturn = Uri.parse("content://" + AUTHORITY + "/book/" + newBookId);
            }
            break;
            case CATEGORY_DIR: {
            }
            break;
            case CATEGORY_ITEM: {
                long newCategoryId = db.insert("Category", null, contentValues);
                uriReturn = Uri.parse("content://" + AUTHORITY + "/category/" + newCategoryId);
            }
            break;
        }
        return uriReturn;
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        SQLiteDatabase db = myDatabaseHelper.getWritableDatabase();
        int deletedRows = 0;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR: {

                deletedRows = db.delete("Book", selection, selectionArgs);
            }
            break;
            case BOOK_ITEM: {
                String bookId = uri.getPathSegments().get(1);
                deletedRows = db.delete("Book", "id=?", new String[]{bookId});
            }
            break;
            case CATEGORY_DIR: {
                deletedRows = db.delete("Category", selection, selectionArgs);
            }
            break;
            case CATEGORY_ITEM: {
                String categoryId = uri.getPathSegments().get(1);
                deletedRows = db.delete("Category", "id=?", new String[]{categoryId});
            }
            break;
        }
        return deletedRows;//返回被删除的行数。
    }

    @Override
    public int update(Uri uri, ContentValues contentValues, String selection, String[] selectionArgs) {
        SQLiteDatabase db = myDatabaseHelper.getWritableDatabase();
        int updatedRows = 0;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
                updatedRows = db.update("Book", contentValues, selection, selectionArgs);
                break;
            case BOOK_ITEM:
                String bookId = uri.getPathSegments().get(1);
                updatedRows = db.update("Book", contentValues, "id = ?", new String[]{bookId});
                break;
            case CATEGORY_DIR:
                updatedRows = db.update("Category", contentValues, selection, selectionArgs);
                break;
            case CATEGORY_ITEM:
                String categoryId = uri.getPathSegments().get(1);
                updatedRows = db.update("Category", contentValues, "id = ?", new String[]{categoryId});
                break;
            default:
                break;
        }
        return updatedRows;//返回受影响的行数。
    }

    /**
     * 对传入的Uri参数进行解析,从中分析出调用方期望访问的表和数据。
     */
    @Nullable
    @Override
    public String getType(Uri uri) {
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
                return "vnd.android.cursor.dir/vnd.com.example.databasetest. provider.book";
            case BOOK_ITEM:
                return "vnd.android.cursor.item/vnd.com.example.databasetest. provider.book";
            case CATEGORY_DIR:
                return "vnd.android.cursor.dir/vnd.com.example.databasetest. provider.category";
            case CATEGORY_ITEM:
                return "vnd.android.cursor.item/vnd.com.example.databasetest. provider.category";
        }
        return null;
    }
}

    首先在类的一开始,定义了四个常量,分别用于表示访问Book表中的所有数据、访问Book表中的单条数据、访问Category表中的所有数据和访问Category表中的单条数据。然后在静态代码块里对UriMatcher进行了初始化操作,将期望匹配的几种URI格式添加了进去。
   接下来就是每个抽象方法的具体实现了,先来看下onCreate()方法,这个方法的代码很短,就是创建了一个MyDatabaseHelper的实例,然后返回true表示内容提供器初始化成功,这时数据库就已经完成了创建或升级操作。
    接着看一下query()方法,在这个方法中先获取到了SQLiteDatabase的实例,然后根据传入的Uri参数判断出用户想要访问哪张表,再调用SQLiteDatabase的query()进行查询,并将Cursor对象返回。
    注意当访问单条数据的时候有一个细节,这里调用了Uri对象的getPathSegments()方法,它会将内容URI权限之后的部分以“/”符号进行分割,并把分割后的结果放入到一个字符串列表中,那这个列表的第0个位置存放的就是路径,第1个位置存放的就是id了。得到了id之后,再通过selection和selectionArgs参数进行约束,就实现了查询单条数据的功能。
    再往后就是insert()方法,同样它也是先获取到了SQLiteDatabase的实例,然后根据传入的Uri参数判断出用户想要往哪张表里添加数据,再调用SQLiteDatabase的insert()方法进行添加就可以了。注意insert()方法要求返回一个能够表示这条新增数据的URI,所以我们还需要调用Uri.parse()方法来将一个内容URI解析成Uri对象,当然这个内容URI是以新增数据的id结尾的。
    接下来就是update()方法了,也是先获取SQLiteDatabase的实例,然后根据传入的Uri参数判断出用户想要更新哪张表里的数据,再调用SQLiteDatabase的update()方法进行更新就好了,受影响的行数将作为返回值返回。

    下面是delete()方法,这里仍然是先获取到SQLiteDatabase的实例,然后根据传入的Uri参数判断出用户想要删除哪张表里的数据,再调用SQLiteDatabase的delete()方法进行删除就好了,被删除的行数将作为返回值返回。

    最后是getType()方法,这个方法中的代码完全是按照上一节中介绍的格式规则编写的,相信已经没有什么解释的必要了。这样我们就将内容提供器中的代码全部编写完了,不过离实现跨程序数据共享的功能还差了一小步,因为还需要将内容提供器在AndroidManifest.xml文件中注册才可以,如下所示:
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.databasetest"
    android:versionCode="1"
    android:versionName="1.0" >
    ……
    <application
        android:allowBackup="true"
        android:icon="@drawable/ic_launcher"
        android:label="@string/app_name"
        android:theme="@style/AppTheme" >
        ……
        <provider
            android:name="com.example.databasetest.DatabaseProvider"
            android:authorities="com.example.databasetest.provider"
            android:enable="true"
            android:exported="true">
        </provider>
    </application>
</manifest>
    使用了<provider>标签来对DatabaseProvider这个内容提供器进行注册,在android:name属性中指定了该类的全名,又在android:authorities属性中指定了该内容提供器的权限。

现在DatabaseTest这个项目就已经拥有了跨程序共享数据的功能了,我们赶快来尝试一下。首先需要将DatabaseTest程序从模拟器中删除掉,以防止上一章中产生的遗留数据对我们造成干扰。然后运行一下项目,将DatabaseTest程序重新安装在模拟器上了。接着关闭掉DatabaseTest这个项目,并创建一个新项目ProviderTest,我们就将通过这个程序去访问DatabaseTest中的数据。


参考资料:第一行代码、Android开发艺术探索

https://www.cnblogs.com/dazuihou/p/3595552.html

猜你喜欢

转载自blog.csdn.net/daxiong25/article/details/80997704
今日推荐