内容提供者

构造ContentProvider实例。内容提供商必须宣布在清单中，使用访问内容解析器、和已创建由系统自动执行，因此应用程序通常不会创建ContentProvider实例。

在构造时，对象未初始化，大多数字段和方法不可用。子类应在中初始化自己创建时（），而不是构造函数。

在应用程序主线程上创建内容提供程序应用程序启动时间。构造函数不能执行冗长的操作操作，否则应用程序启动将延迟。

重写此项以处理执行一批操作的请求，或者默认实现将迭代操作并调用apply（ContentProvider，ContentProviderResult[]，int）在他们每个人身上。如果所有呼叫apply（ContentProvider，ContentProviderResult[]，int）成功然后是a内容提供者结果具有相同数量的数组将返回有操作的元素。如果有任何呼叫如果失败，则取决于其他实现的生效数量。可以从多个线程调用此方法，如中所述过程和线程。

实例化后，调用这个函数来告诉内容提供者关于它自己。

重写此项以处理插入一组新行的请求，或者默认实现将迭代这些值并调用插入（Uri，ContentValues）在他们每个人身上。出于礼貌，请致电通知更改（）插入后。可以从多个线程调用此方法，如中所述过程和线程。

调用提供程序定义的方法。这可用于实施对于类似桌子的界面来说，更便宜和/或更不自然模型。

警告：框架不进行权限检查除了应用程序的基本功能之外，还要考虑内容提供商的这一项根本无法访问提供商。例如，它不知道是否调用执行时可能会读取或写入提供程序中的数据，因此无法强制执行个人权限。此方法的任何实现必须对传入呼叫进行自己的权限检查，以确保它们被允许。

实现此功能以支持引用您的内容提供商。规范URI是可以跨设备、备份/恢复和其他上下文，并且仍然能够引用到同一数据项。通常，这是通过添加查询来实现的URI的参数允许内容提供者验证传入的规范URI引用的数据与它最初用于和的数据相同，如果没有，则在当前环境中查找该数据（如果存在）。

例如，如果内容提供商包含人员和正常的URI是用人员数据库中的行索引创建的，即cananical表示可能在末尾有一个额外的查询参数，该参数指定它的目标用户。稍后使用该URI调用提供程序将显示向上显示URI的基索引行，如果不匹配或其条目name与查询参数中的名称不匹配，请对其数据库执行查询找到要操作的正确行。

如果实现对规范URI的支持，全部的来电URI（包括此URI）必须对任何他们接收的规范URI。此外，还必须实现非规范化（尿）去除任何这些URI的规范化。

此方法的默认实现返回null，表示不支持规范URI。

实现此功能以处理删除一行或多行的请求。执行时应应用选择条款删除，允许操作影响目录中的多行。出于礼貌，请致电通知删除（）删除后。可以从多个线程调用此方法，如中所述过程和线程。

该实现负责在末尾解析出行ID如果要删除特定行，则返回URI。也就是说，客户会传入内容：//联系人/人/22实现是负责在创建SQL语句时解析记录编号（22）。

将提供程序的状态打印到给定流中。如果运行“adb shell dumpsys activity provider<providercomponent_name>”。

返回发起请求的调用者的包名称在当前线程上处理。返回的包裹已验证属于调用UID。退换商品无效的如果没有当前正在处理请求。

这将永远返回无效的处理时getType（Uri）或getStreamTypes（Uri，字符串）请求。

检索运行此提供程序的上下文。仅可用一次创建时（）已调用--这将返回无效的在中构造函数。

返回对的读和/或写访问所需的基于路径的权限此内容提供商。可以从多个螺纹，如中所述过程和线程。

返回只读访问所需的权限名称此内容提供商。可以从多个线程，如中所述过程和线程。

由客户端调用以确定此内容提供程序支持给定的URI。默认实现收益无效的，表示没有类型。如果您的内容提供商存储数据对于特定类型，如果MIME类型与给定的mimeTypeFilter。如果它可以执行类型转换，则返回数组与mimeTypeFilter匹配的所有支持的MIME类型的。

实现此功能以处理对MIME类型数据的请求给定的URI。返回的MIME类型应以开头vnd.android.cursor.item公司对于单个记录，或vnd.android.cursor.dir/用于多个项目。可以从多个线程调用此方法，如中所述过程和线程。

请注意，应用程序不需要权限访问此信息；如果您的内容提供商要求阅读和/或写入权限，或者未导出，所有应用程序仍然可以调用此方法不考虑其访问权限。这使他们能够在调度意图时检索URI的MIME类型。

返回对的读/写访问所需的权限名称此内容提供商。可以从多个线程，如中所述过程和线程。

实现此功能以处理插入新行的请求。出于礼貌，打电话通知更改（）插入后。可以从多个线程调用此方法，如中所述过程和线程。

当您的组件正在运行。注意，与活动不同，其他组件配置更改时从不重新启动：它们必须始终处理更改的结果，例如通过重新检索资源。

在调用此函数时，您的资源对象将被更新以返回与新配置。

有关更多信息，请阅读处理运行时更改。此方法始终在应用程序主线程上调用，并且必须不执行长时间的操作。

默认的内容提供程序实现不执行任何操作。重写此方法以采取适当的操作。（内容提供商通常不关心屏幕之类的东西方向，但可能想了解区域设置更改。）

实现此功能以在启动时初始化内容提供程序。对上所有注册的内容提供程序调用此方法应用程序启动时的应用程序主线程。它不能执行冗长的操作，或应用程序启动将延迟。

您应该推迟重要的初始化（例如打开、，升级和扫描数据库），直到使用内容提供商（通过查询（Uri，String[]，String，String[]，String]）,插入（Uri，ContentValues）等）。延迟初始化保持应用程序快速启动，避免不必要的工作结果不需要，并停止数据库错误（例如磁盘）停止应用程序启动。

如果使用SQLite，存取资料表是一个有用的实用程序类，可以轻松管理数据库，并将自动延迟打开，直到首次使用。如果您确实使用SQLiteOpenHelper，请确保避免调用获取可读数据库（）或获取可写数据库（）从这个方法。（相反，覆盖onOpen（SQLiteDatabase）初始化第一次打开数据库时。）

这是在整个系统内存不足时调用的，并且主动运行的进程应该减少内存使用。While期间通常，调用该函数的确切点没有定义当所有后台进程都被终止时，就会发生这种情况。也就是说，在达到扼杀托管进程的地步之前我们希望避免杀戮的服务和前台UI。

您应该实现此方法以释放您可能持有的任何缓存或其他不必要的资源。从该方法返回后，系统将为您执行垃圾收集。

最好，您应该实现onTrimMemory（int）从组件回调2根据不同的内存需求的级别。该API可用于API级别14及更高级别，因此您应该只使用这个低内存（）方法作为旧版本的备用方法，可以是被视为onTrimMemory（int）使用TRIM_MEMORY_COMPLETE（内存完整）水平。

默认的内容提供程序实现不执行任何操作。子类可以重写此方法以采取适当的操作。

当操作系统确定它是好的时调用进程从其进程中删除不需要的内存的时间。这将例如，当它出现在后台，但数量不足时内存以使尽可能多的后台进程运行。你不得与液位的精确值进行比较，因为新的中间物可以添加值--您通常需要比较大于或等于您感兴趣的级别。

要在任何时候检索进程的当前微调级别，您可以使用ActivityManager.getMyMemoryState（RunningAppProcessInfo）。

这就像是openFile（Uri，字符串），但可以由提供程序实现需要能够返回文件的子部分，通常是资产在他们的.apk里面。可以从多个线程调用此方法，如中所述过程和线程。

如果您实现了这一点，您的客户必须能够处理此类问题文件切片，可以直接使用openAssetFileDescriptor（Uri，字符串），或使用更高级别ContentResolver.openInputStream内容解析程序或内容解决程序.openOutputStream方法。

返回的AssetFileDescriptor可以是要启用的管道或套接字对数据流。

如果您执行此操作以返回完整的文件，则应使用创建AssetFileDescriptor未知长度与…兼容无法处理文件子节的应用程序。

为了在Intents中使用，您需要实现getType（Uri）为此处返回的数据返回适当的MIME类型相同的URI。这将允许意向解析自动确定数据MIME键入并选择适当的匹配目标作为其操作的一部分。

为了更好地与其他应用程序互操作，建议使用对于任何可以打开的URI，您还支持对其进行查询至少包含由指定的列可打开的列。

这就像是openFile（Uri，字符串），但可以由提供程序实现需要能够返回文件的子部分，通常是资产在他们的.apk里面。可以从多个线程调用此方法，如中所述过程和线程。

如果您实现了这一点，您的客户必须能够处理此类问题文件切片，可以直接使用openAssetFileDescriptor（Uri，字符串），或使用更高级别ContentResolver.openInputStream内容解析程序或内容解决程序.openOutputStream方法。

返回的AssetFileDescriptor可以是要启用的管道或套接字对数据流。

如果要实现此操作以返回完整文件应使用创建AssetFileDescriptor未知长度与…兼容无法处理文件子节的应用程序。

为了在Intents中使用，您需要实现getType（Uri）为此处返回的数据返回适当的MIME类型相同的URI。这将允许意向解析自动确定数据MIME键入并选择适当的匹配目标作为其操作的一部分。

为了更好地与其他应用程序互操作，建议使用对于任何可以打开的URI，您还支持对其进行查询至少包含由指定的列可打开的列。

覆盖此项以处理打开文件blob的请求。默认实现总是抛出文件未找到异常。可以从多个线程调用此方法，如中所述过程和线程。

此方法返回直接返回的ParcelFileDescriptor打电话的人。这样，大数据（如图像和文档）可以返回时未复制内容。

返回的ParcelFileDescriptor归调用者所有，因此它是他们有责任在完成后关闭它。也就是说，实施应该为每个调用创建一个新的ParcelFileDescriptor。

如果以独占的“r”或“w”模式打开，则返回ParcelFileDescriptor可以是管道或套接字对以启用流数据的。以“rw”或“rwt”模式打开意味着磁盘上的文件支持搜索。

如果需要检测返回的ParcelFileDescriptor关闭，或者远程进程崩溃或遇到其他问题错误，您可以使用打开（文件、int、android.os.Handler、android.os.ParcelFileDescriptor.OnCloseListener）,创建可交付管道（），或创建可交付套接字对（）。

要在Intents中使用，您需要实现getType（Uri）为此处返回的数据返回适当的MIME类型相同的URI。这将允许意向解析自动确定数据MIME键入并选择适当的匹配目标作为其操作的一部分。

为了更好地与其他应用程序互操作，建议使用对于任何可以打开的URI，您还支持对其进行查询至少包含由指定的列可打开的列。如果有其他元数据，您可能还想支持其他公共列供应，例如添加日期在里面媒体商店。媒体栏。

重写此项以处理打开文件blob的请求。默认实现总是抛出文件未找到异常。可以从多个线程调用此方法，如中所述过程和线程。

此方法返回直接返回的ParcelFileDescriptor打电话的人。这样，大数据（如图像和文档）可以返回时未复制内容。

返回的ParcelFileDescriptor归调用者所有，因此它是他们有责任在完成后关闭它。也就是说，实施应该为每个调用创建一个新的ParcelFileDescriptor。

如果以独占的“r”或“w”模式打开，则返回ParcelFileDescriptor可以是管道或套接字对以启用流数据的。以“rw”或“rwt”模式打开意味着磁盘上的文件支持寻求。

如果需要检测返回的ParcelFileDescriptor关闭，或者远程进程崩溃或遇到其他问题错误，您可以使用打开（文件、int、android.os.Handler、android.os.ParcelFileDescriptor.OnCloseListener）,创建可交付管道（），或创建可交付套接字对（）。

为了在Intents中使用，您需要实现getType（Uri）为此处返回的数据返回适当的MIME类型相同的URI。这将允许意向解析自动确定数据MIME键入并选择适当的匹配目标作为其操作的一部分。

为了更好地与其他应用程序互操作，建议使用对于任何可以打开的URI，您还支持对其进行查询至少包含由指定的列可打开的列。如果有其他元数据，您可能还想支持其他公共列供应，例如添加日期在里面媒体商店。媒体栏。

用于实现的助手函数openTypedAssetFile（Uri、字符串、绑定），用于创建一个数据管道和后台线程，允许您流式传输生成的数据返回到客户端。此函数返回一个新的应返回给调用方（调用方）的ParcelFileDescriptor负责关闭它）。

由客户端调用以打开包含特定的MIME类型。这就像是openAssetFile（Uri，字符串）,但文件只能是只读的，内容提供商可以执行数据转换以生成所需类型的数据。

默认实现将给定的mimeType与的结果getType（Uri）如果匹配，只需调用openAssetFile（Uri，字符串）。

请参见剪辑数据有关使用和实现的示例这种方法。

返回的AssetFileDescriptor可以是要启用的管道或套接字对数据流。

为了更好地与其他应用程序互操作，建议使用对于任何可以打开的URI，您还支持对其进行查询至少包含由指定的列可打开的列。如果有其他元数据，您可能还想支持其他公共列供应，例如添加日期在里面媒体商店。媒体栏。

由客户端调用以打开包含特定的MIME类型。这就像是openAssetFile（Uri，字符串）,但文件只能是只读的，内容提供商可以执行数据转换以生成所需类型的数据。

默认实现将给定的mimeType与的结果getType（Uri）如果匹配，只需调用openAssetFile（Uri，字符串）。

请参见剪辑数据有关使用和实现的示例这种方法。

返回的AssetFileDescriptor可以是要启用的管道或套接字对数据流。

为了更好地与其他应用程序互操作，建议使用对于任何可以打开的URI，您还支持对其进行查询至少包含由指定的列可打开的列。如果有其他元数据，您可能还想支持其他公共列供应，例如添加日期在里面媒体商店。媒体栏。

实现此功能以处理来自客户端的查询请求。可以从多个线程调用此方法，如中所述过程和线程。

客户端调用示例：

//请求特定记录。游标managedCursor=managedQuery(ContentUris.withAppendedId（联系人.People.CONTENT_URI，2），投影，//返回哪些列。null，//WHERE子句。null，//WHERE子句值替换人。名称+“ASC”）；//排序顺序。

//SQLiteQueryBuilder是创建//正确的SQL语法。SQLiteQueryBuilder qBuilder=新SQLiteQueryBuilder（）；//设置我们要查询的表。qBuilder.setTables（DATABASE_TABLE_NAME）；//如果查询以特定的记录号结束，则//被要求提供特定记录，因此设置//查询中的WHERE子句。if（（URI_MATCHER.match（URI））==特定消息）{qBuilder.appendWhere（“_id=”+uri.getPathLeafId（））；}//进行查询。光标c=qBuilder.query（mDb，投影，选择，选择参数，分组依据，有，sortOrder）；c.setNotificationUri（getContext（）.getContentResolver（），uri）；返回c；

实现此功能以处理来自支持取消的客户端的查询请求。可以从多个线程调用此方法，如中所述过程和线程。

客户端调用示例：

//请求特定记录。游标managedCursor=managedQuery(ContentUris.withAppendedId（联系人.People.CONTENT_URI，2），投影，//返回哪些列。null，//WHERE子句。null，//WHERE子句值替换人。名称+“ASC”）；//排序顺序。

//SQLiteQueryBuilder是创建//正确的SQL语法。SQLiteQueryBuilder qBuilder=新SQLiteQueryBuilder（）；//设置我们要查询的表。qBuilder.setTables（DATABASE_TABLE_NAME）；//如果查询以特定的记录号结束，则//被要求提供特定记录，因此设置//查询中的WHERE子句。if（（URI_MATCHER.match（URI））==特定消息）{qBuilder.appendWhere（“_id=”+uri.getPathLeafId（））；}//进行查询。光标c=qBuilder.query（mDb，投影，选择，选择参数，分组依据，有，sortOrder）；c.setNotificationUri（getContext（）.getContentResolver（），uri）；返回c；

如果实现此方法，则还必须实现查询（Uri，String[]，String，String[]，String]）不需要取消确保在中的旧版本Android Framework上正确运行的信号取消信号过载不可用。

实现此操作以关闭ContentProvider实例。然后你可以在单元测试中调用此方法。

Android通常处理ContentProvider的启动和关闭自动。您不需要启动或关闭内容提供商。在ContentProvider上调用测试方法时，但是，ContentProvider实例会启动并在之后继续运行测试结束，即使后续测试实例化了另一个测试内容提供商。冲突的发展是因为这两个实例通常针对相同的底层数据源运行（例如sqlite数据库）。

实现shutDown（）通过提供一种终止ContentProvider。此方法还可以防止内存泄漏从ContentProvider的多个实例化，它可以确保通过允许您完全清理测试来进行单元测试隔离进行下一次测试前进行固定。

从以前返回的规范URI中删除规范化规范化（Uri）。例如，如果您的实现要添加用于规范化URI的查询参数，此方法可以简单地将任何URI上的查询参数。默认实现总是返回相同的网址那是传来的。

实现此功能以处理更新一行或多行的请求。实现应更新与所选内容匹配的所有行根据提供的值映射设置列。出于礼貌，请致电通知更改（）更新后。可以从多个线程调用此方法，如中所述过程和线程。

如果此实例是临时内容提供程序，则返回true。

希望实现的子类的便利性openFile（Uri，字符串）通过在给定URI中查找名为“_data”的列。

更改在中读取和/或写入数据所需的基于路径的权限内容提供商。这通常是从清单中为您设置的首次创建提供程序时的信息。

更改从内容读取数据所需的权限供应商。这通常是从清单信息中为您设置的首次创建提供程序时。

更改读取和写入内容中数据所需的权限供应商。这通常是从清单信息中为您设置的首次创建提供程序时。