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
