FileListingService

public final class FileListingService
extends Object

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

Fournit un service de liste des fichiers annexes IDevice.

Résumé

Classes imbriquées

class FileListingService.FileEntry

Représente une entrée dans un répertoire. 

interface FileListingService.IListingReceiver

Les classes qui implémentent cette interface fournissent une méthode qui gère le résultat asynchrone de la commande ls sur l'appareil. 

Constantes

String DIRECTORY_APP

Dossier de l'application.

String DIRECTORY_DATA

Dossier de données de premier niveau.

String DIRECTORY_MNT

Dossier de montage de premier niveau.

String DIRECTORY_SDCARD

Dossier racine de la carte SD.

String DIRECTORY_SYSTEM

Dossier système de premier niveau.

String DIRECTORY_TEMP

Dossier temporaire de premier niveau.

String FILE_SEPARATOR

Séparateur de fichiers côté appareil.

long REFRESH_RATE

int TYPE_BLOCK

Type d'entrée : blocage

int TYPE_CHARACTER

Type d'entrée : personnage

int TYPE_DIRECTORY

Type d'entrée : Annuaire

int TYPE_DIRECTORY_LINK

Type d'entrée : lien vers l'annuaire

int TYPE_FIFO

Type d'entrée : FIFO

int TYPE_FILE

Type d'entrée : fichier

int TYPE_LINK

Type d'entrée : lien

int TYPE_OTHER

Type d'entrée : autre

int TYPE_SOCKET

Type d'entrée : Socket

Champs

public static final Pattern LS_LD_PATTERN

public static final Pattern LS_L_PATTERN

Modèle d'expression régulière pour analyser le résultat de ls.

public static final Pattern STAT_PATTERN

Expression régulière permettant d'analyser le résultat de la statistique.

Constructeurs publics

FileListingService(IDevice device)

Crée un service de liste de fichiers pour un IDevice spécifié.

Méthodes publiques

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

Renvoie les enfants d'un FileEntry.

FileEntry[] getChildrenSync(FileListingService.FileEntry entry)

Renvoie les enfants d'un FileEntry.

FileListingService.FileEntry getRoot()

Renvoie l'élément racine.

Constantes

DIRECTORY_APP

public static final String DIRECTORY_APP

Dossier de l'application.

Valeur constante : "app"

DIRECTORY_DATA

public static final String DIRECTORY_DATA

Dossier de données de premier niveau.

Valeur constante : "data"

DIRECTORY_MNT

public static final String DIRECTORY_MNT

Dossier de montage de premier niveau.

Valeur constante : "mnt"

DIRECTORY_SDCARD

public static final String DIRECTORY_SDCARD

Dossier racine de la carte SD.

Valeur constante : "sdcard"

DIRECTORY_SYSTEM

public static final String DIRECTORY_SYSTEM

Dossier système de premier niveau.

Valeur constante : "system"

DIRECTORY_TEMP

public static final String DIRECTORY_TEMP

Dossier temporaire de premier niveau.

Valeur constante : "tmp"

FILE_SEPARATOR

public static final String FILE_SEPARATOR

Séparateur de fichiers côté appareil.

Valeur constante : "/"

REFRESH_RATE

public static final long REFRESH_RATE

Valeur constante : 5000 (0x0000000000001388)

TYPE_BLOCK

public static final int TYPE_BLOCK

Type d'entrée : blocage

Valeur constante : 3 (0x00000003)

TYPE_CHARACTER

public static final int TYPE_CHARACTER

Type d'entrée : personnage

Valeur constante : 4 (0x00000004)

TYPE_DIRECTORY

public static final int TYPE_DIRECTORY

Type d'entrée : Annuaire

Valeur constante : 1 (0x00000001) 

public static final int TYPE_DIRECTORY_LINK

Type d'entrée : lien vers l'annuaire

Valeur constante : 2 (0x00000002)

TYPE_FIFO

public static final int TYPE_FIFO

Type d'entrée : FIFO

Valeur constante : 7 (0x00000007)

TYPE_FILE

public static final int TYPE_FILE

Type d'entrée : fichier

Valeur constante : 0 (0x00000000) 

public static final int TYPE_LINK

Type d'entrée : lien

Valeur constante : 5 (0x00000005)

TYPE_OTHER

public static final int TYPE_OTHER

Type d'entrée : autre

Valeur constante : 8 (0x00000008)

TYPE_SOCKET

public static final int TYPE_SOCKET

Type d'entrée : Socket

Valeur constante : 6 (0x00000006)

Champs

LS_LD_PATTERN

public static final Pattern LS_LD_PATTERN

LS_L_PATTERN

public static final Pattern LS_L_PATTERN

Modèle d'expression régulière pour analyser le résultat de ls.

STAT_PATTERN

public static final Pattern STAT_PATTERN

Modèle d'expression régulière pour analyser le résultat de stat. Exemple : drwxr-xr-x root root 2021-08-02 09:20:53.000000000 -0700 4096 /

Constructeurs publics

FileListingService

public FileListingService (IDevice device)

Crée un service de liste de fichiers pour un IDevice spécifié.

Paramètres
device IDevice : appareil auquel le service est connecté.

Méthodes publiques

getChildren

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

Renvoie les enfants d'un FileEntry.

Cette méthode est compatible avec un mécanisme de cache et des modes synchrone et asynchrone.

Si receiver est null, la commande ls côté appareil est exécutée de manière synchrone, et la méthode renvoie une réponse une fois la commande terminée.
Si receiver n'est pas null, la commande est lancée dans un thread distinct et, une fois terminée, le récepteur est informé du résultat.

Le résultat de chaque commande ls est mis en cache dans le FileEntry parent. useCache autorise l'utilisation de ce cache, mais uniquement s'il est valide. Le cache n'est valide que pendant FileListingService.REFRESH_RATE ms. Après cela, une nouvelle commande ls est toujours exécutée.

Si le cache est valide et que useCache == true, la méthode renvoie toujours simplement la valeur du cache, qu'un IListingReceiver ait été fourni ou non.

Paramètres
entry FileListingService.FileEntry : entrée parente.
useCache boolean : indicateur permettant d'utiliser le cache ou de forcer une nouvelle commande ls.
receiver FileListingService.IListingReceiver : récepteur pour les appels asynchrones.
Renvoie
FileEntry[] Liste des enfants ou null pour les appels asynchrones.

getChildrenSync

public FileEntry[] getChildrenSync (FileListingService.FileEntry entry)

Renvoie les enfants d'un FileEntry.

Cette méthode est la version synchrone explicite de getChildren(com.android.ddmlib.FileListingService.FileEntry, boolean, com.android.ddmlib.FileListingService.IListingReceiver). Cela équivaut à peu près à appeler getChildren(FileEntry, false, null).

Paramètres
entry FileListingService.FileEntry : entrée parente.
Renvoie
FileEntry[] Liste des enfants
Génère
TimeoutException en cas de délai d'expiration de la connexion lors de l'envoi de la commande.
AdbCommandRejectedException si adb rejette la commande.
ShellCommandUnresponsiveException si la commande shell n'envoie aucune sortie pendant une période supérieure à maxTimeToOutputResponse.
en cas d'erreur d'E/S sur la connexion.

getRoot

public FileListingService.FileEntry getRoot ()

Renvoie l'élément racine.

Renvoie
FileListingService.FileEntry l'objet FileEntry représentant l'élément racine ou null si l'appareil n'est pas valide.