SyncService

public class SyncService
extends Object implements AutoCloseable

java.lang.Object
com.android.tradefed.device.server.SyncService


Класс службы синхронизации для отправки/получения данных на/с устройств/эмуляторов через отладочный мост.

Чтобы получить объект SyncService , используйте IDevice.getSyncService() .

Краткое содержание

Вложенные классы

class SyncService.FileStat

interface SyncService.ISyncProgressMonitor

Классы, реализующие этот интерфейс, предоставляют методы, отвечающие за отображение хода передачи данных.

Государственные строители

SyncService (InetSocketAddress address, IDevice device)

Создает объект службы синхронизации.

Общедоступные методы

void close ()

Закрывает соединение.

static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

Возвращает индикатор выполнения синхронизации, который ничего не делает.

boolean openSync ()

Открывает соединение для синхронизации.

void pull ( FileEntry[] entries, String localPath, SyncService.ISyncProgressMonitor monitor)

Загружает файл(ы) или папку(и).

void pullFile ( FileListingService.FileEntry remote, String localFilename, SyncService.ISyncProgressMonitor monitor)

Извлекает один файл.

void pullFile (String remoteFilepath, String localFilename, SyncService.ISyncProgressMonitor monitor)

Извлекает один файл.

void push (String[] local, FileListingService.FileEntry remote, SyncService.ISyncProgressMonitor monitor)

Перемещает несколько файлов или каталогов.

void push (String[] local, String remote, SyncService.ISyncProgressMonitor monitor)

Перемещает несколько файлов или каталогов.

void pushFile (String local, String remote, SyncService.ISyncProgressMonitor monitor)

Загрузите один файл.

SyncService.FileStat statFile (String path)

Возвращает статистическую информацию об удаленном файле.

Государственные строители

SyncService

public SyncService (InetSocketAddress address, 
                IDevice device)

Создает объект службы синхронизации.

Параметры
address InetSocketAddress : Адрес для подключения

device IDevice : IDevice , к которому подключается сервис.

Общедоступные методы

закрывать

public void close ()

Закрывает соединение.

getNullProgressMonitor

public static SyncService.ISyncProgressMonitor getNullProgressMonitor ()

Возвращает монитор прогресса синхронизации, который ничего не делает. Это позволяет фоновым задачам, которые не хотят/не нуждаются в отображении пользовательского интерфейса, передавать действительный объект ISyncProgressMonitor .

Этот объект можно использовать многократно, и он может применяться параллельными потоками.

Возвраты
SyncService.ISyncProgressMonitor

openSync

public boolean openSync ()

Открывает соединение для синхронизации. Этот вызов необходимо выполнить перед любыми вызовами push[File] / pull[File].

Возвраты
boolean Возвращает true, если соединение установлено, false, если adb отклоняет соединение. Это может произойти, если IDevice недействителен.

Броски
AdbCommandRejectedException если adb отклонит команду
TimeoutException в случае истечения времени ожидания соединения.
IOException Если соединение с adb не удалось.

тянуть

public void pull (FileEntry[] entries, 
                String localPath, 
                SyncService.ISyncProgressMonitor monitor)

Загружает файл(ы) или папку(и).

Параметры
entries FileEntry : удалённый(е) элемент(ы) для извлечения

localPath String : Локальное место назначения. Если количество записей больше 1 или если уникальная запись является папкой, то это должна быть папка.

monitor SyncService.ISyncProgressMonitor : Монитор прогресса. Не может быть пустым.

Броски
com.android.ddmlib.SyncException
com.android.ddmlib.TimeoutException
java.io.IOException
IOException
SyncException
TimeoutException

pullFile

public void pullFile (FileListingService.FileEntry remote, 
                String localFilename, 
                SyncService.ISyncProgressMonitor monitor)

Извлекает один файл.

Параметры
remote FileListingService.FileEntry : удаленный файл

localFilename String : Локальный адрес назначения.

monitor SyncService.ISyncProgressMonitor : Монитор прогресса. Не может быть пустым.

Броски
SyncException в случае ошибки синхронизации.
TimeoutException в случае превышения времени ожидания при чтении ответов с устройства.
IOException в случае возникновения ошибки ввода-вывода.

pullFile

public void pullFile (String remoteFilepath, 
                String localFilename, 
                SyncService.ISyncProgressMonitor monitor)

Извлекает один файл.

Поскольку этот метод работает только со строкой, содержащей информацию об удаленном файле, а не с FileEntry , размер загружаемого файла неизвестен, и ISyncProgressMonitor не сможет корректно отображать ход выполнения.

Параметры
remoteFilepath String : полный путь к удаленному файлу

localFilename String : Локальный адрес назначения.

monitor SyncService.ISyncProgressMonitor : Монитор прогресса. Не может быть пустым.

Броски
SyncException в случае ошибки синхронизации.
TimeoutException в случае превышения времени ожидания при чтении ответов с устройства.
IOException в случае возникновения ошибки ввода-вывода.

См. также:

толкать

public void push (String[] local, 
                FileListingService.FileEntry remote, 
                SyncService.ISyncProgressMonitor monitor)

Перемещает несколько файлов или каталогов.

Параметры
local String : локальные файлы для отправки

remote FileListingService.FileEntry : удаленный объект FileEntry представляющий каталог.

monitor SyncService.ISyncProgressMonitor : Монитор прогресса

Броски
SyncException если некоторые файлы не удалось отправить
TimeoutException в случае превышения времени ожидания при чтении ответов от устройства
IOException в случае ошибки ввода-вывода в соединении

толкать

public void push (String[] local, 
                String remote, 
                SyncService.ISyncProgressMonitor monitor)

Перемещает несколько файлов или каталогов.

Параметры
local String : локальные файлы для отправки

remote String : удаленный путь, представляющий собой каталог.

monitor SyncService.ISyncProgressMonitor : Монитор прогресса

Броски
SyncException если некоторые файлы не удалось отправить
TimeoutException в случае превышения времени ожидания при чтении ответов от устройства
IOException в случае ошибки ввода-вывода в соединении

pushFile

public void pushFile (String local, 
                String remote, 
                SyncService.ISyncProgressMonitor monitor)

Загрузите один файл.

Параметры
local String : локальный путь к файлу.

remote String : путь к удаленному файлу.

monitor SyncService.ISyncProgressMonitor : Монитор прогресса. Не может быть пустым.

Броски
SyncException если файл не удалось отправить
TimeoutException в случае превышения времени ожидания при чтении ответов с устройства.
IOException в случае ошибки ввода-вывода в соединении.

statFile

public SyncService.FileStat statFile (String path)

Возвращает статистическую информацию об удаленном файле.

Параметры
path String : удаленный файл

Возвраты
SyncService.FileStat Объект FileStat, содержащий информацию о режиме, размере и дате последнего изменения, если все прошло успешно, или null в противном случае.

Броски
TimeoutException в случае превышения времени ожидания при чтении ответов с устройства.
java.io.IOException
IOException