《第一行代码》内容提供器

 

12、内容提供器

内容提供器（Content Provider）主要用于在不同的应用程序之间实现数据共享的功能

 

不同于文件存储和 SharedPreferences 存储中的两种全局可读写操作模式，内容提供器可以选择只对哪一部分数据进行共享，从而保证我们程序中的隐私数据不会有泄漏的风险。

 

种类：

1、使用现有的内容提供器来读取和操作相应程序中的数据

2、另一种是创建自己的内容提供器给我们程序的数据提供外部访问接口

 

ContentResolver 类中提供了一系列的方法用于对数据进行 CRUD 操作

ContentResolver 中的增删改查方法都是不接收表名参数的，而是使用一个 Uri 参数代替

 

URI：

content://com.example.app.provider/table1

content://com.example.app.provider/table2

 

权限（authority）和路径（path）。

权限是用于对不同的应用程序做区分的，一般为了避免冲突，都会采用程序包名的方式来进行命名。

比如某个程序的包名是 com.example.app，那么该程序对应的权限就可以命名为 com.example.app.provider。

 

路径则是用于对同一应用程序中不同的表做区分的，通常都会添加到权限的后面。

比如某个程序的数据库里存在两张表，table1 和 table2，这时就可以将路径分别命名为/table1和/table2，然后把权限和路径进行组合，内容 URI 就变成了 com.example.app.provider/table1和 com.example.app.provider/table2。

 

1. *：表示匹配任意长度的任意字符

2. #：表示匹配任意长度的数字

所以，一个能够匹配任意表的内容 URI 格式就可以写成：

content://com.example.app.provider/*

 

而一个能够匹配 table1 表中任意一行数据的内容 URI 格式就可以写成：

content://com.example.app.provider/table1/#

 

UriMatcher中提供了一个 addURI()方法，这个方法接收三个参数，可以分别把权限、路径和一个自定义代码传进去。

这样，当调用 UriMatcher 的 match()方法时，就可以将一个 Uri 对象传入，返回值是某个能够匹配这个 Uri 对象所对应的自定义代码

 

//URI字符串转URI对象
	Uri uri = Uri.parse("content://com.example.app.provider/table1")
	
	Cursor cursor = getContentResolver().query(
		uri,
		projection,
		selection,
		selectionArgs,
		sortOrder);
	
	if (cursor != null) {
		while (cursor.moveToNext()) {
			String column1 = cursor.getString(cursor.getColumnIndex("column1"));
			int column2 = cursor.getInt(cursor.getColumnIndex("column2"));
		}
		cursor.close();
	}
	
	//新增：
	ContentValues values = new ContentValues();
	values.put("column1", "text");
	values.put("column2", 1);
	getContentResolver().insert(uri, values);

	//修改：
	ContentValues values = new ContentValues();
	values.put("column1", "");
	getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new	String[] {"text", "1"});	
	
	//删除：
	getContentResolver().delete(uri, "column2 = ?", new String[] { "1" });

 

读取系统联系人：

ContactsContract.CommonDataKinds.Phone类已经帮我们做好了封装，提供了一个CONTENT_URI常量，而这个常量就是使用 Uri.parse()方法解析出来的结果。

联系人姓名这一列对应的常量是ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME，

联系人手机号这一列对应的常量是 ContactsContract.CommonDataKinds.Phone.NUMBER。

 

读取系统联系人也是需要声明权限的

<uses-permission android:name="android.permission.READ_CONTACTS" />

private void readContacts() {
        Cursor cursor = null;
        try {
            // 查询联系人数据
            cursor = getContentResolver().query(
                    ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
                    null, null, null, 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);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (cursor != null) {
                cursor.close();
            }
        }
    }	

 

读取通讯录失败：

https://blog.csdn.net/njweiyukun/article/details/50044193

 

当用户手机的android系统为5.1及以下的系统，或者项目设置的targetSDK为22或者以下，那么所有的权限（普通和危险）都是在安装时候授权的，不会出现本博客所提出的问题。

但是如果你的android系统为6.0及以上并且targetSDK为23及以上，每一个危险的权限都必须在app运行时候逐一让用户点击同意或者拒绝。

在 6.0版本 增强了用户的安全机制。涉及到用户的隐私以及安全的时候需要用户自己手动去授权。

 

ListViewActivity:

//第一.你需要导入最新的android-support-v4.jar包
	//第二，检测用户是否已经授权同意过该危险权限，返回true说明还没有授权或者已经拒绝，返回false说明用户已经同意了该危险权限，可以继续执行需要该权限的操作
	if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_CONTACTS)
			!= PackageManager.PERMISSION_GRANTED) {

		//第三.接着第二步返回true的情况，进行用户未授权或拒绝情况的处理
		//返回true表明用户之前已经选择过拒绝授权了；若是返回false，则表明我们还有戏，用户还没有选择过是否授权
		if (ActivityCompat.shouldShowRequestPermissionRationale(this,
				Manifest.permission.READ_CONTACTS)) {
			Toast.makeText(this, "deny for what???", Toast.LENGTH_SHORT).show();
		} else {
			Toast.makeText(this, "show the request popupwindow", Toast.LENGTH_SHORT).show();

			//第四.通过调用系统自带的弹窗询问用户是否授权
			//这时一个异步的方法，TAG_PERMISSION是我们自己定义的一个int类型常量（requestCode），用于标记我们当前的方法。调用此方法，系统会弹出一个dialog，dialog的样式我们是无法修改的
			ActivityCompat.requestPermissions(this,
					new String[]{Manifest.permission.READ_CONTACTS},1);
		}
	} else {
		Toast.makeText(this, "agreed", Toast.LENGTH_SHORT).show();
		readContacts();
	}

	
	//第五.重写请求授权的回调方法
    @Override
    public void onRequestPermissionsResult(int requestCode,
                                           String permissions[], int[] grantResults) {
        switch (requestCode) {
            case 1: {
                if (grantResults.length > 0
                        && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
					
					//用户允许改权限，0表示允许，-1表示拒绝 PERMISSION_GRANTED = 0， PERMISSION_DENIED = -1
                    Toast.makeText(this, "allow", Toast.LENGTH_SHORT).show();
                    readContacts();
                } else {
                    Toast.makeText(this, "deny", Toast.LENGTH_SHORT).show();
                }
                return;
            }
        }

        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    }

 

创建自己的内容提供器

实现跨程序数据共享

 

新建一个类去继承 ContentProvider 的方式来创建一个自己的内容提供器。

ContentProvider 类中有六个抽象方法，我们在使用子类继承它的时候，需要将这六个方法全部重写。

public static final int TABLE1_DIR = 0;
	public static final int TABLE1_ITEM = 1;
	private static UriMatcher uriMatcher;
	
	static {
		uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
		uriMatcher.addURI("com.example.app.provider", "table1", TABLE1_DIR);
		uriMatcher.addURI("com.example.app.provider ", "table1/#", TABLE1_ITEM);
	}

 

getType()方法。它是所有的内容提供器都必须提供的一个方法，用于获取 Uri 对象所对应的 MIME 类型。一个内容 URI 所对应的 MIME

字符串主要由三部分组分，Android 对这三个部分做了如下格式规定。

1. 必须以 vnd 开头。

2. 如果内容 URI 以路径结尾，则后接 android.cursor.dir/，如果内容 URI 以 id 结尾，则后接 android.cursor.item/。

3. 最后接上 vnd.<authority>.<path>。

 

所以，对于 content://com.example.app.provider/table1 这个内容 URI，它所对应的 MIME类型就可以写成：

vnd.android.cursor.dir/vnd.com.example.app.provider.table1

对于 content://com.example.app.provider/table1/1 这个内容 URI，它所对应的 MIME 类型就可以写成：

vnd.android.cursor.item/vnd. com.example.app.provider.table1