ContentProviderHandler

public class ContentProviderHandler
extends Object

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


Handler, der die Interaktionen mit dem Inhaltsanbieter abstrahiert und die Verwendung des geräteseitigen Inhaltsanbieters für verschiedene Vorgänge ermöglicht.

Bei der Implementierung in dieser Klasse sollte der Nutzer berücksichtigt werden, der gerade auf dem Gerät angemeldet ist.

Zusammenfassung

Felder

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, weil der Inhaltsanbieter nicht gefunden wurde.

static String createEscapedContentUri(String deviceFilePath)

Gibt den vollständigen URI-String für den angegebenen Gerätepfad zurück, der so codiert ist, dass keine nicht-URL-Zeichen enthalten sind.

boolean deleteFile(String deviceFilePath)

Callback des Inhaltsanbieters, der eine Datei am URI-Speicherort löscht.

boolean doesFileExist(String deviceFilePath)

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

Integer getUserId()

Gibt die userId zurück, mit der diese Instanz initialisiert wurde.

boolean pullDir(String deviceFilePath, File localDir)

Verzeichnisinhalte rekursiv über den Contentanbieter vom Gerät abrufen.

boolean pullFile(String deviceFilePath, File localFile)

Callback des Inhaltsanbieters, der eine Datei vom URI-Speicherort in eine lokale Datei abruft.

boolean pushDir(File localFileDir, String deviceFilePath, excludedDirectories)

Callback des Inhaltsanbieters, der einen Ordner an den URI-Speicherort sendet.

boolean pushFile(File fileToPush, String deviceFilePath)

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

boolean setUp()

Die Helper-APK des Inhaltsanbieters muss installiert und einsatzbereit sein.

void tearDown()

Entfernen Sie den Contentanbieter-Hilfsprogramm-Dienst vom Gerät.

Felder

SPALTEN

public static final String[] COLUMNS

COLUMN_ABSOLUTE_PATH

public static final String COLUMN_ABSOLUTE_PATH

COLUMN_DIRECTORY

public static final String COLUMN_DIRECTORY

COLUMN_METADATA

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

PACKAGE_NAME

public static final String PACKAGE_NAME

QUERY_INFO_VALUE

public static final String QUERY_INFO_VALUE

Öffentliche Konstruktoren

ContentProviderHandler

public ContentProviderHandler (ITestDevice device)

Konstruktor.

Parameter
device ITestDevice

Ausgabe
DeviceNotAvailableException

ContentProviderHandler

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, weil der Inhaltsanbieter nicht gefunden wurde. Kann durch erneutes Ausführen von setUp() gelöscht werden.

Returns
boolean

createEscapedContentUri

public static String createEscapedContentUri (String deviceFilePath)

Gibt den vollständigen URI-String für den angegebenen Gerätepfad zurück, der so codiert ist, dass keine nicht-URL-Zeichen enthalten sind.

Parameter
deviceFilePath String

Returns
String

deleteFile

public boolean deleteFile (String deviceFilePath)

Callback des Inhaltsanbieters, der eine Datei am URI-Speicherort löscht. Die Datei wird aus den Geräteinhalten gelöscht.

Parameter
deviceFilePath String: Der Pfad auf dem Gerät der Datei, die gelöscht werden soll.

Returns
boolean „True“, wenn erfolgreich, andernfalls „False“

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

doesFileExist

public boolean doesFileExist (String deviceFilePath)

Bestimmt, 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 Existenz geprüft werden soll.

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

Ausgabe
DeviceNotAvailableException

getUserId

public Integer getUserId ()

Gibt die userId zurück, mit der diese Instanz initialisiert wurde.

Returns
Integer

pullDir

public boolean pullDir (String deviceFilePath, 
                File localDir)

Verzeichnisinhalte rekursiv über den Contentanbieter vom Gerät abrufen.

Parameter
deviceFilePath String: der absolute Dateipfad der Remote-Quelle

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

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

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

pullFile

public boolean pullFile (String deviceFilePath, 
                File localFile)

Callback des Inhaltsanbieters, der eine Datei vom URI-Speicherort in eine lokale Datei abruft.

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

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

Returns
boolean „True“, wenn erfolgreich, andernfalls „False“

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pushDir

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

Callback des Inhaltsanbieters, der einen Ordner an den URI-Speicherort sendet.

Parameter
localFileDir File: Das Verzeichnis, das gepusht werden soll

deviceFilePath String: Der Standort auf dem Gerät

excludedDirectories : Verzeichnisse, die nicht im Push enthalten sind.

Returns
boolean „True“, wenn erfolgreich

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

pushFile

public boolean pushFile (File fileToPush, 
                String deviceFilePath)

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

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

deviceFilePath String: Der Pfad auf dem Gerät, an den die Datei gesendet werden soll.

Returns
boolean „True“, wenn erfolgreich, andernfalls „False“

Ausgabe
com.android.tradefed.device.DeviceNotAvailableException
IllegalArgumentException
DeviceNotAvailableException

setUp

public boolean setUp ()

Die Helper-APK des Inhaltsanbieters muss installiert und einsatzbereit sein.

Returns
boolean „True“, wenn die Funktion einsatzbereit ist, andernfalls „False“.

Ausgabe
DeviceNotAvailableException

tearDown

public void tearDown ()

Entfernen Sie den Contentanbieter-Hilfsprogramm-Dienst vom Gerät.

Ausgabe
DeviceNotAvailableException