该系列文章总纲链接：专题总纲目录 Android Framework 总纲
本章关键点总结 & 说明：
说明：本章节主要解读ContentProvider组件的基本知识。关注思维导图中左上侧部分即可。
有了前面activity组件分析、service组件分析、广播组件分析的基础，基于此，接下来我们来分析ContentProvider组件的基本流程，ContentProvider主要涉及2个：
- ContentProvider的注册，开即启动后解析和处理ContentProvider组件。
- getContentResolver，然后执行对应ContentProvider.query方法。
本章，我们先对ContentProvider组件的应用有基本的了解，再详细分析第一个流程。
1 ContentProvider组件解读
1.1 理解ContentProvider组件
ContentProvider 是 Android 框架中的一个核心组件，它专门设计用于在应用之间共享数据。它通过URI标识数据，并提供一组标准的CRUD操作（创建、读取、更新、删除），同时支持数据封装、安全性控制和多用户管理，使得数据访问变得抽象化和标准化。
ContentProvider组件具体内容解读如下：
- 数据共享机制：ContentProvider 提供了一种标准化的接口，允许不同应用或应用的不同部分访问和共享数据。
- URI 访问：每个 ContentProvider 都有一个唯一的标识符（authority），客户端可以通过构建 content 类型的 Uri 来访问提供的数据。
- MIME 类型：ContentProvider 能够返回数据的 MIME 类型，这有助于客户端理解数据的性质并相应地处理。
- CRUD 操作：ContentProvider 实现了创建（Create）、读取（Retrieve）、更新（Update）和删除（Delete）数据的基本操作。
- 数据封装：它封装了数据存储的细节，客户端无需了解数据是如何存储和维护的。
- 安全性：通过权限控制，ContentProvider 可以限制对敏感数据的访问，确保只有授权的应用或用户可以访问。
- 多用户支持：在多用户环境中，ContentProvider 可以管理不同用户的数据隔离。
- 系统服务集成：许多系统服务，如联系人、日历和媒体库，都是通过 ContentProvider 暴露给应用的。
那么ContentProvider为什么要这样设计呢？解读如下：
- 数据共享与封装：设计ContentProvider的核心目的是为了在不同的应用之间共享数据，同时隐藏数据的具体存储细节。这种封装允许数据提供者改变数据存储方式而不影响数据消费者。
- 统一的数据访问接口：提供一个统一的接口（CRUD操作）来访问数据，使得不同的应用可以使用相同的方式与数据交互，无论数据存储在SQLite数据库、文件系统还是其他存储介质中。
- 安全性与权限管理：通过ContentProvider，Android可以控制对敏感数据的访问。使用URI授权和权限系统，只有获得授权的应用才能访问特定的数据，这增强了数据的安全性。
- 解耦组件：ContentProvider允许数据提供者和数据消费者之间保持松耦合关系。消费者无需知道数据是如何生成或存储的，只需知道如何通过ContentProvider访问数据。
- 支持内容URI和MIME类型：内容URI提供了一种标准化的方式来标识和访问数据。MIME类型则允许客户端根据数据类型采取适当的操作，这增加了数据交换的灵活性和多样性。
- 跨应用功能：ContentProvider使得不同的应用可以协同工作，共享数据和功能，为用户提供更加丰富的体验。
- 系统服务集成：许多系统服务，如联系人、日历和媒体库，都是通过ContentProvider暴露给应用的，这使得开发者可以轻松地在自己的应用中集成这些服务。
- 多用户支持：在多用户环境中，ContentProvider可以管理不同用户的数据隔离，确保每个用户只能访问自己的数据。
- 数据同步：ContentProvider可以用于实现数据同步，尤其是在处理需要与网络服务或云端数据同步的场景。
ContentProvider的设计反映了Android平台对于数据访问和共享的深刻理解，它提供了一种强大而灵活的方式来管理应用内和应用间的数据流动。
1.2 ContentProvider被启动和使用的过程
ContentProvider 是 Android 系统中的一个组件，它不像 Activity 或 Service 那样可以直接被启动。相反，ContentProvider 是在系统启动时注册，并在需要时被调用的。ContentProvider 是在系统启动时注册，并在需要时被调用的。以下是 ContentProvider 被启动和使用的过程：
@1 声明 ContentProvider：在应用的 AndroidManifest.xml 文件中声明 ContentProvider，包括它的 authorities（唯一标识）和其他必要的属性。
<provider
android:name=".MyContentProvider"
android:authorities="com.example.myprovider"
android:exported="true" />@2 实现 ContentProvider：创建一个类继承自 ContentProvider，并实现其抽象方法，如 onCreate(), query(), insert(), delete(), update() 和 getType()。
@3 系统启动时注册：当应用安装到设备上时，AndroidManifest.xml 中声明的 ContentProvider 会被系统读取并注册。这意味着系统知道了这个 ContentProvider 的存在和如何与其通信。
@4 调用 ContentProvider：其他应用或组件可以通过构建一个 ContentProvider 的 Uri 来与其交互。这个 Uri 通常是基于 ContentProvider 的 authorities 构建的。例如，使用 ContentResolver 来查询 ContentProvider：
ContentResolver contentResolver = getContentResolver();
Uri uri = Uri.parse("content://com.example.myprovider/items");
Cursor cursor = contentResolver.query(uri, null, null, null, null);@5 ContentProvider 的生命周期：ContentProvider 的 onCreate() 方法在 ContentProvider 第一次被调用时执行，而不是在应用启动时执行。这类似于 Activity 的 onCreate() 方法。ContentProvider 通常在它们的 Uri 被查询时“启动”，这意味着它们的相关方法（如 query()）被调用。
@6 跨应用通信：如果 ContentProvider 的 exported 属性设置为 true，则其他应用可以访问它。如果设置为 false，则只有声明它的应用可以访问。
@7 多用户环境：在多用户环境中，ContentProvider 可以管理不同用户的数据隔离，确保每个用户只能访问自己的数据。
ContentProvider 的启动和使用是被动的，它们在需要时被调用，而不是主动启动。这种设计使得 ContentProvider 可以作为数据共享的桥梁，同时保持应用组件的解耦和灵活性。
1.3 ContentProvider应用解读
以下是两个简单的Android应用示例，一个演示如何通过ContentProvider提供数据，另一个演示如何通过ContentResolver获取数据。
@示例1 通过ContentProvider提供数据
参考文件MyContentProvider.java的内容为:
import android.content.ContentProvider;
import android.content.ContentValues;
import android.content.UriMatcher;
import android.database.Cursor;
import android.net.Uri;
public class MyContentProvider extends ContentProvider {
public static final String AUTHORITY = "com.example.myprovider";
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/items");
private static final int ITEMS = 1;
private static final int ITEM_ID = 2;
private static final UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
static {
uriMatcher.addURI(AUTHORITY, "items", ITEMS);
uriMatcher.addURI(AUTHORITY, "items/#", ITEM_ID);
}
private MyDatabaseHelper dbHelper;
@Override
public boolean onCreate() {
dbHelper = new MyDatabaseHelper(getContext());
return true;
}
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
Cursor cursor;
switch (uriMatcher.match(uri)) {
case ITEMS:
cursor = dbHelper.getReadableDatabase().query("MyTable", projection, selection, selectionArgs, null, null, sortOrder);
break;
case ITEM_ID:
String id = uri.getLastPathSegment();
cursor = dbHelper.getReadableDatabase().query("MyTable", projection, "_id=?", new String[]{id}, null, null, sortOrder);
break;
default:
throw new IllegalArgumentException("Unknown URI: " + uri);
}
cursor.setNotificationUri(getContext(), uri);
return cursor;
}
// Implement other required ContentProvider methods (insert, update, delete, getType)
}需要在AndroidManifest.xml中注册该组件，具体内容为：
<provider
android:name=".MyContentProvider"
android:authorities="com.example.myprovider"
android:exported="true"
android:grantUriPermissions="true" />@示例2 通过ContentResolver获取数据
参考文件MainActivity.java的内容为：
import android.database.Cursor;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import android.content.ContentResolver;
import android.content.UriMatcher;
import android.net.Uri;
import android.provider.BaseColumns;
public class MainActivity extends AppCompatActivity {
private static final String AUTHORITY = "com.example.myprovider";
private static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/items");
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
ContentResolver contentResolver = getContentResolver();
Cursor cursor = contentResolver.query(CONTENT_URI, null, null, null, null);
if (cursor != null) {
while (cursor.moveToNext()) {
// Assuming there's a column named "name" in your database
String name = cursor.getString(cursor.getColumnIndex("name"));
// Do something with the data, e.g., display it in a ListView
}
cursor.close();
}
}
}这两个示例展示了ContentProvider和ContentResolver的基本用法。
- 第一个示例中，MyContentProvider提供了访问数据库的能力，通过定义AUTHORITY和CONTENT_URI来标识数据的来源。
- 第二个示例中，MainActivity使用ContentResolver来查询由MyContentProvider提供的数据。
注意：这两个示例仅提供了核心代码部分，实际应用中需要实现ContentProvider的所有必需方法（如insert、update、delete和getType）。
基于此，我们分析ContentProvider组件主要从两个大的方面进行分析：
- 作为内容提供者，ContentProvider随着开机启动启动注册和解析流程。我们主要关注Provider信息的存储和查询方式。也是本文接下来要解读的部分。
- 作为数据获取者，通过getContentResolver获取ContentResolver对应，进而通过query方法获取数据流程。这里我们关注2个关键流程：getContentResolver获取ContentProvider的流程和通过ContentProvider来查询的query流程。这部分我们放到下一篇文章来解读。
2 ContentProvider开机启动注册流程解读
ContentProvider组件是android应用在 AndroidManifest.xml 文件中声明的 receiver，像这样：
<provider
android:name=".MyContentProvider"
android:authorities="com.example.myprovider"
android:exported="true"
android:grantUriPermissions="true" />它们的信息会在系统启动时，由PMS解析并记录下来。
当 AMS 调用 PMS 的相关接口来查询 对应的Provider 时，PMS 内部就会去查询当初记录下来的数据，并把结果返回 AMS。
这里PMS在初始化时其中一部分是通过scanDirLI相关方法来初始化成员变量mProviders和mProvidersByAuthority，这两个成员变量都是PMS中存储provider的关键变量，关于PMS的初始化部分内容，想有更多了解可参考文章：
Android Framework 包管理子系统（01）PackageManagerService启动分析
这里主要看以scanDirLI为入口，分析mReceivers和mProvidersByAuthority的初始化部分逻辑，代码实现如下所示：
//PMS
//关键流程：step1
private void scanDirLI(File dir, int parseFlags, int scanFlags, long currentTime) {
final File[] files = dir.listFiles();
//...
for (File file : files) {
final boolean isPackage = (isApkFile(file) || file.isDirectory())
&& !PackageInstallerService.isStageName(file.getName());
if (!isPackage) {
// Ignore entries which are not packages
continue;
}
try {
scanPackageLI(file, parseFlags | PackageParser.PARSE_MUST_BE_APK,
scanFlags, currentTime, null);
} catch (PackageManagerException e) {
//...
}
}
}
//关键流程：step2
private PackageParser.Package scanPackageLI(File scanFile, int parseFlags, int scanFlags,
long currentTime, UserHandle user) throws PackageManagerException {
//...
PackageParser.Package scannedPkg = scanPackageLI(pkg, parseFlags, scanFlags
| SCAN_UPDATE_SIGNATURE, currentTime, user);
//...
return scannedPkg;
}
//关键流程：step3
private PackageParser.Package scanPackageLI(PackageParser.Package pkg, int parseFlags,
int scanFlags, long currentTime, UserHandle user) throws PackageManagerException {
boolean success = false;
try {
final PackageParser.Package res = scanPackageDirtyLI(pkg, parseFlags, scanFlags,
currentTime, user);
success = true;
return res;
} finally {
//...
}
}
//关键流程：step4
private PackageParser.Package scanPackageDirtyLI(PackageParser.Package pkg, int parseFlags,
int scanFlags, long currentTime, UserHandle user) throws PackageManagerException {
//...
synchronized (mPackages) {
//...
// 获取应用包中ContentProvider的数量
int N = pkg.providers.size();
int i;
for (i = 0; i < N; i++) {
PackageParser.Provider p = pkg.providers.get(i); // 获取ContentProvider的Provider对象
// 修复ContentProvider的进程名称
p.info.processName = fixProcessName(pkg.applicationInfo.processName,
p.info.processName, pkg.applicationInfo.uid);
// 将ContentProvider添加到全局ContentProvider列表
mProviders.addProvider(p);
// 设置是否可同步
p.syncable = p.info.isSyncable;
// 如果ContentProvider有authority声明
if (p.info.authority != null) {
// 分割authority，因为可能声明了多个
String names[] = p.info.authority.split(";");
p.info.authority = null; // 重置authority
for (int j = 0; j < names.length; j++) {
// 如果是第二个authority并且ContentProvider是可同步的，则创建一个新的Provider对象
if (j == 1 && p.syncable) {
p = new PackageParser.Provider(p);
p.syncable = false; // 新的Provider对象不可同步
}
// 如果mProvidersByAuthority中没有这个authority，则添加进去
if (!mProvidersByAuthority.containsKey(names[j])) {
mProvidersByAuthority.put(names[j], p);
// 设置或更新authority
if (p.info.authority == null) {
p.info.authority = names[j];
} else {
p.info.authority = p.info.authority + ";" + names[j];
}
} else {
// 如果已经有相同的authority，获取已经存在的Provider对象
PackageParser.Provider other = mProvidersByAuthority.get(names[j]);
//...
}
}
}
}
//...
}
//...
//返回处理后的应用包对象
return pkg;
}对于ContentProvider注册的解析，实际上到此就结束了。这里我们主要分析和关注卡年我们提到的2个成员变量mProvidersByAuthority和mProviders，详细解读如下：
- mProvidersByAuthority：通过URI中的authority部分来快速查找ContentProvider的。ArrayMap是Android提供的一个优化版的HashMap，它在存储键值对时更加高效，特别是在键和值都是对象的情况下。mProvidersByAuthority是一个ArrayMap，它将ContentProvider的authority（即URI的authority部分）映射到PackageParser.Provider对象，这样可以快速通过authority查找对应的ContentProvider信息。这个映射表主要用于快速访问和检索ContentProvider，特别是当你需要根据authority来获取ContentProvider的详细信息时，这个映射表提供了一种快速查找的方式。
- mProviders：通过解析Intent的URI和MIME类型来确定哪个ContentProvider应该响应这个Intent的。ProviderIntentResolver是一个用于解析和匹配Intent与ContentProvider的类。它主要负责处理Intent和ContentProvider之间的关系，即根据Intent的URI和MIME类型来确定应该由哪个ContentProvider来处理这个请求。它内部使用了一些数据结构来存储和查找ContentProvider的信息，以便快速匹配和解析Intent。ProviderIntentResolver通常用于动态查找和处理ContentProvider，特别是在处理Intent时，需要根据Intent的URI和MIME类型来确定具体的ContentProvider。
两者都是管理ContentProvider的重要机制，但它们的查找依据和工作方式有所不同。接下来针对查询的流程分别进行解读。接下来针对查询的流程做更详细的解读。
2.1 通过解析intent的Uri和MIME来查找对应provider的流程
当有数据获取端想通过Uri和MIME来快速查找ContentProvider时，则会通过PMS的queryContentProviders方法来查询。接下来我们来查看该方法的实现，代码如下：
//PMS
@Override
public List<ProviderInfo> queryContentProviders(String processName,
int uid, int flags) {
ArrayList<ProviderInfo> finalList = null; // 用于存储最终的ContentProvider信息列表
// reader
synchronized (mPackages) {
final Iterator<PackageParser.Provider> i = mProviders.mProviders.values().iterator();
final int userId = processName != null ?
UserHandle.getUserId(uid) : UserHandle.getCallingUserId();
while (i.hasNext()) {
final PackageParser.Provider p = i.next(); // 获取下一个Provider
PackageSetting ps = mSettings.mPackages.get(p.owner.packageName); // 获取PackageSetting
if (ps != null && p.info.authority != null // 确保PackageSetting不为空且Provider有authority
&& (processName == null // 如果processName为null，或者
|| (p.info.processName.equals(processName) // Provider的processName匹配，并且
&& UserHandle.isSameApp(p.info.applicationInfo.uid, uid))) // UID匹配
&& mSettings.isEnabledLPr(p.info, flags, userId) // Provider是可用的
&& (!mSafeMode // 如果不在安全模式，或者Provider是系统应用
|| (p.info.applicationInfo.flags & ApplicationInfo.FLAG_SYSTEM) != 0)) {
if (finalList == null) {
finalList = new ArrayList<ProviderInfo>(3); // 初始化最终列表
}
ProviderInfo info = PackageParser.generateProviderInfo(p, flags,
ps.readUserState(userId), userId); // 生成ProviderInfo
if (info != null) {
finalList.add(info); // 将ProviderInfo添加到最终列表
}
}
}
}
if (finalList != null) {
Collections.sort(finalList, mProviderInitOrderSorter); // 对最终列表进行排序
}
return finalList; // 返回ContentProvider信息列表
}queryContentProviders方法通过遍历所有已知的ContentProvider，根据给定的条件过滤和生成ProviderInfo对象，最终返回一个包含所有匹配ContentProvider信息的列表。这个过程确保了只有符合条件的ContentProvider被返回，同时考虑了进程名、UID、可用性和安全模式等因素。
这里本质上是基于mProviders来进行处理。
2.2 通过Uri的authority来查找对应provider的流程
当有数据获取端想通过URI中的authority部分来快速查找ContentProvider时，则会通过PMS的resolveContentProvider方法来查询。接下来我们来查看该方法的实现，代码如下：
@Override
public ProviderInfo resolveContentProvider(String name, int flags, int userId) {
// 检查指定的用户是否存在，如果不存在则返回null
if (!sUserManager.exists(userId)) return null;
// 同步代码块，确保线程安全
synchronized (mPackages) {
// 从mProvidersByAuthority中获取指定名称的Provider
final PackageParser.Provider provider = mProvidersByAuthority.get(name);
// 如果provider不为空，则获取其所属包的PackageSetting
PackageSetting ps = provider != null
? mSettings.mPackages.get(provider.owner.packageName)
: null;
// 如果PackageSetting不为空，且provider是启用的，且在安全模式下只允许系统应用
return ps != null
&& mSettings.isEnabledLPr(provider.info, flags, userId)
&& (!mSafeMode || (provider.info.applicationInfo.flags
&ApplicationInfo.FLAG_SYSTEM) != 0)
? PackageParser.generateProviderInfo(provider, flags,
ps.readUserState(userId), userId)
: null;
}
}resolveContentProvider 方法是 PackageManagerService 中用于根据提供的 authority 名称、标志位和用户 ID 来解析特定 ContentProvider 的方法。这个方法主要用于在需要确定特定 authority 对应的 ContentProvider 信息时使用。
这里本质上是基于mProvidersByAuthority来进行处理。
总结下，开机启动后，PMS解析AndroidManifest.xml并处理，将ContentProvider存储在PMS的变量中，关键变量一个是mProvidersByAuthority，另一个是mProviders，两者主要是针对不同的查询需求。
