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() 操作の 1 つが失敗し、コンテンツ プロバイダが見つからなかった場合に 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) コンテンツ プロバイダを使用して、デバイスからディレクトリ コンテンツを再帰的に pull します。
boolean	pullFile(String deviceFilePath, File localFile) URI の場所からローカル ファイルにファイルを pull するコンテンツ プロバイダのコールバック。
boolean	pushDir(File localFileDir, String deviceFilePath, excludedDirectories) URI の場所にディレクトリをプッシュするコンテンツ プロバイダのコールバック。
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

列名

public static final String COLUMN_NAME

コンテンツ プロバイダ 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 ()

操作の 1 つが失敗し、コンテンツ プロバイダが見つからなかった場合に 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)

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

パラメータ
deviceFilePath	String: リモートソースの絶対ファイルパス
localDir	File: ファイルを pull するローカル ディレクトリ

戻り値
boolean	ファイルが正常に pull された場合は true。そうでない場合は false。

例外
DeviceNotAvailableException	デバイスとの接続が失われ、復元できない場合。

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

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

パラメータ
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: push するディレクトリ
deviceFilePath	String: デバイス上の位置情報
excludedDirectories	: push に含まれないディレクトリ。

戻り値
boolean	成功した場合は true

例外
	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