Android 内容提供器

发表于 | 分类于
字数统计: 864 word | 阅读时长 ≈ 3 min
内容提供器

内容提供器(Content Provider)是Android跨程序共享数据的标准方式，内容提供器可以选择对哪一部分数据共享，从而不会有泄露的风险。

用法

内容提供器的用法一般有两种：

  • 一种是使用现有的内容提供其读取操作相应应用程序的数据【比如系统电话簿，短信等】
  • 另一种是创建自己的内容提供器提供外部访问接口
  • 对每一个应用程序来说，如果想要访问内容提供器中共享的数据，就一定要借助ContentResolver类，可以通过Context中的getContentResolver()方法获取到该类的实例。
  • ContentResolver中提供了一系列的方法用于对数据进行CURD操作：
    • insert()方法用于添加数据
    • update()方法用于更新数据
    • delete()方法用于删除数据
    • query()方法用于查询数据
  • 内容URI: 内容URI 给内容提供器中的数据建立了唯一标识符，如context://com.example.app.provider/table1
  • ContentResolver的增删改查方法都接收一个内容URI作为第一个参数
Uri

URI，每一个Content Provider 都对外提供一个 能够唯一标识自己 数据集(data set)的公开URI, 如果一个Content Provider管理多个数据集，其将会为每个数据集分配一个独立的URI。所有的Content Provider的URI 都以"content://" 开头，其中"content:"是用来标识数据是由Content Provider管理的 schema

基本用法
1、查

例如，查询table表的数据：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Uri uri = Uri.parse("content://包名.provider/table")
Cursor cursor = getContentResolver().query(
	uri,
	列名,
	where 约束条件,
	占位参数,
	排序方式
)
if(cursor != null){
	while (cursor.moveToNext()){
		String 列1 = cursor.getString(cursor.getColumnIndex(列名1));
		int 列2 = cursor.getInt(cursor.getColumnIndex(列名2));
		}
	cursor.close();
}
2.增
1
2
3
4
ContentValues values = new ContentValues();
values.put(列名1, 值1);
values.put(列名2, 值2);
getContentResolver().insert(uri, values);
3.其他的都类似于前面的数据库操作
Demo code

下面实现一个读取手机联系人的demo：

  • 在manifest中添加读取联系人权限
1
<uses-permission android:name="android.permission.READ_CONTACTS"/>
  • 布局（简单的一个listview）
1
2
3
4
5
6
7
8
9
10
11
12
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <ListView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:id="@+id/contacts_view"/>

</LinearLayout>
  • 主活动（这里query()的内容URI对象已经被解析出来了）
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
public class MainActivity extends AppCompatActivity {
    ArrayAdapter<String> adapter;
    List<String> contactList = new ArrayList<>();

    @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, "权限被拒绝，无法显示通讯录", Toast.LENGTH_SHORT).show();
                }
                break;
            default:
        }
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        ListView listView_contacts = findViewById(R.id.contacts_view);
        adapter = new ArrayAdapter<String>(this, android.R.layout.simple_list_item_1, contactList);
        listView_contacts.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));
                    contactList.add(displayName+"\n"+number);
                }
                // 刷新并显示
                adapter.notifyDataSetChanged();
            }
        }catch (Exception e){
            e.printStackTrace();
        }finally {
            if (cursor != null){
                cursor.close();
            }
        }
    }
}

0%