ExecutarUtil
public class RunUtil
extends Object
implements IRunUtil
java.lang.Object | |
↳ | com.android.tradefed.util.RunUtil |
Uma coleção de métodos auxiliares para executar operações.
Resumo
Campos | |
---|---|
public static final String | INHERITIO_PREFIX |
public static final String | RUNNABLE_NOTIFIER_NAME
|
Construtores públicos | |
---|---|
RunUtil () Crie um novo objeto |
Métodos públicos | |
---|---|
void | allowInterrupt (boolean allow) Permite/não permite interrupções de execução no thread atual. |
static IRunUtil | getDefault () Obtenha uma referência ao objeto |
void | interrupt (Thread thread, String message, ErrorIdentifier errorId) Interrompe as operações de execução em andamento/futuras no thread determinado. |
void | interrupt (Thread thread, String message) Interrompe as operações de execução em andamento/futuras no thread determinado. |
boolean | isInterruptAllowed () Forneça o status de interrupção do RunUtil. |
Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) Um método |
Process | runCmdInBackground ( command) runCmdInBackground ( command) Um método |
Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) Executar o comando com um |
Process | runCmdInBackground (String... command) Método auxiliar para executar um comando do sistema de forma assíncrona. |
Process | runCmdInBackground (Redirect redirect, String... command) Método auxiliar para executar um comando do sistema de forma assíncrona. |
boolean | runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Bloqueia e executa uma operação várias vezes até obter êxito. |
boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Bloqueia e executa uma operação várias vezes até obter êxito. |
boolean | runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Bloqueia e executa uma operação várias vezes até obter êxito. |
CommandStatus | runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Bloqueia e executa uma operação, abortando se demorar mais que o tempo especificado. |
CommandResult | runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command) Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado. |
CommandResult | runTimedCmd (long timeout, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdSilently (long timeout, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command) Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado. |
CommandResult | runTimedCmdWithInput (long timeout, String input, String... command) Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) Método auxiliar para executar um comando do sistema que requer o redirecionamento de Stdin de um arquivo e o cancelamento se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command) Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado. |
CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Bloqueia e executa uma operação várias vezes até obter êxito. |
boolean | runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Bloqueia e executa uma operação várias vezes até obter êxito. |
CommandStatus | runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Bloqueia e executa uma operação, abortando se demorar mais que o tempo especificado. |
void | setEnvVariable (String name, String value) Define uma variável de ambiente a ser usada ao executar comandos do sistema. |
void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) Decida se, ao criar um processo, a desativação da variável de ambiente tem maior prioridade do que a configuração delas. |
void | setInterruptibleInFuture (Thread thread, long timeMs) Definido como interrompível após algum tempo de espera. |
void | setLinuxInterruptProcess (boolean interrupt) Permitir usar a interrupção 'kill' do Linux no processo em execução através dos métodos #runTimed quando atingir o tempo limite. |
void | setRedirectStderrToStdout (boolean redirect) Configure o fluxo de erros padrão para redirecionar para o fluxo de saída padrão ao executar comandos do sistema. |
void | setWorkingDir (File dir) Define o diretório de trabalho para comandos do sistema. |
void | sleep (long time) Método auxiliar para dormir por um determinado tempo, ignorando quaisquer exceções. |
void | unsetEnvVariable (String key) Desativa uma variável de ambiente, para que os comandos do sistema sejam executados sem essa variável de ambiente. Variáveis de ambiente podem herdar do processo pai, então precisamos excluir a variável de ambiente de |
Campos
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
Construtores públicos
Métodos públicos
permitirInterrupção
public void allowInterrupt (boolean allow)
Permite/não permite interrupções de execução no thread atual. Se for permitido, as operações de execução do thread atual podem ser interrompidas por outros threads por meio do método interrupt(Thread, String)
.
Parâmetros | |
---|---|
allow | boolean : permite ou não interrupções de execução no thread atual. |
getDefault
public static IRunUtil getDefault ()
Obtenha uma referência ao objeto RunUtil
padrão.
setEnvVariable(String, String)
ou setWorkingDir(File)
criem sua própria cópia.Devoluções | |
---|---|
IRunUtil |
interromper
public void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Interrompe as operações de execução em andamento/futuras no thread determinado. As operações de execução no thread fornecido lançarão RunInterruptedException
.
Parâmetros | |
---|---|
message | String : a mensagem para RunInterruptedException . |
errorId | ErrorIdentifier : Representando a causa da interrupção quando conhecida. |
interromper
public void interrupt (Thread thread, String message)
Interrompe as operações de execução em andamento/futuras no thread determinado. As operações de execução no thread fornecido lançarão RunInterruptedException
.
Parâmetros | |
---|---|
message | String : a mensagem para RunInterruptedException . |
isInterruptAllowed
public boolean isInterruptAllowed ()
Forneça o status de interrupção do RunUtil.
Devoluções | |
---|---|
boolean | verdadeiro se a execução puder ser interrompida; caso contrário, falso. |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect,command)
Um método runCmdInBackground(String)
alternativo que aceita os argumentos do comando no formato ERROR(/List)
.
Parâmetros | |
---|---|
redirect | Redirect : O ERROR(/Redirect) a ser aplicado ao ProcessBuilder . |
command | ERROR(/List) contendo o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
Process | o Process do comando executado |
runCmdInBackground
public Process runCmdInBackground (command)
Um método runCmdInBackground(String)
alternativo que aceita os argumentos do comando no formato ERROR(/List)
.
Parâmetros | |
---|---|
command | ERROR(/List) contendo o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
Process | o Process do comando executado |
runCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
Executar o comando com um ERROR(/OutputStream)
registra a saída do comando. Stdout e stderr são mesclados.
Parâmetros | |
---|---|
command | |
output | OutputStream : o OutputStream para salvar a saída |
Devoluções | |
---|---|
Process | o Process executando o comando |
runCmdInBackground
public Process runCmdInBackground (String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona.
Retornará imediatamente após lançar o comando.
Parâmetros | |
---|---|
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
Process | o Process do comando executado |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect, String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona.
Retornará imediatamente após lançar o comando.
Parâmetros | |
---|---|
redirect | Redirect : O ERROR(/Redirect) a ser aplicado ao ProcessBuilder . |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
Process | o Process do comando executado |
runEscalatingTimedRetry
public boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até obter êxito.
Aumentar exponencialmente o tempo de espera entre tentativas de operação. Destina-se a ser usado ao executar uma operação como sondar um servidor, para dar-lhe tempo de recuperação caso fique temporariamente inativo.Parâmetros | |
---|---|
opTimeout | long : tempo máximo de espera em ms para uma única tentativa de operação |
initialPollInterval | long : tempo inicial de espera entre tentativas de operação |
maxPollInterval | long : o tempo máximo de espera entre as tentativas de operação |
maxTime | long : o tempo máximo total aproximado para continuar tentando a operação |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Devoluções | |
---|---|
boolean | true se a operação for concluída com sucesso antes de maxTime expirar |
runFixedTimedRetry
public boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até obter êxito.
Parâmetros | |
---|---|
opTimeout | long : tempo máximo de espera em ms para uma única tentativa de operação |
pollInterval | long : tempo inicial de espera entre tentativas de operação |
maxTime | long : o tempo máximo total aproximado para continuar tentando a operação |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Devoluções | |
---|---|
boolean | true se a operação for concluída com sucesso antes de maxTime expirar |
runFixedTimedRetryWithOutputMonitor
public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até obter êxito. Também monitora a atividade dos fluxos de saída, abortando se nenhuma atividade de fluxo for observada por um tempo especificado. Se odleOutputTimeout for definido como zero, nenhum monitoramento de fluxo ocorrerá.
Parâmetros | |
---|---|
opTimeout | long : tempo máximo de espera em ms para uma única tentativa de operação |
idleOutputTimeout | long : tempo máximo de espera em ms pela saída nos fluxos de saída |
pollInterval | long : tempo inicial de espera entre tentativas de operação |
maxTime | long : o tempo máximo total aproximado para continuar tentando a operação |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Devoluções | |
---|---|
boolean | true se a operação for concluída com sucesso antes de maxTime expirar |
runTimed
public CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloqueia e executa uma operação, abortando se demorar mais que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
logErrors | boolean : registra erros na exceção ou não. |
Devoluções | |
---|---|
CommandStatus | o resultado da operação CommandStatus . |
runTimedCmd
public CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado. Quando ERROR(/OutputStream)
são fornecidos desta forma, eles serão deixados abertos no final da função.
Parâmetros | |
---|---|
timeout | long : tempo limite máximo de espera em ms. 0 significa que não há tempo limite. |
stdout | OutputStream : ERROR(/OutputStream) para onde a saída padrão será redirecionada. Pode ser nulo. |
stderr | OutputStream : ERROR(/OutputStream) para onde a saída do erro será redirecionada. Pode ser nulo. |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmd
public CommandResult runTimedCmd (long timeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms. 0 significa que não há tempo limite. |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdRetry
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms para cada tentativa |
retryInterval | long : tempo de espera entre novas tentativas de comando |
attempts | int : o número máximo de tentativas para tentar |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdRetryWithOutputMonitor
public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. Também monitora a atividade dos fluxos de saída, abortando se nenhuma atividade de fluxo for observada por um tempo especificado. Se odleOutputTimeout for definido como zero, nenhum monitoramento de fluxo ocorrerá.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms para cada tentativa |
idleOutputTimeout | long : tempo máximo de espera em ms pela saída nos fluxos de saída |
retryInterval | long : tempo de espera entre novas tentativas de comando |
attempts | int : o número máximo de tentativas para tentar |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdSilenciosamente
public CommandResult runTimedCmdSilently (long timeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. Semelhante a runTimedCmd(long, String)
, mas não registra nenhum erro na exceção.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdSilentlyRetry
public CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. Semelhante a runTimedCmdRetry(long, long, int, String[])
, mas não registra nenhum erro na exceção.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
retryInterval | long : tempo de espera entre novas tentativas de comando |
attempts | int : o número máximo de tentativas para tentar |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado.
Parâmetros | |
---|---|
timeout | long : tempo limite máximo de espera em ms. 0 significa que não há tempo limite. |
input | String : a entrada stdin a ser passada para o processo |
stdoutFile | File : ERROR(/File) para onde a saída std será redirecionada. Pode ser nulo. |
stderrFile | File : ERROR(/File) para onde a saída do erro será redirecionada. Pode ser nulo. |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se demorar mais do que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
input | String : a entrada stdin a ser passada para o processo |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se demorar mais do que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
input | String : a entrada stdin a ser passada para o processo |
command | ERROR(/List) contendo o comando do sistema e opcionalmente argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithInputRedirect
public CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Método auxiliar para executar um comando do sistema que requer o redirecionamento de Stdin de um arquivo e o cancelamento se demorar mais do que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
inputRedirect | File : o ERROR(/File) para redirecionar como entrada padrão usando ProcessBuilder.redirectInput() . Se for nulo, o stdin não será redirecionado. |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado. Quando ERROR(/OutputStream)
são fornecidos desta forma, eles serão deixados abertos no final da função.
Parâmetros | |
---|---|
timeout | long : tempo limite máximo de espera em ms. 0 significa que não há tempo limite. |
idleOutputTimeout | long : tempo máximo de espera em ms pela saída nos fluxos de saída |
stdout | OutputStream : ERROR(/OutputStream) para onde a saída padrão será redirecionada. Pode ser nulo. |
stderr | OutputStream : ERROR(/OutputStream) para onde a saída do erro será redirecionada. Pode ser nulo. |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. Também monitora a atividade dos fluxos de saída, abortando se nenhuma atividade de fluxo for observada por um tempo especificado. Se odleOutputTimeout for definido como zero, nenhum monitoramento de fluxo ocorrerá.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms. 0 significa que não há tempo limite. |
idleOutputTimeout | long : tempo máximo de espera em ms pela saída nos fluxos de saída |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedRetry
public boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até obter êxito.
Parâmetros | |
---|---|
opTimeout | long : tempo máximo de espera em ms por uma tentativa de operação |
pollInterval | long : tempo de espera entre novas tentativas de comando |
attempts | int : o número máximo de tentativas para tentar |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Devoluções | |
---|---|
boolean | true se a operação for concluída com sucesso antes das tentativas serem alcançadas. |
runTimedRetryWithOutputMonitor
public boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até obter êxito. Também monitora a atividade dos fluxos de saída, abortando se nenhuma atividade de fluxo for observada por um tempo especificado. Se odleOutputTimeout for definido como zero, nenhum monitoramento de fluxo ocorrerá.
Parâmetros | |
---|---|
opTimeout | long : tempo máximo de espera em ms por uma tentativa de operação |
idleOutputTimeout | long : tempo máximo de espera em ms pela saída nos fluxos de saída |
pollInterval | long : tempo de espera entre novas tentativas de comando |
attempts | int : o número máximo de tentativas para tentar |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Devoluções | |
---|---|
boolean | true se a operação for concluída com sucesso antes das tentativas serem alcançadas. |
runTimedWithOutputMonitor
public CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloqueia e executa uma operação, abortando se demorar mais que o tempo especificado. Também monitora a atividade dos fluxos de saída, abortando se nenhuma atividade de fluxo for observada por um tempo especificado. Se odleOutputTimeout for definido como zero, nenhum monitoramento de fluxo ocorrerá.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
idleOutputTimeout | long : tempo máximo de espera em ms pela saída nos fluxos de saída |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
logErrors | boolean : registra erros na exceção ou não. |
Devoluções | |
---|---|
CommandStatus | o resultado da operação CommandStatus . |
setEnvVariável
public void setEnvVariable (String name, String value)
Define uma variável de ambiente a ser usada ao executar comandos do sistema.
Parâmetros | |
---|---|
name | String : o nome da variável |
value | String : o valor da variável |
setEnvVariablePriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Decida se, ao criar um processo, a desativação da variável de ambiente tem maior prioridade do que a configuração delas. Por padrão, a desativação tem maior prioridade: ou seja, se for feita uma tentativa de definir uma variável com o mesmo nome, isso não acontecerá, pois a variável será desativada. Não pode ser usado na instância IRunUtil
padrão.
Parâmetros | |
---|---|
priority | IRunUtil.EnvPriority |
setInterruptibleInFuture
public void setInterruptibleInFuture (Thread thread, long timeMs)
Definido como interrompível após algum tempo de espera. ERROR(/CommandScheduler#shutdownHard())
para forçar o encerramento eventualmente.
Parâmetros | |
---|---|
thread | Thread : o thread que se tornará interrompível. |
timeMs | long : tempo de espera antes de configurar interrompível. |
setLinuxInterruptProcess
public void setLinuxInterruptProcess (boolean interrupt)
Permitir usar a interrupção 'kill' do Linux no processo em execução através dos métodos #runTimed quando atingir o tempo limite. Não pode ser usado na instância IRunUtil
padrão.
Parâmetros | |
---|---|
interrupt | boolean |
setRedirectStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
Configure o fluxo de erros padrão para redirecionar para o fluxo de saída padrão ao executar comandos do sistema. O valor inicial é falso.
Parâmetros | |
---|---|
redirect | boolean : novo valor para redirecionar ou não |
setWorkingDir
public void setWorkingDir (File dir)
Define o diretório de trabalho para comandos do sistema.
Parâmetros | |
---|---|
dir | File : o diretório de trabalho |
dormir
public void sleep (long time)
Método auxiliar para dormir por um determinado tempo, ignorando quaisquer exceções.
Parâmetros | |
---|---|
time | long : ms para dormir. valores menores ou iguais a 0 serão ignorados |
unsetEnvVariável
public void unsetEnvVariable (String key)
Desativa uma variável de ambiente, para que os comandos do sistema sejam executados sem essa variável de ambiente. Variáveis de ambiente podem herdar do processo pai, então precisamos excluir a variável de ambiente de ProcessBuilder.environment()
Parâmetros | |
---|---|
key | String : o nome da variável |
Veja também:
ExecutarUtil
public class RunUtil
extends Object
implements IRunUtil
java.lang.Object | |
↳ | com.android.tradefed.util.RunUtil |
Uma coleção de métodos auxiliares para executar operações.
Resumo
Campos | |
---|---|
public static final String | INHERITIO_PREFIX |
public static final String | RUNNABLE_NOTIFIER_NAME
|
Construtores públicos | |
---|---|
RunUtil () Crie um novo objeto |
Métodos públicos | |
---|---|
void | allowInterrupt (boolean allow) Permite/não permite interrupções de execução no thread atual. |
static IRunUtil | getDefault () Obtenha uma referência ao objeto |
void | interrupt (Thread thread, String message, ErrorIdentifier errorId) Interrompe as operações de execução em andamento/futuras no thread determinado. |
void | interrupt (Thread thread, String message) Interrompe as operações de execução em andamento/futuras no thread determinado. |
boolean | isInterruptAllowed () Forneça o status de interrupção do RunUtil. |
Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) Um método |
Process | runCmdInBackground ( command) runCmdInBackground ( command) Um método |
Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) Executar o comando com um |
Process | runCmdInBackground (String... command) Método auxiliar para executar um comando do sistema de forma assíncrona. |
Process | runCmdInBackground (Redirect redirect, String... command) Método auxiliar para executar um comando do sistema de forma assíncrona. |
boolean | runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Bloqueia e executa uma operação várias vezes até obter êxito. |
boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Bloqueia e executa uma operação várias vezes até obter êxito. |
boolean | runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Bloqueia e executa uma operação várias vezes até obter êxito. |
CommandStatus | runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Bloqueia e executa uma operação, abortando se demorar mais que o tempo especificado. |
CommandResult | runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command) Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado. |
CommandResult | runTimedCmd (long timeout, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdSilently (long timeout, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command) Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado. |
CommandResult | runTimedCmdWithInput (long timeout, String input, String... command) Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) Método auxiliar para executar um comando do sistema que requer o redirecionamento de Stdin de um arquivo e o cancelamento se demorar mais do que o tempo especificado. |
CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command) Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado. |
CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command) Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. |
boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Bloqueia e executa uma operação várias vezes até obter êxito. |
boolean | runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Bloqueia e executa uma operação várias vezes até obter êxito. |
CommandStatus | runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Bloqueia e executa uma operação, abortando se demorar mais que o tempo especificado. |
void | setEnvVariable (String name, String value) Define uma variável de ambiente a ser usada ao executar comandos do sistema. |
void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) Decida se, ao criar um processo, a desativação da variável de ambiente tem maior prioridade do que a configuração delas. |
void | setInterruptibleInFuture (Thread thread, long timeMs) Definido como interrompível após algum tempo de espera. |
void | setLinuxInterruptProcess (boolean interrupt) Permitir usar a interrupção 'kill' do Linux no processo em execução através dos métodos #runTimed quando atingir o tempo limite. |
void | setRedirectStderrToStdout (boolean redirect) Configure o fluxo de erros padrão para redirecionar para o fluxo de saída padrão ao executar comandos do sistema. |
void | setWorkingDir (File dir) Define o diretório de trabalho para comandos do sistema. |
void | sleep (long time) Método auxiliar para dormir por um determinado tempo, ignorando quaisquer exceções. |
void | unsetEnvVariable (String key) Desativa uma variável de ambiente, para que os comandos do sistema sejam executados sem essa variável de ambiente. Variáveis de ambiente podem herdar do processo pai, então precisamos excluir a variável de ambiente de |
Campos
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
Construtores públicos
Métodos públicos
permitirInterrupção
public void allowInterrupt (boolean allow)
Permite/não permite interrupções de execução no thread atual. Se for permitido, as operações de execução do thread atual podem ser interrompidas por outros threads por meio do método interrupt(Thread, String)
.
Parâmetros | |
---|---|
allow | boolean : permite ou não interrupções de execução no thread atual. |
getDefault
public static IRunUtil getDefault ()
Obtenha uma referência ao objeto RunUtil
padrão.
setEnvVariable(String, String)
ou setWorkingDir(File)
criem sua própria cópia.Devoluções | |
---|---|
IRunUtil |
interromper
public void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Interrompe as operações de execução em andamento/futuras no thread determinado. As operações de execução no thread fornecido lançarão RunInterruptedException
.
Parâmetros | |
---|---|
message | String : a mensagem para RunInterruptedException . |
errorId | ErrorIdentifier : Representando a causa da interrupção quando conhecida. |
interromper
public void interrupt (Thread thread, String message)
Interrompe as operações de execução em andamento/futuras no thread determinado. As operações de execução no thread fornecido lançarão RunInterruptedException
.
Parâmetros | |
---|---|
message | String : a mensagem para RunInterruptedException . |
isInterruptAllowed
public boolean isInterruptAllowed ()
Forneça o status de interrupção do RunUtil.
Devoluções | |
---|---|
boolean | verdadeiro se a execução puder ser interrompida; caso contrário, falso. |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect,command)
Um método runCmdInBackground(String)
alternativo que aceita os argumentos do comando no formato ERROR(/List)
.
Parâmetros | |
---|---|
redirect | Redirect : O ERROR(/Redirect) a ser aplicado ao ProcessBuilder . |
command | ERROR(/List) contendo o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
Process | o Process do comando executado |
runCmdInBackground
public Process runCmdInBackground (command)
Um método runCmdInBackground(String)
alternativo que aceita os argumentos do comando no formato ERROR(/List)
.
Parâmetros | |
---|---|
command | ERROR(/List) contendo o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
Process | o Process do comando executado |
runCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
Executar o comando com um ERROR(/OutputStream)
registra a saída do comando. Stdout e stderr são mesclados.
Parâmetros | |
---|---|
command | |
output | OutputStream : o OutputStream para salvar a saída |
Devoluções | |
---|---|
Process | o Process executando o comando |
runCmdInBackground
public Process runCmdInBackground (String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona.
Retornará imediatamente após lançar o comando.
Parâmetros | |
---|---|
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
Process | o Process do comando executado |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect, String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona.
Retornará imediatamente após lançar o comando.
Parâmetros | |
---|---|
redirect | Redirect : O ERROR(/Redirect) a ser aplicado ao ProcessBuilder . |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
Process | o Process do comando executado |
runEscalatingTimedRetry
public boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até obter êxito.
Aumentar exponencialmente o tempo de espera entre tentativas de operação. Destina-se a ser usado ao executar uma operação como sondar um servidor, para dar-lhe tempo de recuperação caso fique temporariamente inativo.Parâmetros | |
---|---|
opTimeout | long : tempo máximo de espera em ms para uma única tentativa de operação |
initialPollInterval | long : tempo inicial de espera entre tentativas de operação |
maxPollInterval | long : o tempo máximo de espera entre as tentativas de operação |
maxTime | long : o tempo máximo total aproximado para continuar tentando a operação |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Devoluções | |
---|---|
boolean | true se a operação for concluída com sucesso antes de maxTime expirar |
runFixedTimedRetry
public boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até obter êxito.
Parâmetros | |
---|---|
opTimeout | long : tempo máximo de espera em ms para uma única tentativa de operação |
pollInterval | long : tempo inicial de espera entre tentativas de operação |
maxTime | long : o tempo máximo total aproximado para continuar tentando a operação |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Devoluções | |
---|---|
boolean | true se a operação for concluída com sucesso antes de maxTime expirar |
runFixedTimedRetryWithOutputMonitor
public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até obter êxito. Também monitora a atividade dos fluxos de saída, abortando se nenhuma atividade de fluxo for observada por um tempo especificado. Se odleOutputTimeout for definido como zero, nenhum monitoramento de fluxo ocorrerá.
Parâmetros | |
---|---|
opTimeout | long : tempo máximo de espera em ms para uma única tentativa de operação |
idleOutputTimeout | long : tempo máximo de espera em ms pela saída nos fluxos de saída |
pollInterval | long : tempo inicial de espera entre tentativas de operação |
maxTime | long : o tempo máximo total aproximado para continuar tentando a operação |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Devoluções | |
---|---|
boolean | true se a operação for concluída com sucesso antes de maxTime expirar |
runTimed
public CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloqueia e executa uma operação, abortando se demorar mais que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
logErrors | boolean : registra erros na exceção ou não. |
Devoluções | |
---|---|
CommandStatus | o resultado da operação CommandStatus . |
runTimedCmd
public CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado. Quando ERROR(/OutputStream)
são fornecidos desta forma, eles serão deixados abertos no final da função.
Parâmetros | |
---|---|
timeout | long : tempo limite máximo de espera em ms. 0 significa que não há tempo limite. |
stdout | OutputStream : ERROR(/OutputStream) para onde a saída padrão será redirecionada. Pode ser nulo. |
stderr | OutputStream : ERROR(/OutputStream) para onde a saída do erro será redirecionada. Pode ser nulo. |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmd
public CommandResult runTimedCmd (long timeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms. 0 significa que não há tempo limite. |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdRetry
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms para cada tentativa |
retryInterval | long : tempo de espera entre novas tentativas de comando |
attempts | int : o número máximo de tentativas para tentar |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdRetryWithOutputMonitor
public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. Também monitora a atividade dos fluxos de saída, abortando se nenhuma atividade de fluxo for observada por um tempo especificado. Se odleOutputTimeout for definido como zero, nenhum monitoramento de fluxo ocorrerá.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms para cada tentativa |
idleOutputTimeout | long : tempo máximo de espera em ms pela saída nos fluxos de saída |
retryInterval | long : tempo de espera entre novas tentativas de comando |
attempts | int : o número máximo de tentativas para tentar |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdSilenciosamente
public CommandResult runTimedCmdSilently (long timeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. Semelhante a runTimedCmd(long, String)
, mas não registra nenhum erro na exceção.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdSilentlyRetry
public CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. Semelhante a runTimedCmdRetry(long, long, int, String[])
, mas não registra nenhum erro na exceção.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
retryInterval | long : tempo de espera entre novas tentativas de comando |
attempts | int : o número máximo de tentativas para tentar |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado.
Parâmetros | |
---|---|
timeout | long : tempo limite máximo de espera em ms. 0 significa que não há tempo limite. |
input | String : a entrada stdin a ser passada para o processo |
stdoutFile | File : ERROR(/File) para onde a saída std será redirecionada. Pode ser nulo. |
stderrFile | File : ERROR(/File) para onde a saída do erro será redirecionada. Pode ser nulo. |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se demorar mais do que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
input | String : a entrada stdin a ser passada para o processo |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se demorar mais do que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
input | String : a entrada stdin a ser passada para o processo |
command | ERROR(/List) contendo o comando do sistema e opcionalmente argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithInputRedirect
public CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Método auxiliar para executar um comando do sistema que requer o redirecionamento de Stdin de um arquivo e o cancelamento se demorar mais do que o tempo especificado.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms |
inputRedirect | File : o ERROR(/File) para redirecionar como entrada padrão usando ProcessBuilder.redirectInput() . Se for nulo, o stdin não será redirecionado. |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, abortar se demorar mais do que o tempo especificado e redirecionar a saída para arquivos, se especificado. Quando ERROR(/OutputStream)
são fornecidos desta forma, eles serão deixados abertos no final da função.
Parâmetros | |
---|---|
timeout | long : tempo limite máximo de espera em ms. 0 significa que não há tempo limite. |
idleOutputTimeout | long : tempo máximo de espera em ms pela saída nos fluxos de saída |
stdout | OutputStream : ERROR(/OutputStream) para onde a saída padrão será redirecionada. Pode ser nulo. |
stderr | OutputStream : ERROR(/OutputStream) para onde a saída do erro será redirecionada. Pode ser nulo. |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se demorar mais do que o tempo especificado. Também monitora a atividade dos fluxos de saída, abortando se nenhuma atividade de fluxo for observada por um tempo especificado. Se odleOutputTimeout for definido como zero, nenhum monitoramento de fluxo ocorrerá.
Parâmetros | |
---|---|
timeout | long : tempo máximo de espera em ms. 0 significa que não há tempo limite. |
idleOutputTimeout | long : tempo máximo de espera em ms pela saída nos fluxos de saída |
command | String : o comando do sistema especificado e, opcionalmente, argumentos para exec |
Devoluções | |
---|---|
CommandResult | um CommandResult contendo o resultado da execução do comando |
runTimedRetry
public boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até obter êxito.
Parâmetros | |
---|---|
opTimeout | long : tempo máximo de espera em ms por uma tentativa de operação |
pollInterval | long : tempo de espera entre novas tentativas de comando |
attempts | int : o número máximo de tentativas para tentar |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Devoluções | |
---|---|
boolean | true se a operação for concluída com sucesso antes das tentativas serem alcançadas. |
runTimedRetryWithOutputMonitor
public boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até obter êxito. Também monitora a atividade dos fluxos de saída, abortando se nenhuma atividade de fluxo for observada por um tempo especificado. Se o IdleOutputTimeout estiver definido como zero, nenhum monitoramento de fluxo ocorrerá.
Parâmetros | |
---|---|
opTimeout | long : tempo máximo para esperar no MS para uma tentativa de operação |
idleOutputTimeout | long : tempo máximo para esperar no MS para saída nos fluxos de saída |
pollInterval | long : tempo para esperar entre as tentativas de comando |
attempts | int : o número máximo de tentativas de tentar |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Devoluções | |
---|---|
boolean | true se a operação foi concluída com êxito antes das tentativas alcançarem. |
RuntimedWithOutputMonitor
public CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloqueie e executa uma operação, abortando se levar mais tempo que um tempo especificado. Monitora também os fluxos de saída para atividade, abortando se nenhuma atividade de fluxo for observada para um tempo especificado. Se o IdleOutputTimeout estiver definido como zero, nenhum monitoramento de fluxo ocorrerá.
Parâmetros | |
---|---|
timeout | long : tempo máximo para esperar em ms |
idleOutputTimeout | long : tempo máximo para esperar no MS para saída nos fluxos de saída |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
logErrors | boolean : erros de log na exceção ou não. |
Devoluções | |
---|---|
CommandStatus | o resultado CommandStatus de operação. |
setenvvariable
public void setEnvVariable (String name, String value)
Define uma variável de ambiente a ser usada ao executar comandos do sistema.
Parâmetros | |
---|---|
name | String : o nome da variável |
value | String : o valor variável |
setenvvariablepriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Decida se ao criar ou não um processo, a variável de ambiente desnecessária é uma prioridade mais alta do que defini -las. Por padrão, a desencadeamento é uma prioridade mais alta: significando que, se uma tentativa de definir uma variável com o mesmo nome for feita, isso não acontecerá, pois a variável não será definida. Não pode ser usado na instância IRunUtil
padrão.
Parâmetros | |
---|---|
priority | IRunUtil.EnvPriority |
setInterruptibleInfuture
public void setInterruptibleInFuture (Thread thread, long timeMs)
Definido como interrompível após algum tempo de espera. ERROR(/CommandScheduler#shutdownHard())
para fazer cumprir, eventualmente.
Parâmetros | |
---|---|
thread | Thread : o thread que se tornará interrompido. |
timeMs | long : tempo de esperar antes de definir interruptível. |
SetLinuxinterruptProcess
public void setLinuxInterruptProcess (boolean interrupt)
Deixe o uso da interrupção do Linux 'Kill' no processo que será executado através de métodos #Runtimed quando atingir um tempo limite. Não pode ser usado na instância IRunUtil
padrão.
Parâmetros | |
---|---|
interrupt | boolean |
SetRedirectStDerrtostDout
public void setRedirectStderrToStdout (boolean redirect)
Defina o fluxo de erro padrão para redirecionar para o fluxo de saída padrão ao executar comandos do sistema. O valor inicial é falso.
Parâmetros | |
---|---|
redirect | boolean : novo valor para redirecionar ou não |
setworkingdir
public void setWorkingDir (File dir)
Define o diretório de trabalho para comandos do sistema.
Parâmetros | |
---|---|
dir | File : o diretório de trabalho |
dormir
public void sleep (long time)
Método ajudante para dormir por um determinado tempo, ignorando qualquer exceção.
Parâmetros | |
---|---|
time | long : MS para dormir. valores menores ou iguais a 0 serão ignorados |
UnsEtenvVariable
public void unsetEnvVariable (String key)
Desfie uma variável de ambiente, portanto, os comandos do sistema são executados sem essa variável de ambiente. As variáveis de ambiente podem herdar do processo pai, por isso precisamos excluir a variável de ambiente do ProcessBuilder.environment()
Parâmetros | |
---|---|
key | String : o nome da variável |
Veja também: