ContentProviderHandler

public class ContentProviderHandler
extends Object

java.lang.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) الكامل لمسار الجهاز المحدّد، مع إزالة أي أحرف غير متوافقة مع عناوين URL واستبدالها بأحرف أخرى.
boolean	deleteFile(String deviceFilePath) دالة رد الاتصال لموفّر المحتوى التي تحذف ملفًا في موقع معرّف الموارد المنتظم (URI)
boolean	doesFileExist(String deviceFilePath) تحدِّد ما إذا كان الملف أو الدليل غير الفارغ متوفّرًا على الجهاز.
IRunUtil	getRunUtil()
Integer	getUserId() تعرِض هذه السمة رقم تعريف المستخدم الذي تمّت تهيئة هذا المثيل به.
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() محو الجهاز من أداة مساعدة موفّر المحتوى

الثوابت

COLUMN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

القيمة الثابتة: "absolute_path"

COLUMN_DIRECTORY

public static final String COLUMN_DIRECTORY

القيمة الثابتة: "is_directory"

COLUMN_METADATA

public static final String COLUMN_METADATA

Constant Value: "metadata"

COLUMN_MIME_TYPE

public static final String COLUMN_MIME_TYPE

القيمة الثابتة: "mime_type"

COLUMN_NAME

public static final String COLUMN_NAME

Constant Value: "name"

CONTENT_PROVIDER_URI

public static final String CONTENT_PROVIDER_URI

القيمة الثابتة: "content://android.tradefed.contentprovider"

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

Constant Value: "No result found."

PACKAGE_NAME

public static final String PACKAGE_NAME

Constant Value: "android.tradefed.contentprovider"

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

Constant Value: "INFO"

الحقول

أعمدة

public static final String[] COLUMNS

الإنشاءات العامة

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	صحيح إذا كان ناجحًا، خطأ في الحالات الأخرى

الرميات
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

تحدِّد ما إذا كان الملف أو الدليل غير الفارغ متوفّرًا على الجهاز.

المعلمات
deviceFilePath	‫String: مسار الملف المطلق على الجهاز للتحقّق من توفّره.

المرتجعات
boolean	صحيح إذا كان الملف أو الدليل متوفّرًا، وخطأ في الحالات الأخرى. إذا كان الدليل فارغًا، سيتم عرض القيمة False أيضًا.

الرميات
DeviceNotAvailableException

getRunUtil

public IRunUtil getRunUtil ()

المرتجعات
IRunUtil

getUserId

public Integer getUserId ()

تعرِض هذه السمة رقم تعريف المستخدم الذي تمّت تهيئة هذا المثيل به.

المرتجعات
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)

دالة ردّ الاتصال لموفّر المحتوى التي تسحب ملفًا من موقع 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	‫: الأدلة غير المضمّنة في عملية الدفع

المرتجعات
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
	IllegalArgumentException
DeviceNotAvailableException

setRunUtil

public void setRunUtil (IRunUtil runUtil)

المعلمات
runUtil	IRunUtil

setUp

public boolean setUp ()

تأكَّد من تثبيت حزمة APK الخاصة بأداة مساعدة مقدّم المحتوى وأنّها جاهزة للاستخدام.

المرتجعات
boolean	صحيح إذا كان جاهزًا للاستخدام، وخطأ في الحالات الأخرى.

الرميات
DeviceNotAvailableException

tearDown

public void tearDown ()

محو الجهاز من أداة مساعدة موفّر المحتوى

الرميات
DeviceNotAvailableException