Android组件Content Provider基本使用

涉及项目代码地址： 

DatabaseTest.zip-Android代码类资源-CSDN下载

ProviderTest.zip-Android代码类资源-CSDN下载

ContentResolver的基本用法 

       对于每一个应用程序来说，如果想要访问内容提供器中共享的数据，就一定要借助Content- Resolver 类，可以通过 Context 中的 getContentResolver() 方法获取到该类的实例。 Content- Resolver中提供了一系列的方法用于对数据进行CRUD操作，其中insert(）方法用于添加数据， update()方法用于更新数据，delete()方法用于删除数据，query()方法用于查询数据。有没 有似曾相识的感觉？没错，SQLiteDatabase中也是使用这几个方法来进行CRUD操作的，只不过 它们在方法参数上稍微有一些区别。
        不同于SQLiteDatabase，ContentResolver中的增删改查方法都是不接收表名参数的，而是使 用一个Uri参数代替，这个参数被称为内容URI。内容URI给内容提供器中的数据建立了唯一 标识符，它主要由两部分组成：authority和path。authority是用于对不同的应用程序做区分的， 一般为了避免冲突，都会采用程序包名的方式来进行命名。比如某个程序的包名是com.example. app，那么该程序对应的authority就可以命名为com.example.app. provider。path则是用于对同一 应用程序中不同的表做区分的，通常都会添加到authority的后面。比如某个程序的数据库里存在 两张表：tablel和table2,这时就可以将path分别命名为/tablel和/table2,然后把authority和path 进行组合，内容 URI 就变成了 com.example.app.provider/tablel 和 com.example.app.provider/table2。 
不过，目前还很难辨认出这两个字符串就是两个内容URI，我们还需要在字符串的头部加上协议 
声明。因此，内容URI最标准的格式写法如下：
        content://com.example.app.provider/tablel1
        content://com.example.app.provider/table2
        有没有发现，内容URI可以非常清楚地表达出我们想要访问哪个程序中哪张表里的数据。 也正是因此，ContentResolver中的增删改查方法才都接收Uri对象作为参数，因为如果使用表名 的话，系统将无法得知我们期望访问的是哪个应用程序里的表。

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

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

查询完成后返间的仍然是一个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（);

}
掌握了最难的查询操作，剩下的增加、修改、删除操作就更不在话下了。我们先来看看如何向table1表中添加一条数据，代码如下所示：
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" });
到这为止，我们就把ContentResolver中的增删改查方法全部学完了。

创建自己的内容提供器（实现跨程序数据共享）

         新建DatabaseTest项目

    创建MyDatabaseHelper 继承SQLiteOpenHelper

public class MyDatabaseHelper extends SQLiteOpenHelper {

    public static final String CREATE_BOOK = "create table Book("
            + "id integer primary key autoincrement,"
            + "author text,"
            + "price real,"
            + "pages integer,"
            + "name text)";

    private Context mContext;

    public MyDatabaseHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) {
        super(context, name, factory, version);
        mContext = context;
    }

    @Override
    public void onCreate(SQLiteDatabase db) {
        db.execSQL(CREATE_BOOK);
    }

    @Override
    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

    }
}

        创建DatabaseProvider 继承ContentProvider

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.zjsos.www.databasetest.provider";

    private static UriMatcher uriMatcher;

    private MyDatabaseHelper dbHepler;

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

    @Nullable
    @Override
    public Cursor query(@NonNull Uri uri, @Nullable String[] projection, @Nullable String selection, @Nullable String[] selectionArgs, @Nullable String sortOrder) {
        SQLiteDatabase db = dbHepler.getWritableDatabase();
        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;
    }

    @Nullable
    @Override
    public Uri insert(@NonNull Uri uri, @Nullable ContentValues values) {
        SQLiteDatabase db = dbHepler.getWritableDatabase();
        Uri uriReturn = null;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
            case BOOK_ITEM:
                long newBookId = db.insert("Book", null, values);
                uriReturn = Uri.parse("content://" + AUTHORITY + "/book/" + newBookId);
                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(@NonNull Uri uri, @Nullable ContentValues values, @Nullable String selection, @Nullable String[] selectionArgs) {
        //更 新 教 据
        SQLiteDatabase db = dbHepler.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(@NonNull Uri uri, @Nullable String selection, @Nullable String[]
            selectionArgs) {
        //刪除数据
        SQLiteDatabase db = dbHepler.getWritableDatabase();
        int deletedRow = 0;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
                deletedRow = db.delete("Book", selection, selectionArgs);
                break;
            case BOOK_ITEM:
                String bookId = uri.getPathSegments().get(1);
                deletedRow = db.delete("Book", "id =?", new String[]{bookId});
                break;
            case CATEGORY_DIR:
                deletedRow = db.delete("Category", selection, selectionArgs);
                break;
            case CATEGORY_ITEM:
                String categoryId = uri.getPathSegments().get(1);
                deletedRow = db.delete("Category", "id =?", new String[]{categoryId});
                break;
            default:
                break;
        }
        return deletedRow;
    }


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

getType ( )说明

根据传入的内容 URI 来返回相应的 MIME 类型。

可以看到，儿乎每一个方法都会带有 uri 这个参数，这个参数也正是调用 ContentResolver 的增删改查方法时传递过来的。而现在，我们需要对传人的 Uri 参数进行解析，从中分析出调用方期望访问的表和数据。

回顾一下，一个标准的内容 URI 写法是这样的：

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

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

content://com.example.app.provider/table/1

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

内容 URI 的格式主要就只有以上两种，以路径结尾就表示期望访问该表中所有的数据，以 id 结尾就表示期望访问该表中拥有相应 id 的数据。我们可以使用通配符的方式来分别匹配这两种格式的内容URI,规则如下。
   *     表示匹配任意长度的任意字符。
  #    表示匹配任意长度的数字。
所以，一个能够匹配任意表的内容URI格式就可以写成： 
content://com.example.app.provider/*
而一个能够匹配tablel表中任意一行数据的内容URI格式就可以写成： 
content://com.example.app.provider/tablel/#
接着，我们借助UriMatcher这个类就可以轻松地实现匹配内容URI的功能。UriMatcher中提供了一个addUR()方法，这个方法接收3个参数，可以分别把authority、path和一个自定义代码传进去。这样，当调用UriMatcher的match()方法时，就可以将一个Uri对象传入，返回值是某个能够匹配这个Uri对象所对应的自定义代码，利用这个代码，我们就可以判断出调用方期望访问的是哪张表中的数据了。

配置Provider

<provider
    android:name=".DatabaseProvider"
    android:authorities="com.zjsos.www.databasetest.provider"
    android:enabled="true"
    android:exported="true" />

添加数据读写权限
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>

新建ProviderTest项目

通过新建项目去访问DatabaseTest项目中数据

编写activity_main.xml布局

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">


    <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="Qurey From Book" />

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

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

</LinearLayout>

编写主页面MainActivity代码 

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.zjsos.www.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", 22.85);
                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.zjsos.www.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.e("MainActivity", "book name is" + name);
                        Log.e("MainActivity", "book author is" + author);
                        Log.e("MainActivity", "book pages is" + pages);
                        Log.e("MainActivity", "book price is" + price);

                        if (Integer.parseInt(Build.VERSION.SDK) < 14) {
                            //只有4.0以下才需要手动关闭
                            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.zjsos.www.databasetest.provider/book/" + newId);
                ContentValues values = new ContentValues();
                values.put("name", " A Storm of Swords");
                values.put("pages", 1216);
                values.put("price", 24.85);
                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.zjsos.www.databasetest.provider/book/" + newId);
                getContentResolver().delete(uri, null, null);
            }
        });

    }
}

运行安装DatabaseTest项目，打开项目，然后运行安装ProviderTest项目

点击ProviderTest项目中ADD TO BOOK按钮，此时数据应该已经添加到DatabaseTest项目，点击QUREY FROM BOOK按钮查看打印日志就可以查看到数据了

点击upadte data修改按钮，在点击query from book查询，查看数据库已经改变

 点击delete data按钮，在点击query from book按钮，就查询不到数据了，测试完成

参考：第一行代码Android 第2版  郭霖 著  建议大家去买下正版书  支持下郭老师

项目代码地址： 

DatabaseTest.zip-Android代码类资源-CSDN下载

ProviderTest.zip-Android代码类资源-CSDN下载