Android
Content Provider Guides

　　Content Providers管理对结构化数据集的访问。它们包装数据，并且提供一种定义数据安全的机制。

　　Content providers是不同进程间数据连接的标准接口。

　　要获取content
provider中的数据，需要运用你的应用中的 Context中的ContentResolver对象作为一个client来和provider交互。

　　这个provider对象是一个实现了ContentProvider接口的类的对象。Provider对象从clients那里获取数据请求，执行请求的动作，然后返回结果。

　　如果你不想和其他的应用分享数据，你就不必开发自己的provider，但是，如果你需要在应用中提供自定义的搜索建议，或者你需要从你的应用复制粘贴复杂的数据和文件到其他的应用，你还是需要开发自己的provider。

　　Android系统包含了管理各种数据的content
provider，可管理的数据包括音频、视频、图像、个人通讯信息等。可以看看这个包： android.provider。在一些限制条件下，这些providers是可以被任何Android应用访问的。

Content Provider
Basics

　　Content
Provider管理对中央数据库的访问，是Android应用的一部分，经常会提供一些UI来操作数据。

　　然而，content
providers主要是用来被其他应用使用的，其他应用通过一个client对象来访问provider。

　　providers和provider
clients一起，提供了持续、标准的接口来访问数据，其中还包含了一些跨进程通信和数据访问安全相关的东西。

　　Content
provider向外部应用呈现数据的方式像关系型数据库中的表(但是底层实现并不一定要求是数据库)。

　　provider没有要求必须有主键，也没有要求必须有一列叫_ID，然而，如果想要绑定数据到ListView中，就得有一列叫_ID。

访问provider

　　一个应用想要访问content provider中的数据，需要通过一个 ContentResolver客户端对象。

　　这个客户端对象中有一些方法会调用provider对象中的同名方法。

　　provider对象是 ContentProvider的实现类的实例。 

　　ContentResolver中的方法提供了基本的“CRUD”(create, retrieve, update, and
delete)数据操作。

　　ContentResolver 对象在客户端应用的进程中， ContentProvider对象在拥有provider的应用中，它们会自动处理跨进程通信。 ContentProvider 也是一个抽象层，处在数据仓库(底层)和数据表(外部表现)之间。

　　为了访问provider，应用通常需要声明一些权限，见 Content
Provider Permissions。

Content
URI

　　Content
URI中包含了provider的符号名(authority)和一个指向数据表的路径名(path)。

　　当你调用客户端方法来访问provider中的表的时候，参数中会需要一个content
URI。

　　ContentResolver对象会解析URI的authority，使用它和系统已知的providers的表做对比，来resolve出provider。

　　之后 ContentResolver就可以把查询的参数分发给正确的provider了。

　　ContentResolver会使用content
URI的path来选择要访问的table，一个provider通常会为每一个table提供一个path。

　　比如：

　　content://user_dictionary/words

　　user_dictionary是authority，words是table的path。

　　content://
(the scheme)说明这个字符串是一个content URI。

　　很多providers会允许在URI后面加上ID值来访问table中的行。

　　一些有用的类：Uri Uri.Builder ContentUris

Retrieving Data
from the Provider

　　数据查询操作通常需要在一个非UI的线程异步执行，可以参考Loaders
guide。

　　从一个provider中查询数据，通常需要两步：

　　1.获取这个provider的读权限；

　　2.定义好向这个provider查询语句。

　　官方Guides里写了例子，还讲了防SQL注入等相关的考虑。

/*

 * This defines a one-element String array to contain the selection argument.

 */

String[] mSelectionArgs = {""};

// Gets a word from the UI

mSearchString = mSearchWord.getText().toString();
// Remember to insert code here to check for invalid or malicious input.
// If the word is the empty string, gets everything

if (TextUtils.isEmpty(mSearchString)) {

    // Setting the selection clause to null will return all words

    mSelectionClause = null;

    mSelectionArgs[0] = "";
} else {

    // Constructs a selection clause that matches the word that the user entered.

    mSelectionClause = UserDictionary.Words.WORD + " = ?";
// Moves the user‘s input string to the selection arguments.

    mSelectionArgs[0] = mSearchString;
}
// Does a query against the table and returns a Cursor object

mCursor = getContentResolver().query(

    UserDictionary.Words.CONTENT_URI,  // The content URI of the words table

    mProjection,                       // The columns to return for each row

    mSelectionClause                   // Either null, or the word the user entered

    mSelectionArgs,                    // Either empty, or the string the user entered

    mSortOrder);                       // The sort order for the returned rows
// Some providers return null if an error occurs, others throw an exception

if (null == mCursor) {

    /*

     * Insert code here to handle the error. Be sure not to use the cursor! You may want to

     * call android.util.Log.e() to log this error.

     *

     */

// If the Cursor is empty, the provider found no matches

} else if (mCursor.getCount() < 1) {
/*

     * Insert code here to notify the user that the search was unsuccessful. This isn‘t necessarily

     * an error. You may want to offer the user the option to insert a new row, or re-type the

     * search term.

     */
} else {

    // Insert code here to do something with the results
}

Displaying query
results

　　查询的结果是一个 Cursor ，包含了满足查询条件的行，projection所指定的列。

　　如果没有满足条件的行，会返回一个空Cursor( Cursor.getCount() 为0)。

　　如果查询时发生了内部错误，根据具体provider，结果会有所不同，有可能会返回null，或者有可能会抛出异常。

　　Cursor对象提供对其包含行列的随机访问。

　　使用Cursor中的方法，你可以遍历结果中的行，得到每一列的数据类型，得到某一列数据，查看结果的其他属性等等。

　　一些 Cursor的实现类会在provider数据变化时自动更新数据，或者在Cursor改变时激发一些观察者方法，或这两都有。

　　展示查询数据可以用 CursorAdapter或用SimpleCursorAdapter绑定到ListView中去。

　　要绑定Cursor数据到ListView中，cursor必须包含一列叫_ID。

Inserting,
Updating, and Deleting Data

Insert

　　插入数据用 ContentResolver.insert()：这个方法会返回新插入的行的URI，比如：content://user_dictionary/words/<id_value>

　　数据是放在ContentValues类的对象中，_ID列是provider自动维护的不需要自己写，providers通常会将_ID作为主键。

　　为了从URI中获取id，可以调用 ContentUris.parseId()方法。

Update

　　Update的时候，首先根据选择条件进行查询，然后对其中的值进行更改，和插入一样，采用ContentValues对象。

　　采用的方法是 ContentResolver.update()。

Delete

　　删除和查询差不多，设置选择条件，然后找到要删除的行，客户端方法会返回删除的行的个数。

　　删除用的方法是 ContentResolver.delete()。

　　更新和删除的时候都要注意是否有用户的恶意操作，参见：Protecting
against malicious input.。

参考资料

　　API Guides: Content Providers

　　http://developer.android.com/guide/topics/providers/content-providers.html

　　Content Provider Basics

　　http://developer.android.com/guide/topics/providers/content-provider-basics.html

Android Content Provider Guides