内容提供器

内容提供器（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
contactPermission contactListView

创建自己的内容提供器

创建一个类去继承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;
    }
}

Android四大组件之内容提供器

内容提供器