SyncService
public
class
SyncService
extends Object
implements
AutoCloseable
| java.lang.Object | |
| ↳ | com.android.tradefed.device.server.SyncService |
Synchronisierungsdienstklasse zum Senden/Abrufen von Daten an/von Geräten/Emulatoren über die Debug-Bridge.
Verwenden Sie IDevice.getSyncService(), um ein SyncService-Objekt abzurufen.
Zusammenfassung
Verschachtelte Klassen | |
|---|---|
class |
SyncService.FileStat
|
interface |
SyncService.ISyncProgressMonitor
Klassen, die diese Schnittstelle implementieren, bieten Methoden zum Anzeigen des Übertragungsfortschritts. |
Öffentliche Konstruktoren | |
|---|---|
SyncService(InetSocketAddress address, IDevice device)
Erstellt ein Sync-Dienstobjekt. |
|
Öffentliche Methoden | |
|---|---|
void
|
close()
Schließt die Verbindung. |
static
SyncService.ISyncProgressMonitor
|
getNullProgressMonitor()
Gibt einen Synchronisierungsfortschrittsmonitor zurück, der nichts tut. |
boolean
|
openSync()
Öffnet die Synchronisierungsverbindung. |
void
|
pull(FileEntry[] entries, String localPath, SyncService.ISyncProgressMonitor monitor)
Ruft Dateien oder Ordner ab. |
void
|
pullFile(FileListingService.FileEntry remote, String localFilename, SyncService.ISyncProgressMonitor monitor)
Ruft eine einzelne Datei ab. |
void
|
pullFile(String remoteFilepath, String localFilename, SyncService.ISyncProgressMonitor monitor)
Ruft eine einzelne Datei ab. |
void
|
push(String[] local, FileListingService.FileEntry remote, SyncService.ISyncProgressMonitor monitor)
Überträgt mehrere Dateien oder Verzeichnisse. |
void
|
push(String[] local, String remote, SyncService.ISyncProgressMonitor monitor)
Überträgt mehrere Dateien oder Verzeichnisse. |
void
|
pushFile(String local, String remote, SyncService.ISyncProgressMonitor monitor)
Eine einzelne Datei übertragen. |
SyncService.FileStat
|
statFile(String path)
Gibt die Statistikinformationen der Remotedatei zurück. |
Öffentliche Konstruktoren
SyncService
public SyncService (InetSocketAddress address,
IDevice device)Erstellt ein Sync-Dienstobjekt.
| Parameter | |
|---|---|
address |
InetSocketAddress: Die Adresse, zu der eine Verbindung hergestellt werden soll |
device |
IDevice: die IDevice, mit der der Dienst eine Verbindung herstellt. |
Öffentliche Methoden
Schließen
public void close ()
Schließt die Verbindung.
getNullProgressMonitor
public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()
Gibt einen Synchronisierungsfortschrittsmonitor zurück, der nichts tut. So können Hintergrundaufgaben, für die keine Benutzeroberfläche angezeigt werden soll oder muss, einen gültigen ISyncProgressMonitor übergeben.
Dieses Objekt kann mehrmals wiederverwendet und von gleichzeitigen Threads verwendet werden.
| Gibt Folgendes zurück: | |
|---|---|
SyncService.ISyncProgressMonitor |
|
openSync
public boolean openSync ()
Öffnet die Synchronisierungsverbindung. Diese Methode muss vor allen Aufrufen von push[File] / pull[File] aufgerufen werden.
| Gibt Folgendes zurück: | |
|---|---|
boolean |
„true“, wenn die Verbindung geöffnet wurde, „false“, wenn ADB die Verbindung abgelehnt hat. Das kann passieren, wenn die IDevice ungültig ist. |
| Löst aus | |
|---|---|
AdbCommandRejectedException |
Wenn der Befehl von ADB abgelehnt wird |
TimeoutException |
bei Zeitüberschreitung der Verbindung. |
IOException |
Wenn die Verbindung zu adb fehlgeschlagen ist. |
pull
public void pull (FileEntry[] entries, String localPath, SyncService.ISyncProgressMonitor monitor)
Ruft Dateien oder Ordner ab.
| Parameter | |
|---|---|
entries |
FileEntry: die Remote-Elemente, die abgerufen werden sollen |
localPath |
String: Das lokale Ziel. Wenn die Anzahl der Einträge > 1 ist oder der eindeutige Eintrag ein Ordner ist, sollte dies ein Ordner sein. |
monitor |
SyncService.ISyncProgressMonitor: Die Fortschrittsanzeige. Darf nicht null sein. |
| Löst aus | |
|---|---|
|
com.android.ddmlib.SyncException |
|
com.android.ddmlib.TimeoutException |
|
java.io.IOException |
IOException |
|
SyncException |
|
TimeoutException |
|
Weitere Informationen
pullFile
public void pullFile (FileListingService.FileEntry remote, String localFilename, SyncService.ISyncProgressMonitor monitor)
Ruft eine einzelne Datei ab.
| Parameter | |
|---|---|
remote |
FileListingService.FileEntry: die Remote-Datei |
localFilename |
String: Das lokale Ziel. |
monitor |
SyncService.ISyncProgressMonitor: Die Fortschrittsanzeige. Darf nicht null sein. |
| Löst aus | |
|---|---|
SyncException |
bei einer Synchronisierungsabweichung. |
TimeoutException |
bei einer Zeitüberschreitung beim Lesen von Antworten vom Gerät. |
IOException |
im Falle einer E/A-Ausnahme. |
Weitere Informationen
pullFile
public void pullFile (String remoteFilepath,
String localFilename,
SyncService.ISyncProgressMonitor monitor)Ruft eine einzelne Datei ab.
Da bei dieser Methode nur ein String für die Remotedatei anstelle eines FileEntry verwendet wird, ist die Größe der abgerufenen Datei unbekannt und der ISyncProgressMonitor zeigt den Fortschritt nicht richtig an.
| Parameter | |
|---|---|
remoteFilepath |
String: der vollständige Pfad zur Remotedatei |
localFilename |
String: Das lokale Ziel. |
monitor |
SyncService.ISyncProgressMonitor: Die Fortschrittsanzeige. Darf nicht null sein. |
| Löst aus | |
|---|---|
SyncException |
bei einer Synchronisierungsabweichung. |
TimeoutException |
bei einer Zeitüberschreitung beim Lesen von Antworten vom Gerät. |
IOException |
im Falle einer E/A-Ausnahme. |
Weitere Informationen
push
public void push (String[] local,
FileListingService.FileEntry remote,
SyncService.ISyncProgressMonitor monitor)Überträgt mehrere Dateien oder Verzeichnisse.
| Parameter | |
|---|---|
local |
String: die lokalen Dateien, die übertragen werden sollen |
remote |
FileListingService.FileEntry: das Remote-FileEntry, das ein Verzeichnis darstellt |
monitor |
SyncService.ISyncProgressMonitor: Die Fortschrittsanzeige |
| Löst aus | |
|---|---|
SyncException |
wenn einige Dateien nicht übertragen werden konnten |
TimeoutException |
bei einer Zeitüberschreitung beim Lesen von Antworten vom Gerät |
IOException |
bei einem E/A-Fehler bei der Verbindung |
push
public void push (String[] local,
String remote,
SyncService.ISyncProgressMonitor monitor)Überträgt mehrere Dateien oder Verzeichnisse.
| Parameter | |
|---|---|
local |
String: die lokalen Dateien, die übertragen werden sollen |
remote |
String: der Remote-Pfad, der ein Verzeichnis darstellt |
monitor |
SyncService.ISyncProgressMonitor: Die Fortschrittsanzeige |
| Löst aus | |
|---|---|
SyncException |
wenn einige Dateien nicht übertragen werden konnten |
TimeoutException |
bei einer Zeitüberschreitung beim Lesen von Antworten vom Gerät |
IOException |
bei einem E/A-Fehler bei der Verbindung |
pushFile
public void pushFile (String local,
String remote,
SyncService.ISyncProgressMonitor monitor)Eine einzelne Datei übertragen.
| Parameter | |
|---|---|
local |
String: der lokale Dateipfad. |
remote |
String: Der Remote-Dateipfad. |
monitor |
SyncService.ISyncProgressMonitor: Die Fortschrittsanzeige. Darf nicht null sein. |
| Löst aus | |
|---|---|
SyncException |
wenn die Datei nicht übertragen werden konnte |
TimeoutException |
bei einer Zeitüberschreitung beim Lesen von Antworten vom Gerät. |
IOException |
bei einem E/A-Fehler bei der Verbindung. |
statFile
public SyncService.FileStat statFile (String path)
Gibt die Statistikinformationen der Remotedatei zurück.
| Parameter | |
|---|---|
path |
String: die Remote-Datei |
| Gibt Folgendes zurück: | |
|---|---|
SyncService.FileStat |
ein FileStat-Objekt mit dem Modus, der Größe und den Informationen zur letzten Änderung, wenn alles gut gegangen ist, andernfalls „null“ |
| Löst aus | |
|---|---|
TimeoutException |
bei einer Zeitüberschreitung beim Lesen von Antworten vom Gerät. |
|
java.io.IOException |
IOException |
|