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 字串 (逸出和編碼，以避免非網址) 字元。
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) 內容供應器回呼，可將 dir 推送至 URI 位置。
boolean	pushFile(File fileToPush, String deviceFilePath) 可將檔案推送至 URI 位置的內容供應器回呼。
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

內容供應商 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

建立 EscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

傳回指定裝置路徑的完整 URI 字串 (逸出和編碼，以避免非網址) 字元。

參數
deviceFilePath	String

傳回
String

刪除檔案

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

getUserId

public Integer getUserId ()

傳回用於初始化這個執行個體的 userId。

傳回
Integer

拉克迪爾

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)

內容供應器回呼，可將 dir 推送至 URI 位置。

參數
localFileDir	File：要推送的目錄
deviceFilePath	String：裝置端位置資訊
excludedDirectories	：未包含在推送作業中的目錄。

傳回
boolean	若成功，則為 True

擲回
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

推送檔案

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	可供使用時為「是」，否則傳回「否」。

擲回
DeviceNotAvailableException

TearDown

public void tearDown ()

使用內容供應器的輔助工具清理裝置。

擲回
DeviceNotAvailableException