内容提供器(Content Provider)主要用于在不同的应用程序之间实现数据共享的功能,它提 供了一套完整的机制,允许一个程序访问另一个程序中的数据,同时还能保证被访数据的安全性。目前,使用内容提供器是 Android 实现跨程序共享数据的标准方式。
运行时权限(打电话为例)
1、AndroidManifest.xml
文件添加如下代码
<uses-permission android:name="android.permission.CALL_PHONE" />
2、申请运行时权限逻辑代码
// 点击时申请权限
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();
}
// call()方法代码
private 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, String[] permissions, 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:
}
}
内容提供器
内容提供器的用法一般有两种,一种是使用现有的内容提供器来读取和操作相应程序中的数据,另一种是创建自己的内容提供器给我们程序的数据提供外部访问接口
1、读取和操作相应程序中的数据
如果想要访问内容提供器中共享的数据,就一定要借助
ContentResolver
类,可以通过Context
中的getContentResolver()
方法获取到该类的实例。ContentResolver
中提供了一系列的方法用于对数据进行CRUD
操作,其中insert()
方法用于添加数据,update()
方法用于更新数据,delete()
方法用于删除数据,query()
方法用于查询数据。ContentResolver
中的增删改查方法都是不接收表名参数的,而是使 用一个Uri
参数代替,这个参数被称为内容URI
内容URI
给内容提供器中的数据建立了唯一 标识符,它主要由两部分组成:authority
和path
。authority
是用于对不同的应用程序做区分的, 一般为了避免冲突,都会采用程序包名的方式来进行命名。path
则是用于对同一 应用程序中不同的表做区分的,通常都会添加到authority
的后面。内容 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")
- 查询
query
/*
uri from table_name 指定查询某个应用程序下的某一张表
projection select column1, column2 指定查询的列名
selection where column = value 指定where的约束条件
selectionArgs - 为where中的占位符提供具体的值
sortOrder order by column1, column2 指定查询结果的排序方式
查询完成后返回的仍然是一个 Cursor 对象
*/
Cursor cursor = getContentResolver().query(
uri,
projection,
selection,
selectionArgs,
sortOrder);
- 插入
insert
ContentValues values = new ContentValues();
values.put("column1", "text");
values.put("column2", 1);
getContentResolver().insert(uri, values);
- 更新
update
ContentValues values = new ContentValues();
values.put("column1", "");
getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new String[] {"text", "1"});
- 删除
delete
getContentResolver().delete(uri, "column2 = ?", new String[] { "1" });
读取手机联系人示例
1、AndroidManifest.xml
文件添加<uses-permission android:name="android.permission.READ_CONTACTS" />
2、 逻辑代码
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 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, 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 {
// 查询联系人数据
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, String[] permissions, 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:
}
}
}
2、创建自己的内容提供器
如果想要实现跨程序共享数据的功能,官方推荐的方式就是使用内容提供器,可以通过新建一个类去继承
ContentProvider
的方式来创建一个自己的内容提供器。ContentProvider
类中有 6 个抽象方法,我们在使用子类继承它的时候,需要将这 6 个方法全部重写.
/*
onCreate() 初始化内容提供器的时候调用。
通常会在这里完成对数据库的创建和升级等操作,返回 true
表示内容提供器初始化成功,返回 false 则表示失败。
*/
@Override
public boolean onCreate() {
return false;
}
/*
query() 从内容提供器中查询数据
*/
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
return null;
}
/*
insert() 向内容提供器中添加一条数据
*/
@Override
public Uri insert(Uri uri, ContentValues values) {
return null;
}
/*
update() 更新内容提供器中已有的数据
*/
@Override
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
return 0;
}
/*
delete() 从内容提供器中删除数据
*/
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
return 0;
}
/*
getType() 根据传入的内容 URI来返回相应的MIME类型。
*/
@Override
public String getType(Uri uri) {
return null;
}
每一个方法都会带有
Uri
这个参数,这个参数也正是调用ContentResolver
的增删改查方法时传递过来的。
内容URI
的格式主要就只有以上两种,以路径结尾就表示期望访问该表中所有的数据,以id
结尾就表示期望访问该表中拥有相应id
的数据。我们可以使用通配符的方式来分别匹配这两种格式的内容URI
,规则如下。
*:表示匹配任意长度的任意字符。
#:表示匹配任意长度的数字。
UriMatcher
这个类就可以轻松地实现匹配内容URI
的功能。UriMatcher
中提供了一个 addURI()
方法,这个方法接收 3个参数,可以分别把 authority
、path
和一个自 定义代码传进去。这样,当调用 UriMatcher
的 match()
方法时,就可以将一个Uri
对象传入, 返回值是某个能够匹配这个Uri
对象所对应的自定义代码,利用这个代码,我们就可以判断出调用方期望访问的是哪张表中的数据了.
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;
private 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:
// 查询 table1 表中的所有数据
break;
case TABLE1_ITEM:
// 查询 table1 表中的单条数据
break;
case TABLE2_DIR:
// 查询 table2 表中的所有数据
break;
case TABLE2_ITEM:
// 查询 table2 表中的单条数据
break;
default: break;
}
}
getType()
方法
它是所有的内容提供器都必须 提供的一个方法,用于获取Uri
对象所对应的MIME
类型。一个内容URI
所对应的MIME
字符 串主要由 3部分组成,Android
对这 3个部分做了如下格式规定。
1.必须以vnd
开头。
2.如果内容URI
以路径结尾,则后接android.cursor.dir/
,如果内容URI
以id
结尾, 则后接android.cursor.item/
。
3.最后接上vnd.<authority>.<path>
。
所以,对于content://com.example.app.provider/table1
这个内容URI
,它所对应的MIME
类型就可以写成:vnd.android.cursor.dir/vnd.com.example.app.provider.table1
对于content://com.example.app.provider/table1/1
这个内容URI
,它所对应的MIME
类型就可 以写成:vnd.android.cursor.item/vnd.com.example.app.provider.table1
最后在
AndroidManifest.xml
中声明自定义内容提供器
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:supportsRtl="true"
android:theme="@style/AppTheme">
...
<provider android:name=".DatabaseProvider"
android:authorities="com.example.databasetest.provider"
android:enabled="true"
android:exported="true">
</provider>
</application>