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.

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

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

ערך קבוע: "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 static FileEntry[] getChildrenSync (FileListingService.FileEntry entry, 
                INativeDevice device)

הפונקציה מחזירה את צאצאי הרכיב FileEntry.

השיטה הזו היא הגרסה הסינכרונית המפורשת של getChildren(FileEntry,boolean,IListingReceiver). היא שקולה בערך לקריאה של getChildren(FileEntry, false, null)

פרמטרים
entry ‫FileListingService.FileEntry: רשומת האב.
device INativeDevice

החזרות
FileEntry[] רשימת הילדים
הקפצת הודעות שגיאה (throw)
AdbCommandRejectedException אם adb דוחה את הפקודה.
ShellCommandUnresponsiveException במקרה שפקודת ה-Shell לא שולחת פלט במשך יותר מ-maxTimeToOutputResponse.
TimeoutException אם חלף הזמן הקצוב לחיבור כששולחים את הפקודה.
IOException במקרה של שגיאת קלט/פלט בחיבור.
DeviceNotAvailableException

getRoot

public FileListingService.FileEntry getRoot ()

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

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