Android内容提供器（Content Provider）

内容提供器（Content Provider）主要用于在不同的应用程序之间实现数据共享的功能，它提 供了一套完整的机制，允许一个程序访问另一个程序中的数据，同时还能保证被访数据的安全性。目前，使用内容提供器是 Android 实现跨程序共享数据的标准方式。

运行时权限（打电话为例）

1、AndroidManifest.xml文件添加如下代码

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

2、申请运行时权限逻辑代码

// 点击时申请权限
if (ContextCompat.checkSelfPermission(MainActivity.this, Manifest. permission.CALL_PHONE) != PackageManager.PERMISSION_GRANTED) { 
   	ActivityCompat.requestPermissions(MainActivity.this, new String[]{ Manifest.permission.CALL_PHONE }, 1);
} else { 
	call();
}


// call()方法代码
private void call() { 
	try {
		Intent intent = new Intent(Intent.ACTION_CALL); intent.setData(Uri.parse("tel:10086")); startActivity(intent);
	} catch (SecurityException e) {
	 	e.printStackTrace();
	}
}


// 重写权限请求回调
@Override 
public void onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults) { 
	switch (requestCode) { 
		case 1: 
			if (grantResults.length > 0 && grantResults[0] == PackageManager. PERMISSION_GRANTED) { 
				call();
			} else { 
				Toast.makeText(this, "You denied the permission", Toast.LENGTH_ SHORT).show();
			} 
		break;
		default: 
	}
}

内容提供器

内容提供器的用法一般有两种，一种是使用现有的内容提供器来读取和操作相应程序中的数据，另一种是创建自己的内容提供器给我们程序的数据提供外部访问接口

1、读取和操作相应程序中的数据

如果想要访问内容提供器中共享的数据，就一定要借助 ContentResolver类，可以通过 Context 中的 getContentResolver()方法获取到该类的实例。ContentResolver中提供了一系列的方法用于对数据进行 CRUD操作，其中insert()方法用于添加数据，update()方法用于更新数据，delete()方法用于删除数据，query()方法用于查询数据。
ContentResolver中的增删改查方法都是不接收表名参数的，而是使 用一个 Uri 参数代替，这个参数被称为内容 URI
内容 URI给内容提供器中的数据建立了唯一 标识符，它主要由两部分组成：authority和 path。
authority是用于对不同的应用程序做区分的， 一般为了避免冲突，都会采用程序包名的方式来进行命名。
path则是用于对同一 应用程序中不同的表做区分的，通常都会添加到authority的后面。内容 URI最标准的格式写法如下：
content://com.example.app.provider/table1
content://com.example.app.provider/table2

内容 URI字符串，我们还需要将它解析成 Uri 对象才可以作为参数传入。解析的方法也相当简单，代码如下所示：
Uri uri = Uri.parse("content://com.example.app.provider/table1")

• 查询query

/*
uri 			from table_name				指定查询某个应用程序下的某一张表
projection 		select column1, column2 	指定查询的列名
selection		where column = value   		指定where的约束条件
selectionArgs 	-							为where中的占位符提供具体的值
sortOrder		order by column1, column2	指定查询结果的排序方式

查询完成后返回的仍然是一个 Cursor 对象
*/
Cursor cursor = getContentResolver().query( 
   					 uri, 
   					 projection, 
   					 selection, 
   					 selectionArgs,
   					 sortOrder);

• 插入insert

ContentValues values = new ContentValues(); 
values.put("column1", "text"); 
values.put("column2", 1);
getContentResolver().insert(uri, values);

• 更新update

ContentValues values = new ContentValues(); 
values.put("column1", ""); 
getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new String[] {"text", "1"});

• 删除delete

getContentResolver().delete(uri, "column2 = ?", new String[] { "1" });

读取手机联系人示例

1、AndroidManifest.xml 文件添加
<uses-permission android:name="android.permission.READ_CONTACTS" />
2、 逻辑代码

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: 
		}
	}
}

2、创建自己的内容提供器

如果想要实现跨程序共享数据的功能，官方推荐的方式就是使用内容提供器，可以通过新建一个类去继承 ContentProvider的方式来创建一个自己的内容提供器。ContentProvider 类中有 6 个抽象方法，我们在使用子类继承它的时候，需要将这 6 个方法全部重写.

/*
 onCreate() 初始化内容提供器的时候调用。
 通常会在这里完成对数据库的创建和升级等操作，返回 true
 表示内容提供器初始化成功，返回 false 则表示失败。
*/
@Override 
public boolean onCreate() { 
	return false;
}

/*
 query() 从内容提供器中查询数据
*/
@Override 
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { 
	return null;
}
/*
 insert() 向内容提供器中添加一条数据
*/
@Override 
public Uri insert(Uri uri, ContentValues values) { 
	return null;
}
/*
update() 更新内容提供器中已有的数据
*/
@Override 
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { 
	return 0;
}
/*
delete() 从内容提供器中删除数据
*/
@Override 
public int delete(Uri uri, String selection, String[] selectionArgs) { 
	return 0;
}
/*
getType() 根据传入的内容 URI来返回相应的MIME类型。
*/
@Override 
public String getType(Uri uri) { 
	return null;
}

每一个方法都会带有 Uri这个参数，这个参数也正是调用 ContentResolver 的增删改查方法时传递过来的。
内容 URI 的格式主要就只有以上两种，以路径结尾就表示期望访问该表中所有的数据，以 id结尾就表示期望访问该表中拥有相应 id的数据。我们可以使用通配符的方式来分别匹配这两种格式的内容URI，规则如下。
*：表示匹配任意长度的任意字符。
#：表示匹配任意长度的数字。

UriMatcher 这个类就可以轻松地实现匹配内容URI的功能。UriMatcher 中提供了一个 addURI()方法，这个方法接收 3个参数，可以分别把 authority、path和一个自 定义代码传进去。这样，当调用 UriMatcher的 match()方法时，就可以将一个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; 
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); 
	uriMatcher.addURI("com.example.app.provider ", "table2", TABLE2_DIR);
	uriMatcher.addURI("com.example.app.provider ", "table2/#", TABLE2_ITEM);
}

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;
		default: break;
	}
}

getType()方法
它是所有的内容提供器都必须 提供的一个方法，用于获取 Uri 对象所对应的 MIME类型。一个内容 URI所对应的 MIME字符 串主要由 3部分组成，Android对这 3个部分做了如下格式规定。
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

最后在AndroidManifest.xml中声明自定义内容提供器

<application 
	android:allowBackup="true" 
	android:icon="@mipmap/ic_launcher" 
	android:label="@string/app_name" 
	android:supportsRtl="true" 
	android:theme="@style/AppTheme">
	 ... 
	 <provider android:name=".DatabaseProvider" 
		 android:authorities="com.example.databasetest.provider" 
		 android:enabled="true" 
		 android:exported="true">
	</provider>
</application>