مدیریت کننده محتوا

public class ContentProviderHandler
extends 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 را برای مسیر دستگاه داده شده، به صورت escape شده و کدگذاری شده برای جلوگیری از کاراکترهای غیر URL برمی‌گرداند.
boolean	deleteFile (String deviceFilePath) فراخوانی ارائه دهنده محتوا که فایلی را در محل URI حذف می‌کند.
boolean	doesFileExist (String deviceFilePath) تعیین می‌کند که آیا فایل یا دایرکتوری غیر خالی روی دستگاه وجود دارد یا خیر.
IRunUtil	getRunUtil ()
Integer	getUserId () شناسه کاربری (userId) که این نمونه با آن مقداردهی اولیه شده است را برمی‌گرداند.
boolean	pullDir (String deviceFilePath, File localDir) به صورت بازگشتی محتویات دایرکتوری را با استفاده از ارائه دهنده محتوا از دستگاه دریافت می‌کند.
boolean	pullFile (String deviceFilePath, File localFile) فراخوانی ارائه دهنده محتوا که یک فایل را از مکان URI به یک فایل محلی منتقل می‌کند.
boolean	pushDir (File localFileDir, String deviceFilePath, excludedDirectories) فراخوانی ارائه دهنده محتوا که یک دایرکتوری را به مکان URI ارسال می‌کند.
boolean	pushFile (File fileToPush, String deviceFilePath) فراخوانی‌های ارائه‌دهنده محتوا که یک فایل را به مکان URI ارسال می‌کنند.
void	setRunUtil ( IRunUtil runUtil)
boolean	setUp () مطمئن شوید که فایل apk کمکی ارائه دهنده محتوا نصب شده و آماده استفاده است.
void	tearDown () دستگاه را از روی کمک‌رسان ارائه‌دهنده محتوا پاک کنید.

ثابت‌ها

مسیر مطلق ستون

public static final String COLUMN_ABSOLUTE_PATH

مقدار ثابت: "absolute_path"

دایرکتوری ستون

public static final String COLUMN_DIRECTORY

مقدار ثابت: "is_directory"

فراداده ستون

public static final String COLUMN_METADATA

مقدار ثابت: "فراداده"

نوع_MIME_ستون

public static final String COLUMN_MIME_TYPE

مقدار ثابت: "mime_type"

نام ستون

public static final String COLUMN_NAME

مقدار ثابت: "نام"

URL_ارائه‌دهنده_محتوا

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"

مقدار پرس و جو

public static final String QUERY_INFO_VALUE

مقدار ثابت: "اطلاعات"

فیلدها

ستون‌ها

public static final String[] COLUMNS

سازندگان عمومی

مدیریت کننده محتوا

public ContentProviderHandler (ITestDevice device)

سازنده

پارامترها
device	ITestDevice

پرتاب‌ها
DeviceNotAvailableException

مدیریت کننده محتوا

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 را برای مسیر دستگاه داده شده، به صورت escape شده و کدگذاری شده برای جلوگیری از کاراکترهای غیر URL برمی‌گرداند.

پارامترها
deviceFilePath	String

بازگشت‌ها
String

حذف فایل

public boolean deleteFile (String deviceFilePath)

فراخوانی ارائه دهنده محتوا که یک فایل را در محل URI حذف می‌کند. فایل از محتوای دستگاه حذف خواهد شد.

پارامترها
deviceFilePath	String : مسیر فایلی که قرار است حذف شود روی دستگاه.

بازگشت‌ها
boolean	اگر موفق باشد درست، در غیر این صورت نادرست

پرتاب‌ها
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

آیافایل‌موجود است؟

public boolean doesFileExist (String deviceFilePath)

تعیین می‌کند که آیا فایل یا دایرکتوری غیر خالی روی دستگاه وجود دارد یا خیر.

پارامترها
deviceFilePath	String : مسیر مطلق فایل روی دستگاه که باید وجود آن بررسی شود.

بازگشت‌ها
boolean	اگر فایل/دایرکتوری وجود داشته باشد، مقدار True و در غیر این صورت False برمی‌گرداند. اگر دایرکتوری خالی باشد، مقدار False نیز برگردانده می‌شود.

پرتاب‌ها
DeviceNotAvailableException

دریافت RunUtil

public IRunUtil getRunUtil ()

بازگشت‌ها
IRunUtil

دریافت شناسه کاربری

public Integer getUserId ()

شناسه کاربری (userId) که این نمونه با آن مقداردهی اولیه شده است را برمی‌گرداند.

بازگشت‌ها
Integer

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

به صورت بازگشتی محتویات دایرکتوری را با استفاده از ارائه دهنده محتوا از دستگاه دریافت می‌کند.

پارامترها
deviceFilePath	String : مسیر مطلق فایل منبع راه دور
localDir	File : دایرکتوری محلی برای انتقال فایل‌ها به آن

بازگشت‌ها
boolean	اگر فایل با موفقیت استخراج شده باشد، true و در غیر این صورت false برمی‌گرداند.

پرتاب‌ها
DeviceNotAvailableException	اگر ارتباط با دستگاه قطع شده و قابل بازیابی نباشد.

فایل pull

public boolean pullFile (String deviceFilePath, 
                File localFile)

فراخوانی ارائه دهنده محتوا که یک فایل را از مکان URI به یک فایل محلی منتقل می‌کند.

پارامترها
deviceFilePath	String : مسیری روی دستگاه که فایل از آنجا دریافت می‌شود.
localFile	File : ERROR(/File) برای ذخیره محتویات. اگر خالی نباشد، محتویات جایگزین می‌شوند.

بازگشت‌ها
boolean	اگر موفق باشد درست، در غیر این صورت نادرست

پرتاب‌ها
	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	اگر موفق باشد درست، در غیر این صورت نادرست

پرتاب‌ها
	com.android.tradefed.device.DeviceNotAvailableException
	استثنای استدلال غیرقانونی
DeviceNotAvailableException

setRunUtil

public void setRunUtil (IRunUtil runUtil)

پارامترها
runUtil	IRunUtil

راه‌اندازی

public boolean setUp ()

مطمئن شوید که فایل apk کمکی ارائه دهنده محتوا نصب شده و آماده استفاده است.

بازگشت‌ها
boolean	اگر آماده استفاده باشد، درست و در غیر این صورت نادرست است.

پرتاب‌ها
DeviceNotAvailableException

اشک‌ریزان

public void tearDown ()

دستگاه را از روی کمک‌رسان ارائه‌دهنده محتوا پاک کنید.

پرتاب‌ها
DeviceNotAvailableException