معرِّف 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) الكاملة لمسار الجهاز المحدّد، مع تخطّيها وترميزها لتجنّب الأحرف التي لا تمثّل عنوان URL.
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

البيانات الوصفية للعمود

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_{8/}معرّف الموارد المنتظم (URI)

public static final String CONTENT_PROVIDER_URI

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

حزمة_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

الطرق العامة

لم يتم العثور على contentProvider

public boolean contentProviderNotFound ()

يعرض True إذا فشلت إحدى العمليات مع عدم العثور على موفر المحتوى. ويمكن محوها من خلال إعادة تشغيل setUp() بنجاح.

الركلات المردودة
boolean

إنشاء EscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

تعرض سلسلة معرّف الموارد المنتظم (URI) الكاملة لمسار الجهاز المحدّد، مع تخطّيها وترميزها لتجنّب الأحرف التي لا تمثّل عنوان 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	يتم الضبط على "صحيح" في حال توفُّر الملف أو الدليل، بينما يكون الإعداد "خطأ" في الحالات الأخرى. وإذا كان الدليل فارغًا، سيعرض الإعداد False أيضًا.

الرميات
DeviceNotAvailableException

getUserId

public Integer getUserId ()

تعرض userId الذي تم إعداد هذا المثيل باستخدامه.

الركلات المردودة
Integer

سحب

public boolean pullDir (String deviceFilePath, 
                File localDir)

سحب محتوى الدليل من الجهاز بشكل متكرر باستخدام موفّر المحتوى

المعلّمات
deviceFilePath	String: المسار المطلق للملف للمصدر البعيد
localDir	File: الدليل المحلي لسحب الملفات إليه

الركلات المردودة
boolean	true إذا تم سحب الملف بنجاح. false بخلاف ذلك.

الرميات
DeviceNotAvailableException	في حال فقد الاتصال بالجهاز وتعذّر استرداده.

ملف سحب

public boolean pullFile (String deviceFilePath, 
                File localFile)

استدعاء موفّر المحتوى الذي يسحب ملفًا من موقع معرّف الموارد المنتظم (URI) إلى ملف محلي.

المعلّمات
deviceFilePath	String: المسار على الجهاز حيث سيتم سحب الملف منه.
localFile	File: السمة ERROR(/File) المطلوب تخزين المحتوى فيها وإذا لم تكن فارغة، سيتم استبدال المحتوى.

الركلات المردودة
boolean	صواب إذا كانت ناجحة، وخطأ بخلاف ذلك

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

مفتاح الدفع

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

استدعاء موفّر المحتوى الذي يدفع dir إلى موقع معرّف الموارد المنتظم (URI).

المعلّمات
localFileDir	File: الدليل المطلوب إرسال بياناته
deviceFilePath	String: الموقع الجغرافي على الجهاز
excludedDirectories	: الأدلة غير مضمَّنة في عملية الإرسال.

الركلات المردودة
boolean	صواب إذا كانت ناجحة

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

ملف الدفع

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

معاودة الاتصال بموفّر المحتوى التي ترسل ملفًا إلى موقع معرّف الموارد المنتظم (URI).

المعلّمات
fileToPush	File: القيمة "ERROR(/File)" المطلوب دفعها إلى الجهاز
deviceFilePath	String: المسار على الجهاز الذي تريد إرسال الملف إليه

الركلات المردودة
boolean	صواب إذا كانت ناجحة، وخطأ بخلاف ذلك

الرميات
	com.android.tradefed.device.DeviceNotavailableException
	استثناء وسيطة غير قانونية
DeviceNotAvailableException

إعداد

public boolean setUp ()

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

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

الرميات
DeviceNotAvailableException

قطع

public void tearDown ()

نظِّف الجهاز من مساعد موفّر المحتوى.

الرميات
DeviceNotAvailableException