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 המלאה של הנתיב הנתון, עם תווי בריחה (escape) וקידוד כדי להימנע מתווים שאינם כתובות URL.
boolean	deleteFile(String deviceFilePath) קריאה חוזרת (callback) של ספק התוכן שמוחקת קובץ במיקום ה-URI.
boolean	doesFileExist(String deviceFilePath) המדיניות קובעת אם הקובץ או ספרייה שהיא לא ריקה קיימת במכשיר.
Integer	getUserId() הפונקציה מחזירה את ה-User-ID שאיתו המופע הזה מאותחל.
boolean	pullDir(String deviceFilePath, File localDir) שליפת תוכן ספרייה מהמכשיר באופן רקורסיבי באמצעות ספק התוכן.
boolean	pullFile(String deviceFilePath, File localFile) קריאה חוזרת (callback) של ספק התוכן, שולפת קובץ ממיקום ה-URI לקובץ מקומי.
boolean	pushDir(File localFileDir, String deviceFilePath, excludedDirectories) קריאה חוזרת (callback) של ספק התוכן שדוחפת dir למיקום ה-URI.
boolean	pushFile(File fileToPush, String deviceFilePath) קריאה חוזרת (callback) של ספק התוכן שדוחפת קובץ למיקום ה-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

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 המלאה של הנתיב הנתון, עם תווי בריחה (escape) וקידוד כדי להימנע מתווים שאינם כתובות URL.

פרמטרים
deviceFilePath	String

החזרות
String

DeleteFile

public boolean deleteFile (String deviceFilePath)

קריאה חוזרת (callback) של ספק התוכן שמוחקת קובץ במיקום ה-URI. הקובץ יימחק מהתוכן במכשיר.

פרמטרים
deviceFilePath	String: הנתיב במכשיר של הקובץ שרוצים למחוק.

החזרות
boolean	True אם הפעולה בוצעה בהצלחה, False אם לא

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

DoFileExist

public boolean doesFileExist (String deviceFilePath)

המדיניות קובעת אם הקובץ או ספרייה שהיא לא ריקה קיימת במכשיר.

פרמטרים
deviceFilePath	String: הנתיב המוחלט של הקובץ במכשיר כדי לבדוק אם קיים.

החזרות
boolean	True אם קיימים קובץ/ספרייה, אחרת False. אם הספרייה ריקה, הפונקציה תחזיר גם את הערך False.

קליעות
DeviceNotAvailableException

מזהה משתמש [getUserId]

public Integer getUserId ()

הפונקציה מחזירה את ה-User-ID שאיתו המופע הזה מאותחל.

החזרות
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)

קריאה חוזרת (callback) של ספק התוכן, שולפת קובץ ממיקום ה-URI לקובץ מקומי.

פרמטרים
deviceFilePath	String: הנתיב במכשיר שממנו מאחזרים את הקובץ.
localFile	File: ה-ERROR(/File) שבו יש לאחסן את התוכן. אם השדה לא ריק, התוכן יוחלף.

החזרות
boolean	True אם הפעולה בוצעה בהצלחה, False אם לא

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

PushDir

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

קריאה חוזרת (callback) של ספק התוכן שדוחפת dir למיקום ה-URI.

פרמטרים
localFileDir	File: הספרייה שרוצים לדחוף
deviceFilePath	String: המיקום במכשיר
excludedDirectories	: הספריות לא נכללות בדחיפה.

החזרות
boolean	True אם הפעולה בוצעה בהצלחה

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
DeviceNotAvailableException

קובץ PushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

קריאה חוזרת (callback) של ספק התוכן שדוחפת קובץ למיקום ה-URI.

פרמטרים
fileToPush	File: ה-ERROR(/File) שיש להעביר למכשיר.
deviceFilePath	String: הנתיב במכשיר שאליו צריך להעביר את הקובץ.

החזרות
boolean	True אם הפעולה בוצעה בהצלחה, False אם לא

קליעות
	com.android.tradefed.device.DeviceNotAvailableExt [המכשיר לא זמין]
	החרגה לא חוקית
DeviceNotAvailableException

הגדרה

public boolean setUp ()

מוודאים שאפליקציית ה-APK העזרה של ספק התוכן מותקנת ומוכנה לשימוש.

החזרות
boolean	True אם הוא מוכן לשימוש, אחרת False.

קליעות
DeviceNotAvailableException

פירעון

public void tearDown ()

מנקים את המכשיר בעזרת כלי העזר של ספק התוכן.

קליעות
DeviceNotAvailableException