本节书摘来自异步社区《Android开发进阶：从小工到专家》一书中的第1章，第1.4节ContentProvider（外共享数据），作者 何红辉，更多章节内容可以访问云栖社区“异步社区”公众号查看

1.4　ContentProvider（外共享数据）

ContentProvider在android中的作用是对外共享数据，也就是说可以通过ContentProvider把应用中的数据共享给其他应用访问，其他应用可以通过ContentProvider对应用中的数据进行添、删、改、查。使用ContentProvider对外共享数据的好处是，统一了数据的访问方式，它实际上是对SQliteOpenHelper的进一步封装，通过Uri映射来判断选择需要操作数据库中的哪个表，并且进行增、删、改、查处理。

首先我们先来学习Uri，Uri代表了要操作的数据表的绝对路径，Uri主要包含了两部分信息，一是需要操作的ContentProvider，二是对ContentProvider中的哪个表进行操作。对于ContentProvider来说，一个Uri由以下几部分组成，如图1-18所示。

ContentProvider的scheme已经由Android固定设置为content://,Authority用于唯一标识这个ContentProvider，外部调用者可以根据这个标识来找到它。这里的path就是要操作的数据库表，最后的id关键字是可选字段，例如，我们要操作特定的数据项时就会指定一个查询条件，如所有联系人的Uri：content://contacts/people，某个联系人的Uri: content://contacts/people/5，这个5就是联系人的id，也就对应了这里的查询关键字。

如果要把一个字符串转换成Uri，可以使用Uri类中的parse()函数，如下：

Uri uri = Uri.parse("content://contacts /people");

Android系统根据Uri来定位注册到系统的ContentProvider中，找到ContentProvider之后会通过ContentResolver来操作对应的数据库。实现ContentProvider的第一步就是需要覆写ContentProvider的insert、query、upate、delete、getType函数。下面我们要创建一个ContentProvider，该ContentProvider存储了一些服务行业人员的电话信息，如一些系统中就存储了快递人员、肯德基订餐电话等信息。我们要做的就是实现类似的功能，首先定义一个ContentProvider，代码如下：

public class UserInfoProvider extends ContentProvider {    private static final String CONTENT = "content://";    public static final String AUTHORIY = "com.book.jtm.info";    /**     * 该ContentProvider所返回的数据类型定义、数据集合     */    public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd." + AUTHORIY;    /**     * 单项数据     */    public static final String CONTENT_TYPE_ITEM = "vnd.android.cursor.item/vnd." + AUTHORIY;    /**     * 数据集合操作时的Uri     */    public static final Uri POSTCODE_URI = Uri.parse(CONTENT + AUTHORIY + "/" +       UserInfoDbHelper.TABLE_USER_INFO);    /**     * 数据集合操作时的Uri     */    public static final Uri COMPANY_URI = Uri.parse(CONTENT + AUTHORIY + "/" +       UserInfoDbHelper.TABLE_COMPANY);    private SQLiteDatabase mDatabase;    static final int USER_INFOS = 1;    static final int USER_INFO_ITEM = 2;    static final int COMPANY = 3;    static final int COMPANY_ITEM = 4;    static UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);    static {        uriMatcher.addURI(AUTHORIY, "userinfo", USER_INFOS);        uriMatcher.addURI(AUTHORIY, "userinfo/*", USER_INFO_ITEM);        uriMatcher.addURI(AUTHORIY, "company", COMPANY);        uriMatcher.addURI(AUTHORIY, "company/#",COMPANY_ITEM);    }    @Override    public String getType(Uri uri) {        switch (uriMatcher.match(uri)) {            case USER_INFOS:            case COMPANY:                return CONTENT_TYPE;            case USER_INFO_ITEM:            case  COMPANY_ITEM:                return CONTENT_TYPE_ITEM;            default:                throw new RuntimeException("错误的Uri");        }    }    // 删除、更新的代码省略}

我们需要在ContentProvider中根据Uri建立关系映射，通过UriMatcher管理不同Uri对应的Type类型，这个类型会在getType中被返回。当在ContentProvider中进行增、删、改、查操作时，就会根据这个类型选择对应的数据表。在这个例子中，我们通过UriMatcher映射了4种Uri类型， Uri 的格式主要有两种，以表名结尾就表示期望访问该表中所有的数据，以id结尾就表示期望访问该表中拥有相应 id 的数据。我们可以使用通配符的方式来分别匹配这两种格式的内容Uri，“*”表示匹配任意长度的任意字符，“#”表示匹配任意长度的数字。因此，content://com.book.jtm.info /userinfo表示要查询userinfo表中的所有数据，而content://com.book.jtm.info /userinfo/#表示要根据一个数字id查询一个用户。

下面我们就完成数据库操作的相关代码：

@Override    public boolean onCreate() {        mDatabase = new UserInfoDbHelper(getContext()).getWritableDatabase();        return true;    }    @Override    public Uri insert(Uri uri, ContentValues values) {        long newId = 0 ;        Uri newUri = null;        switch (uriMatcher.match(uri)) {            case USER_INFOS:                newId =  mDatabase.insert(UserInfoDbHelper.TABLE_USER_INFO, null, values);                newUri = Uri.parse(CONTENT + AUTHORIY + "/"                        + UserInfoDbHelper.TABLE_USER_INFO + "/" + newId);                break;            case COMPANY:               newId = mDatabase.insert(UserInfoDbHelper.TABLE_COMPANY, null, values);                newUri = Uri.parse(CONTENT + AUTHORIY + "/"                        + UserInfoDbHelper.TABLE_COMPANY + "/" + newId);                break;        }        if (newId > 0) {            return newUri;        }        throw new IllegalArgumentException("Failed to insert row into" + uri);    }    @Override    public Cursor query(Uri uri, String[] projection, String selection, String[]       selectionArgs, String sortOrder) {        Cursor cursor = null;        switch (uriMatcher.match(uri)) {            case USER_INFOS:                cursor = mDatabase.query(UserInfoDbHelper.TABLE_USER_INFO, projection,                        selection, selectionArgs, null, null, sortOrder);                break;            case USER_INFO_ITEM:                String tel = uri.getPathSegments().get(1);                cursor = mDatabase.query(UserInfoDbHelper.TABLE_USER_INFO, projection,                        "tel_num = ?", new String[]{tel}, null, null, sortOrder);                break;            case COMPANY:                cursor = mDatabase.query(UserInfoDbHelper.TABLE_COMPANY, projection,                        selection, selectionArgs, null, null, sortOrder);                break;            case COMPANY_ITEM:                String cid = uri.getPathSegments().get(1);                cursor = mDatabase.query(UserInfoDbHelper.TABLE_COMPANY, projection,                        "id = ?", new String[]{cid}, null, null, sortOrder);                break;        }        return cursor;    }

// 删除、更新的代码省略

上述代码中，我们把传递进来的Uri通过UriMatcher进行解析，得到type之后，再根据type来判断要操作哪个表，根据它的数据类型是所有数据还是单个数据，然后执行对应的数据库操作。对数据库的操作通过UserInfoDbHelper类实现。代码如下：

public class UserInfoDbHelper extends SQLiteOpenHelper {    private static final String DB_NAME = "userinfo.db";    private static final int DB_VERSION = 1;    public static final String TABLE_USER_INFO = "userinfo";    public static final String TABLE_COMPANY = "company";    public static final String TEL_COLUMN = "tel_num";    public static final String DESC_COLUMN = "desc";    public static final String COMP_ID_COLUMN = "comp_id";    public static final String ID_COLUMN = "id";    public static final String BUSINESS_COLUMN = "business";    public static final String ADDR_COLUMN = "addr";    private static final String POSTCODE_TABLE_SQL = "CREATE TABLE " + TABLE_USER_INFO + "   ("            + TEL_COLUMN + " TEXT ,"            + COMP_ID_COLUMN + " TEXT  , "            + DESC_COLUMN + " TEXT "            + ")";    private static final String COMPANY_TABLE_SQL = "CREATE TABLE " + TABLE_COMPANY + " ("            + ID_COLUMN + " TEXT PRIMARY KEY , "            + BUSINESS_COLUMN + " TEXT , "            + ADDR_COLUMN + " TEXT"            +  ")";    public UserInfoDbHelper(Context context) {        super(context, DB_NAME, null, DB_VERSION);    }    @Override    public void onCreate(SQLiteDatabase db) {        db.execSQL(POSTCODE_TABLE_SQL);        db.execSQL(COMPANY_TABLE_SQL);    }    @Override    public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {    }}

在UserInfoDbHelper中我们建立了两个表，分别为userinfo和company，表结构表1-2和表1-3所示。

完成ContentProvider代码之后，第二步需要在AndroidManifest.xml中使用对该ContentProvider进行配置，为了能让其他应用找到该ContentProvider ，ContentProvider采用了authorities对它进行唯一标识，示例如下：

此时，我们就可以使用该ContentProvider了。

我们新建一个ProviderActivity，在该Activity中存储、查询用户信息，代码如下所示：

public class ProviderActivity extends Activity {    EditText mUserDescEdittext;     // 用户描述信息    EditText mUserTelEdittext;      // 电话号码    EditText mUserCompIdEdittext ;  // 用户所属的公司id    Button mSubmitBtn;              // 提交按钮    EditText mCompIdEdittext;       // 公司id    EditText mCompBusinessEdittext; // 公司业务    EditText mCompAddrEdittext;     // 公司地址    Button mCompSubmitBtn;          // 提交按钮    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_provider);        initWidgets();    }    private void initWidgets() {        // 用户信息相关的View        mUserDescEdittext = (EditText) findViewById(R.id.desc_edit);        mUserTelEdittext = (EditText) findViewById(R.id.tel_edit);        mUserCompIdEdittext = (EditText) findViewById(R.id.comp_edit);        mSubmitBtn = (Button) findViewById(R.id.submit_btn);        mSubmitBtn.setOnClickListener(new View.OnClickListener() {            @Override            public void onClick(View view) {                saveUserInfoRecord();                mSubmitBtn.postDelayed(new Runnable() {                    @Override                    public void run() {                        queryPostCode();                    }                }, 1000) ;            }        });        // 公司信息相关的View        mCompAddrEdittext = (EditText) findViewById(R.id.comp_addr_edit);        mCompIdEdittext = (EditText) findViewById(R.id.comp_id_edit);        mCompBusinessEdittext = (EditText) findViewById(R.id.comp_business_edit);        mCompSubmitBtn = (Button) findViewById(R.id.submit_comp_btn);        mCompSubmitBtn.setOnClickListener(new View.OnClickListener() {            @Override            public void onClick(View view) {                saveCompanyRecord();            }        });    }    /**     * 存储用户信息到ContentProvider     */    private void saveUserInfoRecord() {        ContentValues newRecord = new ContentValues();        newRecord.put(UserInfoDbHelper.DESC_COLUMN,             mUserDescEdittext.getText().toString());        newRecord.put(UserInfoDbHelper.TEL_COLUMN,             mUserTelEdittext.getText().toString());        newRecord.put(UserInfoDbHelper.COMP_ID_COLUMN,             mCompIdEdittext.getText().toString());        getContentResolver().insert(UserInfoProvider.USERINFO_URI, newRecord);    }    /**     * 存储公司信息到ContentProvider中     */    private void saveCompanyRecord() {        ContentValues newRecord = new ContentValues();        newRecord.put(UserInfoDbHelper.ADDR_COLUMN,             mCompAddrEdittext.getText().toString());        newRecord.put(UserInfoDbHelper.BUSINESS_COLUMN,             mCompBusinessEdittext.getText().toString());        newRecord.put(UserInfoDbHelper.ID_COLUMN, mCompIdEdittext.getText().toString());        getContentResolver().insert(UserInfoProvider.COMPANY_URI, newRecord);    }    /**     * 通过电话号码查询相关信息     */    private void queryPostCode() {        Uri queryUri = Uri.parse("content://com.book.jtm.info/userinfo/123456");        Cursor cursor = getContentResolver().query(queryUri, null, null, null, null);        if (cursor.moveToFirst()) {            Toast.makeText(this, "电话来自 : "             + cursor.getString(2), Toast.LENGTH_SHORT).show();        }    }}

上述Activity中我们可以将用户信息和公司信息根据不同的Uri插入到同一个ContentProvider中，UserInfoProvider会根据Uri选择对应的表进行插入，查询也是同样的道理。首先我们插入一条用户数据，该用户的电话为123456，描述为顺风快递员吴老二，公司id为11，插入之后我们可通过电话号码123456到ContentProvider中查询该用户的信息，此时就会得到该用户的描述信息，如图1-19所示。

然后我们再插入该公司的信息，此时该ConentProvider的数据库中就有了数据，我们将数据库导出到PC中，结果如图1-20和图1-21所示。

正如本章前文所说，ContentProvider不过是对SQLiteOpenHelper的二次封装，通过UriMatcher将数据库中的表与Uri建立关联，当用户通过Uri操作ContentProvider时，ContentProvider会根据Uri选择对应的数据库表进行增、删、改、查操作。通过ContentProvider机制，使得数据可以在各应用之间共享，并且为用户提供了统一的API接口，降低了用户的使用成本。