Android进阶#（1/12）Android的构成基石——四大组件_ContentProvider（外共享数据）

（1/12）Android的构成基石——四大组件_ContentProvider（外共享数据）

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

这里首先学一下Uri。
Uri代表了要操作数据表的绝对路径。
Uri主要包含了2部分信息：一个是需要操作的ContentProvider；二是对ContentProvider中的哪个表进行操作。
对于ContentProvider来说，一个Uri由以下几部分组成：





scheme 已经由Android 固定设置为 content：//
authority 用于唯一标识这个ContentProvider，外部调用者可根据这个标识来找到它
path就是要操作的数据库表
id关键字是可选字段
要把一个字符串转换成Uri，可以使用Uri类中的parse（）函数：
Uri uri = Uri.parse（“content://contacts/people"）;
Android系统根据Uri来定位注册到系统的ContentProvider中，找到ContentProvider之后会通过ContentProvider来操作对应的数据库。
实现ContentProvider的第一步：重写 ContentProvider的 insert、query、delete、getType函数。
以下创建一个ContentProvider，它存储了一些服务行业人员的电话信息。
首先定义一个ContentProvider，代码如下：

import android.support.annotation.Nullable;

/**
* Created by Administrator on 2017/8/23.
*/

public class UserInfoProvider extends ContentProvider {
private static final String CONTENT = "content://";
private static final String AUTHORITY = "com.book.jtm.info";

/**
* 该ContentProvider所返回的数据类型定义、数据集合；
* @return
*/
public static final String CONTENT_TYPE = "vnd.android.cursor.dir/vnd."+AUTHORITY;

/**
* 单项数据
* @return
*/
public static final String CONTENT_TYPE_ITEM = "vnd.android.cursor.item/vnd."+AUTHORITY;

/**
* 数据集合操作时的Uri
*
* @return
*/
public static final String POSTCODE_URI = Uri.parse(CONTENT + AUTHORITY + "/" + UserInfoDbHelper.TABLE_USER_INFO);

/**
* 数据集合操作时的 Uri
* @return
*/
public static final Uri COMPANY_URI = Uri.parse(CONTENT+AUTHORITY+"/"+UserInfoDbHelper.TABLE_COMPANY);

private SQLiteDatabase mDatabase;
static final int USER_INFOS = 1;
static final int USER_INFO_TIME = 2;
static final int COMPANY = 3 ;
static final int COMPANY_ITEM = 4;

static UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);

static {
uriMatcher.addURI(AUTHORITY,"userinfo",USER_INFOS);
uriMatcher.addURI(AUTHORITY,"userinfo/*",USER_INFO_TIME);
uriMatcher.addURI(AUTHORITY,"company",COMPANY);
uriMatcher.addURI(AUTHORITY,"company/#",COMPANY_ITEM);

}
@Override
public boolean onCreate() {
return false;
}

@Nullable
@Override
public Cursor query(@NonNull Uri uri, @Nullable String[] projection, @Nullable String selection, @Nullable String[] selectionArgs, @Nullable String sortOrder) {
return null;
}

@Nullable
@Override
public String getType( Uri uri) {
switch (uriMatcher.match(uri)){
case USER_INFOS:
case COMPANY:
return CONTENT_TYPE;
case USER_INFO_TIME:
case COMPANY_ITEM:
return CONTENT_TYPE_ITEM;
default:
throw new RuntimeException("错误的指令") ;
}
}

/***
* 删除、更新的代码
* @param uri
* @param values
* @return
*/

@Nullable
@Override
public Uri insert(@NonNull Uri uri, @Nullable ContentValues values) {
return null;
}

@Override
public int delete(@NonNull Uri uri, @Nullable String selection, @Nullable String[] selectionArgs) {
return 0;
}

@Override
public int update(@NonNull Uri uri, @Nullable ContentValues values, @Nullable String selection, @Nullable String[] selectionArgs) {
return 0;
}
}

我们需要在 ContentProvider 中根据 Uri 建立关系映射，通过 UriMatcher 管理不同Uri 对应的 Type 类型。这个类型还在 getType中被返回。

当ContentProvider 中进行 增、删、改、查 操作时，就会根据这个类型选择对应的数据表。

在这里
—— “ * ” 表示匹配任意长度的任意字符。
—— “ # ”表示匹配任意长度的数字。

因此：
—— content://com.book.jtm.info/userinfo/* 表示要查询userinfo表中的所有数据
—— content://com.book.jtm.info/userinfo/#表示要根据一个数字id查询一个用户

下面是完成数据库操作的相关代码：

4000
/**
* 完成对数据库的操作
* @return
*/
@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.matche(uri)){
case USER_INFOS:
newId = mDatabase.insert(UserInfoDbHelper.TABLE_USER_INFO, null ,values);
newUri = Uri.parse(CONTENT+AUTHORITY+"/"+UserInfoDbHelper.TABLE_USER_INFO+"/"+newId);
break;
case COMPANY:
newId = mDatabase.insert(UserInfoDbHelper.TABLE_COMPANY,null,values);
newUri = Uri.parse(CONTENT+AUTHORITY+"/"+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_TIME:
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类实现：

package com.example.administrator.myapplication;

import android.content.Context;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteOpenHelper;

import java.security.Provider;
import java.security.SecureRandom;

/**
* Created by Administrator on 2017/8/23.
*/

public class UserInfoDbHelper extends SQLiteOpenHelper {

public static final String TABLE_USER_INFO = "userinfo";
public static final String TABLE_COMPANY = "company";
public static final String DB_NAME = "userinfo.db";
public static final int DB_VERSION = 1 ;

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);

}

public UserInfoDbHelper(Context context, String name, SQLiteDatabase.CursorFactory factory, int version) {
super(context, name, factory, version);
}

@Override
public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) {

}
}

在 UserInfoDbHelper中建立了两个表，分别为 userInfo 和company：



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

<?xml version="1.0" encoding="utf-8"?>

此时，我们就可使用该 ContentProvider 了。
新建一个ProviderActivity，在该Activity中 存储。查询用户信息，代码如下：

package com.example.administrator.myapplication;

import android.app.Activity;
import android.content.ContentValues;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;

public class ProviderActivity extends Activity {
EditText mUserDescEdittext;
EditText mUserTelEdittext;
EditText mUserCompIdEdittext;
Button mSubmitBtn;

EditText mCompIdEdittext;
EditText mCompBusinessEdittext;
EditText mComAddrEdittext;
Button mCompSubmitBtn;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_provider);
initWidgets();
}
private void initWidgets(){
//用户信息相关的View
mUserCompIdEdittext = (EditText) findViewById(R.id.comp_edit);
mUserDescEdittext = (EditText) findViewById(R.id.desc_edit);
mUserTelEdittext = (EditText) findViewById(R.id.tel_edit);
mSubmitBtn = (Button) findViewById(R.id.submit_btn);

mSubmitBtn.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
saveUserInfoRecord();
mSubmitBtn.postDelayed(new Runnable() {
@Override
public void run() {
queryPostCode();
}
},1000);

}
});
//公司信息相关的View
mComAddrEdittext = (EditText) findViewById(R.id.comp_addr_edit);
mCompBusinessEdittext = (EditText) findViewById(R.id.comp_business_edit);
mCompIdEdittext = (EditText) findViewById(R.id.comp_id_edit);

mCompSubmitBtn = (Button) findViewById(R.id.submit_comp_btn);
mCompSubmitBtn.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
saveCompInfoRecord();
}
});
}

/**
* 存储公司信息到ContentProvider
*/

private void saveCompInfoRecord() {
ContentValues newRecord = new ContentValues();
newRecord.put(UserInfoDbHelper.ADDR_COLUMN,mComAddrEdittext.getText().toString());
newRecord.put(UserInfoDbHelper.BUSINESS_COLUMN,mCompBusinessEdittext.getText().toString());
newRecord.put(UserInfoDbHelper.ID_COLUMN,mCompIdEdittext.getText().toString());
getContentResolver().insert(UserInfoProvider.COMPANY_URI,newRecord);

}

/**
* 存储用户信息到ContentProvider
*/

private void queryPostCode() {
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,mUserCompIdEdittext.getText().toString());
getContentResolver().insert(UserInfoProvider.USERINFO_URI,newRecord);
}

/**
* 通过电话号码查询相关信息
*/

private void saveUserInfoRecord() {
}
}

上述Activity中我们可以将用户信息和公司信息根据不同的 Uri 插入到同一个ContentProvider中，UserInfoProvider会根据Uri选择对应的表进行插入。查询也是同样的道理。

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