ICommandScheduler
public interface ICommandScheduler
com.android.tradefed.command.ICommandScheduler |
Um agendador para executar comandos do TradeFederation.
Resumo
Turmas aninhadas | |
---|---|
interface | ICommandScheduler.IScheduledInvocationListener Ouvinte para eventos de invocação quando a invocação for concluída. |
Métodos públicos | |
---|---|
abstract boolean | addCommand (String[] args) Adiciona um comando ao agendador. |
abstract void | addCommandFile (String cmdFile, extraArgs) addCommandFile (String cmdFile, extraArgs) Adiciona todos os comandos do arquivo fornecido ao agendador |
abstract void | await () Aguarda que o agendador comece a ser executado, inclusive aguardando a conclusão da transferência do TF antigo, se aplicável. |
abstract void | completeHandover () Informa ao programador de comandos que uma sequência de handover iniciada está totalmente concluída e deve reinicializar seu gerenciador remoto na porta padrão. |
abstract void | displayCommandQueue (PrintWriter printWriter) Saída de informações detalhadas de depuração sobre o estado da fila de execução do comando. |
abstract void | displayCommandsInfo (PrintWriter printWriter, String regex) Saída de uma lista de comandos atuais. |
abstract void | displayInvocationsInfo (PrintWriter printWriter) Exibe uma lista de invocações atuais. |
abstract void | dumpCommandsXml (PrintWriter printWriter, String regex) Despeje o arquivo xml expandido para o comando com todos os valores de |
abstract void | execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args) Aloca diretamente um dispositivo e executa um comando sem adicioná-lo à fila de comandos usando um |
abstract void | execCommand ( ICommandScheduler.IScheduledInvocationListener listener, String[] args) Aloca diretamente um dispositivo e executa um comando sem adicioná-lo à fila de comandos. |
abstract void | execCommand ( ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args) Execute o comando diretamente no dispositivo já alocado. |
abstract CommandFileWatcher | getCommandFileWatcher () Obtenha o |
abstract int | getExecutingCommandCount () Retorna o número de Comandos em estado de execução. |
abstract String | getInvocationInfo (int invocationId) Retorne as informações sobre uma invocação bu especificando o id de invocação. |
abstract CommandRunner.ExitCode | getLastInvocationExitCode () Retorna o código de erro da última invocação executada. |
abstract Throwable | getLastInvocationThrowable () Retorne o |
abstract int | getReadyCommandCount () Retorna o número de Comandos em estado pronto na fila. |
abstract void | handoverInitiationComplete () Informa ao agendador de comandos que a troca inicial de handover de dispositivos e comandos em uso foi concluída e pode iniciar a operação de agendamento. |
abstract boolean | handoverShutdown (int handoverPort) Inicia um |
abstract void | join () Aguarda a conclusão do agendador. |
abstract void | join (long millis) Aguarda a conclusão do agendador ou o tempo limite após a duração especificada em milissegundos. |
abstract void | removeAllCommands () Remova todos os comandos do agendador |
abstract void | setClearcutClient (ClearcutClient client) Defina o cliente para relatar dados de chicote |
abstract boolean | shouldShutdownOnCmdfileError () Retorna true se precisarmos desligar o agendador em um erro de comando |
abstract void | shutdown () Tente encerrar normalmente o planejador de comandos. |
abstract void | shutdownHard (boolean killAdb) Tente encerrar com força o planejador de comandos. |
abstract void | shutdownHard () Tente encerrar com força o planejador de comandos. |
abstract void | shutdownOnEmpty () Semelhante a |
abstract void | start () Inicie o |
abstract boolean | stopInvocation (int invocationId, String cause) Pare uma invocação em execução especificando seu id. |
default boolean | stopInvocation (int invocationId) Pare uma invocação em execução especificando seu id. |
abstract boolean | stopInvocation ( ITestInvocation invocation) Interrompa uma invocação em execução. |
Métodos públicos
addCommand
public abstract boolean addCommand (String[] args)
Adiciona um comando ao agendador.
Um comando é essencialmente uma instância de uma configuração a ser executada e seus argumentos associados. Se o argumento "--help" for especificado, o texto de ajuda para a configuração será enviado para stdout. Caso contrário, a configuração será adicionada à fila para execução.Parâmetros | |
---|---|
args | String : os argumentos de configuração. |
Devoluções | |
---|---|
boolean | true se o comando foi adicionado com sucesso |
Lança | |
---|---|
ConfigurationException | se o comando não pôde ser analisado |
addCommandFile
public abstract void addCommandFile (String cmdFile,extraArgs)
Adiciona todos os comandos do arquivo fornecido ao agendador
Parâmetros | |
---|---|
cmdFile | String : o caminho do sistema de arquivos do arquivo de comando |
extraArgs | ERROR(/List) de argumentos String para anexar a cada comando analisado do arquivo. Pode ser vazio, mas não deve ser nulo. |
Lança | |
---|---|
ConfigurationException | se o arquivo de comando não pôde ser analisado |
Veja também:
aguardam
public abstract void await ()
Aguarda que o agendador comece a ser executado, inclusive aguardando a conclusão da transferência do TF antigo, se aplicável.
completoEntrega
public abstract void completeHandover ()
Informa ao programador de comandos que uma sequência de handover iniciada está totalmente concluída e deve reinicializar seu gerenciador remoto na porta padrão.
displayCommandQueue
public abstract void displayCommandQueue (PrintWriter printWriter)
Saída de informações detalhadas de depuração sobre o estado da fila de execução do comando.
displayCommandsInfo
public abstract void displayCommandsInfo (PrintWriter printWriter, String regex)
Saída de uma lista de comandos atuais.
Parâmetros | |
---|---|
printWriter | PrintWriter : o ERROR(/PrintWriter) para o qual a saída será. |
regex | String : a expressão regular à qual os comandos devem corresponder para serem impressos. Se null, todos os comandos serão impressos. |
displayInvocationsInfo
public abstract void displayInvocationsInfo (PrintWriter printWriter)
Exibe uma lista de invocações atuais.
Parâmetros | |
---|---|
printWriter | PrintWriter : o ERROR(/PrintWriter) para o qual a saída será. |
dumpCommandsXml
public abstract void dumpCommandsXml (PrintWriter printWriter, String regex)
Despeje o arquivo xml expandido para o comando com todos os valores de Option
especificados para todos os comandos atuais.
Parâmetros | |
---|---|
printWriter | PrintWriter : o ERROR(/PrintWriter) para o qual enviar o status. |
regex | String : a expressão regular à qual os comandos devem corresponder para que o arquivo xml seja despejado. Se null, todos os comandos serão despejados. |
comando exec
public abstract void execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)
Aloca diretamente um dispositivo e executa um comando sem adicioná-lo à fila de comandos usando um IInvocationContext
já existente.
Parâmetros | |
---|---|
context | IInvocationContext : um IInvocationContext existente. |
listener | ICommandScheduler.IScheduledInvocationListener : o ICommandScheduler.IScheduledInvocationListener a ser informado |
args | String : os argumentos do comando |
Lança | |
---|---|
ConfigurationException | se o comando era inválido |
NoDeviceException | se não houver nenhum dispositivo para usar |
comando exec
public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, String[] args)
Aloca diretamente um dispositivo e executa um comando sem adicioná-lo à fila de comandos.
Parâmetros | |
---|---|
listener | ICommandScheduler.IScheduledInvocationListener : o ICommandScheduler.IScheduledInvocationListener a ser informado |
args | String : os argumentos do comando |
Lança | |
---|---|
ConfigurationException | se o comando era inválido |
NoDeviceException | se não houver nenhum dispositivo para usar |
comando exec
public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)
Execute o comando diretamente no dispositivo já alocado.
Parâmetros | |
---|---|
listener | ICommandScheduler.IScheduledInvocationListener : o ICommandScheduler.IScheduledInvocationListener a ser informado |
device | ITestDevice : o ITestDevice a ser usado |
args | String : os argumentos do comando |
Lança | |
---|---|
ConfigurationException | se o comando era inválido |
getCommandFileWatcher
public abstract CommandFileWatcher getCommandFileWatcher ()
Obtenha o CommandFileWatcher
apropriado para este agendador
Devoluções | |
---|---|
CommandFileWatcher |
getExecutingCommandCount
public abstract int getExecutingCommandCount ()
Retorna o número de Comandos em estado de execução.
Devoluções | |
---|---|
int |
getInvocationInfo
public abstract String getInvocationInfo (int invocationId)
Retorne as informações sobre uma invocação bu especificando o id de invocação.
Parâmetros | |
---|---|
invocationId | int : o ID de rastreamento da invocação. |
Devoluções | |
---|---|
String | Uma String contendo informações sobre a invocação. |
getLastInvocationExitCode
public abstract CommandRunner.ExitCode getLastInvocationExitCode ()
Retorna o código de erro da última invocação executada. Retorna 0 (sem erro), se nenhuma invocação foi executada ainda.
Devoluções | |
---|---|
CommandRunner.ExitCode |
getLastInvocationThrowable
public abstract Throwable getLastInvocationThrowable ()
Retorne o Throwable
da última invocação que foi executada. Retorna null, se nenhum throwable estiver disponível.
Devoluções | |
---|---|
Throwable |
getReadyCommandCount
public abstract int getReadyCommandCount ()
Retorna o número de Comandos em estado pronto na fila.
Devoluções | |
---|---|
int |
handoverIniciaçãoConcluído
public abstract void handoverInitiationComplete ()
Informa ao agendador de comandos que a troca inicial de handover de dispositivos e comandos em uso foi concluída e pode iniciar a operação de agendamento.
entrega Desligar
public abstract boolean handoverShutdown (int handoverPort)
Inicia um shutdown()
e entrega para outro processo tradefed neste mesmo host.
Parâmetros | |
---|---|
handoverPort | int |
Devoluções | |
---|---|
boolean | true se a iniciação do handover foi bem-sucedida, false caso contrário |
Junte
public abstract void join (long millis)
Aguarda a conclusão do agendador ou o tempo limite após a duração especificada em milissegundos.
Parâmetros | |
---|---|
millis | long |
Veja também:
removeAllCommands
public abstract void removeAllCommands ()
Remova todos os comandos do agendador
setClearcutClient
public abstract void setClearcutClient (ClearcutClient client)
Defina o cliente para relatar dados de chicote
Parâmetros | |
---|---|
client | ClearcutClient |
shouldShutdownOnCmdfileError
public abstract boolean shouldShutdownOnCmdfileError ()
Retorna true se precisarmos desligar o agendador em um erro de comando
Devoluções | |
---|---|
boolean |
desligar
public abstract void shutdown ()
Tente encerrar normalmente o planejador de comandos.
Limpa os comandos aguardando para serem testados e solicita que todas as invocações em andamento sejam encerradas normalmente. Depois que o desligamento é chamado, o loop principal do agendador aguardará a conclusão de todas as invocações em andamento antes de sair completamente.shutdownHard
public abstract void shutdownHard (boolean killAdb)
Tente encerrar com força o planejador de comandos.
Semelhante a shutdown()
, mas opcionalmente também matará a conexão adb, em uma tentativa de 'inspirar' invocações em andamento para serem concluídas mais rapidamente.
Parâmetros | |
---|---|
killAdb | boolean |
shutdownHard
public abstract void shutdownHard ()
Tente encerrar com força o planejador de comandos. O mesmo que shutdownHard(true).
shutdownOnEmpty
public abstract void shutdownOnEmpty ()
Semelhante a shutdown()
, mas aguardará que todos os comandos sejam executados antes de sair.
começar
public abstract void start ()
Inicie o ICommandScheduler
.
shutdown()
seja chamado. veja Thread.start()
. pararInvocação
public abstract boolean stopInvocation (int invocationId, String cause)
Pare uma invocação em execução especificando seu id.
Parâmetros | |
---|---|
invocationId | int : o ID de rastreamento da invocação. |
cause | String : a causa para parar a invocação. |
Devoluções | |
---|---|
boolean | true se a invocação foi interrompida, false caso contrário |
Lança | |
---|---|
UnsupportedOperationException | se a implementação não suportar isso |
pararInvocação
public boolean stopInvocation (int invocationId)
Pare uma invocação em execução especificando seu id.
Parâmetros | |
---|---|
invocationId | int |
Devoluções | |
---|---|
boolean | true se a invocação foi interrompida, false caso contrário |
Lança | |
---|---|
UnsupportedOperationException | se a implementação não suportar isso |
pararInvocação
public abstract boolean stopInvocation (ITestInvocation invocation)
Interrompa uma invocação em execução.
Parâmetros | |
---|---|
invocation | ITestInvocation |
Devoluções | |
---|---|
boolean | true se a invocação foi interrompida, false caso contrário |
Lança | |
---|---|
UnsupportedOperationException | se a implementação não suportar isso |
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2022-07-06 UTC.