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

תיקיית 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

תבנית של ביטוי רגולרי לניתוח התוצאה מ-ls.

public static final Pattern STAT_PATTERN

תבנית של ביטוי רגולרי לניתוח התוצאה מהנתון הסטטיסטי.

Constructors ציבוריים

FileListingService(IDevice device)

יוצרת שירות של רשימת קבצים עבור IDevice שצוין.

‫methods ציבוריים

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

תיקיית הנתונים ברמה העליונה.

ערך קבוע: "data"

DIRECTORY_MNT

public static final String DIRECTORY_MNT

תיקיית ההרכבה ברמה העליונה.

ערך קבוע: ‎"mnt"‎

DIRECTORY_SDCARD

public static final String DIRECTORY_SDCARD

תיקיית כרטיס SD ברמה העליונה.

ערך קבוע: "sdcard"

DIRECTORY_SYSTEM

public static final String DIRECTORY_SYSTEM

תיקיית מערכת ברמה העליונה.

ערך קבוע: ‎"system"‎

DIRECTORY_TEMP

public static final String DIRECTORY_TEMP

תיקיית temp ברמה העליונה.

ערך קבוע: ‎"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

סוג הרשומה: חסימה

ערך קבוע: 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

סוג הרשומה: קישור לספרייה

ערך קבוע: 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

סוג הרשומה: קישור

ערך קבוע: 5 (0x00000005)

TYPE_OTHER

public static final int TYPE_OTHER

סוג הרשומה: אחר

ערך קבוע: 8 (0x00000008)

TYPE_SOCKET

public static final int TYPE_SOCKET

סוג הרשומה: שקע

ערך קבוע: 6 (0x00000006)

שדות

LS_LD_PATTERN

public static final Pattern LS_LD_PATTERN

LS_L_PATTERN

public static final Pattern LS_L_PATTERN

תבנית של ביטוי רגולרי לניתוח התוצאה מ-ls.

STAT_PATTERN

public static final Pattern STAT_PATTERN

תבנית ביטוי רגולרי לניתוח התוצאה מ-stat. לדוגמה: drwxr-xr-x root root 2021-08-02 09:20:53.000000000 -0700 4096 /

Constructors ציבוריים

FileListingService

public FileListingService (IDevice device)

יוצרת שירות של רשימת קבצים עבור IDevice שצוין.

פרמטרים
device ‫IDevice: המכשיר שאליו השירות מחובר.

‫methods ציבוריים

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 אם adb דוחה את הפקודה.
ShellCommandUnresponsiveException במקרה שפקודת ה-Shell לא שולחת פלט במשך תקופה ארוכה מ-maxTimeToOutputResponse.
במקרה של שגיאת קלט/פלט בחיבור.

getRoot

public FileListingService.FileEntry getRoot ()

מחזירה את רכיב הבסיס.

החזרות
FileListingService.FileEntry האובייקט FileEntry שמייצג את רכיב הבסיס או null אם המכשיר לא תקין.