ContentProvider-Handler

public class ContentProviderHandler
extends Object

java.lang.Object
com.android.tradefed.device.contentprovider.ContentProviderHandler


Handler, der die Interaktionen des Contentanbieters abstrahiert und die Verwendung des Contentanbieters auf Geräteseite für verschiedene Vorgänge ermöglicht.

Bei der Implementierung in dieser Klasse sollte immer der aktuell auf dem Gerät ausgeführte Nutzer berücksichtigt werden.

Zusammenfassung

Fields

public static final String[] COLUMNS

public static final String COLUMN_ABSOLUTE_PATH

public static final String COLUMN_DIRECTORY

public static final String COLUMN_METADATA

public static final String COLUMN_MIME_TYPE

public static final String COLUMN_NAME

public static final String CONTENT_PROVIDER_URI

public static final String NO_RESULTS_STRING

public static final String PACKAGE_NAME

public static final String QUERY_INFO_VALUE

Öffentliche Konstruktoren

ContentProviderHandler(ITestDevice device)

Konstruktor.

ContentProviderHandler(ITestDevice device, Integer userId)

Öffentliche Methoden

boolean contentProviderNotFound()

Gibt "True" zurück, wenn einer der Vorgänge fehlgeschlagen ist und der Contentanbieter nicht gefunden wurde.

static String createEscapedContentUri(String deviceFilePath)

Gibt den vollständigen URI-String für den angegebenen Gerätepfad zurück, maskiert und codiert, um Nicht-URL-Zeichen zu vermeiden.

boolean deleteFile(String deviceFilePath)

Contentanbieter-Callback, durch den eine Datei am URI-Speicherort gelöscht wird

boolean doesFileExist(String deviceFilePath)

Ermittelt, ob die Datei oder das nicht leere Verzeichnis auf dem Gerät vorhanden ist.

Integer getUserId()

Gibt die Nutzer-ID zurück, mit der diese Instanz initialisiert wird.

boolean pullDir(String deviceFilePath, File localDir)

Verzeichnisinhalte mithilfe des Contentanbieters rekursiv vom Gerät abrufen.

boolean pullFile(String deviceFilePath, File localFile)

Contentanbieter-Callback, mit dem eine Datei vom URI-Speicherort in eine lokale Datei geladen wird

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

Contentanbieter-Callback, der ein dir an den URI-Speicherort sendet.

boolean pushFile(File fileToPush, String deviceFilePath)

Contentanbieter-Callback, der eine Datei an den URI-Speicherort sendet.

boolean setUp()

Prüfen Sie, ob die Hilfs-App des Contentanbieters installiert und einsatzbereit ist.

void tearDown()

Reinigen Sie das Gerät aus dem Contentanbieter-Assistenten.

Fields

SPALTEN

public static final String[] COLUMNS

SPALTEN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

SPALTENVERZEICHNIS

public static final String COLUMN_DIRECTORY

SPALTEN-METADATEN

public static final String COLUMN_METADATA

COLUMN_MIME_TYPE

public static final String COLUMN_MIME_TYPE

COLUMN_NAME

public static final String COLUMN_NAME

CONTENT_PROVIDER_URI

public static final String CONTENT_PROVIDER_URI

NO_RESULTS_STRING

public static final String NO_RESULTS_STRING

PAKETNAME

public static final String PACKAGE_NAME

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

Öffentliche Konstruktoren

ContentProvider-Handler

public ContentProviderHandler (ITestDevice device)

Konstruktor.

Parameter
device ITestDevice

Ausgabe
DeviceNotAvailableException

ContentProvider-Handler

public ContentProviderHandler (ITestDevice device, 
                Integer userId)

Parameter
device ITestDevice

userId Integer

Öffentliche Methoden

contentProviderNotFound

public boolean contentProviderNotFound ()

Gibt "True" zurück, wenn einer der Vorgänge fehlgeschlagen ist und der Contentanbieter nicht gefunden wurde. Kann gelöscht werden, indem setUp() noch einmal ausgeführt wird.

Returns
boolean

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

Gibt den vollständigen URI-String für den angegebenen Gerätepfad zurück, maskiert und codiert, um Nicht-URL-Zeichen zu vermeiden.

Parameter
deviceFilePath String

Returns
String

Datei löschen

public boolean deleteFile (String deviceFilePath)

Contentanbieter-Callback, durch den eine Datei am URI-Speicherort gelöscht wird Die Datei wird aus dem Geräteinhalt gelöscht.

Parameter
deviceFilePath String: Pfad auf dem Gerät der zu löschenden Datei.

Returns
boolean „True“ bei Erfolg, andernfalls „False“

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

tutFileExist

public boolean doesFileExist (String deviceFilePath)

Ermittelt, ob die Datei oder das nicht leere Verzeichnis auf dem Gerät vorhanden ist.

Parameter
deviceFilePath String: Der absolute Dateipfad auf dem Gerät, der auf das Vorhandensein geprüft werden soll.

Returns
boolean "True", wenn eine Datei/ein Verzeichnis vorhanden ist, andernfalls "False". Wenn das Verzeichnis leer ist, wird auch „False“ zurückgegeben.

Ausgabe
DeviceNotAvailableException

getUserId (Nutzer-ID)

public Integer getUserId ()

Gibt die Nutzer-ID zurück, mit der diese Instanz initialisiert wird.

Returns
Integer

PullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Verzeichnisinhalte mithilfe des Contentanbieters rekursiv vom Gerät abrufen.

Parameter
deviceFilePath String: der absolute Dateipfad der Remote-Quelle

localDir File: das lokale Verzeichnis, in das Dateien abgerufen werden sollen

Returns
boolean true, wenn die Datei abgerufen wurde. Andernfalls false.

Ausgabe
DeviceNotAvailableException Die Verbindung zum Gerät wird unterbrochen und kann nicht wiederhergestellt werden.

Pull-Datei

public boolean pullFile (String deviceFilePath, 
                File localFile)

Contentanbieter-Callback, mit dem eine Datei vom URI-Speicherort in eine lokale Datei geladen wird

Parameter
deviceFilePath String: Pfad auf dem Gerät, von dem die Datei abgerufen werden soll.

localFile File: Die ERROR(/File), in der die Inhalte gespeichert werden sollen. Wenn das Feld nicht leer ist, werden Inhalte ersetzt.

Returns
boolean „True“ bei Erfolg, andernfalls „False“

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

PushDir

public boolean pushDir (File localFileDir, 
                String deviceFilePath, 
                 excludedDirectories)

Contentanbieter-Callback, der ein dir an den URI-Speicherort sendet.

Parameter
localFileDir File: Verzeichnis, das übertragen werden soll

deviceFilePath String: Standort auf dem Gerät

excludedDirectories : Verzeichnisse, die nicht im Push-Vorgang enthalten sind.

Returns
boolean „True“ bei Erfolg

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

Push-Datei

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

Contentanbieter-Callback, der eine Datei an den URI-Speicherort sendet.

Parameter
fileToPush File: Die ERROR(/File), die an das Gerät gesendet werden soll.

deviceFilePath String: Pfad auf dem Gerät, in das die Datei übertragen werden soll.

Returns
boolean „True“ bei Erfolg, andernfalls „False“

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
Ausnahme
DeviceNotAvailableException

einrichten

public boolean setUp ()

Prüfen Sie, ob die Hilfs-App des Contentanbieters installiert und einsatzbereit ist.

Returns
boolean „True“, wenn es sofort verwendet werden kann, andernfalls „False“.

Ausgabe
DeviceNotAvailableException

Teardown

public void tearDown ()

Reinigen Sie das Gerät aus dem Contentanbieter-Assistenten.

Ausgabe
DeviceNotAvailableException