FileListingService

public final class FileListingService
extends Object

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


Fornisce il servizio di elenco dei file collaterali IDevice.

Riepilogo

Classi nidificate

class FileListingService.FileEntry

Rappresenta una voce in una directory. 

interface FileListingService.IListingReceiver

Le classi che implementano questa interfaccia forniscono un metodo che gestisce il risultato asincrono del comando ls sul dispositivo. 

Costanti

String DIRECTORY_APP

Cartella dell'applicazione.

String DIRECTORY_DATA

Cartella di dati di primo livello.

String DIRECTORY_MNT

Cartella di montaggio di primo livello.

String DIRECTORY_SDCARD

Cartella sdcard di primo livello.

String DIRECTORY_SYSTEM

Cartella di sistema di primo livello.

String DIRECTORY_TEMP

Cartella temporanea di primo livello.

String FILE_SEPARATOR

Separatore di file lato dispositivo.

long REFRESH_RATE

int TYPE_BLOCK

Tipo di voce: blocco

int TYPE_CHARACTER

Tipo di voce: carattere

int TYPE_DIRECTORY

Tipo di voce: directory

int TYPE_DIRECTORY_LINK

Tipo di voce: link alla directory

int TYPE_FIFO

Tipo di voce: FIFO

int TYPE_FILE

Tipo di voce: File

int TYPE_LINK

Tipo di voce: link

int TYPE_OTHER

Tipo di voce: altro

int TYPE_SOCKET

Tipo di voce: presa

Campi

public static final Pattern LS_LD_PATTERN

public static final Pattern LS_L_PATTERN

Pattern Regexp per analizzare il risultato di ls.

public static final Pattern STAT_PATTERN

Pattern Regexp per analizzare il risultato della statistica.

Costruttori pubblici

FileListingService(IDevice device)

Crea un servizio di elenco dei file per un IDevice specificato.

Metodi pubblici

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

Restituisce i figli di un FileEntry.

FileEntry[] getChildrenSync(FileListingService.FileEntry entry)

Restituisce i figli di un FileEntry.

FileListingService.FileEntry getRoot()

Restituisce l'elemento principale.

Costanti

DIRECTORY_APP

public static final String DIRECTORY_APP

Cartella dell'applicazione.

Constant Value: "app"

DIRECTORY_DATA

public static final String DIRECTORY_DATA

Cartella di dati di primo livello.

Valore costante: "data"

DIRECTORY_MNT

public static final String DIRECTORY_MNT

Cartella di montaggio di primo livello.

Constant Value: "mnt"

DIRECTORY_SDCARD

public static final String DIRECTORY_SDCARD

Cartella sdcard di primo livello.

Constant Value: "sdcard"

DIRECTORY_SYSTEM

public static final String DIRECTORY_SYSTEM

Cartella di sistema di primo livello.

Valore costante: "system"

DIRECTORY_TEMP

public static final String DIRECTORY_TEMP

Cartella temporanea di primo livello.

Valore costante: "tmp"

FILE_SEPARATOR

public static final String FILE_SEPARATOR

Separatore di file lato dispositivo.

Valore costante: "/"

REFRESH_RATE

public static final long REFRESH_RATE

Valore costante: 5000 (0x0000000000001388)

TYPE_BLOCK

public static final int TYPE_BLOCK

Tipo di voce: blocco

Valore costante: 3 (0x00000003)

TYPE_CHARACTER

public static final int TYPE_CHARACTER

Tipo di voce: carattere

Valore costante: 4 (0x00000004)

TYPE_DIRECTORY

public static final int TYPE_DIRECTORY

Tipo di voce: directory

Constant Value: 1 (0x00000001)

public static final int TYPE_DIRECTORY_LINK

Tipo di voce: link alla directory

Constant Value: 2 (0x00000002)

TYPE_FIFO

public static final int TYPE_FIFO

Tipo di voce: FIFO

Constant Value: 7 (0x00000007)

TYPE_FILE

public static final int TYPE_FILE

Tipo di voce: File

Valore costante: 0 (0x00000000)

public static final int TYPE_LINK

Tipo di voce: link

Constant Value: 5 (0x00000005)

TYPE_OTHER

public static final int TYPE_OTHER

Tipo di voce: altro

Valore costante: 8 (0x00000008)

TYPE_SOCKET

public static final int TYPE_SOCKET

Tipo di voce: presa

Valore costante: 6 (0x00000006)

Campi

LS_LD_PATTERN

public static final Pattern LS_LD_PATTERN

LS_L_PATTERN

public static final Pattern LS_L_PATTERN

Pattern Regexp per analizzare il risultato di ls.

STAT_PATTERN

public static final Pattern STAT_PATTERN

Pattern Regexp per analizzare il risultato da stat. Esempio: drwxr-xr-x root root 2021-08-02 09:20:53.000000000 -0700 4096 /

Costruttori pubblici

FileListingService

public FileListingService (IDevice device)

Crea un servizio di elenco dei file per un IDevice specificato.

Parametri
device IDevice: il dispositivo a cui è connesso il servizio.

Metodi pubblici

getChildren

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

Restituisce i figli di un FileEntry.

Questo metodo supporta un meccanismo di cache e le modalità sincrona e asincrona.

Se receiver è null, il comando ls lato dispositivo viene eseguito in modo sincrono e il metodo verrà restituito al termine del comando.
Se receiver non è null, il comando viene avviato in un thread separato e, al termine, il destinatario riceverà una notifica del risultato.

Il risultato di ogni comando ls viene memorizzato nella cache del comando FileEntry padre. useCache consente l'utilizzo di questa cache, ma solo se è valida. La cache è valida solo per FileListingService.REFRESH_RATE ms. Dopodiché viene sempre eseguito un nuovo comando ls .

Se la cache è valida e useCache == true, il metodo restituirà sempre semplicemente il valore della cache, indipendentemente dal fatto che sia stato fornito o meno un IListingReceiver.

Parametri
entry FileListingService.FileEntry: la voce principale.

useCache boolean: un flag per utilizzare la cache o forzare un nuovo comando ls.

receiver FileListingService.IListingReceiver: un ricevitore per le chiamate asincrone.

Ritorni
FileEntry[] L'elenco dei bambini o null per le chiamate asincrone.

getChildrenSync

public FileEntry[] getChildrenSync (FileListingService.FileEntry entry)

Restituisce i figli di un FileEntry.

Questo metodo è la versione sincrona esplicita di getChildren(com.android.ddmlib.FileListingService.FileEntry, boolean, com.android.ddmlib.FileListingService.IListingReceiver). Equivale approssimativamente a chiamare getChildren(FileEntry, false, null)

Parametri
entry FileListingService.FileEntry: la voce principale.

Ritorni
FileEntry[] L'elenco dei bambini

Lanci
TimeoutException in caso di timeout della connessione durante l'invio del comando.
AdbCommandRejectedException se adb rifiuta il comando.
ShellCommandUnresponsiveException nel caso in cui il comando shell non invii alcun output per un periodo superiore a maxTimeToOutputResponse.
in caso di errore I/O sulla connessione.

getRoot

public FileListingService.FileEntry getRoot ()

Restituisce l'elemento principale.

Ritorni
FileListingService.FileEntry l'oggetto FileEntry che rappresenta l'elemento radice o null se il dispositivo non è valido.