使用 ContentProviderClient 与 ContentResolver 访问内容提供者

Question

有关 Android 内容提供程序的文档介绍了如何使用 ContentResolver，从 getContentResolver() 获取，用于访问内容。

不过，还有一个 ContentProviderClient，可以从 getContentResolver().acquireContentProviderClient(authority) 获取。它似乎提供了或多或少与 ContentResolver 中可用的方法相同的方法，用于从提供者访问内容。

我什么时候应该使用 ContentProviderClient 而不是直接使用 ContentResolver？有什么好处？

Answer 1

您的 Android 设备有许多数据库，每个数据库都由唯一的内容权威机构标识。这是 content:// uri 中“域名”的等效部分——第一个斜杠之前的所有内容。

ContentResolver 存储提供从 String contentAuthority 到 ContentProvider 映射的数据。当您调用 ContentResolver.query() 或 update() 或其他方法时，URI 将被解析为其组件，识别 contentAuthority 字符串，并且 contentResolver 必须在该映射中搜索匹配的字符串，并将查询定向到正确的提供者。这种昂贵的搜索会在每次调用期间发生，因为每次调用的 URI 可能都不同，并且具有不同的 contentAuthority。此外，建立和断开与特定提供商的连接可能会涉及一些成本——它不能在调用之间重复使用。我不确定其中涉及的开销，这是一些相当深的操作系统级别代码。

相比之下，当您调用 acquireContentProviderClient(authority) 时，“我需要什么提供者？”查找完成一次，然后您将获得一个 ContentProviderClient，它本质上是到 ContentProvider 的直接链接。 （您和提供者之间有一些联系，涉及跨线程通信和并发锁定）。但是，当您使用 ContentProviderClient 时，您将直接与 Provider 对话以获取您请求的权限。这消除了不断重新计算“我想要哪个提供商？”的浪费。

注意：根据 acquireContentProviderClient() 文档：如果您获取 ContentProviderClient，“调用者必须通过调用 ContentProviderClient.release() 这将允许系统在确定没有其他原因保持其活动状态时释放提供程序。” 因此，本质上，让过时的客户端保持打开状态将迫使提供者在后台作为服务继续运行。所以，一定要记得清理哦！

摘要：

多次调用不同的 contentAuthorities： 使用 ContentResolver。

重复调用同一权限：获取并使用ContentProviderClient。完成后记得release()它。

Answer 2

好的，但请注意，它仅在 ContentProvider 与 Activity 在同一进程中运行时才有效。

方法 getLocalContentProvider() 的文档注释：

如果 ContentProvider 在不同的进程中运行，则为 null
将被退回。如果您知道自己正在运行，则可以使用此功能
与提供商相同的流程，并且希望直接访问其
实施细节。

Answer 3

我认为另一个重要区别是 ContentProviderClient 可以转换为自定义提供程序对象并访问除 CRUD 之外的其他方法。

ContentProvider cp = getContentResolver().acquireContentProviderClient(mCurUri).getLocalContentProvider();
yourProvider fld = (yourProvider)cp;
fld.query(...);           // you can query as ContentResolver
fld.addFolder(newFolder); // also can invoke the extend method of your custom ContentProvider

Answer 4

我发现了以下区别：
我在应用程序 A 中编写了自己的自定义内容提供程序。
我在 App B 中编写了一个主屏幕 Widget。
当我尝试通过小部件中的 ContentResolver 访问应用程序 A 的 ContentProvider 时，出现“无法找到提供程序信息”错误。
当我通过 ContentResolver 获取 ContentProviderClient 并通过 ContentProviderClient 查询时，它会起作用。
我不必更改任何其他内容，只需使用 ContentProviderClient 而不是 ContentResolver。
我对这种行为没有真正的解释，也没有在互联网上找到任何信息来解释为什么会这样。
我不知道这是否是小部件的一个特殊怪癖，因为我没有从应用程序 B 中的活动中尝试它（应用程序 B 只是一个小部件，没有活动）。

Answer 5

ContentProviderClient的用法之一是有助于在测试中访问ContentProvider的一些方法。例如，我使用 shutdown() 方法在单元测试中以避免实例化多个内容提供者的多个测试。

像这样实现 ContentProvider#shutdown()：

@Override
public void shutdown() {
    openHelper.close();
    super.shutdown();
}

并在测试方法结束时，使用 ContentProviderClient 调用 shutdown() 来清理测试以便其他测试可以使用内容提供程序：

getContext()
       .getContentResolver()
       .acquireContentProviderClient(URI)
       .getLocalContentProvider()
       .shutdown();