1. 内容提供器
内容提供器(Content Provider
)主要用于在不同的应用程序之间实现数据共享的功能,它提供了一套完整的机制,
允许一个程序访问另一个程序中的数据,同时还能保证被访数据的安全性。目前,使用内容提供器是Android实现跨程序共享数据的标准方式。
对于每一个应用程序来说,如果想要访问内容提供器中共享的数据,就一定要借助ContentResolver
类,可以通过Context
中的getContentResolver()
方法获取到该类的实例。
ContentResolve
r中提供了一系列的方法用于对数据进行CRUD操作,其中
insert()
方法用于添加数据,update()
方法用于更新数据,delete()
方法用于删除数据,query()
方法用于查询数据。
ContentResolver
中的增删改查方法都是不接收表名参数的,而是使用一个Uri参数代替,这个参数被称为内容URI
。内容URI给内容提供器中的数据建立了唯一标识符,它主要由两部分组成:
authority
和path
。
authority
是用于对不同的应用程序做区分的,一般为了避免冲突,都会采用程序包名的方式来进行命名。比如某个程序的包名是com.example.app
,那么该程序对应的authority
就可以命名为com.example.app.provider
。path
则是用于对同一应用程序中不同的表做区分的,通常都会添加到authority
的后面。比如某个程序的数据库里存在两张表:table1
和table2
,这时就可以将path分别命名为/table1
和/table2
,然后把authority和path进行组合,内容URI就变成了com.example.app.provider/table1
和com.example.app.provider/table2
。- 不过,目前还很难辨认出这两个字符串就是两个内容URI,我们还需要在字符串的头部加上协议声明。因此,内容URI最标准的格式写法如下:
content://com.example.app.provider/table1
在得到了内容URI字符串之后,我们还需要将它解析成Uri对象才可以作为参数传入。解析的方法也相当简单,代码如下所示:
Uri uri = Uri.parse("content://com.example.app.provider/table1")
2.读取通讯录
- 1.
AndroidManifest.xml
中声明权限
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.contactsdemo">
<uses-permission android:name="android.permission.READ_CONTACTS"/>
....
</manifest>
- 2 .
activity_main.xml
<?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">
<ListView android:id="@+id/view_contacts"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</LinearLayout>
- 3.
MainActivity.java
public class MainActivity extends AppCompatActivity {
private List<String> contactsList = new ArrayList<>();
private ArrayAdapter<String> adapter;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ListView viewContact = findViewById(R.id.view_contacts);
adapter = new ArrayAdapter<String>(MainActivity.this, android.R.layout.simple_list_item_1, contactsList);
viewContact.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 {
//获取 ContentResolver
ContentResolver contentResolver = getContentResolver();
//通讯录URL:ContactsContract.CommonDataKinds.Phone.CONTENT_URI
cursor = contentResolver.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 phonenum = cursor.getString(cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
contactsList.add(displayName + "
" + phonenum);
adapter.notifyDataSetChanged(); //更新ListView数据
}
}
} 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, "无法读取联系人,未经授权", Toast.LENGTH_SHORT).show();
}
break;
default:
break;
}
}
}
3.知识点:
- 声明权限:
<uses-permission android:name="android.permission.READ_CONTACTS"/>
- 通讯录权限名:
Manifest.permission.READ_CONTACTS
- 获取 ContentResolver:
ContentResolver contentResolver = getContentResolver();
- 通讯录URI:
ContactsContract.CommonDataKinds.Phone.CONTENT_URI
- 读取通讯录:
cursor = contentResolver.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null, null, null, null);