ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler

Известные косвенные подклассы ClusterCommandScheduler , CommandScheduler ClusterCommandScheduler ICommandScheduler для поддержки TFC (кластер Tradefed). Планировщик команд Планировщик для запуска команд TradeFederation на всех доступных устройствах.

---

Планировщик для выполнения команд TradeFederation.

Резюме

Вложенные классы
interface	ICommandScheduler.IScheduledInvocationListener Прослушиватель событий вызова после завершения вызова.

Публичные методы
abstract boolean	addCommand (String[] args) Добавляет команду в планировщик.
abstract void	addCommandFile (String cmdFile, extraArgs) addCommandFile (String cmdFile, extraArgs) Добавляет все команды из данного файла в планировщик
abstract void	await () Ожидает запуска планировщика, включая ожидание завершения передачи от старого TF, если это применимо.
abstract void	completeHandover () Сообщает планировщику команд, что инициированная последовательность передачи полностью завершена, и он должен повторно инициализировать свой удаленный менеджер на порту по умолчанию.
abstract void	displayCommandQueue (PrintWriter printWriter) Выводить подробную отладочную информацию о состоянии очереди выполнения команд.
abstract void	displayCommandsInfo (PrintWriter printWriter, String regex) Вывести список текущих команд.
abstract void	displayInvocationsInfo (PrintWriter printWriter) Отображает список текущих вызовов.
abstract void	dumpCommandsXml (PrintWriter printWriter, String regex) Создайте дамп расширенного XML-файла для команды со всеми Option параметров, указанными для всех текущих команд.
abstract void	execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args) Напрямую выделяет устройство и выполняет команду, не добавляя ее в очередь команд, используя уже существующий IInvocationContext .
abstract void	execCommand ( ICommandScheduler.IScheduledInvocationListener listener, String[] args) Непосредственно выделяет устройство и выполняет команду, не добавляя ее в очередь команд.
abstract void	execCommand ( ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args) Непосредственно выполнить команду на уже выделенном устройстве.
abstract CommandFileWatcher	getCommandFileWatcher () Получите соответствующий CommandFileWatcher для этого планировщика
abstract int	getExecutingCommandCount () Возвращает количество команд в состоянии выполнения.
abstract String	getInvocationInfo (int invocationId) Возвращает информацию о вызове bu с указанием идентификатора вызова.
abstract CommandRunner.ExitCode	getLastInvocationExitCode () Возвращает код ошибки последнего запущенного вызова.
abstract Throwable	getLastInvocationThrowable () Возвратите Throwable из последнего запущенного вызова.
abstract int	getReadyCommandCount () Возвращает количество Команд в состоянии готовности в очереди.
abstract void	handoverInitiationComplete () Информирует планировщик команд о том, что первоначальный хэндовер-обмен используемыми устройствами и командами завершен, и он может начать операцию планирования.
abstract boolean	handoverShutdown (int handoverPort) Инициирует shutdown() и передачу управления другому процессу tradefed на том же хосте.
abstract void	join () Ожидает завершения планировщика.
abstract void	join (long millis) Ожидает завершения планировщика или истечения времени ожидания по истечении времени, указанного в миллисекундах.
abstract void	removeAllCommands () Удалить все команды из планировщика
abstract void	setClearcutClient (ClearcutClient client) Настройте клиент для передачи данных жгута проводов
abstract boolean	shouldShutdownOnCmdfileError () Верните true, если нам нужно выключить планировщик при ошибках команды.
abstract void	shutdown () Попытка корректно завершить работу планировщика команд.
abstract void	shutdownHard (boolean killAdb) Попытка принудительно отключить планировщик команд.
abstract void	shutdownHard () Попытка принудительно отключить планировщик команд.
abstract void	shutdownOnEmpty () Подобно shutdown() , но вместо этого будет ждать выполнения всех команд перед выходом.
abstract void	start () Запустите ICommandScheduler .
abstract boolean	stopInvocation (int invocationId, String cause) Остановите запущенный вызов, указав его идентификатор.
default boolean	stopInvocation (int invocationId) Остановите запущенный вызов, указав его идентификатор.
abstract boolean	stopInvocation ( ITestInvocation invocation) Остановить запущенный вызов.

Публичные методы

добавитькоманду

public abstract boolean addCommand (String[] args)

Добавляет команду в планировщик.

Команда, по сути, представляет собой экземпляр конфигурации для запуска и связанные с ней аргументы.

Если указан аргумент "--help", текст справки для конфигурации будет выведен на стандартный вывод. В противном случае конфиг будет добавлен в очередь на выполнение.

Параметры
args	String : аргументы конфигурации.

Возвращает
boolean	true , если команда была успешно добавлена

Броски
ConfigurationException	если команда не может быть проанализирована

Смотрите также:

• IConfigurationFactory.createConfigurationFromArgs(String[])

добавитьCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Добавляет все команды из данного файла в планировщик

Параметры
cmdFile	String : путь файловой системы к командному файлу.
extraArgs	: ERROR(/List) String аргументов для добавления к каждой команде, проанализированной из файла. Может быть пустым, но не должен быть нулевым.

Броски
ConfigurationException	если командный файл не может быть проанализирован

Смотрите также:

• CommandFileParser

Ждите

public abstract void await ()

Ожидает запуска планировщика, включая ожидание завершения передачи от старого TF, если это применимо.

полная передача

public abstract void completeHandover ()

Сообщает планировщику команд, что инициированная последовательность передачи полностью завершена, и он должен повторно инициализировать свой удаленный менеджер на порту по умолчанию.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

Выводить подробную отладочную информацию о состоянии очереди выполнения команд.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Вывести список текущих команд.

Параметры
printWriter	PrintWriter : ERROR(/PrintWriter) для вывода.
regex	String : регулярное выражение, которому должны соответствовать команды для вывода на печать. Если null, то будут напечатаны все команды.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Отображает список текущих вызовов.

Параметры
printWriter	PrintWriter : ERROR(/PrintWriter) для вывода.

дампКоммандсксмл

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Создайте дамп расширенного XML-файла для команды со всеми Option параметров, указанными для всех текущих команд.

Параметры
printWriter	PrintWriter : ERROR(/PrintWriter) для вывода состояния.
regex	String : регулярное выражение, с которым должны сопоставляться команды для создания дампа XML-файла. Если null, то все команды будут сброшены.

execCommand

public abstract void execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

Напрямую выделяет устройство и выполняет команду, не добавляя ее в очередь команд, используя уже существующий IInvocationContext .

Параметры
context	IInvocationContext : существующий IInvocationContext .
listener	ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener должен быть проинформирован
args	String : аргументы команды

Броски
ConfigurationException	если команда недействительна
NoDeviceException	если нет устройства для использования

execCommand

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

Непосредственно выделяет устройство и выполняет команду, не добавляя ее в очередь команд.

Параметры
listener	ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener должен быть проинформирован
args	String : аргументы команды

Броски
ConfigurationException	если команда недействительна
NoDeviceException	если нет устройства для использования

execCommand

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                ITestDevice device, 
                String[] args)

Непосредственно выполнить команду на уже выделенном устройстве.

Параметры
listener	ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener должен быть проинформирован
device	ITestDevice : ITestDevice для использования
args	String : аргументы команды

Броски
ConfigurationException	если команда недействительна

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Получите соответствующий CommandFileWatcher для этого планировщика

Возвращает
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Возвращает количество команд в состоянии выполнения.

Возвращает
int

получитьInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Возвращает информацию о вызове bu с указанием идентификатора вызова.

Параметры
invocationId	int : идентификатор отслеживания вызова.

Возвращает
String	String , содержащая информацию о вызове.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Возвращает код ошибки последнего запущенного вызова. Возвращает 0 (нет ошибки), если вызов еще не выполнялся.

Возвращает
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

Возвратите Throwable из последнего запущенного вызова. Возвращает null, если нет доступных бросков.

Возвращает
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

Возвращает количество Команд в состоянии готовности в очереди.

Возвращает
int

handoverInitiationComplete

public abstract void handoverInitiationComplete ()

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

хендоверзакрытие

public abstract boolean handoverShutdown (int handoverPort)

Инициирует shutdown() и передачу управления другому процессу tradefed на том же хосте.

Планировщик сообщит удаленному процессу tradefed, прослушивающему этот порт, об освобожденных устройствах, как только они станут доступными.

Параметры
handoverPort	int

Возвращает
boolean	true , если инициация хендовера прошла успешно, иначе false

присоединиться

public abstract void join ()

Ожидает завершения планировщика.

Смотрите также:

• Thread.join()

присоединиться

public abstract void join (long millis)

Ожидает завершения планировщика или истечения времени ожидания по истечении времени, указанного в миллисекундах.

Параметры
millis	long

Смотрите также:

• Thread.join(long)

удалить все команды

public abstract void removeAllCommands ()

Удалить все команды из планировщика

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Настройте клиент для передачи данных жгута проводов

Параметры
client	ClearcutClient

следуетShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Верните true, если нам нужно выключить планировщик при ошибках команды.

Возвращает
boolean

неисправность

public abstract void shutdown ()

Попытка корректно завершить работу планировщика команд.

Очищает команды, ожидающие проверки, и запрашивает корректное завершение всех выполняемых вызовов.

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

выключениеHard

public abstract void shutdownHard (boolean killAdb)

Попытка принудительно отключить планировщик команд.

Аналогичен shutdown() , но также необязательно отключает соединение adb, пытаясь «вдохновить» выполняемые вызовы на более быстрое завершение.

Параметры
killAdb	boolean

выключениеHard

public abstract void shutdownHard ()

Попытка принудительно отключить планировщик команд. То же, что и shutdownHard(true).

выключениеOnEmpty

public abstract void shutdownOnEmpty ()

Подобно shutdown() , но вместо этого будет ждать выполнения всех команд перед выходом.

Обратите внимание, что если какие-либо команды находятся в циклическом режиме, планировщик никогда не выйдет.

Начало

public abstract void start ()

Запустите ICommandScheduler .

Должен вызываться перед вызовом других методов.

Будет работать до тех пор, пока не будет вызван shutdown() . см. Thread.start() .

стопинвокация

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Остановите запущенный вызов, указав его идентификатор.

Параметры
invocationId	int : идентификатор отслеживания вызова.
cause	String : причина остановки вызова.

Возвращает
boolean	true, если вызов был остановлен, иначе false

Броски
UnsupportedOperationException	если реализация не поддерживает это

стопинвокация

public boolean stopInvocation (int invocationId)

Остановите запущенный вызов, указав его идентификатор.

Параметры
invocationId	int

Возвращает
boolean	true, если вызов был остановлен, иначе false

Броски
UnsupportedOperationException	если реализация не поддерживает это

стопинвокация

public abstract boolean stopInvocation (ITestInvocation invocation)

Остановить запущенный вызов.

Параметры
invocation	ITestInvocation

Возвращает
boolean	true, если вызов был остановлен, иначе false

Броски
UnsupportedOperationException	если реализация не поддерживает это