Content Provider 之 最终弹 实战体验跨程序数据共享(结合SQLiteDemo)


本模块共有四篇文章,参考郭神的《第一行代码》,对Content Provider的学习做一个详细的笔记,大家可以一起交流一下:


简单起见,我们还是在之前的DatabaseTest项目(点击前往码云地址)的基础上继续开发。
需求是:通过内容提供器来给它加人外部访问接口。

程序设计的步骤:

1.在A程序中注册内容提供器,写好接口处理方法;
      具体的,全局变量:定义自定义代码常量,定义authority常量,声明uriMatcher和DatabaseHelper对象;
      1.1 内容提供器中增删改查的程序设计步骤为:
            1.1.1  调用实例化DatabaseHelper的get方法获得SQLiteDatabase实例化对象;
                      (get方法即getWritableDatabase或者getReadableDatabase)
            1.1.2   接着,query需定义一个Cursor对象(cursor)用于接收返回结果;
                                  insert需定义一个Uri对象(urireturn)用于接收insert新增的数据行的uri
                                  update需定义一个int对象(updatedRows)用于接收受影响的行数;
                                  delete需定义一个int对象(deletedRows)用于接收受影响的行数(被删除的行数);
            1.1.3  使用switch语句进行对uri的判断及判断结果的处理;
2.在需要访问A程序的内容提供器的程序中,构建对应的Uri,通过getContentResolver调用增删改查即可;


下面开始详细解析:
打开DatabaseTest项目(点击前往码云地址),首先将MyDatabaseHelper中使用Toast弹出创建数据库成功的提示去除掉,因为跨程序访问时我们不能直接使用Toast(!!!!!)。然后创建一个内容提供器,右击com.example.databasetest包—New—Other—ContentProvider,

9125154-9122ceb510408fe9.png


会弹出如图所示:

9125154-633d1994f088dbd0.png

这里我们将内容提供器命名为DatabaseProvider,
authority指定为com.example.databasetest.provider,
Exported属性表示是否允许外部程序访问我们的内容提供器,
Enabled属性表示是否启用这个内容提供器。
将两个属性都勾中,点击Finish完成创建。
接着我们修改DatabaseProvider:

package com.example.databasetest;

import android.content.ContentProvider;
import android.content.ContentValues;
import android.content.UriMatcher;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.net.Uri;

public class DatabaseProvider extends ContentProvider {
    public static final int BOOK_DIR = 0;
    public static final int BOOK_ITEM = 1;
    public static final int CATEGORY_DIR = 2;
    public static final int CATEGORY_ITEM = 3;

    public static final String AUTHORITY = "com.example.databasetest.provider";
    private static UriMatcher uriMatcher;
    private MyDatabaseHelper dbHelper;

    static {
        uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        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() {
        dbHelper = new MyDatabaseHelper(getContext(), "BookStore.db", null, 2);
        return true;
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
        // 查询数据
        SQLiteDatabase db = dbHelper.getReadableDatabase();
        Cursor cursor = null;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
                cursor = db.query("Book", projection, selection, selectionArgs, null, null, sortOrder);
                break;
            case BOOK_ITEM:
                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;
            default:
                break;
        }
        return cursor;
    }

    @Override
    public Uri insert(Uri uri, ContentValues values) {
        // 添加数据
        SQLiteDatabase db = dbHelper.getWritableDatabase();
        Uri uriReturn = null;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
            case BOOK_ITEM:
                long newBookId = db.insert("Book", null, values);          //插入后返回一个id!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
                uriReturn = Uri.parse("content://" + AUTHORITY + "/book/" + newBookId);//id构造用于返回的URI!!!!!!!!!!!!!!!!!!!!!!
                break;
            case CATEGORY_DIR:
            case CATEGORY_ITEM:
                long newCategoryId = db.insert("Category", null, values);
                uriReturn = Uri.parse("content://" + AUTHORITY + "/category/" + newCategoryId);
                break;
            default:
                break;
        }
        return uriReturn;
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
        // 更新数据
        SQLiteDatabase db = dbHelper.getWritableDatabase();
        int updatedRows = 0;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
                updatedRows = db.update("Book", values, selection, selectionArgs);
                break;
            case BOOK_ITEM:
                String bookId = uri.getPathSegments().get(1);
                updatedRows = db.update("Book", values, "id = ?", new String[] { bookId });
                break;
            case CATEGORY_DIR:
                updatedRows = db.update("Category", values, selection, selectionArgs);
                break;
            case CATEGORY_ITEM:
                String categoryId = uri.getPathSegments().get(1);
                updatedRows = db.update("Category", values, "id = ?", new String[] { categoryId });
                break;
            default:
                break;
        }
        return updatedRows;
    }

    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        // 删除数据
        SQLiteDatabase db = dbHelper.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;
            default:
                break;
        }
        return deletedRows;
    }

    @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;
    }

}
  • 代码虽然很长,不过都不难理解,都是上一节学习过的内容。
    首先在类的一开始,同样是定义了4个常量,分别用于表示
    访问Book表中的所有数据;
    访问Book表中的单条数据;
    访问Category表中的所有数据;
    访问Category表中的单条数据。
    然后在静态代码块里对UriMatcher进行了初始化操作,将期望匹配的几种URI格式添加了进去。

  • 接下来是onCreate()方法:
    创建了一个MyDatabaseHelper的实例,然后返回true表示内容提供器初始化成功,这时数据库就已经完成了创建或升级操作。

  • 接着是query()方法:
    首先获取到SQLiteDatabase实例,然后根据传入的Uri参数判断出用户想要访问哪张表,
    再调用SQLiteDatabase的query()进行查询,并将Cursor对象返回即可。
    注意当访问单条数据的时候有一个细节:
    这里调用了Uri对象的getpathSegments()方法,它会将内容URI权限之后的部分以“/“符号进行分割,并把分割后
    的结果放入到一个字符串列表中,那这个列表的第0个位置存放的就是路径,第1个位置存放的就是id了。
    得到了id之后,再通过selection和selectionArgs参数进行约束,就实现了查询单条数据的功能。

getPathSegments().get(1)的解释参考:

9125154-a51816313b02add0.png

  • 然后是insert()方法:
    同样先获取到SQLiteDatabase实例,
    然后根据传入的Uri参数判断出用户想要往哪张表里添加数据,
    再调用SQLiteDatabase的insert()方法进行添加即可。
    注意insert()方法要求返回一个能够表示这条新增数据的URI,则这里还需调用Uri.parse()方法来将一个内容URI解析成Uri对象,当然这个内容URI是以新增数据的id结尾的。

  • 接着是update()方法:
    先获取SQLiteDatabase实例,
    然后根据传入的Uri参数判断出用户想要更新哪张表里的数据,
    再调用SQLiteDatabase的update()方法进行更新即可,受影响的行数作为返回值返回。

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

  • 最后是getType()方法,这里按照上一节中介绍的格式规则编写即可。

至此内容提供器中的代码便全部编写完了。

另外!!内容提供器一定要在AndroidMamfest.xml文件中注册才可以使用,
不过使用Androidstudio的快捷方式创建内容提供器的话,注册会被自动完成。
打开AndroidManifest.xmI文件看一下:

9125154-912f53cceaf73cc9.png

可以看到<application>标签内出现了一个新的标签<provider>,我们使用它来注册内容提供器DatabaseProvider。
其中android:name指定DatabaseProvider的类名,
android:authorities指定了DatabaseProvider的authority,
enabled和exported属性则是根据我们刚才勾选的状态自动生成的。

现在DatabaseTest这个项目便具备跨程序共享数据的功能了。
可以调试一下:
首先将DatabaseTest程序从模拟器中删除掉,防止遗留数据的造成干扰。
然后运行一下项目,将DatabaseTest程序重新安装在模拟器上。
接着关闭掉DatabaseTest这个项目,并创建一个新项目ProviderTest,
接着通过这个程序去访问DatabaseTest中的数据,

先编写布局文件:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >

    <Button
        android:id="@+id/add_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Add To Book" />

    <Button
        android:id="@+id/query_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Query From Book" />

    <Button
        android:id="@+id/update_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Update Book" />

    <Button
        android:id="@+id/delete_data"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Delete From Book" />

</LinearLayout>

MainActivity.java:

package com.example.providertest;

import android.content.ContentValues;
import android.database.Cursor;
import android.net.Uri;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.View;
import android.widget.Button;

public class MainActivity extends AppCompatActivity {

    private String newId;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        Button addData = (Button) findViewById(R.id.add_data);
        addData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 添加数据
                Uri uri = Uri.parse("content://com.example.databasetest.provider/book");
                ContentValues values = new ContentValues();
                values.put("name", "A Clash of Kings");
                values.put("author", "George Martin");
                values.put("pages", 1040);
                values.put("price", 55.55);
                Uri newUri = getContentResolver().insert(uri, values);
                newId = newUri.getPathSegments().get(1);
            }
        });
        Button queryData = (Button) findViewById(R.id.query_data);
        queryData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 查询数据
                Uri uri = Uri.parse("content://com.example.databasetest.provider/book");
                Cursor cursor = getContentResolver().query(uri, null, null, null, null);
                if (cursor != null) {
                    while (cursor.moveToNext()) {
                        String name = cursor.getString(cursor. getColumnIndex("name"));
                        String author = cursor.getString(cursor. getColumnIndex("author"));
                        int pages = cursor.getInt(cursor.getColumnIndex ("pages"));
                        double price = cursor.getDouble(cursor. getColumnIndex("price"));
                        Log.d("MainActivity", "book name is " + name);
                        Log.d("MainActivity", "book author is " + author);
                        Log.d("MainActivity", "book pages is " + pages);
                        Log.d("MainActivity", "book price is " + price);
                    }
                    cursor.close();
                }
            }
        });
        Button updateData = (Button) findViewById(R.id.update_data);
        updateData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 更新数据
                Uri uri = Uri.parse("content://com.example.databasetest.provider/book/" + newId);
                ContentValues values = new ContentValues();
                values.put("name", "A Storm of Swords");
                values.put("pages", 1216);
                values.put("price", 24.05);
                getContentResolver().update(uri, values, null, null);
            }
        });
        Button deleteData = (Button) findViewById(R.id.delete_data);
        deleteData.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 删除数据
                Uri uri = Uri.parse("content://com.example.databasetest.provider/book/" + newId);
                getContentResolver().delete(uri, null, null);
            }
        });
    }
}

其中值得注意的是:

9125154-b804e3169fd8b3db.png

从以上代码中,我们可以看到DIR类型常量匹配的,selection, selectionArgs参数位是由调用本内容提供器的时候由调用方程序提供的,
ITEM则不同,uri中已经包含了ID,我们可以使用getPathSegments将之get出来再使用,即ITEM类型常量匹配的,调用方程序无需提供selection, selectionArgs参数位(如下方的代码截图),uri中已经包含了信息,处理方法也在内容提供器中写好了。
(这一点在调用getContentResolver().update()以及getContentResolver().delete()的时候都一样)

9125154-3598b1ed14d82ea9.png

下面进行代码的简析:
分别在这4个按钮的点击事件里面处理了增删改查的逻辑:

  • 添加数据的时候:
    首先调用Uri.parse()将内容URI解析成Uri对象,
    把要添加的数据存放到ContentValues对象中,
    调用ContentResolver的insert()方法执行添加操作即可。
    注意insert()会返回一个Uri对象,这个对象中包含了新增数据的id,这里用getPathSegments()将这个id取出,稍后会用到它;

  • 查询数据的时候:
    调用Uri.parse()将内容URI解析成Uri对象,
    调用ContentResolver的query()方法去查询数据,
    查询的结果存放在Cursor对象中,
    对Cursor进行遍历,从中取出查询结果,并一一打印出来;

  • 更新数据的时候:
    调用Uri.parse()将内容URI解析成Uri对象,
    把想要更新的数据存放到ContentValues对象中,
    调用ContentResolver的update()方法执行更新操作即可;
    注意这里为了不让Book表中的其他行受到影响,
    在调用Uri.parse()方法时,给内容URI的尾部增加了一个id,而这个id正是添加数据时所返回的。
    也就是说这里只更新刚刚添加的那条数据,不受影响Book表中的其他行。

  • 删除数据的时候,
    解析一个以id结尾的内容URI,
    调用ContentResolver的delete()方法执行删除操作就可以了,
    由于我们在内容URI里指定了一个id,因此只会删掉拥有相应id的那行数据,不会影响Book表中的其他数据。

现在运行一下ProviderTest项目,效果图如下:

9125154-809c95d655e7de4b.png

点击一下AddToBook按钮,此时数据便已经添加到DatabaseTest程序的数据库中了,
可以点击QueryFromBook按钮来检查一下,打印日志如图:

9125154-7bf5e4a4623ddda2.png

这里可以看到DatabaseTest程序中只有我们刚刚添加的一条数据,
databaseTest的SQLite数据库是我们在点击Add To Book的时候,试图访问DatabaseTest的内容提供器,由此DatabaseTest的内容提供器(DatabaseProvider)会触发DatabaseProvider.java中的onCreate()方法,如下,
由此创建了数据库,并返回True,这一点在 跨程序共享数据——Content Provider 之 创建自己的内容提供器中曾经有提及;
创建了数据库之后,便添加了添加了一条数据,由此DatabaseTest程序中只有我们刚刚添加的那一条数据而已。

9125154-571755a8ca8736a6.png

点击一下Update Book按钮来更新数据,再点击一下Query From Book按钮进行检查,结果如图:

9125154-d8c3f2bb884e54c9.png

最后点击Delete From Book按钮删除数据,此时再点击Query From Book按钮就查询不到数据了。

至此跨程序共享数据功能便成功实现了。

现在不仅是ProviderTest程序,任何一个程序都可以轻松访问DatabaseTest中的数据,同时丝毫不用担心隐私数据泄漏的问题。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

凌川江雪

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值