第七章 内容提供器
7.1 内容提供器（Content Provider）
主要应用于在不同的应用程序之间实现数据共享功能。允许一个程序访问另一个程序中的数据，同时还能保证被访数据的安全性。
7.2 运行时权限
7.2.1 Android权限机制
普通权限：不会直接威胁到用户的安全和隐私的权限，系统会自动进行授权
危险权限：可能会触及用户隐私或者对设备安全性造成影响的权限，对于这部分权限，必须要手动点击授权才可以，否则程序就无法使用相应的功能。
7.2.2 在程序运行时申请权限
新建RuntimePermissionTest项目，使用CALL_PHONE权限，编写拨打电话功能的时候需要声明。
1.Android 6.0之前
a.activity_main.xml中加入Button
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"> <Button
android:id="@+id/make_call"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:text="make call"/>
</LinearLayout>
b.MainActivity.java中注册事件
Button makeCall = (Button)findViewById(R.id.make_call);
makeCall.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
try{
Intent intent = new Intent(Intent.ACTION_CALL);
intent.setData(Uri.parse("tel:10086"));
startActivity(intent);
}catch(SecurityException e){
e.printStackTrace();
});
构建了一个隐式Intent
c.增加AndroidManifest.xml中的权限
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.sog.runtimepermissiontest"> <uses-permission android:name="android.permission.CALL_PHONE"/> <application
低于6.0的系统都是可以正常运行的，当在6.0或更高版本系统的手机上运行，打印日志会发现需要进行权限处理。
2. 6.0系统以上的处理
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button makeCall = (Button)findViewById(R.id.make_call);
makeCall.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if(ContextCompat.checkSelfPermission(MainActivity.this,
Manifest.permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED){
ActivityCompat.requestPermissions(MainActivity.this, new
String[]{ Manifest.permission.CALL_PHONE }, 1);
}else{
call();
}
}
});
}
public void call(){
try{
Intent intent = new Intent(Intent.ACTION_CALL);
intent.setData(Uri.parse("tel:10086"));
startActivity(intent);
}catch(SecurityException e){
e.printStackTrace();
}
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
switch (requestCode){
case 1:
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED){
call();
}else{
Toast.makeText(this, "You denied the permission", Toast.LENGTH_SHORT).show();
}
break;
default:
}
}
}
onCreate()方法中，借助ContextCompat.checkSelfPermission()方法判断是否用户已经授权了，接收两个参数，第一个为Context，第二个参数为具体的权限名，然后将使用方法的返回值和PackageManager.PERMISSION_GRANTED作比较，相等就表示已经授权，否则就为没授权。
授权了就call()，没有授权就调用requestPermissions()方法，接收三个参数，第一个参数为Activity的实例，第二个参数为String数组，要把申请的权限名传入，第三个参数为请求码，传入1
Button makeCall = (Button)findViewById(R.id.make_call);
makeCall.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if(ContextCompat.checkSelfPermission(MainActivity.this,
Manifest.permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED){
ActivityCompat.requestPermissions(MainActivity.this, new
String[]{ Manifest.permission.CALL_PHONE }, 1);
}else{
call();
}
}
});
调用完了requestPermissions()方法之后，系统会弹出一个权限申请的对话框，用户选择同意或者拒绝，不论什么结果，都会回调到onReqPermissionsResult()方法中
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
switch (requestCode){
case 1:
if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED){
call();
}else{
Toast.makeText(this, "You denied the permission", Toast.LENGTH_SHORT).show();
}
break;
default:
}
}
7.3 访问其他程序中的数据
内容提供器的用法：
1.使用现有的内容提供器来读取和操作相应程序中的数据
2.创建自己的内容提供器给程序的数据提供外部访问的接口
7.3.1 ContentResolver的基本用法
访问内容提供器*享的数据，就一定要借助ContentResolve类，可以通过Context中的getContentResolver()方法获取该实例。
ContentResolver中提供了一系列的方法用于对数据进行CRUD操作，insert()用于添加数据，update()用于更新数据，delete()用于删除数据，query()用于查询数据。
CRUD操作的参数为Uri参数，内容URI给内容提供器中的数据建立了唯一的标识符，由两部分组成：authority和path。
authority一般为程序包名，path则为用于对一应用程序中不同的表做区分的，最后要在字符串头部加上协议声明，如：
content://com.example.app.provider/table1
content://com.example.app.provider/table2
用Uri.parse()方法进行解析为Uri对象
Uri uri = Uri.parse("content://com.example.app.provider/table1");
然后就可以利用该Uri对象来查询table1表中的数据了
Cursor cursor = getContentResolver().query(
uri,
projection,
selection,
selectionArgs,
sortOrder);
通过Cursor对象来进行增删改查操作
1.查
遍历Cursor所有行，通过移动游标的方式，再取出每一行中相应列的数据。
if(cursor != null){
while(cursor.moveToNext()){
String column1 = cursor.getString(cursor.getColumnIndex("column1"));
int column2 = cursor.getInt(cursor.getColumnIndex("column2"));
}
cursor.close();
}
2.增
向table1中添加数据
ContentValues values = new ContentValues();
values.put("column1","text");
values.put("column2","1");
getContentResolver().insert(uri, values);
3.清空column1值，update
ContentValues values = new ContentValues();
values.put("column1", "");
getContentResolver().update(uri, values, "column1 = ？and column2 = ?", new
String[]{"text", "1"});
4.删除
getContentResolver().delete(uri, "column2 = ?“, new String[]{ "1" });
7.3.2 读取系统联系人
新建项目ContactsTest，在activity_main中添加ListView
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/activity_main"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context="com.example.song.contactstest.MainActivity"> <ListView
android:id="@+id/contacts_view"
android:layout_width="match_parent"
android:layout_height="match_parent" />
</LinearLayout>
修改MainActivity中的代码
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.provider.ContactsContract;
import android.support.annotation.NonNull;
import android.support.v4.app.ActivityCompat;
import android.support.v4.content.ContextCompat;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.ArrayAdapter;
import android.widget.ListView;
import android.widget.Toast; import java.util.ArrayList;
import java.util.List;
import java.util.jar.Manifest; public class MainActivity extends AppCompatActivity {
ArrayAdapter<String> adapter;
List<String> contactsList = new ArrayList<>();
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
//加载ListView
ListView contactsView = (ListView)findViewById(R.id.contacts_view);
adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, contactsList);
contactsView.setAdapter(adapter);
//权限设置
if(ContextCompat.checkSelfPermission(this, android.Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED){
ActivityCompat.requestPermissions(this, new String[]{ android.Manifest.permission.READ_CONTACTS },1);
}else {
readContacts();
}
} 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));
contactsList.add( displayName + "\n" + number );
}
}
adapter.notifyDataSetChanged();
}catch (Exception e){
e.printStackTrace();
}finally {
if(cursor != null){
cursor.close();
}
}
} @Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] 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:
}
}
}
重点在于readContacts()方法
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));
contactsList.add( displayName + "\n" + number );
}
}
adapter.notifyDataSetChanged();
}catch (Exception e){
e.printStackTrace();
}finally {
if(cursor != null){
cursor.close();
}
}
}
使用ContentResolver的query()方法来查询系统的联系人数据，没有调用Uri.parse()方法来解析Uri字符串，ContactsContract.CommomDataKinds.Phone类做好了封装
String displayName =cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
String number = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER))；
将拼接好的数据添加到ListView的数据源里，并通知刷新ListView。
最后记得要关闭Cursor对象
在AndroidManifest.xml中加入权限声明
<uses-permission android:name="android.permission.READ_CONTACTS"/>
运行程序
7.4 创建自己的内容提供器
7.4.1 创建内容提供器的步骤
新建一个类来继承ContentProvider的方式来创建一个自己的内容提供器
import android.content.ContentProvider;
import android.content.ContentValues;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.os.CancellationSignal;
import android.support.annotation.Nullable; public class MyProvider extends ContentProvider{
@Override
public boolean onCreate() {
return false;
} @Nullable
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
return null;
} @Nullable
@Override
public Uri insert(Uri uri, ContentValues contentValues) {
return null;
} @Override
public int update(Uri uri, ContentValues contentValues, String s, String[] strings) {
return 0;
} @Override
public int delete(Uri uri, String s, String[] strings) {
return 0;
} @Nullable
@Override
public String getType(Uri uri) {
return null;
}
}
重写了6个方法
1.onCreate()
初始化内容提供器的时候调用，通常会完成对数据库的创建和升级等操作，返回true表示初始化成功，返回false则表示失败。
2.query()
从内容提供器中查询数据。使用Uri参数来确定查询哪张表，projection参数用于确定查询哪些列，selection和selectionArgs参数用于约束查询哪些行，sortOrder参数用于对结果进行排序，查询的结果存放在Cursor对象中返回。
3.insert()
向内容提供器中添加一条数据。使用uri参数来确定要添加的表，待添加的数据保存在values参数中。添加完成后，返回一个用于表示这条新纪录的Uri。
4.update()
更新内容提供器中以有的数据。使用uri参数来确定更新哪一张表中的数据，新数据保存在values中，selections和selectionArgs参数用于约束更新那些行，受影响的行数将作为返回值返回。
5.delete()
从内容提供器中删除数据。使用uri参数来确定删除哪一张表中的数据，selections和selectionArgs参数用于约束删除哪些行，被删除的行数将作为返回值返回。
6.getType()
根据传入的内容URI来返回相应的MIME类型。
同时，可以在URI内容后面添加通配符
数字：表示id content://com.example.app.provider/table1/1
*：表示匹配任意长度的任意字符 content://com.example.app.provider/*
#：表示匹配任意长度的数字 content://com.example.app.provide/table1/#
借助UriMatch类可以实现匹配内容Uri的功能，UriMatch类提供了一个addURI()方法，接受3个参数，可以分别传入authority、path和一个自定义代码。当调用match()方法时，可以将一个Uri对象传入，返回值是某个能够匹配这个Uri对象所对应的自定义代码，利用该代码，就可以判断出调用方期望访问的是表中哪个数据了。
eg：
更改类MyProvider中的代码
public class MyProvider extends ContentProvider{
public static final int TABLE1_DIR = 0;
public static final int TABLE1_ITEM = 1;
public static final int TABLE2_DIR = 2;
public static final int TABLE2_ITEM = 3;
public static UriMatcher uriMatcher;
static{
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI("com.example.app.provider","table1",TABLE1_DIR);
uriMatcher.addURI("com.example.app.provider","table1/#",TABLE1_ITEM);
uriMatcher.addURI("com.example.app.provider","table2",TABLE2_DIR);
uriMatcher.addURI("com.example.app.provider","table2/#",TABLE2_ITEM);
}
......
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
switch (uriMatcher.match(uri)){
case TABLE1_DIR:
break;
case TABLE1_ITEM:
break;
case TABLE2_DIR:
break;
case TABLE2_ITEM:
break;
default:
break;
}
return null;
}
.....
}
TABLE1_DIR表示访问table1表中的所有数据，TABLE1_ITEM表示访问table1表中的单条数据；TABLE2_DIR表示访问table2表中的所有数据，TABLE2_ITEM表示访问Table2中的单条数据。
除此之外，还有一种getType()方法，是所有内容提供器都必须提供的一个方法，用于获取Uri对象所对应的MIME类型。
一个内容URI对应的MIME字符串由3部分组成：
1）必须以vnd开头
2）如果内容URI以路径结尾，则后接android.cursor.dir/，如果内容URI以id结尾，则后接android.cursor.item/。
3）最后接上vnd.<authority>.<path>
所以，对于content://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
所以对MyProvider中的方法还可以继续完善为：
@Override
public String getType(Uri uri) {
switch(uriMatcher.match(uri)){
case TABLE1_DIR:
return "vnd.android.cursor.dir/vnd.com.example.app.provider.table1";
case TABLE1_ITEM:
return "vnd.android.cursor.item/vnd.com.example.app.provider.table1";
case TABLE2_DIR:
return "vnd.android.cursor.dir/vnd.com.example.app.provider.table2";
case TABLE2_ITEM:
return "vnd.android.cursor.item/vnd.com.example.app.provider.table2"
}
return null;
}
7.4.2 实现跨程序数据共享