Android_四大组件之ContentProvider

一、概述

ContentProvider(内容提供者)管理对结构化数据集的访问，它们封装数据，并提供用于定义数据安全性的机制。其他应用，通过Context的ContentResolver对象 作为客户端 与ContentProvider进行通信，访问操作数据。

Android本身的ContentProvider，我们比较常见的有，视频、音频、图像、个人信息等数据。

下面通过简单例子进行说明（数据存储形式为SQLite数据库）.

二、基础知识

1.Uri

通用资源标识符（Universal Resource Identifer），标明了一个数据操作的地址。

content://<authority>/<path>:指向表的路径

content://<authority>/<path>/<id>：指向单行的路径

包括整个提供程序的符号名称（其授权authority）和一个指向表或文件的名称（路径path），可选 ID 部分指向表中的单个行。

授权：ContentProvider都有单一的授权，避免与其他的ContentProvider冲突，所以要唯一。建议如果Android 软件包名称为 com.example.<appname>，则应为提供程序提供 com.example.<appname>.provider 授权。

路径：指向数据库的表或文件，如果你有数据库table1,则Uri:  授权/table1

Uri ID:ContentPorvider会将该 ID 值与表的 _ID 列进行匹配，并对匹配的行执行请求的访问。

UriMatcher：它会通过addURI将授权和路径 映射到整型上，可以在后续通过switch对特定一个和多个Uri进行操作。match()方法会将Uri返回整型。

注：这里讲到的Uri只是关于ContentProvider使用到的相关部分，Uri远不止这一点。简单扩展一点：

关于文件存储部分，会涉及到Uri的scheme是file的，如：

file:///storage/emulated/0/beam/image_to_share.jpg

Uri(android.net.Uri)，URI(java.net.URI)：Uri可以看作andorid对java的URI的扩展，对于URI的组成结构可以查看API。

Uri的语法及组成，下面几个是一步步的划分:

[scheme:]scheme-specific-part[#fragment]  //基本组成
[scheme:][//authority][path][?query][#fragment]  //进一步划分

依据：Uri构建和解析要符合RFC 2396。

2.SQLiteDatabase

 SQLiteDatabase是Android提供的管理SQLite database的对象，提供了数据库的基本的操作(增删改查)方法以及执行SQL语句。数据库名 在某应用里需要唯一，不需要在整个系统中唯一。

创建的数据库在/data/data/<package_name>/databases/xxx.db。 我们可以通过adb shell进入手机，通过sqlite3调试查看调试数据库里的数据。

sqlite3的基本操作：进入到对应应用的数据库文件夹后

(1)sqlite3  xxx.db:  键入这个命令后 你就能执行SQLite的各种命令了

(2). tables: 显示数据库中的表名，注意前面的.（点）啊

(3）知道表名后就能 通过SQL命令 操作对应的表了，如select * from TABLE1；(不要忘了分号)

(4) . quit  和 . exit：退出sqlite,  注意前面的.（点）啊

三、基本用法

下面通过具体例子 简单说明下 ContentProvider的简单应用。

1.通过provider在清单文件AndroidManifest.xml中 配置：

        <provider
            android:authorities="com.flx.testapp.provider"
            android:name=".MyContentProvider"
            android:exported="true"/>

这里的授权名称 在后续都是很重要的。

2.通过继承SQLiteOpenHelper 创建数据库。MyDatabaseHelper.java

package com.flx.testcontentprovider;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;

public class MyDatabaseHelper extends SQLiteOpenHelper {
    //_id, name, age

    final private static String DBNAME = "test.db";
    final public static String TABLE1 = "table1";
    final private static String SQL_CREATE_TAB = "CREATE TABLE TABLE1 " +
            "(_ID INTEGER PRIMARY KEY, NAME VARCHAR(20), AGE INT(10))";

    public MyDatabaseHelper(Context context) {
        super(context, DBNAME, null, 1);
    }

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

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

从代码中可以看到，创建的数据库名叫test.db, 里面只有一个表table1. 表里面3个字段（id,name,age）。很简单的数据库。

3.清单里配置的ContentProvider的名字是MyContentProvider。代码如下：

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;
import android.util.Log;

public class MyContentProvider extends ContentProvider {
    private MyDatabaseHelper mMyDatabaseHelper;
    final private static UriMatcher mUriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
    final private static int TABLE1_CODE = 1;

    static {
        mUriMatcher.addURI("com.flx.testapp.provider", "table1", TABLE1_CODE);
    }

    @Override
    public boolean onCreate() {
        mMyDatabaseHelper = new MyDatabaseHelper(getContext());
        return true;
    }

    @Override
    public Cursor query(Uri uri,String[] projection,  String selection,  String[] selectionArgs,  String sortOrder) {
        SQLiteDatabase sqLiteDatabase = mMyDatabaseHelper.getWritableDatabase();
        Cursor cursor = null;
        if (mUriMatcher.match(uri) == TABLE1_CODE) {
            cursor = sqLiteDatabase.query(MyDatabaseHelper.TABLE1, projection, selection,selectionArgs,null,null,sortOrder);
            Log.d("flx_provider", "MyContentProvider->query()");
        } else {
            Log.d("flx_provider", "MyContentProvider->query() the patch is not match");
        }
        return cursor;
    }

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

    
    @Override
    public Uri insert( Uri uri,  ContentValues values) {
        SQLiteDatabase sqLiteDatabase = mMyDatabaseHelper.getWritableDatabase();
        if(mUriMatcher.match(uri) == TABLE1_CODE) {
            long rowNum = sqLiteDatabase.insert(MyDatabaseHelper.TABLE1, null, values);
            Log.d("flx_provider", "MyContentProvider->insert() rowNum="+rowNum);
        } else {
            Log.d("flx_provider", "MyContentProvider->insert() the patch is not match");
        }
        return null;
    }

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

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

onCreate()中，通过创建MyDatabaseHelper对象 连接数据库，执行了创建数据的命令，数据库被创建了。

自定义的ContentPorvider要重写增(insert)删(delete)改(update)查(query)等方法，上述代码只实现了insert()和query(),依次两个为说明。

上述代码创建了UriMatcher, 定义了Uri规则(前面有简单介绍)：addURI中是授权（清单文件中配置时设置的一致），路径（这里是表名），映射的整型。这里映射的整型 在重写的操作数据库方法中 操作哪个数据 是一个重要判断。

final private static UriMatcher mUriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
    final private static int TABLE1_CODE = 1;

    static {
        mUriMatcher.addURI("com.flx.testapp.provider", "table1", TABLE1_CODE);
    }

　　

4.上述部分，基本ContentProvider的内容都已经完成了。下面是具体的activity中如何去调用的（这里在同一个应用中调用的）

布局文件activity_main.xml，只有两个按钮，增 查

<?xml version="1.0" encoding="utf-8"?>
<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_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="AddData"/>

    <Button android:id="@+id/query_btn"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="QueryData" />

</LinearLayout>

MainActivity.java，具体操作待用代码

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 {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        Button addButton = findViewById(R.id.add_btn);
        addButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Log.d("flx_provider", "ManiActivity->oncreate() addButton click");
                Uri uri = Uri.parse("content://com.flx.testapp.provider/table1");
                String names[] = {"AA", "BB", "CC"};
                int ages[] = {18, 19, 20};
                for (int i = 0;i < names.length;i++) {
                    ContentValues values = new ContentValues();
                    values.put("name", names[i]);
                    values.put("age", ages[i]);
                    getContentResolver().insert(uri, values);
                }
            }
        });

        Button queryBtn = findViewById(R.id.query_btn);
        queryBtn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                Log.d("flx_provider", "ManiActivity->oncreate() queryBtn click");
                Uri uri = Uri.parse("content://com.flx.testapp.provider/table1");
                Cursor cursor = getContentResolver().query(uri, null, "name=?",
                        new String[]{"AA"},null);
                if (cursor != null && cursor.getCount() > 0) {
                    cursor.moveToFirst();
                    do {
                        Log.d("flx_provider", "ManiActivity->oncreate() query results:" + cursor.getString(0)
                                + "   " + cursor.getString(1) + "   " + cursor.getString(2));
                    } while (cursor.moveToNext());
                    cursor.close();
                }
            }
        });
    }
}

两个按钮的功能很简单，增加按钮：插入3组数据了。 查询按钮：查询name为AA的数据并返回打印log了。

下面来看看真个内部数据库情况和log流程。

（1）当应用编译安装后，通过adb shell进入手机中看到，对应应用下数据库文件还不存在。

（2）首先我们点击查询(QueryData)按钮，这是数据库还不存在。点击后，log如下

2019-08-03 08:44:44.336 28711-28711/com.flx.testcontentprovider D/flx_provider: ManiActivity->oncreate() queryBtn click
2019-08-03 08:44:44.428 28711-28711/com.flx.testcontentprovider D/flx_provider: MyContentProvider->query()

　　

从log看，执行到了MyContentProvider->query(),数据库创建被执行。我们进入数据库，看下数据库中是什么情况。

从下面看到此时的数据库里没有数据。

（3）点击增加（AddData）按钮。

2019-08-03 08:50:50.295 28711-28711/com.flx.testcontentprovider D/flx_provider: ManiActivity->oncreate() addButton click
2019-08-03 08:50:50.305 28711-28711/com.flx.testcontentprovider D/flx_provider: MyContentProvider->insert() rowNum=1
2019-08-03 08:50:50.312 28711-28711/com.flx.testcontentprovider D/flx_provider: MyContentProvider->insert() rowNum=2
2019-08-03 08:50:50.317 28711-28711/com.flx.testcontentprovider D/flx_provider: MyContentProvider->insert() rowNum=3

　　通过log看，增加了3条数据，通过sqlite3查看如下,3条数据是插入成功的。

（4）点击查询（QueryData）按钮，查询OK的。

2019-08-03 09:01:57.995 28711-28711/com.flx.testcontentprovider D/flx_provider: ManiActivity->oncreate() queryBtn click
2019-08-03 09:01:58.001 28711-28711/com.flx.testcontentprovider D/flx_provider: MyContentProvider->query()
2019-08-03 09:01:58.005 28711-28711/com.flx.testcontentprovider D/flx_provider: ManiActivity->oncreate() query results:1   AA   18

　　

（5）在点击依次增加按钮

2019-08-03 09:02:55.125 28711-28711/com.flx.testcontentprovider D/flx_provider: ManiActivity->oncreate() addButton click
2019-08-03 09:02:55.132 28711-28711/com.flx.testcontentprovider D/flx_provider: MyContentProvider->insert() rowNum=4
2019-08-03 09:02:55.138 28711-28711/com.flx.testcontentprovider D/flx_provider: MyContentProvider->insert() rowNum=5
2019-08-03 09:02:55.147 28711-28711/com.flx.testcontentprovider D/flx_provider: MyContentProvider->insert() rowNum=6

　　

（6）点击查询，查询的数据是OK的。

2019-08-03 09:03:37.950 28711-28711/com.flx.testcontentprovider D/flx_provider: ManiActivity->oncreate() queryBtn click
2019-08-03 09:03:37.960 28711-28711/com.flx.testcontentprovider D/flx_provider: MyContentProvider->query()
2019-08-03 09:03:37.965 28711-28711/com.flx.testcontentprovider D/flx_provider: ManiActivity->oncreate() query results:1   AA   18
2019-08-03 09:03:37.965 28711-28711/com.flx.testcontentprovider D/flx_provider: ManiActivity->oncreate() query results:4   AA   18