内容提供器

内容提供器（Content Provider）主要用于在不同程序之间实现数据共享的功能,它提供一套完整的机制，允许一个程序访问另一个程序中的数据，并保证被访问数据的安全性。内容提供器可以选择对哪一部分数据进行共享，从而保证程序中的隐私不会泄露。

内容提供器的增删查改操作（CRUD）

ContentResolver的增删查改方法都是不接收表名参数的，而是使用一个Uri参数代替，这个参数被称为内容URI。内容URI给内容提供器中的数据建立了唯一标识符，由authority与path组成，authority是用于对不同的应用程序做区分的，一般采用程序包名的方式来命名，比如某个程序的包名为com.example.app,那么该程序对应的authority就是com.example.app.provider,path是用于对同一应用程序中不同表做区分，通常会添加到authority后面,加入某个程序中存有两张表table1,table2,则该程序path为/table1,/table2,内容URI加上协议声明之后的标准格式如下：

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

内容URI字符串需要解析为Uri对象才能作为参数传入

Uri uri = Uri.parse("content://com.example.app.provider/table1");

• 查询语句

//uri:指定查询某个应用程序下的某一张表
//projection：指定查询的列名
//selection:指定where的约束条件
//selectionArgs:为where中的占位符提供具体的值
//sortOrder: 指定查询结果的排序方式
Cursor cursor = getContentResolver().query(uri,projection,selection,selecetionArgs,sortOrder)

查询语句返回Cursor对象，取值操作与SQLite中相同

if(cursor!=null){
while(cursor.moveToNext){
String xxx = cursor.getString(cursor.getColumnIndex("XXX"));
int xxx = cursor.getInt(cursor.getColumnIndex("XXX"));
}
cursor.close();
}

• 插入语句

ContentValues values = new ContentValues();
values.put("column1","text");
values.put("column2","1");
getContentResolver().insert(uri,values);

• 删除语句

getContentResolver().delete(uri,selection,selectionArgs);
例：getContentResolver().delete(uri,"column1 = ?","new String[]{ "1" }");

• 更新语句

getContentResolver().update(uri,values,selection,selectionArgs);

例：

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

访问其他程序中的数据

访问系统联系人

• 在AVD中创建联系人
• 使用ListView来展示联系人信息
• 活动中判断是否获取访问系统联系人的权限 若已获取，则访问联系人
• 否则，动态申请权限，处理结果

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
contact_list = findViewById(R.id.contact_list);
adapter = new ArrayAdapter<String >(this,android.R.layout.simple_list_item_1,contactList);
contact_list.setAdapter(adapter);
//是否已获取访问系统联系人的权限
if(ContextCompat.checkSelfPermission(MainActivity.this,Manifest.permission.READ_CONTACTS)
!= PackageManager.PERMISSION_GRANTED){
ActivityCompat.requestPermissions(MainActivity.this,new String[]{Manifest.permission.READ_CONTACTS},1);
}else{
//若已获取权限，访问联系人
readContacts();
}
}

<uses-permission android:name="android.permission.READ_CONTACTS"/>

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
switch(requestCode){
case 1:
if(grantResults.length>0 && grantResults[0] == PackageManager.PERMISSION_GRANTED){
readContacts();
}else{
Toast.makeText(this,"you denied the permission",Toast.LENGTH_SHORT).show();
}
break;
default:
}
}

访问系统联系人封装为方法

private void readContacts(){
Cursor cursor = null;
try{
cursor = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,null,null,null,null);
if(cursor!=null){
while(cursor.moveToNext()){
String displayName = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
String number = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
contactList.add(displayName + "\n" + number);
}
//调用此方法来刷新ListView列表
adapter.notifyDataSetChanged();
}
}catch(Exception e){
e.printStackTrace();
}finally {
if(cursor!=null){
cursor.close();
}
}
}

上述查询方法中第一个参数的由来：ContactsContract.CommonDataKinds.Phone类帮我们做好封装，提供一个CONTENT_URI常量，实际为通过Uri.parse()方法解析出来的

ContactsContract.CommonDataKinds.Phone.CONTENT_URI

系统联系人姓名常量

ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME

系统联系人电话常量

ContactsContract.CommonDataKinds.Phone.NUMBER

创建自己的内容提供器

• 创建一个类去继承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 getTyoe(Uri uri){
return null;
}

• onCreate()：初始化的时候调用，通常在这里完成对数据库的创建和升级
• query():查询内容提供器中已有的数据，返回Cursor对象
• update()：更新内容提供器中已有的数据，受影响的行数作为返回值
• delete():从内容提供器中删除数据，被删除的行数作为返回值
• getType():根据传入的URI来返回相应的MIME类型
  内容URI的MIME类型 必须以vnd开头
• 如果内容URI以路径结尾，则后接android.cursor.dir/,如果以id结尾，则后接上android.cursor.item/
• 最后接上vnd.< authority > . < path >
  例如：conten://com.example.app.provider/table1的MIME类型为：

vnd.android.cursor.dir/vnd.com.example.app.provider.table1

content://com.example.app.provider/table1/1的MIME类型为：

vnd.android.cursor.item/vnd.com.example.app.provider.table1

分析Uri参数指向的表和数据

几乎每一个方法都带有Uri这个参数，现在我们对Uri参数进行解析，分析出调用方期望访问的表和数据。
标准Uri参数的写法是：

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

这里表示调用方期望访问的是com.example.app这个应用的table1表中的数据。我们还可以在这个内容Uri后加上一个id,如：

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

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

内容Uri格式有以上两种，以路径结尾表示期望访问该表中所有的数据，以id结尾表示期望访问该表中相应id的数据。因此我们可以使用通配符的方式来分别匹配这两种格式的内容URI。
*：表示匹配任意长度的字符串
#：表示匹配任意长度的数据
一个能够匹配任意表的内容URI格式：

content://com.example.app/*

一个能偶匹配任意一行数据的内容URI格式：

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

我们再借助UriMatcher这个类就可以轻松实现匹配内容URI的功能，addURI():添加内容Ur和自定义代码i；match()：匹配内容URI并返回自定义代码

UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);
matcher.addURI(authority,path,自定义代码);
matcher.match(uri);//uri匹配成功后会返回addURI()中的自定义代码

自定义内容提供器：MyProvider

public class MyProvider 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.app.provider";
private static UriMatcher uriMatcher;

static {
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI(authority, "/Book", BOOK_DIR);
uriMatcher.addURI(authority, "/Book/#", BOOK_ITEM);
}

@Override
public boolean onCreate() {
// TODO: Implement this to initialize your content provider on startup.
return true;
}

@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
int deleteRows = 0;
switch (uriMatcher.match(uri)) {
case BOOK_DIR:
//返回被删除的行数
break;
case BOOK_ITEM:
String bookId = uri.getPathSegments().get(1);
break;
}
return deleteRows;
}

@Override
public Uri insert(Uri uri, ContentValues values) {
// TODO: Implement this to handle requests to insert a new row.
Uri uriReturn = null;
switch (uriMatcher.match(uri)){
case BOOK_DIR:
case BOOK_ITEM:
//返回新插入行id，或者-1
break;
}
return uriReturn;
}

@Override
public Cursor query(Uri uri, String[] projection, String selection,
String[] selectionArgs, String sortOrder) {
// TODO: Implement this to handle query requests from clients.
Cursor cursor = null;
switch (uriMatcher.match(uri)){
case BOOK_DIR:
break;
case BOOK_ITEM:
String bookId = uri.getPathSegments().get(1);
break;
}
return cursor;
}

@Override
public int update(Uri uri, ContentValues values, String selection,
String[] selectionArgs) {
// TODO: Implement this to handle requests to update one or more rows.
int updateRows = 0;
switch (uriMatcher.match(uri)){
case BOOK_DIR:
//返回受影响的行数
break;
case BOOK_ITEM:
String bookId = uri.getPathSegments().get(1);
break;
}
return updateRows;
}

@Override
public String getType(Uri uri) {
// TODO: Implement this to handle requests for the MIME type of the data
// at the given URI.
switch (uriMatcher.match(uri)) {
case BOOK_DIR:
return "vnd.android.cursor.dir/vnd.com.example.sqlitetest.provider.book";
case BOOK_ITEM:
return "vnd.android.cursor.item/vnd.com.example.sqlitetest.provider.book";
}
return null;
}
}