1.ContentResolver的基本用法
对于每一个应用程序来说,如果想要访问内容提供器中的共享数据,就一定要借助ContentResolver类,可以通过Context中的getContentResolver()方法获取到该类的实例,ContentResolver中提供了一系列的方法用于对数据进行CRUD
操作.其中insert()方法用于添加数据,update()方法用于更新数据,delete()方法用于删除数据,query()方法用于查询数据.
不同于SQLiteDatabase,ContentResolver中的增删改查方法都是不接收表名参数的,而是使用一个Uri参数代替,这个参数被称为内容URI,内容URI给内容提供器中的数据建立了唯一标识符,它主要由两部分组成:authority和path,authority是用于对不同的应用程序做区分的,一般为了避免冲突,都会采用程序包名的方式来进行命名,比如某个程序的包名是com.example.app,那么该程序对应的authority就可以命名为com.example.app.procider.path则是用于对同一个应用程序中不同的表做区分的,通常会添加到authority后面,比如某个应用的数据库里面存在两张表:table1和table2,这时就可以将path分别命名为/table1和table2,然后把authority和path进行组合,内容URI就变成了 com.example.app.procider/table1和com.example.app.procider/table2.我们还需要在字符串的头部加上协议声明,因此,内容URI的最标准的格式写法如下:
content://com.example.app.procider/table1
content://com.example.app.procider/table2
在得到了内容URI字符串之后,我们还需要将它解析成Uri对象才可以作为参数传入.解析相当简单,代码如下:
Uri uri = Uri.parse("content://com.example.app.procider/table1");
只需要调用Uri.parse()方法,就可以将内容URI字符串解析成Uri对象了.
现在我们可以使用这个Uri对象来查询table1表中的数据了,代码如下:
Cursor cursor = getContentResolver().query(
uri,
projection,
selection,
selectionArgs,
sortOrder);
//uri from table_name 指定查询某个应用程序下的某一张表
//projection select column1,column2 指定查询的列名
//selection where column = value 指定where的约束条件
//selectionArgs - 为where中的占位符提供具体的值
//orderBy order by column1,column2 指定查询结果的排序方式
查询完成后返回的是一个Cursor对象,这时我们就可以将数据从Cursor对象中逐个读取出来,读取的思路仍然是通过移动游标的位置来遍历Cursor的所有行,然后再取出每一行中相应列的数据,代码如下:
if (cursor != null){
while(cursor.moveToNext()){
String column1 = cursor.getString(cursor.getColumnIndex("column1"));
int column2 = cursor.getInt(cursor.getColumnIndex("column2"));
}
cursor.close();
}
向table1表中添加一条数据,代码如下:
ContentValues values = new ContentValues();
values.put("column1", "text");
values.put("column2:, 1);
getContentResolver().insert(uri, values);
将待添加的数据组装到ContentValues中,然后调用ContentResolver的insert()方法,将uri和ContentValues作为参数传入.
如果我们想要更新这条新添加的数据,把column1的值清空,可以接祖ContentResolver的update()方法实现,代码如下:
ContentValues values = new ContentValues();
values.put("column1", "");
getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new String[] {"text", "1"});
注意上述代码使用了selection和selectionArgs参数来对想要更新的数据进行约束,以防止所有行都会受影响.
最后,可以调用ContentResolver的delete()方法将这条数据删除掉,代码如下:
getContentResolver().delete(uri, values, "column2 = ?", new String[] {"1"});
2.读取系统联系人
首先编写一下布局文件,读取出来的联系人信息显示在ListView中,修改activity_main.xml代码:
<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:id="@+id/contacts_view"
android:layout_width="match_parent"
android:layout_height="match_parent"/>
</LinearLayout>
修改MainActivity代码:
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:
}
}
}
在onCreate()方法中,我们首先获取了ListView控件的实例,并给它设置好了适配器,然后开始调用运行时权限的处理逻辑,因为READ_CONTACTS权限是危险权限,所以要使用运行时权限处理流程,我们在用户授权之后调用readContacts()方法来读取系统联系人信息.
在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对象关闭掉,
注意要声明读取系统联系人的权限,修改AndroidManifest,xml的代码
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.contactstest">
<uses-permission android:name="android.permission.READ_CONTACTS"/>
...
</manifest>