FileListingService

public final class FileListingService
extends Object

java.lang.Object
   ↳ com.android.ddmlib.FileListingService


تقدّم هذه الخدمة قائمة بملفات IDevice الجانبية.

ملخّص

الصفوف المتداخلة

class FileListingService.FileEntry

تمثّل هذه السمة إدخالاً في دليل. 

interface FileListingService.IListingReceiver

توفّر الفئات التي تنفّذ هذه الواجهة طريقة للتعامل مع النتائج غير المتزامنة من أمر ls على الجهاز. 

الثوابت

String DIRECTORY_APP

مجلد التطبيقات

String DIRECTORY_DATA

مجلد البيانات على المستوى الأعلى

String DIRECTORY_MNT

مجلد التحميل على المستوى الأعلى

String DIRECTORY_SDCARD

مجلد بطاقة SD على المستوى الأعلى

String DIRECTORY_SYSTEM

مجلد النظام على المستوى الأعلى

String DIRECTORY_TEMP

مجلد الملفات المؤقتة على المستوى الأعلى

String FILE_SEPARATOR

فاصل الملفات على الجهاز

long REFRESH_RATE

int TYPE_BLOCK

نوع الإدخال: حظر

int TYPE_CHARACTER

نوع الإدخال: حرف

int TYPE_DIRECTORY

نوع الإدخال: دليل

int TYPE_DIRECTORY_LINK

نوع الإدخال: رابط دليل

int TYPE_FIFO

نوع الإدخال: FIFO

int TYPE_FILE

نوع الإدخال: ملف

int TYPE_LINK

نوع الإدخال: رابط

int TYPE_OTHER

نوع الإدخال: غير ذلك

int TYPE_SOCKET

نوع الإدخال: مقبس

الحقول

public static final Pattern LS_LD_PATTERN

public static final Pattern LS_L_PATTERN

نمط Regexp لتحليل النتيجة من ls.

public static final Pattern STAT_PATTERN

نمط Regexp لتحليل النتيجة من الإحصاء.

طُرق وضع التصميم العامة

FileListingService(IDevice device)

تنشئ هذه الطريقة خدمة "قائمة الملفات" لـ IDevice محدّد.

الإجراءات العامة

FileEntry[] getChildren(FileListingService.FileEntry entry, boolean useCache, FileListingService.IListingReceiver receiver)

تعرض هذه الدالة العناصر الفرعية من FileEntry.

static FileEntry[] getChildrenSync(FileListingService.FileEntry entry, INativeDevice device)

تعرض هذه الدالة العناصر الفرعية من FileEntry.

FileListingService.FileEntry getRoot()

تعرِض هذه السمة عنصر الجذر.

الثوابت

DIRECTORY_APP

public static final String DIRECTORY_APP

مجلد التطبيقات

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

DIRECTORY_DATA

public static final String DIRECTORY_DATA

مجلد البيانات على المستوى الأعلى

Constant Value: "data"

DIRECTORY_MNT

public static final String DIRECTORY_MNT

مجلد التحميل على المستوى الأعلى

Constant Value: "mnt"

DIRECTORY_SDCARD

public static final String DIRECTORY_SDCARD

مجلد بطاقة SD على المستوى الأعلى

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

DIRECTORY_SYSTEM

public static final String DIRECTORY_SYSTEM

مجلد النظام على المستوى الأعلى

Constant Value: "system"

DIRECTORY_TEMP

public static final String DIRECTORY_TEMP

مجلد مؤقت على المستوى الأعلى

Constant Value: "tmp"

FILE_SEPARATOR

public static final String FILE_SEPARATOR

فاصل الملفات على الجهاز

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

REFRESH_RATE

public static final long REFRESH_RATE

القيمة الثابتة: 5000 (0x0000000000001388)

TYPE_BLOCK

public static final int TYPE_BLOCK

نوع الإدخال: حظر

Constant Value: 3 (0x00000003)

TYPE_CHARACTER

public static final int TYPE_CHARACTER

نوع الإدخال: حرف

القيمة الثابتة: 4 (0x00000004)

TYPE_DIRECTORY

public static final int TYPE_DIRECTORY

نوع الإدخال: دليل

القيمة الثابتة: 1 (0x00000001)

public static final int TYPE_DIRECTORY_LINK

نوع الإدخال: رابط دليل

Constant Value: 2 (0x00000002)

TYPE_FIFO

public static final int TYPE_FIFO

نوع الإدخال: FIFO

القيمة الثابتة: 7 (0x00000007)

TYPE_FILE

public static final int TYPE_FILE

نوع الإدخال: ملف

القيمة الثابتة: 0 (0x00000000)

public static final int TYPE_LINK

نوع الإدخال: رابط

Constant Value: 5 (0x00000005)

TYPE_OTHER

public static final int TYPE_OTHER

نوع الإدخال: غير ذلك

Constant Value: 8 (0x00000008)

TYPE_SOCKET

public static final int TYPE_SOCKET

نوع الإدخال: مقبس

Constant Value: 6 (0x00000006)

الحقول

LS_LD_PATTERN

public static final Pattern LS_LD_PATTERN

LS_L_PATTERN

public static final Pattern LS_L_PATTERN

نمط Regexp لتحليل النتيجة من ls.

STAT_PATTERN

public static final Pattern STAT_PATTERN

نمط Regexp لتحليل النتيجة من stat، مثل drwxr-xr-x root root 2021-08-02 09:20:53.000000000 -0700 4096 /

طُرق وضع التصميم العامة

FileListingService

public FileListingService (IDevice device)

تنشئ هذه الطريقة خدمة "قائمة الملفات" لـ IDevice محدّد.

المعلَمات
device IDevice: الجهاز المرتبط بالخدمة

الإجراءات العامة

getChildren

public FileEntry[] getChildren (FileListingService.FileEntry entry, 
                boolean useCache, 
                FileListingService.IListingReceiver receiver)

تعرض هذه الدالة العناصر الفرعية من FileEntry.

تتيح هذه الطريقة آلية تخزين مؤقت وأوضاعًا متزامنة وغير متزامنة.

إذا كانت قيمة receiver هي null، يتم تنفيذ الأمر ls من جهة الجهاز بشكل متزامن، وسيعرض الإجراء نتيجة عند اكتمال الأمر.
إذا كانت receiver غير null، يتم تشغيل الأمر في سلسلة محادثات منفصلة وعند اكتماله، سيتم إعلام المستلِم بالنتيجة.

يتم تخزين نتيجة كل أمر ls مؤقتًا في FileEntry الأصل. تسمح ميزة useCache باستخدام ذاكرة التخزين المؤقت هذه، ولكن فقط إذا كانت صالحة. تكون ذاكرة التخزين المؤقت صالحة لمدة FileListingService.REFRESH_RATE ملي ثانية فقط، وبعد ذلك يتم تنفيذ الأمر ls الجديد دائمًا.

إذا كانت ذاكرة التخزين المؤقت صالحة وuseCache == true، ستعرض الطريقة دائمًا قيمة ذاكرة التخزين المؤقت، سواء تم توفير IListingReceiver أم لا.

المعلَمات
entry FileListingService.FileEntry: تمثّل هذه السمة الإدخال الرئيسي.

useCache boolean: علامة لاستخدام ذاكرة التخزين المؤقت أو فرض تنفيذ أمر ls جديد.

receiver FileListingService.IListingReceiver: جهاز استقبال للمكالمات غير المتزامنة.

المرتجعات
FileEntry[] قائمة الأطفال أو null للمكالمات غير المتزامنة

يُرجى الاطّلاع أيضًا على:

getChildrenSync

public static FileEntry[] getChildrenSync (FileListingService.FileEntry entry, 
                INativeDevice device)

تعرض هذه الدالة العناصر الفرعية من FileEntry.

هذه الطريقة هي الإصدار المتزامن الصريح من getChildren(FileEntry,boolean,IListingReceiver). وهي تكافئ تقريبًا استدعاء getChildren(FileEntry, false, null)

المعلَمات
entry FileListingService.FileEntry: تمثّل هذه السمة الإدخال الرئيسي.

device INativeDevice

المرتجعات
FileEntry[] قائمة الأطفال

عمليات الطرح
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException في حال عدم إرسال أمر shell أي مخرجات لفترة أطول من maxTimeToOutputResponse
TimeoutException في حال انتهاء المهلة أثناء الاتصال عند إرسال الأمر
IOException في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال
DeviceNotAvailableException

getRoot

public FileListingService.FileEntry getRoot ()

تعرِض هذه السمة عنصر الجذر.

المرتجعات
FileListingService.FileEntry الكائن FileEntry الذي يمثّل العنصر الجذر أو null إذا كان الجهاز غير صالح.