此页面由 Cloud Translation API 翻译。

ContentProviderHandler

public class ContentProviderHandler
extends Object

java.lang.Object 中
↳	com.android.tradefed.device.contentprovider.ContentProviderHandler

对 content provider 互动进行抽象化处理并允许使用设备端内容的处理程序不同操作的提供程序。

该类中的所有实现都应留意当前在设备。

摘要

字段
`public static final String[]`	`COLUMNS`
`public static final String`	`COLUMN_ABSOLUTE_PATH`
`public static final String`	`COLUMN_DIRECTORY`
`public static final String`	`COLUMN_METADATA`
`public static final String`	`COLUMN_MIME_TYPE`
`public static final String`	`COLUMN_NAME`
`public static final String`	`CONTENT_PROVIDER_URI`
`public static final String`	`NO_RESULTS_STRING`
`public static final String`	`PACKAGE_NAME`
`public static final String`	`QUERY_INFO_VALUE`

公共构造函数
`ContentProviderHandler(ITestDevice device)` 构造函数。
`ContentProviderHandler(ITestDevice device, Integer userId)`

公共方法
`boolean`	`contentProviderNotFound()` 如果某项操作失败且未找到内容提供程序，则返回 True。
`static String`	`createEscapedContentUri(String deviceFilePath)` 返回给定设备路径的完整 URI 字符串，并进行转义和编码以避免使用非网址字符。
`boolean`	`deleteFile(String deviceFilePath)` 用于删除 URI 位置处文件的内容提供程序回调。
`boolean`	`doesFileExist(String deviceFilePath)` 确定设备上是否存在文件或非空目录。
`Integer`	`getUserId()` 返回初始化此实例时使用的 userId。
`boolean`	`pullDir(String deviceFilePath, File localDir)` 使用 content provider 以递归方式从设备中提取目录内容。
`boolean`	`pullFile(String deviceFilePath, File localFile)` 用于将 URI 位置中的文件拉取到本地文件的内容提供程序回调。
`boolean`	`pushDir(File localFileDir, String deviceFilePath, excludedDirectories)` 用于将目录推送到 URI 位置的 content provider 回调。
`boolean`	`pushFile(File fileToPush, String deviceFilePath)` 用于将文件推送到 URI 位置的 content provider 回调。
`boolean`	`setUp()` 确保内容提供方帮助程序 APK 已安装且可供使用。
`void`	`tearDown()` 通过 content provider 帮助程序清理设备。

字段

列

public static final String[] COLUMNS

COLUMN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

COLUMN_DIRECTORY

public static final String COLUMN_DIRECTORY

COLUMN_METADATA

public static final String COLUMN_METADATA

COLUMN_MIME_TYPE

public static final String COLUMN_MIME_TYPE

COLUMN_NAME

public static final String COLUMN_NAME

CONTENT_PROVIDER_URI

public static final String CONTENT_PROVIDER_URI

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

PACKAGE_NAME

public static final String PACKAGE_NAME

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

公共构造函数

ContentProviderHandler

public ContentProviderHandler (ITestDevice device)

构造函数。

参数
`device`	`ITestDevice`

抛出
`DeviceNotAvailableException`

ContentProviderHandler

public ContentProviderHandler (ITestDevice device, 
                Integer userId)

参数
`device`	`ITestDevice`
`userId`	`Integer`

公共方法

找不到 contentProvider

public boolean contentProviderNotFound ()

如果某项操作失败且未找到内容提供程序，则返回 True。可清除重新运行 setUp()。

返回
`boolean`

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

返回给定设备路径的完整 URI 字符串，并进行转义和编码以避免使用非网址字符。

参数
`deviceFilePath`	`String`

返回
`String`

deleteFile

public boolean deleteFile (String deviceFilePath)

用于删除 URI 位置处文件的内容提供程序回调。文件将从以下位置删除：设备内容。

参数
`deviceFilePath`	`String`：要删除的文件设备上的路径。

返回
`boolean`	如果成功，则为 true，否则为 false

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

doFileExist

public boolean doesFileExist (String deviceFilePath)

确定设备上是否存在文件或非空目录。

参数
`deviceFilePath`	`String`：设备上要检查是否存在的绝对文件路径。

返回
`boolean`	如果文件/目录存在，则为 true，否则为 false。如果目录为空，则返回同样错误。

抛出
`DeviceNotAvailableException`

获取用户 ID

public Integer getUserId ()

返回初始化此实例时使用的 userId。

返回
`Integer`

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

使用 content provider 以递归方式从设备中提取目录内容。

参数
`deviceFilePath`	`String`：远程来源的绝对文件路径
`localDir`	`File`：用于拉取文件的本地目录

返回
`boolean`	如果文件已成功拉取，则为 `true`。否则为 `false`。

抛出
`DeviceNotAvailableException`	如果与设备的连接已断开且无法连接已恢复。

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

用于将 URI 位置中的文件拉取到本地文件的内容提供程序回调。

参数
`deviceFilePath`	`String`：设备上的路径，可从中拉取文件。
`localFile`	`File`：用于存储内容的 `ERROR(/File)`。如果不为空，内容将是已替换。

返回
`boolean`	如果成功，则为 true，否则为 false

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

推送目录

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

用于将目录推送到 URI 位置的 content provider 回调。

参数
`localFileDir`	`File`：要推送的目录
`deviceFilePath`	`String`：设备上的位置
`excludedDirectories`	：推送中未包含的目录。

返回
`boolean`	如果成功，则为 true

抛出
	com.android.tradefed.device.DeviceNotAvailableException
`DeviceNotAvailableException`

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

用于将文件推送到 URI 位置的 content provider 回调。

参数
`fileToPush`	`File`：要推送到设备的 `ERROR(/File)`。
`deviceFilePath`	`String`：设备上要将文件推送到其中的路径。

返回
`boolean`	如果成功，则为 true，否则为 false

抛出
	com.android.tradefed.device.DeviceNotAvailableException
	IllegalArgumentException
`DeviceNotAvailableException`

设置

public boolean setUp ()

确保内容提供方帮助程序 APK 已安装且可供使用。

返回
`boolean`	如果可供使用，则为 true，否则为 false。

抛出
`DeviceNotAvailableException`

拆解

public void tearDown ()

通过 content provider 帮助程序清理设备。

抛出
`DeviceNotAvailableException`