<Android基础> (七）内容提供器

第七章 内容提供器

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 实现跨程序数据共享