跨程序共享数据——ContentProvider

目录

  • 跨程序共享数据——ContentProvider
  • 运行时权限
  • Android权限机制详解
  • 在程序运行时申请权限
  • 访问其他程序中的数据
  • ContentResolver的基本用法
  • 读取系统联系人
  • 补充URI
  • 创建自己的contentprovider
  • 创建contentprovider的步骤
  • 实现跨程序数据共享


可以让其他程序进行二次开发的数据都是可以共享的。包括通讯录、短信、媒体库等程序都实现了跨程序数据共享的功能,而使用的技术当然就是contentprovider。

contentprovider主要用于不同的应用程序之间实现数据共享的功能,它提供了一套完整的机制,允许一个程序访问另一个程序中的数据,同时还能保证被访问数据的安全性。

  • 文件存储、sharedpreferences存储中是两种全局可读写模式,
  • contentprovider可以选择只对那一部分数据进行共享,从而保证我们程序中的隐私数据不会有泄漏的风险。

运行时权限

Android权限机制详解

比如,当为了要监听开机广播,我们要在AndroidManifest.xml文件中添加了这样一句权限声明:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.ssozh.broadcastbestpractice">
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
</manifest>

因为监听开机广播涉及了用户设备的安全,因此必须在AndroidManifest.xml中加入权限声明,否则我们的程序就会崩溃。

用户主要在两个方面得到了保护:

  • 安装界面会给出该程序一共申请了哪些权限。从而决定是否要安装这个程序。
  • 用户可以随时在应用管理界面查看任意一个程序的权限申请情况。

但是这样会存在”店大欺客“的问题,比如微信申请查看短信权。因为,Android开发团队在Android中加入了运行时权限功能。当然,并不是所有权限都需要在运行时申请,对于用户来说,不停地授权也很繁琐。

Android现在将常的权限大致分为两类:

  • 普通权限:指的是哪些不会直接威胁到用户的安全和隐私的权限。对于这部分权限申请,系统会自动帮我们进行授权。比如开机广播
  • 危险权限:表示哪些可能会触及用户隐私劶对设备安全性造成影响的权限,比如获取联系人信息等。必须由用户手动授权才可以。
  • (特殊权限)

因为权限很多,所以除了那么危险权限,剩下的大多数为危险权限:

权限组名

权限名

CALENDAR(日历)

READ_CALENDAR 、WRITE_CALENDAR

CALL_LOG

READ_CALL_LOG、WRITE_CALL_LOG、PROCESS_OUTGOING_CALLS

CAMERA

CAMERA

CONTACTS

READ_CONTACTS、WRITE_CONTACTS、GET_ACCOUNTS

LOCATIONS

ACCESS_FINE_LOCATION、ACCESS_CORASE_LOCATION、ACCESS_BACKGROUND_LOCATION

MICROPHONE

RECORD_AUDIO

PHONE

SENSORS

BODY_SENSORS

ACTIVITY_RECOGNITION

ACTIVITY_RECOGNITION

SMS

STORAGE

如果是上面这张表的权限,就需要进行运行时权限处理,否则,只需要子啊AndroidManifest.xml文件中添加一下权限声明就可以了。另外注意、表格的每一个危险权限都属于同一个权限组。原则上,用户一旦同意了某个权限申请后,同组的其他权限也会被系统自动授权。

在程序运行时申请权限

首先常见一个RuntimePermissionTest项目:

java代码:

private final static String TAG = "MainActivity";    
	@Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        makeCall = (Button) findViewById(R.id.make_call);
        makeCall.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                // 这个try catch 是为了防止程序崩溃
                try {
                    Log.d(TAG,"我要开始打电话了!");
                    Intent intent = new Intent(Intent.ACTION_CALL);  // 系统内置的打电话动作。而打开拨号界面是不需要声明权限的。ACTION_DIAL
                    intent.setData(Uri.parse("tel:10086"));  // data部分指定了协议是tel,号码是10086
                    startActivity(intent);
                }catch (Exception e){
                    e.printStackTrace();
                }
            }
        });
    }
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.ssozh.runtimepermissiontest">

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

但是这个是一个危险权限,所以其实会出现err:

2020-12-04 19:56:40.595 18900-18900/com.ssozh.runtimepermissiontest D/MainActivity: 我要开始打电话了!
2020-12-04 19:56:40.616 18900-18900/com.ssozh.runtimepermissiontest W/System.err:     at com.ssozh.runtimepermissiontest.MainActivity$1.onClick(MainActivity.java:29)

因此,危险权限不仅要像普通权限一样在manifest里面声明,而且还要判断用户是否授权我们。

具体流程如下:

  1. ContextCompat.checkSelfPermission()方法判断用户是否授权。第一个参数是上下文,第二个参数是具体权限名,Manifest.permission.CALL_PHONE
  2. 如果没有,需要调用ActivityCompat.requestPermissions()方法来向用户申请授权。三个参数
  1. Activity实例
  2. String数组,我们要把申请的权限名放入数组即可
  3. 请求码
ActivityCompat.requestPermissions(MainActivity.this,new String[]{Manifest.permission.CALL_PHONE}, 1);
  1. 调用完ActivityCompat.requestPermissions()方法后,系统会弹出一个权限申请框。无论用户是同意还是拒绝都会回调到onRequestPermission()方法中,而授权则会封装在grantResults参数当中,允许是[0]
  2. 注意在对话框中选择允许后,会默认永久允许这个操作,下次就不会再找你要权限了!想要关闭就需要:应用->应用管理->appName->关闭权限
private Button makeCall;
private final static String TAG = "MainActivity";

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    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) {
                Log.d(TAG,"requestPermissions");
                ActivityCompat.requestPermissions(MainActivity.this,new String[]{Manifest.permission.CALL_PHONE}, 1);
            }else {
                Log.d(TAG,"beginCall");

                call();
            }
        }
    });
}
private void call() {
    try{
        Intent intent = new Intent(Intent.ACTION_CALL);
        intent.setData(Uri.parse( "tel:10086"));
        startActivity(intent);
    }catch (Exception e){
        e.printStackTrace();
    }
}

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    Log.d(TAG, Arrays.toString(grantResults));  // [0]始终允许是0,如何添加仅一次允许
    switch (requestCode) {
        case 1:
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                call();
            } else {
                Toast.makeText(this, "你不让我打电话5555", Toast.LENGTH_SHORT).show();
            }
            break;
        default:
    }
}

访问其他程序中的数据

contentprovider的用法一般有两种,一种是使用现有的contentprovider来读取和操作相应程序中的数据,另一种是创造自己的contentprovider给我们程序的数据提供外部访问的接口。

ContentResolver的基本用法

对于一个应用程序来说,如果想要访问contentprovider中共享的数据,就一定要借助contentresolver类,可以通过context中的getcontentresolver()方法获取该类的实例。可以通过context中的getcontentresolver()方法获取该类的实例。contentResolver中提供了RUCD操作的相关方法。

不同于SQLiteDatabase,contentResolver中的CRUD是不接受表名参数的,而是使用了一个Uri参数代替,这个参数称为内容URI。内容URI给contentProvider中的数据简历了唯一标识符,它由两部分组成:authority和path。

  • authority:是用于对不同的应用程序做区别的,为了避免冲突,会采用应用包名的方式进行命名:包名.provider
  • path则是用于对统一应用程序不同的表做区分的。如果某个数据库中存在两张表table1和table2,path就是/table1和/table2。

标准格式如下:

content://com.ssozh.app.provider/table1
content://com.ssozh.app.provider/table2

另外通配符有:

* 表示匹配任意长度的任意字符
# 表示匹配任意长度的数字

另外需要借助UriMatcher这个类实现匹配内容URI的功能。

在得到了内容URI字符串之后,可以直接使用Uri.parse()进行解析:

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

最后使用这个Uri对象查询table表中的数据了:

Cursor cursor = getContentResovler().query(
	uri,
    projection,
    seletion,
    seletionArgs,
    sortOrder);

/**
这些参数和SQLiteDatabase中query方法的参数很像。
参数解释:
query()的参数        对应的SQL部分          描述
	uri             from table_name   
	projection      select column1,column2
	selection       where column=value
	selectionArgs                       为where提供具体的值
	orderBy         order by column1, column2

查询完成后返回的依然是一个Cursor对象,这时我们就可以将数据从Cursor对象中逐个读取出来即可(按行遍历)。读取代码如下:

if(cursor !=null ){
    while (cursor.moveNext()) {
        String column1 = cursor.getString(cursor.getColumnIndex("column1"));
        int column2 = cursor.getInt(cursor.getColumnIndex("column1"));
    }
    cursor.close();
}

其他的增删改这里就不一一介绍了。大概代码如下;

// 增
ContentValues values = new ContentValues(); 
value.put("colunm1", ""); 

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

// 删
getContentResolver().delete(uri, "column2 = ?", new String[]{"1"});

读取系统联系人

使用ListView展示从通讯录读取的信息:

  1. 创建一个List<String>数组存放通讯录读取的信息。
  2. 创建adapter用于ListView展示。
  3. 申请用户授权危险权限。【记得同时在manifest中添加声明】
  4. 判断是否授权后读取通讯录
  1. Uri为ContactsContract.CommonDataKinds.Phone.CONTENT_URI固定值。
  2. 因为是全部读取,所以其他都为null
  3. 读取后存入List
  1. 当List内容发生变化,通知ListView
private ListView contactView;
    private ArrayAdapter<String> adapter;
    private List<String> contactList =new ArrayList<>();
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        contactView = (ListView) findViewById(R.id.contact_view);
        adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, contactList);
        contactView.setAdapter(adapter);
        if(ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS) != PackageManager.PERMISSION_GRANTED){

            ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_CONTACTS}, 1);
        }else {
            readContacts();
        }
    }

    private void readContacts() {
        Cursor cursor = null;
        try {
            Uri uri = ContactsContract.CommonDataKinds.Phone.CONTENT_URI;
            cursor = getContentResolver().query(
                    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);
                }
                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) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        switch (requestCode){
            case 1:
                if(grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED){
                    readContacts();
                }else {
                    Toast.makeText(this, "你拒绝了查看授权我查看通讯录的权利5555",Toast.LENGTH_SHORT).show();
                }
                break;
            default:
        }
    }

从上面可以看出,自己能改的地方很少,自己就是对着模板抄就行了。还是很简单的!

补充URI

通用资源标志符(Universal Resource Identifier, 简称"URI")。Uri代表要操作的数据,Android上可用的每种资源 (图像、视频片段、网页等) 都可以用Uri来表示。从概念上来讲,URI包括URL。

Uri的通用格式为:scheme: scheme-specific-part #fragment

通常有下面三种形式

  1. scheme://authority path ?query #fragment
  2. scheme://host:port path ?query #fragment
  3. scheme:scheme-specific-part #fragment

第一种用于访问本地资源,这里的scheme为content或者file,resource

Uri uri = Uri.parse("android.resource://"+context.getPackageName()+"/"+ R.raw.xxx);

第二种用于访问网络资源,这里的scheme通常为http

第三种用于打电话等服务,这里的scheme通常为smsto和tel等。

创建自己的contentprovider

创建contentprovider的步骤

如果想要实现跨程序共享数据的功能,可以通过粗行间一个类去继承ContentProvider的方式来实现。ContentProvider类中有6个抽象方法,我们子啊使用子类继承他的时候,需要重写。

public class MyProvider extends ContentProvider {

    @Override
    public boolean onCreate() {
        return false;
    }

    @Nullable
    @Override
    public Cursor query(@NonNull Uri uri, @Nullable String[] projection, @Nullable String selection, @Nullable String[] selectionArgs, @Nullable String sortOrder) {
        return null;
    }

    @Nullable
    @Override
    public String getType(@NonNull Uri uri) {
        return null;
    }

    @Nullable
    @Override
    public Uri insert(@NonNull Uri uri, @Nullable ContentValues values) {
        return null;
    }

    @Override
    public int delete(@NonNull Uri uri, @Nullable String selection, @Nullable String[] selectionArgs) {
        return 0;
    }

    @Override
    public int update(@NonNull Uri uri, @Nullable ContentValues values, @Nullable String selection, @Nullable String[] selectionArgs) {
        return 0;
    }
}
  • onCreate():初始化contentprovider的时候调用。通常这里完成对数据库的创建和升级等操作。true表示初始化成功.
a/**
 * onCreate 就是创建一个dbHelper~
 * @return 创建成功返回true
 */
@Override
public boolean onCreate() {
    dbHelper = new MydatabaseHelper(getContext(), "BookStore.db",null, 3);
    return true;
}
  • query():是从contentprovider中查询数据
  • 首先获取SQLiteDatabase的实例
  • 根据传入的Uri判断用户想要访问那张表。uriMatcher.match(uri)
  • 返回Cursor即可。
@Override
    public Cursor query(Uri uri, String[] projection, String selection,
                        String[] selectionArgs, String sortOrder) {
        // 查询数据
        SQLiteDatabase db = dbHelper.getWritableDatabase();
        Cursor cursor= null;
        switch (uriMatcher.match(uri)) {
            case BOOK_DIR:
                // 查看BOOK表中的所有数据
                cursor = db.query("Book", projection, selection, selectionArgs, null, null, sortOrder);
                break;
            case BOOK_ITEM:
                String bookId = uri.getPathSegments().get(1);
                cursor = db.query("Book", projection, "id = ?", new String[]{ bookId }, null, null, sortOrder);
                break;
                //...
        }
  • insert():添加数据
  • 也是根据Uri判断是在那张表添加数据
  • 在对应表中inser数据
  • 由于insert()方法要求返回一个能表示这条新增数据的URI,因此需要调用Uri.parse()将内容URI解析成URI对象。
uriReturn =  Uri.parse("content://" + AUTHORITY + "/book/" + newBookId);
  • update():更新:基本同上
  • delete():删除:基本同上
  • getType():根据传入的内容URI返回响应的MIME类型。(多用途互联网邮件扩展类型)
  • 他是所有contentprovider必须提供的一个方法,用于获取uri对象所对应的MIME类型。一个内容URI对应你的MIME字符串由三部分组成
  • 必须以vnd开头
  • 如果内容URI以路径结尾,则后面接android.cursor.dir/
  • 如果内容URI以id结尾,则后面解android.cursor.item/
  • 最后接上vnd.<authority>.<path>
@Override
    public String getType(Uri uri) {
        // at the given URI.
//        throw new UnsupportedOperationException("Not yet implemented");
        //     public static final String AUTHORITY = "com.ssozh.databasetest.provider";
        switch (uriMatcher.match(uri)){
            case BOOK_DIR:
                return "vnd.android.cursor.dir/vnd." + AUTHORITY + ".Book";
            case BOOK_ITEM:
                return "vnd.android.cursor.item/vnd." + AUTHORITY + ".Book";
            case CATEGORY_DIR:
                return "vnd.android.cursor.dir/vnd." + AUTHORITY + ".Category";
            case CATEGORY_ITEM:
                return "vnd.android.cursor.item/vnd." + AUTHORITY + ".Category";
            default:
                break;
        }
        return null;
    }

创建自己的contentprovider还是通过反键,other里面的content provider创建,他不仅给你创建文件,还帮你注册manifest。

另外,contentprovider一定要在manifest中注册了才可以使用。

实现跨程序数据共享

最后再回调函数中使用contentprovider:

// 以query为例 useUri是可以访问别的程序的db,而db则只能访问自己的数据
@Override
public void onClick(View v) {
    SQLiteDatabase db = dbHelper.getWritableDatabase();
    Cursor cursor = null;
    if(useUri){
        // 使用CUR获取cursor
        Uri uri = Uri.parse("content://com.ssozh.databasetest.provider/book");
        cursor = getContentResolver().query(uri,null,null,null,null,null);
    }else {
        // 查询db表中的所有数据
        cursor = db.query("Book", null, null, null, null, null, null);
    }

    if(cursor!=null) {
        while (cursor.moveToNext()){
            String[] columns = new String[]{"name", "author", "pages", "price"};
            for(String column : columns){
                printOnLog(cursor,column);
            }

        }
        cursor.close();
    }
}