FileListingService
public
final
class
FileListingService
extends Object
| java.lang.Object | |
| ↳ | com.android.ddmlib.FileListingService |
تقدّم هذه الخدمة قائمة بملفات IDevice الجانبية.
ملخّص
الصفوف المتداخلة | |
|---|---|
class |
FileListingService.FileEntry
تمثّل هذه السمة إدخالاً في دليل. |
interface |
FileListingService.IListingReceiver
توفّر الفئات التي تنفّذ هذه الواجهة طريقة للتعامل مع النتائج غير المتزامنة
من أمر |
الثوابت | |
|---|---|
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)
تنشئ هذه الطريقة خدمة "قائمة الملفات" لـ |
|
الإجراءات العامة | |
|---|---|
FileEntry[]
|
getChildren(FileListingService.FileEntry entry, boolean useCache, FileListingService.IListingReceiver receiver)
تعرض هذه الدالة العناصر الفرعية من |
static
FileEntry[]
|
getChildrenSync(FileListingService.FileEntry entry, INativeDevice device)
تعرض هذه الدالة العناصر الفرعية من |
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)
TYPE_DIRECTORY_LINK
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)
TYPE_LINK
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 إذا كان الجهاز غير صالح. |