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

مجلد sdcard على المستوى الأعلى

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.

FileEntry[] getChildrenSync(FileListingService.FileEntry entry)

تعرض هذه السمة العناصر الفرعية من 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

مجلد sdcard على المستوى الأعلى

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

DIRECTORY_SYSTEM

public static final String DIRECTORY_SYSTEM

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

Constant Value: "system"

DIRECTORY_TEMP

public static final String DIRECTORY_TEMP

مجلد 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

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

Constant Value: 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

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

Constant Value: 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 FileEntry[] getChildrenSync (FileListingService.FileEntry entry)

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

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

المعلمات
entry ‫FileListingService.FileEntry: تمثّل هذه السمة الإدخال الرئيسي.
المرتجعات
FileEntry[] قائمة الأطفال
الرميات
TimeoutException في حال انتهاء المهلة أثناء الاتصال عند إرسال الأمر
AdbCommandRejectedException إذا رفضت أداة تصحيح أخطاء Android الأمر
ShellCommandUnresponsiveException في حال عدم إرسال أمر shell أي مخرجات لفترة أطول من maxTimeToOutputResponse.
في حال حدوث خطأ في الإدخال/الإخراج عند الاتصال

getRoot

public FileListingService.FileEntry getRoot ()

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

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