前言
数据库是Android开发中最基本的数据保存方式,但由于数据库的私有性,我们无法对外提供或获取信息,当两个应用需要实现数据共享时,此时就需要本篇文章的主题——ContentProvider
1、Uri基础
在使用ContentProvider之前,先介绍下Uri基础,Uri的对于开发者来说应该并不陌生,开发中使用Uri之处有很多,如:AppLink、FileProvider等,他们的作用相同都是定位资源位置,不同的是此处定义的是数据库中的信息;
- Uri的四个组成部分:content://contacts/people/5
- schema:已由Android固定设置为content://
- authority:ContentProvider权限,在AndroidMenifest中设置权限
- path:要操作的数据库表
- Id:查询的关键字(可选字段)
- Uri匹配模式
Uri的匹配表示要查询的数据,对于单个数据查询,可直接使用Uri定位具体的资源位置,但当范围查询时就需要结合通配符的使用,Uri提供以下两种通配符:
- *:匹配由任意长度的任何有效字符组成的字符串
- #:匹配由任意长度的数字字符组成的字符串
content://com.example.app.provider/table2/* //多数据查询
content://com.example.app.provider/table3/#
content://com.example.app.provider/table3/6 //单数据查询
复制代码
- Uri的转换
Uri uri = Uri.parse(“content://contacts/people/5")
复制代码
- Uri创建
//通过将 ID 值追加到 URI 末尾来访问表中的单个行
Uri singleUri = ContentUris.withAppendedId(UserDictionary.Words.CONTENT_URI,4);
复制代码
2、ContentProvider使用
ContentProvider一般配合数据库共同使用,实现对外共享数据的目的,所以它需要对数据库的增删改查操作,ContentProvider也为我们提供了相应的操作方法,使用时只需实现即可,下面按照使用步骤实现一个ContentProvider:
- 创建ContentProvider的子类,重写insert、update、query、delete、getType
- 添加UriMatcher 映射数据表
UriMatcher的作用是在使用Uri操作数据库时,根据发起请求的Uri和配置好的uriMatcher确定本次操作的数据表
static UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH)
Static{
uriMatcher.addURI(AUTHORIY,”userinfo”,1) //添加userinfo表映射
uriMatcher.addURI(AUTHORIY,”userinfo/*”,2) //*表示匹配任意长度任意字符
uriMatcher.addURI(AUTHORIY,”userinfo/#”,3) //#匹配任意长度的的数字
}
复制代码
- insert ():添加数据
public Uri insert(Uri uri,ContentValues contentValues){
long newId = 0;
Uri newUri = null;
switch (uriMatcher.match(uri)){
newId = dataBase.insert(…) //此处的newId表示插入数据的id
newUri = Uri.parse(content://authoriy/**table/newId)
}
return newUri;
}
复制代码
使用细节:
- dataBase添加后返回添加的id,此时使用withAppendedId ()和id创建添加的Uri
- insert()最终返回的是本次新添加数据的newUri
- 使用 ContentUris.parseId() 可以从newUri中获取本次添加数据的_ID
- query():查询方法
ContentProvider的查询和数据库查询一样,支持条件查询和多数据查询,返回结果为查询Cursor实例
//当查询整个数据表时. Uri.parse(”content://com.book.jtm/userinfo")
dataBase.query(….)
//当查询具体一个数据. Uri.parse(”content://com.book.jtm/userinfo/123456”)
String id = uri.getPathSegments().get(1)
//调价查询时
dataBase.query(table, projection,”tel_number = ?”,new String[]{id},null, null,sortOrder)
复制代码
- ContentObserver
提到ContentProvider的使用就会想到ContentObserver,这里一起介绍下ContentObserver,采用观察者模式在存储的数据发生修改时自动触发回调,使用起来也很简单创建ContentObserver的实例完成注册即可:
val contentObservable = object : ContentObserver(handler){
override fun onChange(selfChange: Boolean, uri: Uri?) {
super.onChange(selfChange, uri)
val cursor = contentResolver.query(uri, arrayOf("_id","name"),null,null,null)
if (cursor != null && cursor.moveToFirst()) {
do {
Log.e("========", cursor.getInt(cursor.getColumnIndex("_id")).toString())
Log.e("========", cursor.getString(cursor.getColumnIndex("name")).toString())
}while (cursor.moveToNext())
}
}
}
复制代码
当数据添加时自动查询所有数据:
3、MimeType理解和使用
3.1、简介
- 作用:用来标识当前所能打开的文件类型
- 使用场景:隐式启动Activity
- 在清单文件中配置隐式启动的action
<intent-filter>
<action android:name="com.alex.kotlin.job.JobScheduleActivity"/>
<category android:name="android.intent.category.DEFAULT"/>
<data android:mimeType="text/plain”/> //生明匹配的数据类型
</intent-filter>
复制代码
- 创建Intent实例配置启动Action并设置数据类型
val intent = Intent("com.alex.kotlin.job.JobScheduleActivity")
intent.type = "text/plain” // 设置数据库类型,只有与清单文件中设置的一致才能启动
startActivity(intent)
复制代码
3.2、ContentProvider中的MimeType
- ContentProvider根据操作的对象不同提供两种MimeType
- getType():必须实现的查询数据的类型
- getStreamTypes():对外提供文件时需要实现方法,根据查询的Uri返回匹配的类型数组
- Table MimeType系统提供两种类型:
- vnd.android.cursor.item/***:用于单个行操作的URI模式
- vnd.android.cursor.dir/***:用于多行操作的URI模式
- 文件MIME类型(例如程序对外提供 .jpg、.png、.gif 形式对外提供照片)
- 如果在获取时使用“image/*”过滤,则getStreamTypes()返回 数组 { "image/jpg", "image/png", "image/gif"}
- 如果获取时使用“/jpg”过滤,则返回数组{"image/jpg”}
- 如果获取时的Uri不匹配提供内容,则返回null
3.3、使用ContentProvider隐式启动上面的Activity
- 修改上面清单文件中的
<data android:mimeType="vnd.android.cursor.dir/test"/>
复制代码
- 修改ContentProvider的注册文件,设置匹配的意图
<provider
android:authorities="com.alex.kotlin.job.provider"
android:name=".Provider">
<intent-filter>
<category android:name="android.intent.category.DEFAULT" />
<data
android:host="com.alex.kotlin.job.provider"
android:pathPrefix="/path"
android:scheme="content" />
</intent-filter>
</provider>
复制代码
- 创建ContentProvider的实现类,并配置UriMatcher,在getType中根据Uri返回MimeType
usrSwitch.addURI(AUTHORITY, "path", 1)
const val data = "vnd.android.cursor.dir/test” //声明要返回的MIMEType类型
override fun getType(uri: Uri): String? {
when(usrSwitch.match(uri)){
1 -> { return data}
}
return null
}
复制代码
- 使用Uri访问,便会直接打开JobScheduleActivity
val intent = Intent("com.alex.kotlin.job.JobScheduleActivity”) //配置action
intent.data = Uri.parse("content://com.alex.kotlin.job.provider/path”) //设置Uri
startActivity(intent)
复制代码
有没有想过为什么可以启动活动呢?静态启动Activity的两个条件:必须匹配意图过滤的action和mimeType;
由上面的代码看出创建Intent时设置了意图过滤action,那么mimeType呢?其实在使用Uri.parse("content://com.alex.kotlin.job.provider/path”) 设置intent.data时会启动上面配置的ContentProvider,在ContentProvider返回Uri模式"vnd.android.cursor.dir/test”正好匹配清单中的data数据类型,所以会直接启动JobScheduleActivity
4、权限
- 指定其他应用访问提供程序的数据所必须具备权限的属性:
- android:grantUriPermssions:表示是否可以通过临时权限访问数据,默认为false,在开发中可以只对限定的内容提供临时权限,如照片的内容 URI 设置临时权限
//该属性的值决定可访问的提供程序范围,如果设置为true,系统会像整个系统授予临时权限,并替代其他设置的权限
android:grantUriPermissions=“true"
//设置为false,则需添加<grant-uri-permission>并表明可以授权临时权限所对应的URI
android:grantUriPermissions=“false"
<grant-uri-permission android:path=“string” // path表示绝对路径Uri
android:pathPattern=“string” // 表示限定完整的路径但可以使用./*通配符匹配
android:pathPrefix="string" /> //限定路径的初始部分后面可以变化,只要初始部分符合即可授权
复制代码
- android:permission:统一提供程序范围读取/写入权限
- android:readPermission:提供程序范围读取权限,优先于permission权限
- android:writePermission:提供程序范围写入权限,优先于permission权限
android:readPermission="com.alex.kotlin.job.provider.permission.READ_PERMISSION"
android:writePermission="com.alex.kotlin.job.provider.permission.WRITE_PERMISSION"
android:permission="com.alex.kotlin.job.provider.permission.PERMISSION"
复制代码
- 权限的使用
使用一个实例验证权限的使用,创建两个程序A和B,在程序A中使用ContentProvider保存数据,在程序B中进行查询,在开始A程序中不设置任何权限,B程序进行访问数据,系统直接报错:
报错原因也很直接,没有权限访问,此时是因为A程序中的Privider没有支持其他进程使用,修改A程序清单文件添加android:exported="true",再次访问数据访问成功: 从Log中可以看出获取的进程包为“baselibrary",而提供数据的包为“job.provider”,可见二者并不是同一个程序;- 添加读写权限
android:writePermission="com.alex.kotlin.job.provider.WRITE"
android:readPermission="com.alex.kotlin.job.provider.READ"
复制代码
在A程序的清单文件中,为Provider添加两个读写权限,添加完权限后再次在B程序中获取数据,还是会报错,也很正常因为已经对数据的访问设置了门槛,所以在B程序中声明读写权限即可:
<uses-permission android:name="com.alex.kotlin.job.provider.READ"/>
<uses-permission android:name="com.alex.kotlin.job.provider.WRITE"/>
复制代码
5、ContentProvider工作过程
- 使用
contentResolver.query(......)
复制代码
ContentProvider的使用是通过ContentResolver实例进行操作的,所以工作原理分析从调用getContentResolver()获取ContentResolver实例
- getContentResolver()
@Override
public ContentResolver getContentResolver() {
return mBase.getContentResolver();
}
复制代码
getContentResolver() 获取的是ContextImpl.ApplicationContentResolver()实例,而ApplicationContentResolver继承了ContentResolver,本次对ContentProvider的分析以query()为例,contentResolver.query(......)调用的是ContentResolver.query()
- ContentResolver.query()
public final @Nullable Cursor query(final @RequiresPermission.Read @NonNull Uri uri) {
IContentProvider unstableProvider = acquireUnstableProvider(uri);
qCursor = unstableProvider.query(mPackageName, uri, projection,
queryArgs, remoteCancellationSignal);
}
复制代码
query()中首先调用acquireUnstableProvider(uri)获取IContentProvider实例,acquireUnstableProvider中调用了ContentResolver.acquireUnstableProvider(),ApplicationContentResolver继承了ContentResolver,此处实际执行的是ApplicationContentResolver.acquireUnstableProvider(),acquireUnstableProvider()中又调用ActivityThread.acquireProvider()
@Override
protected IContentProvider acquireUnstableProvider(Context c, String auth) {
return mMainThread.acquireProvider(c,
ContentProvider.getAuthorityWithoutUserId(auth),
resolveUserIdFromAuthority(auth), false);
}
复制代码
- ActivityThread.acquireProvider()
Context c, String auth, int userId, boolean stable) {
final IContentProvider provider = acquireExistingProvider(c, auth, userId, stable);
if (provider != null) {
return provider;
}
synchronized (getGetProviderLock(auth, userId)) {
holder = ActivityManager.getService().getContentProvider(
getApplicationThread(), auth, userId, stable);
}
复制代码
acquireProvider中,首先从ArrayMap中获取IContentProvider,如果获取成功则直接返回,若ArrayMap中不存在则ActivityManagerService.getContentProvider启动Provider,getContentProvide()中调用getContentProviderImpl()
- ActivityManagerService.getContentProviderImpl()
if (proc != null && proc.thread != null && !proc.killed) {
if (!proc.pubProviders.containsKey(cpi.name)) {
proc.pubProviders.put(cpi.name, cpr);
try {
proc.thread.scheduleInstallProvider(cpi);
} catch (RemoteException e) {
}
}
} else {
proc = startProcessLocked(cpi.processName,
cpr.appInfo, false, 0, "content provider",
new ComponentName(cpi.applicationInfo.packageName,
cpi.name), false, false, false);
return null;
}
}
复制代码
getContentProviderImpl()执行过程分两步:
- 如果应用进程已经启动则调用proc.thread.scheduleInstallProvider(cpi)启动ContentProvider
- 如果应用进程未启动则执行startProcessLocked(),然后启动ContentProvider
对于已启动的进程直接调用Application.scheduleInstallProvider()启动ContentProvider
- Application.scheduleInstallProvider()
public void scheduleInstallProvider(ProviderInfo provider) {
sendMessage(H.INSTALL_PROVIDER, provider); //发送Message信息,执行handleInstallProvider()
}
复制代码
handleInstallProvider()中又调用installContentProviders()方法,对于应用进程已启动的分析,先暂停此处,下面分析以下应用进程未启动的状况,首先执行startProcessLocked(),启动应用进程并初始化ContentProvider
- 启动应用进程 ()
应用进程启动后调用ActivityThread.main(),初始化消息队列,创建ActivityThread实例并调用attach()方法
- ActivityThread.main()
ActivityThread thread = new ActivityThread();
thread.attach(false);
复制代码
main方法中执行thread.attach()方法,attach()中又调用了IActivityManager.attachApplication(),ActivityManagerService 是IActivityManager的代理类,此处执行的ActivityManagerService.attachApplication(),attachApplication()中又调用attachApplicationLocked(),attachApplicationLocked中调用I Application.bindApplication()
thread.bindApplication(processName, appInfo, providers,
app.instr.mClass,
......
buildSerial, isAutofillCompatEnabled);
复制代码
- bindApplication()
sendMessage(H.BIND_APPLICATION, data);
复制代码
bindApplication()中发送Message消息,Handler接收消息后执行handleBindApplication()
- handleBindApplication()
private void handleBindApplication(AppBindData data) {
final ContextImpl appContext = ContextImpl.createAppContext(this, data.info);//1
try {
final ClassLoader cl = instrContext.getClassLoader();
mInstrumentation = (Instrumentation)
cl.loadClass(data.instrumentationName.getClassName()).newInstance();//2
} catch (Exception e) {...}
final ComponentName component = new ComponentName(ii.packageName, ii.name);
mInstrumentation.init(this, instrContext, appContext, component,
data.instrumentationWatcher, data.instrumentationUiAutomationConnection);//3
Application app = data.info.makeApplication(data.restrictedBackupMode, null);//4
mInitialApplication = app;
if (!data.restrictedBackupMode) {
if (!ArrayUtils.isEmpty(data.providers)) {
installContentProviders(app, data.providers);//5
mH.sendEmptyMessageDelayed(H.ENABLE_JIT, 10*1000);
}
}
mInstrumentation.callApplicationOnCreate(app);//6
}
复制代码
执行工作过程:
- 创建ContextImpl的实例
- 使用反射创建Instrumentation实例
- 调用makeApplication()创建Application实例
- installContentProviders()执行创建和初始化ContentProvider
- 调用 mInstrumentation.callApplicationOnCreate(app)执行Appliocation的onCreate()
上述过程执行启动应用程序和初始化Application之后,调用 installContentProviders(),这里和上面第一种情况一样都执行到installContentProviders方法,所以此处就接着第一种情况一起分析,在installContentProviders方法中回调用nstallProvider()
- installProvider(ProviderInfo info)
final java.lang.ClassLoader cl = c.getClassLoader(); //
LoadedApk packageInfo = peekPackageInfo(ai.packageName, true);
if (packageInfo == null) {
packageInfo = getSystemContext().mPackageInfo;
}
localProvider = packageInfo.getAppFactory()。//
.instantiateProvider(cl, info.name);
provider = localProvider.getIContentProvider();
localProvider.attachInfo(c, info); //
//localProvider.attachInfo
ContentProvider.this.onCreate(); //
复制代码
执行过程:
- 反射获取实例ClassLoader
- 创建ContentProvider实例
- 调用ContentProvider的attachInfo()
- attachInfo()中调用ContentProvider.this.onCreate(),初始化ContentProvider ContentProvider.this.onCreate()执行后,ContentProvider就完成了整个启动过程,后面就可以调用每个方法执行相应的操作了
6、总结
到此ContentProvider的整个使用和工作过程就分析完了,较四大组件中其他三个而言,ContentProvider的启动情况略微复杂,这也符合它跨进程跨程序的功能,之前很早就分析过它的工作过程,但没有整理和输出,通过此篇文章的编写和分析,加深了对ContentProvider的使用和原理的理解。