ContentProviderHandler

public class ContentProviderHandler
extends Object

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

コンテンツ プロバイダの操作を抽象化し、さまざまなオペレーションでデバイス側のコンテンツ プロバイダを使用できるようにするハンドラ。

このクラスのすべての実装では、デバイスで現在実行されているユーザーに注意する必要があります。

概要

フィールド

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 文字列を返します。URL 以外の文字が含まれないようにエスケープしてエンコードします。

boolean deleteFile(String deviceFilePath)

URI の場所にあるファイルを削除するコンテンツ プロバイダ コールバック。

boolean doesFileExist(String deviceFilePath)

ファイルまたは空でないディレクトリがデバイスに存在するかどうかを判断します。

Integer getUserId()

このインスタンスが初期化された userId を返します。

boolean pullDir(String deviceFilePath, File localDir)

コンテンツ プロバイダを使用して、デバイスからディレクトリの内容を再帰的に取得。

boolean pullFile(String deviceFilePath, File localFile)

URI の場所からローカル ファイルにファイルを取得するコンテンツ プロバイダ コールバック。

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

URI の場所にあるディレクトリを push するコンテンツ プロバイダ コールバック。

boolean pushFile(File fileToPush, String deviceFilePath)

ファイルを URI の場所に push するコンテンツ プロバイダ コールバック。

boolean setUp()

コンテンツ プロバイダ ヘルパー APK がインストールされ、使用可能であることを確認します。

void tearDown()

コンテンツ プロバイダ ヘルパーからデバイスをクリーンアップします。

フィールド

列

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

パブリック メソッド

contentProviderNotFound

public boolean contentProviderNotFound ()

いずれかの操作が失敗し、コンテンツ プロバイダが見つからない場合は true を返します。setUp() を再度正常に実行すると消去できます。

戻り値
boolean

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

指定されたデバイスパスの完全な URI 文字列を返します。URL 以外の文字が含まれないようにエスケープしてエンコードします。

パラメータ
deviceFilePath String

戻り値
String

deleteFile

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

getUserId

public Integer getUserId ()

このインスタンスが初期化された userId を返します。

戻り値
Integer

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

コンテンツ プロバイダを使用して、デバイスからディレクトリの内容を再帰的に取得します。

パラメータ
deviceFilePath String: リモート ソースの絶対ファイルパス
localDir File: ファイルを pull するローカル ディレクトリ
戻り値
boolean ファイルが正常に pull された場合は true。それ以外の場合は false。
例外
DeviceNotAvailableException デバイスとの接続が失われ、復元できない場合。

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

URI の場所からローカル ファイルにファイルを取得するコンテンツ プロバイダ コールバック。

パラメータ
deviceFilePath String: ファイルを pull するデバイス上のパス。
localFile File: コンテンツを保存する ERROR(/File)。空でない場合、コンテンツが置き換えられます。
戻り値
boolean 成功した場合は true、それ以外の場合は false
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pushDir

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

URI の場所にあるディレクトリを push するコンテンツ プロバイダ コールバック。

パラメータ
localFileDir File: push するディレクトリ
deviceFilePath String: デバイス上の場所
excludedDirectories : push に含まれないディレクトリ。
戻り値
boolean 成功した場合は true
例外
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

ファイルを URI の場所に push するコンテンツ プロバイダ コールバック。

パラメータ
fileToPush File: デバイスに push される ERROR(/File)。
deviceFilePath String: ファイルを push するデバイス上のパス。
戻り値
boolean 成功した場合は true、それ以外の場合は false
例外
com.android.tradefed.device.DeviceNotAvailableException
IllegalArgumentException
DeviceNotAvailableException

setUp

public boolean setUp ()

コンテンツ プロバイダ ヘルパー APK がインストールされ、使用可能であることを確認します。

戻り値
boolean 使用できる場合は true、それ以外の場合は false。
例外
DeviceNotAvailableException

tearDown

public void tearDown ()

コンテンツ プロバイダ ヘルパーからデバイスをクリーンアップします。

例外
DeviceNotAvailableException