跨程序共享数据——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里面声明,而且还要判断用户是否授权我们。
具体流程如下:
ContextCompat.checkSelfPermission()
方法判断用户是否授权。第一个参数是上下文,第二个参数是具体权限名,Manifest.permission.CALL_PHONE
- 如果没有,需要调用
ActivityCompat.requestPermissions()
方法来向用户申请授权。三个参数
- Activity实例
- String数组,我们要把申请的权限名放入数组即可
- 请求码
ActivityCompat.requestPermissions(MainActivity.this,new String[]{Manifest.permission.CALL_PHONE}, 1);
- 调用完
ActivityCompat.requestPermissions()
方法后,系统会弹出一个权限申请框。无论用户是同意还是拒绝都会回调到onRequestPermission()
方法中,而授权则会封装在grantResults
参数当中,允许是[0] - 注意在对话框中选择允许后,会默认永久允许这个操作,下次就不会再找你要权限了!想要关闭就需要:
应用->应用管理->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展示从通讯录读取的信息:
- 创建一个
List<String>
数组存放通讯录读取的信息。 - 创建adapter用于ListView展示。
- 申请用户授权危险权限。【记得同时在manifest中添加声明】
- 判断是否授权后读取通讯录
- Uri为
ContactsContract.CommonDataKinds.Phone.CONTENT_URI
固定值。 - 因为是全部读取,所以其他都为null
- 读取后存入List
- 当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
通常有下面三种形式
- scheme://authority path ?query #fragment
- scheme://host:port path ?query #fragment
- 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();
}
}