内容提供器主要用于在不同应用程序之间实现数据共享功能,提供了一套完整的机制,允许一个程序访问另一个程序中的数据,同时还能保证被访问数据的安全性,内容提供器是Android实现跨程序共享数据的标准方式。不同于文件存储和SharedPreferences存储中的两种全局可读写操作模式内容提供器可以选择只对哪一部分数据进行共享。
1 运行时权限
1.2 在程序运行时申请权限
新建一个RuntimePermissionTest项目,使用CALL_PHONE这个权限作为本小节的示例
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<Button
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:id="@+id/make_call"
android:text="Make Call"/>
</LinearLayout>
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 view) {
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();
}
}
});
}
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:
}
}
}
运行时权限的核心就是在程序运行过程中由用户授权我们去执行某些危险操作,第一步,先判断用户是不是已经给过我们授权了,借助ContextCompat.checkSelfPermission()方法,接收两个参数,第一个参数Context,第二个参数是具体的权限名,打电话的权限名是Manifest.permission.CALL_PHONE,然后使用方法的返回值和PackageManager.PERMISSION_GRANTED作比较。
若已经授权,直接执行拨打电话的逻辑,拨打电话的逻辑封装在call()方法里,构建了一个隐式Intent,Intent的action指定为Intent.ACTION_CALL,这是一个系统内置的拨打电话的动作,然后在data部分指定了协议是tel,号码是10086,ACTION_CALL可以直接拨打电话,必须声明权限。
<uses-permission android:name="android.permission.CALL_PHONE"/>
若没有授权,则需要调用ActivityCompat.requestPermissions()方法来向用户申请授权,requestPermissions()接收三个参数,第一个参数要求是Activity的实例,第二个参数是一个String数组,我们把要申请的权限名放在数组中,第三个参数是请求码,只要是唯一值。
调用完requestPermissions()方法后,系统会弹出一个权限申请对话框,最终都会回调到onRequestPermissionsResult()方法中,授权结果会封装在grantResults参数当中,这里判断。
2 访问其他程序中的数据
内容提供器有两种,一种是使用现有的内容提供器,另一种是创建自己的内容提供器给我们程序的数据提供外部访问接口。
如果一个程序通过内容提供器对其数据提供了外部访问接口,那么任何其他的应用程序就都可以对这部分数据进行访问。
2.1ContentResolver的基本用法
每一个应用程序,想要访问内容提供器中共享的数据,就一定要借助ContentResolver类,通过Context中的getContentResolver()方法获取到该类的实例。ContentResolver
提供了一系列方法对数据进行CRUD操作,都是不接收表名的,使用一个Uri参数代替,内容URI给内容提供器中的数据建立了唯一标识符,主要两部分组成authority和path,得到内容URI字符串后,需要将他解析成Uri对象才可以作为参数传入
Uri uri = Uri.parse(“context://com.example.app.provider/table1”)。
2.2 读取系统联系人
先创建两个联系人,新建一个项目,
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="vertical"
android:layout_width="match_parent"
android:layout_height="wrap_content">
<ListView
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:id="@+id/list_view"/>
</LinearLayout>
public class MainActivity extends AppCompatActivity {
List<String> contactsList = new ArrayList<>();
ArrayAdapter<String> adapter;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ListView contactsView = (ListView) findViewById(R.id.list_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();
}
}
public 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 number = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
String name = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
contactsList.add(name + "\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_LONG).show();
}
break;
default:
}
}
}
<uses-permission android:name="android.permission.READ_CONTACTS"/>
readContacts()方法,使用了ContentResolver的query()方法来查询系统的联系人数据,这里没有调用Uri.parse()方法去解析一个内容URI字符,因为ContactsContract.CommonDataKinds.Phone类已经帮我们做好了封装,提供了一个CONTENT_URI常量,这个常量就是使用Uri.parse()方法解析出来的结果,然后对Cursor对象进行遍历,姓名对应的常量是ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME,电话号码对应的常量是ContactsContract.CommonDataKinds.Phone.NUMBER,拼接后加到ListView的数据源里,并通知刷新一下ListView,最后将Cursor对象关掉。
创建自己的内容提供器
上一节学习了如何在自己的程序中访问其他应用程序的数据,只需要获取到该应用程序的内容URI,然后借助ContentResolver进行CRUD操作,那些提供外部接口的应用程序如何实现这种功能?
可以通过新建一个类去继承ContentProvider的方式来创建一个自己的内容提供器,ContentProvider类中有6个抽象方法,使用子类继承的时候需要将这6个方法全部重写。
public class MyProvider extends ContentProvider {
@Override
public boolean onCreate(){
return false;
}
@Override
public Cursor query(Uri uri,String[] projection,String selection,String[] selectionArgs,String sortOrder){
return null;
}
@Override
public Uri insert(Uri uri, ContentValues values){
return null;
}
@Override
public int update(Uri uri,ContentValues values,String selection,String[] selectionArgs){
return 0;
}
@Override
public int delete(Uri uri,String selection,String[] selectionArgs){
return 0;
}
@Override
public String getType(Uri uri){
return null;
}
}
1.onCreate():初始化内容提供器的时候调用,通常会在这里完成对数据库的创建和升级等操作,返回true表示内容提供器初始化成功,false则失败
2.query():uri参数来确定查询哪张表,projection查询哪些列,selection和selectionArgs参数用于约束查询哪些行,sortOrder用于对结果进行排序,查询结果放在Cursor对象中返回。
3.insert():向内容提供器中添加一条数据,uri来确定添加到的表,待添加的数据保存在values参数中,添加完后,返回一个用于表示这条新记录的URI。
4.update():uri更新哪张表,新数据保存在values参数中,selection和selectionArgs参数用于约束更新哪些行,受影响的行数作为返回值返回。
5.delete():uri删除哪一张表中的数据,selection和selectionArgs参数用于约束删除哪些行,被删除的行数作为返回值返回。
6.getType():根据传入的内容URI返回相应的MIME类型。
借助UriMatcher这个类可以轻松实现匹配内容URI的功能。UriMatcher中提供了一个addURI()方法,接收三个参数,可以分别把authoity,path和一个自定义代码传进去,当调用UriMatcher的math()方法时,就可以将一个Uri对象传入,返回值是某个能匹配这个Uri对象所对应的自定义代码。
内容提供器,所有的CURD操作都一定要匹配到相应的内容URI格式才能进行,不向UriMatcher中添加隐私数据的URI,这部分数据就无法被外部程序访问。