FileListingService

public final class FileListingService
extends Object

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

Bietet einen Dienst zum Auflisten von IDevice-Begleitdateien.

Zusammenfassung

Verschachtelte Klassen

class FileListingService.FileEntry

Stellt einen Eintrag in einem Verzeichnis dar. 

interface FileListingService.IListingReceiver

Klassen, die diese Schnittstelle implementieren, bieten eine Methode, die sich mit dem asynchronen Ergebnis des ls-Befehls auf dem Gerät befasst. 

Konstanten

String DIRECTORY_APP

Anwendungsordner.

String DIRECTORY_DATA

Datenordner der obersten Ebene.

String DIRECTORY_MNT

Mount-Ordner der obersten Ebene.

String DIRECTORY_SDCARD

SD-Kartenordner der obersten Ebene.

String DIRECTORY_SYSTEM

Systemordner der obersten Ebene.

String DIRECTORY_TEMP

Temporärer Ordner auf oberster Ebene.

String FILE_SEPARATOR

Dateitrennzeichen auf dem Gerät.

long REFRESH_RATE

int TYPE_BLOCK

Eintragstyp: Block

int TYPE_CHARACTER

Eintragstyp: Zeichen

int TYPE_DIRECTORY

Eintragstyp: Verzeichnis

int TYPE_DIRECTORY_LINK

Eintragstyp: Verzeichnislink

int TYPE_FIFO

Eintragstyp: FIFO

int TYPE_FILE

Eintragstyp: Datei

int TYPE_LINK

Eintragstyp: Link

int TYPE_OTHER

Eintragstyp: Sonstiges

int TYPE_SOCKET

Eintragstyp: Sockel

Felder

public static final Pattern LS_LD_PATTERN

public static final Pattern LS_L_PATTERN

Regexp-Muster zum Parsen des Ergebnisses von „ls“.

public static final Pattern STAT_PATTERN

Regexp-Muster zum Parsen des Ergebnisses aus „stat“.

Öffentliche Konstruktoren

FileListingService(IDevice device)

Erstellt einen File Listing Service für ein angegebenes IDevice.

Öffentliche Methoden

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

Gibt die untergeordneten Elemente eines FileEntry zurück.

FileEntry[] getChildrenSync(FileListingService.FileEntry entry)

Gibt die untergeordneten Elemente eines FileEntry zurück.

FileListingService.FileEntry getRoot()

Gibt das Stammelement zurück.

Konstanten

DIRECTORY_APP

public static final String DIRECTORY_APP

Anwendungsordner.

Konstanter Wert: "app"

DIRECTORY_DATA

public static final String DIRECTORY_DATA

Datenordner der obersten Ebene.

Konstanter Wert: "data"

DIRECTORY_MNT

public static final String DIRECTORY_MNT

Mount-Ordner der obersten Ebene.

Konstanter Wert: "mnt"

DIRECTORY_SDCARD

public static final String DIRECTORY_SDCARD

SD-Kartenordner der obersten Ebene.

Konstanter Wert: "sdcard"

DIRECTORY_SYSTEM

public static final String DIRECTORY_SYSTEM

Systemordner der obersten Ebene.

Konstanter Wert: "system"

DIRECTORY_TEMP

public static final String DIRECTORY_TEMP

Temporärer Ordner auf oberster Ebene.

Konstanter Wert: "tmp"

FILE_SEPARATOR

public static final String FILE_SEPARATOR

Dateitrennzeichen auf dem Gerät.

Konstanter Wert: "/"

REFRESH_RATE

public static final long REFRESH_RATE

Konstanter Wert: 5000 (0x0000000000001388)

TYPE_BLOCK

public static final int TYPE_BLOCK

Eintragstyp: Block

Konstanter Wert: 3 (0x00000003)

TYPE_CHARACTER

public static final int TYPE_CHARACTER

Eintragstyp: Zeichen

Konstanter Wert: 4 (0x00000004)

TYPE_DIRECTORY

public static final int TYPE_DIRECTORY

Eintragstyp: Verzeichnis

Konstanter Wert: 1 (0x00000001) 

public static final int TYPE_DIRECTORY_LINK

Eintragstyp: Verzeichnislink

Konstanter Wert: 2 (0x00000002)

TYPE_FIFO

public static final int TYPE_FIFO

Eintragstyp: FIFO

Konstanter Wert: 7 (0x00000007)

TYPE_FILE

public static final int TYPE_FILE

Eintragstyp: Datei

Konstanter Wert: 0 (0x00000000) 

public static final int TYPE_LINK

Eintragstyp: Link

Konstanter Wert: 5 (0x00000005)

TYPE_OTHER

public static final int TYPE_OTHER

Eintragstyp: Sonstiges

Konstanter Wert: 8 (0x00000008)

TYPE_SOCKET

public static final int TYPE_SOCKET

Eintragstyp: Sockel

Konstanter Wert: 6 (0x00000006)

Felder

LS_LD_PATTERN

public static final Pattern LS_LD_PATTERN

LS_L_PATTERN

public static final Pattern LS_L_PATTERN

Regexp-Muster zum Parsen des Ergebnisses von „ls“.

STAT_PATTERN

public static final Pattern STAT_PATTERN

Regexp-Muster zum Parsen des Ergebnisses von „stat“. Beispiel: drwxr-xr-x root root 2021-08-02 09:20:53.000000000 -0700 4096 /

Öffentliche Konstruktoren

FileListingService

public FileListingService (IDevice device)

Erstellt einen Dateilistendienst für eine angegebene IDevice.

Parameter
device IDevice: Das Gerät, mit dem der Dienst verbunden ist.

Öffentliche Methoden

getChildren

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

Gibt die untergeordneten Elemente eines FileEntry zurück.

Diese Methode unterstützt einen Cachemechanismus sowie synchrone und asynchrone Modi.

Wenn receiver null ist, wird der geräteseitige ls-Befehl synchron ausgeführt und die Methode wird nach Abschluss des Befehls zurückgegeben.
Wenn receiver nicht null ist, wird der Befehl in einem separaten Thread gestartet. Nach Abschluss wird der Empfänger über das Ergebnis benachrichtigt.

Das Ergebnis für jeden ls-Befehl wird im übergeordneten FileEntry-Objekt zwischengespeichert. useCache ermöglicht die Verwendung dieses Caches, aber nur, wenn der Cache gültig ist. Der Cache ist nur FileListingService.REFRESH_RATE ms lang gültig. Danach wird immer ein neuer ls -Befehl ausgeführt.

Wenn der Cache gültig und useCache == true ist, gibt die Methode immer nur den Wert des Cache zurück, unabhängig davon, ob ein IListingReceiver angegeben wurde oder nicht.

Parameter
entry FileListingService.FileEntry: Der übergeordnete Eintrag.
useCache boolean: Ein Flag, mit dem der Cache verwendet oder ein neuer „ls“-Befehl erzwungen wird.
receiver FileListingService.IListingReceiver: Ein Empfänger für asynchrone Aufrufe.
Returns
FileEntry[] Die Liste der untergeordneten Elemente oder null für asynchrone Aufrufe.

getChildrenSync

public FileEntry[] getChildrenSync (FileListingService.FileEntry entry)

Gibt die untergeordneten Elemente eines FileEntry zurück.

Diese Methode ist die explizite synchrone Version von getChildren(com.android.ddmlib.FileListingService.FileEntry, boolean, com.android.ddmlib.FileListingService.IListingReceiver). Dies entspricht in etwa dem Aufrufen von getChildren(FileEntry, false, null).

Parameter
entry FileListingService.FileEntry: Der übergeordnete Eintrag.
Returns
FileEntry[] Die Liste der untergeordneten Elemente
Ausgabe
TimeoutException bei Zeitüberschreitung der Verbindung beim Senden des Befehls.
AdbCommandRejectedException wenn der Befehl von ADB abgelehnt wird.
ShellCommandUnresponsiveException wenn der Shell-Befehl über einen Zeitraum von mehr als maxTimeToOutputResponse keine Ausgabe sendet.
bei einem E/A-Fehler bei der Verbindung.

getRoot

public FileListingService.FileEntry getRoot ()

Gibt das Stammelement zurück.

Returns
FileListingService.FileEntry Das FileEntry-Objekt, das das Stammelement darstellt, oder null, wenn das Gerät ungültig ist.