ContentProviderHandler
public class ContentProviderHandler
extends Object
| java.lang.Object | |
| ↳ | com.android.tradefed.device.contentprovider.ContentProviderHandler |
Обработчик, который абстрагирует взаимодействия с поставщиком контента и позволяет использовать поставщика контента на стороне устройства для различных операций.
Все реализации в этом классе должны учитывать пользователя, работающего в данный момент на устройстве.
Краткое содержание
Константы | |
|---|---|
String | COLUMN_ABSOLUTE_PATH |
String | COLUMN_DIRECTORY |
String | COLUMN_METADATA |
String | COLUMN_MIME_TYPE |
String | COLUMN_NAME |
String | CONTENT_PROVIDER_URI |
String | NO_RESULTS_STRING |
String | PACKAGE_NAME |
String | QUERY_INFO_VALUE |
Поля | |
|---|---|
public static final String[] | COLUMNS |
Публичные конструкторы | |
|---|---|
ContentProviderHandler ( ITestDevice device)Конструктор. | |
ContentProviderHandler ( ITestDevice device, Integer userId) | |
Публичные методы | |
|---|---|
boolean | contentProviderNotFound ()Возвращает True, если одна из операций завершилась неудачей и поставщик контента не найден. |
static String | createEscapedContentUri (String deviceFilePath)Возвращает полную строку URI для заданного пути устройства, экранированную и закодированную для исключения символов, не входящих в URL. |
boolean | deleteFile (String deviceFilePath)Обратный вызов поставщика контента, который удаляет файл в местоположении URI. |
boolean | doesFileExist (String deviceFilePath)Определяет, существует ли файл или непустой каталог на устройстве. |
IRunUtil | getRunUtil () |
Integer | getUserId ()Возвращает идентификатор пользователя, с которым инициализируется этот экземпляр. |
boolean | pullDir (String deviceFilePath, File localDir)Рекурсивно извлечь содержимое каталога с устройства, используя поставщик контента. |
boolean | pullFile (String deviceFilePath, File localFile)Обратный вызов поставщика контента, который извлекает файл из местоположения URI в локальный файл. |
boolean | pushDir (File localFileDir, String deviceFilePath,Обратный вызов поставщика контента, который помещает каталог в местоположение URI. |
boolean | pushFile (File fileToPush, String deviceFilePath)Обратный вызов поставщика контента, который отправляет файл в местоположение URI. |
void | setRunUtil ( IRunUtil runUtil) |
boolean | setUp ()Убедитесь, что APK-файл помощника поставщика контента установлен и готов к использованию. |
void | tearDown ()Очистите устройство от помощника поставщика контента. |
Константы
COLUMN_ABSOLUTE_PATH
public static final String COLUMN_ABSOLUTE_PATH
Постоянное значение: «absolute_path»
COLUMN_DIRECTORY
public static final String COLUMN_DIRECTORY
Постоянное значение: "is_directory"
COLUMN_METADATA
public static final String COLUMN_METADATA
Постоянное значение: «метаданные»
COLUMN_MIME_TYPE
public static final String COLUMN_MIME_TYPE
Постоянное значение: «mime_type»
COLUMN_NAME
public static final String COLUMN_NAME
Постоянное значение: «имя»
CONTENT_PROVIDER_URI
public static final String CONTENT_PROVIDER_URI
Постоянное значение: "content://android.tradefed.contentprovider"
НЕТ_РЕЗУЛЬТАТОВ_СТРОКИ
public static final String NO_RESULTS_STRING
Постоянное значение: «Результат не найден».
ИМЯ_ПАКЕТА
public static final String PACKAGE_NAME
Постоянное значение: «android.tradefed.contentprovider»
QUERY_INFO_VALUE
public static final String QUERY_INFO_VALUE
Постоянное значение: «INFO»
Поля
КОЛОННЫ
public static final String[] COLUMNS
Публичные конструкторы
ContentProviderHandler
public ContentProviderHandler (ITestDevice device)
Конструктор.
| Параметры | |
|---|---|
device | ITestDevice |
| Броски | |
|---|---|
DeviceNotAvailableException | |
ContentProviderHandler
public ContentProviderHandler (ITestDevice device, Integer userId)
| Параметры | |
|---|---|
device | ITestDevice |
userId | Integer |
Публичные методы
contentProviderNotFound
public boolean contentProviderNotFound ()
Возвращает True, если одна из операций завершилась неудачей и поставщик контента не найден. Можно сбросить это, успешно выполнив setUp() ещё раз.
| Возврат | |
|---|---|
boolean | |
createEscapedContentUri
public static String createEscapedContentUri (String deviceFilePath)
Возвращает полную строку URI для заданного пути устройства, экранированную и закодированную для исключения символов, не входящих в URL.
| Параметры | |
|---|---|
deviceFilePath | String |
| Возврат | |
|---|---|
String | |
удалитьФайл
public boolean deleteFile (String deviceFilePath)
Обратный вызов поставщика контента, который удаляет файл по указанному URI. Файл будет удалён из содержимого устройства.
| Параметры | |
|---|---|
deviceFilePath | String : Путь на устройстве к файлу, который необходимо удалить. |
| Возврат | |
|---|---|
boolean | True в случае успеха, False в противном случае |
| Броски | |
|---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException | |
doesFileExist
public boolean doesFileExist (String deviceFilePath)
Определяет, существует ли файл или непустой каталог на устройстве.
| Параметры | |
|---|---|
deviceFilePath | String : Абсолютный путь к файлу на устройстве, существование которого проверяется. |
| Возврат | |
|---|---|
boolean | True, если файл/каталог существует, False в противном случае. Если каталог пуст, функция также вернёт False. |
| Броски | |
|---|---|
DeviceNotAvailableException | |
получитьUserId
public Integer getUserId ()
Возвращает идентификатор пользователя, с которым инициализируется этот экземпляр.
| Возврат | |
|---|---|
Integer | |
pullDir
public boolean pullDir (String deviceFilePath,
File localDir)Рекурсивно извлечь содержимое каталога с устройства, используя поставщик контента.
| Параметры | |
|---|---|
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 | |
pushDir
public boolean pushDir (File localFileDir,
String deviceFilePath,
excludedDirectories) Обратный вызов поставщика контента, который помещает каталог в местоположение URI.
| Параметры | |
|---|---|
localFileDir | File : Каталог для отправки |
deviceFilePath | String : Местоположение на устройстве |
excludedDirectories | : Каталоги, не включенные в push-запрос. |
| Возврат | |
|---|---|
boolean | Правда, если успешно |
| Броски | |
|---|---|
| com.android.tradefed.device.DeviceNotAvailableException |
DeviceNotAvailableException | |
pushFile
public boolean pushFile (File fileToPush,
String deviceFilePath)Обратный вызов поставщика контента, который отправляет файл в местоположение URI.
| Параметры | |
|---|---|
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 ()
Очистите устройство от помощника поставщика контента.
| Броски | |
|---|---|
DeviceNotAvailableException | |