这里有两个概念:ContentProvider----内容提供者,主要实现在不同应用程序之间实现数据的共享的功能。Android中的四大组件指的就是它。
ContentResolver----内容接受者,想要访问内容提供者中共享的数据,就要借助ContentResolver这个类。
URI的格式:
SQLiteDatabase的增删改查要传入表名参数,ContentResolver的增删改查则是要传入参数Uri。这个参数成为内容URI,内容URI给内容提供者中的数据建立了一个唯一的标识符,主要有两个部分组成:authority和path。authority是用来区分不同的应用程序。path则是对同一个应用程序中不同的表做区分。这两个参数都有一定的规则:
authority一般是以包名来命名,例如一个应用程序的包名是:com.company.app,那么authority可以命名为com.company.app.provider。
path则是会添加到authority后面,例如这个app的数据库里有两个表格:table1和table2,则path则分别命名为/table1和/table2。
然后URI就是:com.company.app.provider/table1和com.company.app.provider/table2,最后一步,添加协议头:
content://com.company.app.provider/table1
content://com.company.app.provider/table2
这样,URI字符串就确定了。
在得到URI字符串之后,就需要把它变成系统可以识别的Uri对象,才能作为传入参数,方法是用Uri.parse()方法:
Uri uri = Uri.parse("content://com.company.app.provider/table1");
如果想要访问表table中id为的数据:
content://com.company.app.provider/table1/1
另外还有两个通配符:
* :表示匹配任意长度的任意字符
#:表示匹配任意长度的数字
一个能匹配任意表的内容的URI格式:
content://com.company.app.provider/*
一个能匹配table表中任意一行数据的内容的URI格式:
content://com.company.app.provider/table1/#
ContentResolver
可以通过Context中的getContentResolver()方法来获取该类的实例。ContentResolver中提供一系列方法用于对数据的增删改查。insert()---添加数据,update()---更新数据,delete()---删除数据,query()---查询数据。和SQLiteDatabase中的方法类似,只是具体的参数是不一样的。可以对比着来记忆。
查询:
现在就可以用这个Uri来查询table1表里面的数据了,用的方法是getContentResolver().query(),它返回一个cursor对象:
Cursor cursor = getContentResolver().query(uri,projection,selection,selectionArgs,sortOrder);
参数:uri:上面刚刚说过,对应于要查询的某个应用程序下的某张表,相当于SQL里面的 from table_name;
projection:指定要查询的列的名称,相当于SQL里面的select column1,column2;
selection:查询条件,相当于SQL里面的where column = value;
selectionArgs:为selection中的占位符提供具体的值;
sortOrder:指定查询结果的排列方式,相当于SQL里面的order by column1,column2;
由于返回的是一个Cursor对象,思路就很简单了,可以类似于SQLite一样把Cursor里面的数据逐个读出来,
if (cursor != null) {
while (cursor.moveToNext()) {
String column1 = cursor.getString(cursor.getColumnIndex("column1"));
int column2 = cursor.getInt(cursor.getColumnIndex("column2"));
}
cursor.close();
}
记得关闭cursor哦。
剩下的就很简单了。
添加,把数据放在ContentValues对象里,通过insert()方法传入URI和ContentValues对象即可:
ContentValues values = new ContentValues();
values.put("column1",value1);
values.put("column2",value2);
getContentResolver().insert(uri,values);
更新,通过update()方法即可,传入第三个参数是约束条件,第四个条件是约束条件的值:
ContentValues values = new ContentValues();
values.put("column1", value1);
values.put("column2", value2);
getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new String[]{"value1", "value2"});
删除:
getContentResolver().delete(uri, "column1 = ? and column2 = ?", new String[]{"value1", "value2"});
增删改查已经ok了。
一个小例子,结合Easypermissions,查询系统联系人:
1.添加权限
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.WRITE_CONTACTS" />
2.布局文件
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/activity_provider_test"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
tools:context="com.firstcode.firstcode2.chapter7.ProviderTest">
<ListView
android:id="@+id/contacts_list"
android:layout_width="match_parent"
android:layout_height="match_parent">
</ListView>
</LinearLayout>
3.Activity代码
//读取系统联系人
public class ProviderTest extends AppCompatActivity implements EasyPermissions.PermissionCallbacks {
private ListView mContacts_list;
private ArrayAdapter<String> mAdapter;
private List<String> mDate;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_provider_test);
ActionBar actionBar = getSupportActionBar();
if (actionBar != null) {
actionBar.hide();
}
initView();
initDate();
}
private void initView() {
mContacts_list = (ListView) findViewById(R.id.contacts_list);
}
private void initDate() {
mDate = new ArrayList<>();
mAdapter = new ArrayAdapter<>(ProviderTest.this,
android.R.layout.simple_list_item_1,
mDate);
mContacts_list.setAdapter(mAdapter);
//判断权限
String[] permissions = {Manifest.permission.READ_CONTACTS, Manifest.permission.WRITE_CONTACTS};
if (EasyPermissions.hasPermissions(this, permissions)) {
readContacts();
} else {
EasyPermissions.requestPermissions(this, "读取联系人的权限", 1, permissions);
}
}
private void readContacts() {
Cursor cursor = null;
try {
//得到cursor对象
cursor = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
null, null, null, null);
//遍历cursor
if (cursor != null) {
while (cursor.moveToNext()) {
//获取联系人
String contact_name = cursor.getString(
cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
//获取电话
String contact_phone = cursor.getString(
cursor.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
//添加数据
mDate.add("name = " + contact_name + " phone = " + contact_phone);
}
//同步adapter
mAdapter.notifyDataSetChanged();
}
} catch (Exception e) {
e.printStackTrace();
} finally {
//关闭cursor对象
if (cursor != null) {
cursor.close();
}
}
}
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
//把申请权限的回调交由EasyPermissions处理
EasyPermissions.onRequestPermissionsResult(requestCode, permissions, grantResults, this);
}
//实现接口的方法--同意授权
@Override
public void onPermissionsGranted(int requestCode, List<String> perms) {
switch (requestCode) {
case 1:
readContacts();
break;
}
}
//实现接口的方法--拒绝授权
@Override
public void onPermissionsDenied(int requestCode, List<String> perms) {
switch (requestCode) {
case 1:
Toast.makeText(this, "You denied the Contact permission", Toast.LENGTH_SHORT).show();
break;
}
}
}
ContentResolver is OVER。
ContentProvider
接下来就是ContentProvider,用新建一个类继承ContentProvider的方式来创建自己的内容提供器。继承ContentProvider类之后有6个方法需要自己实现:
public class MyProvider extends ContentProvider {
//借助UriMatcher可以实现匹配URI的功能
//uriMatcher.addURI()传入是三个参数:authority,path和一个自定义代码
//当调用uriMatcher.match(uri)方法时,只需要传入一个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;
public static final String authority = "com.firstcode.firstcode2";
private static UriMatcher uriMatcher;
static {
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI(authority, "table1", TABLE1_DIR);
uriMatcher.addURI(authority, "table1/#", TABLE1_ITEM);
uriMatcher.addURI(authority, "table2", TABLE2_DIR);
uriMatcher.addURI(authority, "table2/#", TABLE2_ITEM);
}
/**
* 初始化ContentProvider,完成数据库的创建和升级的操作
* 此方法只有在ContentResolver尝试访问本应用程序的时候,内容提供器才会被初始化
*
* @return 返回true表示创建成功,false表示创建失败
*/
@Override
public boolean onCreate() {
return false;
}
/**
* 从内容提供器中查询数据,查询的结果存放在cuesor对象中返回
*
* @param uri 确定要查询的表
* @param projection 确定查询那些列
* @param selection 约束条件
* @param selectionArgs 约束条件的值
* @param sortOrder 结果排序
* @return cursor对象
*/
@Nullable
@Override
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;
}
return null;
}
/**
* 向内容提供器中添加一条数据
*
* @param uri 确定要添加的表
* @param values 添加的数据
* @return 返回一个用于表示这条新记录的URI
*/
@Nullable
@Override
public Uri insert(Uri uri, ContentValues values) {
return null;
}
/**
* 更新内容提供器中已有的数据
*
* @param uri 确定要更新的表
* @param values 更新的数据
* @param selection 约束条件
* @param selectionArgs 约束条件的值
* @return 返回受影响的行数
*/
@Override
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
return 0;
}
/**
* 从内容提供器中删除数据
*
* @param uri 确定要删除的表
* @param selection 约束条件
* @param selectionArgs 约束条件的值
* @return 返回被删除的行数
*/
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
return 0;
}
/**
* 根据传入内容的URI来返回相应的MIME类型
* 一个URI所对应的MIME字符串由三个部分组成:
* 1.必须以vnd开头。
* 2.内容必须URI以路径结尾的,则需要后接android.cursor.dir/。如果以id结尾的,则后接android.cursor.item/
* 3.最后接上vnd.<authority>.<path>
* eg:以 content://com.company.app.provider/table1 为例:
* 对应的MIME类型是:vnd.android.cursor.dir/vnd.com.company.app.provider/table1
* eg:以 content://com.company.app.provider/table1/1 为例:
* 对应的MIME类型是:vnd.android.cursor.item/vnd.com.company.app.provider/table1
* 后面没有 /1 了。
*
* @param uri 传入的URI
* @return 返回相应的MIME类型
*/
@Nullable
@Override
public String getType(Uri uri) {
switch (uriMatcher.match(uri)) {
case TABLE1_DIR:
return "vnd.android.cursor.dir/vnd.com.firstcode.firstcode2/table1";
case TABLE1_ITEM:
return "vnd.android.cursor.item/vnd.com.firstcode.firstcode2/table1";
case TABLE2_DIR:
return "vnd.android.cursor.dir/vnd.com.firstcode.firstcode2/table2";
case TABLE2_ITEM:
return "vnd.android.cursor.item/vnd.com.firstcode.firstcode2/table2";
}
return null;
}
}
over