IRunUtil
public
interface
IRunUtil
com.android.tradefed.util.IRunUtil |
Interface para executar operações programadas e comandos do sistema.
Resumo
Classes aninhadas | |
---|---|
interface |
IRunUtil.IRunnableResult
Uma interface para executar assíncronamente uma operação que retorna um status booleano. |
Métodos públicos | |
---|---|
abstract
void
|
allowInterrupt(boolean allow)
Permite/proíbe interrupções de execução na linha de execução atual. |
abstract
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
Interrompe as operações de execução atuais/futuras na linha de execução. |
abstract
void
|
interrupt(Thread thread, String message)
Interrompe as operações de execução atuais/futuras na linha de execução. |
abstract
boolean
|
isInterruptAllowed()
Informa o status de interrupção do RunUtil. |
abstract
Process
|
runCmdInBackground(Redirect redirect,
Um método |
abstract
Process
|
runCmdInBackground(
Um método |
abstract
Process
|
runCmdInBackground(
Executar o comando com um |
abstract
Process
|
runCmdInBackground(String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona. |
abstract
Process
|
runCmdInBackground(Redirect redirect, String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona. |
abstract
boolean
|
runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até que ela seja concluída. |
abstract
boolean
|
runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até que ela seja concluída. |
abstract
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até que ela seja concluída. |
abstract
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloqueia e executa uma operação, abortando se ela demorar mais do que um tempo especificado. |
abstract
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, abortar se ele levar mais tempo do que o especificado e redirecionar a saída para arquivos, se especificado. |
abstract
CommandResult
|
runTimedCmd(long timeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado. |
abstract
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado. |
abstract
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado. |
abstract
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado. |
abstract
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
Método auxiliar para executar um comando do sistema, abortar se ele levar mais tempo do que o especificado e redirecionar a saída para arquivos, se especificado. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se ele levar mais tempo do que o especificado. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se ele levar mais tempo do que o especificado. |
abstract
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 encerramento se ele levar mais tempo do que o especificado. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, abortar se ele levar mais tempo do que o especificado e redirecionar a saída para arquivos, se especificado. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
Método auxiliar para executar um comando do sistema com armazenamento em cache. |
abstract
boolean
|
runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até que ela seja concluída. |
abstract
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até que ela seja concluída. |
abstract
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloqueia e executa uma operação, abortando se ela demorar mais do que um tempo especificado. |
abstract
void
|
setEnvVariable(String key, String value)
Define uma variável de ambiente para ser usada ao executar comandos do sistema. |
abstract
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
Ao criar um processo, decida se a prioridade de redefinir a variável de ambiente é maior do que defini-la. |
abstract
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Definir como interrompível após algum tempo de espera. |
abstract
void
|
setLinuxInterruptProcess(boolean interrupt)
Permite usar a interrupção "kill" do Linux no processo em execução pelos métodos #runTimed quando ele atinge um tempo limite. |
abstract
void
|
setRedirectStderrToStdout(boolean redirect)
Define o fluxo de erro padrão para redirecionar para o fluxo de saída padrão ao executar comandos do sistema. |
abstract
void
|
setWorkingDir(File dir)
Define o diretório de trabalho para comandos do sistema. |
abstract
void
|
sleep(long time)
Método auxiliar para suspender por um determinado período, ignorando exceções. |
abstract
void
|
unsetEnvVariable(String key)
Cancela a configuração de uma variável de ambiente para que os comandos do sistema sejam executados sem essa variável. |
abstract
void
|
uploadCache(ICacheClient cacheClient, ExecutableActionResult actionResult)
Faz o upload da última |
Métodos públicos
allowInterrupt
public abstract void allowInterrupt (boolean allow)
Permite/proíbe interrupções de execução na linha de execução atual. Se permitido, as operações de execução da
linha de execução atual podem ser interrompidas por outras linhas de execução usando o método interrupt(Thread, String)
.
Parâmetros | |
---|---|
allow |
boolean : permite interrupções de execução na linha de execução atual. |
interromper
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Interrompe as operações de execução atuais/futuras na linha de execução. As operações de execução na
linha de execução especificada vão gerar RunInterruptedException
.
Parâmetros | |
---|---|
message |
String : a mensagem para RunInterruptedException . |
errorId |
ErrorIdentifier : representa a causa da interrupção quando conhecida. |
interromper
public abstract void interrupt (Thread thread, String message)
Interrompe as operações de execução atuais/futuras na linha de execução. As operações de execução na
linha de execução especificada vão gerar RunInterruptedException
.
Parâmetros | |
---|---|
message |
String : a mensagem para RunInterruptedException . |
isInterruptAllowed
public abstract boolean isInterruptAllowed ()
Informa o status de interrupção do RunUtil.
Retorna | |
---|---|
boolean |
Verdadeiro se a execução pode ser interrompida. Caso contrário, é falso. |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect,command)
Um método runCmdInBackground(String)
alternativo que aceita os argumentos de comando
no formato ERROR(/List)
.
Parâmetros | |
---|---|
redirect |
Redirect : o ERROR(/Redirect) a ser aplicado ao ProcessBuilder . |
command |
: o ERROR(/List) que contém o comando do sistema especificado e, opcionalmente, argumentos
para execução |
Retorna | |
---|---|
Process |
o Process do comando executado |
Gera | |
---|---|
|
Se o comando não for executado |
runCmdInBackground
public abstract Process runCmdInBackground (command)
Um método runCmdInBackground(String)
alternativo que aceita os argumentos de comando
no formato ERROR(/List)
.
Parâmetros | |
---|---|
command |
: o ERROR(/List) que contém o comando do sistema especificado e, opcionalmente, argumentos
para execução |
Retorna | |
---|---|
Process |
o Process do comando executado |
Gera | |
---|---|
|
Se o comando não for executado |
runCmdInBackground
public abstract Process runCmdInBackground (command, OutputStream output)
Executar o comando com um ERROR(/OutputStream)
registra a saída do comando.
O stdout e o stderr são mesclados.
Parâmetros | |
---|---|
command |
: o comando a ser executado |
output |
OutputStream : o OutputStream para salvar a saída |
Retorna | |
---|---|
Process |
o Process que executa o comando |
Gera | |
---|---|
|
IOException |
runCmdInBackground
public abstract Process runCmdInBackground (String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona.
Será retornado imediatamente após o comando de inicialização.
Parâmetros | |
---|---|
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
Process |
o Process do comando executado |
Gera | |
---|---|
|
Se o comando não for executado |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect, String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona.
Será retornado imediatamente após o comando de inicialização.
Parâmetros | |
---|---|
redirect |
Redirect : o ERROR(/Redirect) a ser aplicado ao ProcessBuilder . |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
Process |
o Process do comando executado |
Gera | |
---|---|
|
Se o comando não for executado |
runEscalatingTimedRetry
public abstract boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até que ela seja concluída.
Aumente exponencialmente o tempo de espera entre as tentativas de operação. O objetivo é usá-lo ao realizar uma operação, como a pesquisa de um servidor, para dar tempo para que ele se recupere caso esteja 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 as tentativas de operação |
maxPollInterval |
long : o tempo máximo de espera entre as tentativas de operação |
maxTime |
long : o tempo máximo aproximado total para continuar tentando a operação |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Retorna | |
---|---|
boolean |
true se a operação for concluída antes do vencimento do maxTime |
runFixedTimedRetry
public abstract boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até que ela seja concluída.
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 as tentativas de operação |
maxTime |
long : o tempo máximo aproximado total para continuar tentando a operação |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Retorna | |
---|---|
boolean |
true se a operação for concluída antes do vencimento do maxTime |
runFixedTimedRetryWithOutputMonitor
public abstract boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até que ela seja concluída. Também monitora os streams de saída em busca de atividades, abortando se nenhuma atividade de stream for observada por um período especificado. Se o idleOutputTimeout for definido como zero, nenhum monitoramento de stream vai 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 para a saída nos fluxos de saída |
pollInterval |
long : tempo inicial de espera entre as tentativas de operação |
maxTime |
long : o tempo máximo aproximado total para continuar tentando a operação |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Retorna | |
---|---|
boolean |
true se a operação for concluída antes do vencimento do maxTime |
runTimed
public abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloqueia e executa uma operação, abortando se ela demorar mais do que um tempo especificado.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera em ms |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
logErrors |
boolean : registra erros em uma exceção ou não. |
Retorna | |
---|---|
CommandStatus |
o resultado CommandStatus da operação. |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, abortar se ele levar mais tempo do que o especificado
e redirecionar a saída para arquivos, se especificado. Quando ERROR(/OutputStream)
são fornecidos dessa maneira,
eles são deixados abertos no final da função.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera do tempo limite em ms. O valor 0 significa que não há tempo limite. |
stdout |
OutputStream : ERROR(/OutputStream) em que a saída padrão será redirecionada. Pode ser nulo. |
stderr |
OutputStream : ERROR(/OutputStream) em que a saída de erro será redirecionada. Pode ser nulo. |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera em ms. O valor 0 significa que não há tempo limite. |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdRetry
public abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera em ms para cada tentativa |
retryInterval |
long : tempo de espera entre as novas tentativas de comando |
attempts |
int : o número máximo de tentativas |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdRetryWithOutputMonitor
public abstract CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado. Também monitora os streams de saída para atividade, abortando se nenhuma atividade de stream for observada por um tempo especificado. Se o idleOutputTimeout for definido como zero, nenhum monitoramento de stream vai ocorrer.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera em ms para cada tentativa |
idleOutputTimeout |
long : tempo máximo de espera em ms para a saída nos fluxos de saída |
retryInterval |
long : tempo de espera entre as novas tentativas de comando |
attempts |
int : o número máximo de tentativas |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdSilently
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado. Semelhante a runTimedCmd(long, String)
, mas não registra erros na
exceção.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera em ms |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdSilentlyRetry
public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado. Semelhante a runTimedCmdRetry(long, long, int, String[])
,
mas não registra erros em exceções.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera em ms |
retryInterval |
long : tempo de espera entre as novas tentativas de comando |
attempts |
int : o número máximo de tentativas |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Método auxiliar para executar um comando do sistema, abortar se ele levar mais tempo do que o especificado e redirecionar a saída para arquivos, se especificado.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera do tempo limite em ms. O valor 0 significa que não há tempo limite. |
input |
String : a entrada stdin a ser transmitida para o processo |
stdoutFile |
File : ERROR(/File) em que a saída padrão será redirecionada. Pode ser nulo. |
stderrFile |
File : ERROR(/File) em que a saída de erro será redirecionada. Pode ser nulo. |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se ele levar mais tempo do que o especificado.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera em ms |
input |
String : a entrada stdin a ser transmitida para o processo |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input,command)
Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se ele levar mais tempo do que o especificado.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera em ms |
input |
String : a entrada stdin a ser transmitida para o processo |
command |
: ERROR(/List) contendo o comando do sistema e, opcionalmente, argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdWithInputRedirect
public abstract 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 encerramento se ele levar mais tempo do que o 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, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, abortar se ele levar mais tempo do que o especificado
e redirecionar a saída para arquivos, se especificado. Quando ERROR(/OutputStream)
são fornecidos dessa maneira,
eles são deixados abertos no final da função.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera do tempo limite em ms. O valor 0 significa que não há tempo limite. |
idleOutputTimeout |
long : tempo máximo de espera em ms para a saída nos fluxos de saída |
stdout |
OutputStream : ERROR(/OutputStream) em que a saída padrão será redirecionada. Pode ser nulo. |
stderr |
OutputStream : ERROR(/OutputStream) em que a saída de erro será redirecionada. Pode ser nulo. |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Método auxiliar para executar um comando do sistema e abortar se ele levar mais tempo do que o especificado. Também monitora os streams de saída para atividade, abortando se nenhuma atividade de stream for observada por um tempo especificado. Se o idleOutputTimeout for definido como zero, nenhum monitoramento de stream vai ocorrer.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera em ms. O valor 0 significa que não há tempo limite. |
idleOutputTimeout |
long : tempo máximo de espera em ms para a saída nos fluxos de saída |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
Método auxiliar para executar um comando do sistema com armazenamento em cache.
Se cacheClient
for especificado, o armazenamento em cache será ativado. Se o cache estiver
disponível, o resultado armazenado em cache será retornado. Caso contrário, runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String)
será usado para executar o comando, e o resultado será enviado para armazenamento em cache.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera do tempo limite em ms. O valor 0 significa que não há tempo limite. |
idleOutputTimeout |
long : tempo máximo de espera em ms para a saída nos fluxos de saída. |
stdout |
OutputStream : ERROR(/OutputStream) em que a saída padrão será redirecionada. Pode ser nulo. |
stderr |
OutputStream : ERROR(/OutputStream) em que a saída de erro será redirecionada. Pode ser nulo. |
cacheClient |
ICacheClient : uma instância de ICacheClient usada para processar o armazenamento em cache. |
command |
String : o comando do sistema especificado e, opcionalmente, os argumentos para execução. |
Retorna | |
---|---|
CommandResult |
um CommandResult que contém o resultado da execução do comando. |
runTimedRetry
public abstract boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até que ela seja concluída.
Parâmetros | |
---|---|
opTimeout |
long : tempo máximo de espera em ms para uma tentativa de operação |
pollInterval |
long : tempo de espera entre as novas tentativas de comando |
attempts |
int : o número máximo de tentativas |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Retorna | |
---|---|
boolean |
true se a operação for concluída antes de atingir as tentativas. |
runTimedRetryWithOutputMonitor
public abstract boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloqueia e executa uma operação várias vezes até que ela seja concluída. Também monitora os streams de saída em busca de atividades, abortando se nenhuma atividade de stream for observada por um período especificado. Se o idleOutputTimeout for definido como zero, nenhum monitoramento de stream vai ocorrer.
Parâmetros | |
---|---|
opTimeout |
long : tempo máximo de espera em ms para uma tentativa de operação |
idleOutputTimeout |
long : tempo máximo de espera em ms para a saída nos fluxos de saída |
pollInterval |
long : tempo de espera entre as novas tentativas de comando |
attempts |
int : o número máximo de tentativas |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
Retorna | |
---|---|
boolean |
true se a operação for concluída antes de atingir as tentativas. |
runTimedWithOutputMonitor
public abstract CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloqueia e executa uma operação, abortando se ela demorar mais do que um tempo especificado. Também monitora os streams de saída em busca de atividade, abortando se nenhuma atividade de stream for observada por um período especificado. Se o idleOutputTimeout for definido como zero, nenhum monitoramento de stream vai ocorrer.
Parâmetros | |
---|---|
timeout |
long : tempo máximo de espera em ms |
idleOutputTimeout |
long : tempo máximo de espera em ms para a saída nos fluxos de saída |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para executar |
logErrors |
boolean : registra erros em uma exceção ou não. |
Retorna | |
---|---|
CommandStatus |
o resultado CommandStatus da operação. |
setEnvVariable
public abstract void setEnvVariable (String key, String value)
Define uma variável de ambiente para ser usada ao executar comandos do sistema.
Parâmetros | |
---|---|
key |
String : o nome da variável |
value |
String : o valor da variável |
Confira também:
setEnvVariablePriority
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Ao criar um processo, decida se a prioridade de redefinir a variável de ambiente é maior
do que defini-la.
Por padrão, a prioridade de redefinição é mais alta: isso significa que, se uma tentativa de definir uma variável com o
mesmo nome for feita, ela não vai acontecer, já que a variável será redefinida.
Não pode ser usado na instância IRunUtil
padrão.
Parâmetros | |
---|---|
priority |
IRunUtil.EnvPriority |
setInterruptibleInFuture
public abstract void setInterruptibleInFuture (Thread thread, long timeMs)
Definir como interrompível após algum tempo de espera.
ERROR(/CommandScheduler#shutdownHard())
para aplicarmos o encerramento.
Parâmetros | |
---|---|
thread |
Thread : a linha de execução que vai se tornar interrompível. |
timeMs |
long : tempo de espera antes de definir o estado interrompível. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Permite usar a interrupção "kill" do Linux no processo em execução pelos métodos #runTimed quando
ele atinge um tempo limite.
Não pode ser usado na instância IRunUtil
padrão.
Parâmetros | |
---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
Define 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 |
Confira também:
setWorkingDir
public abstract void setWorkingDir (File dir)
Define o diretório de trabalho para comandos do sistema.
Parâmetros | |
---|---|
dir |
File : o diretório de trabalho |
Confira também:
sono
public abstract void sleep (long time)
Método auxiliar para suspender por um determinado período, ignorando exceções.
Parâmetros | |
---|---|
time |
long : ms para suspensão. Valores menores ou iguais a 0 serão ignorados. |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
Cancela a configuração de uma variável de ambiente para que os comandos do sistema sejam executados sem essa variável.
Parâmetros | |
---|---|
key |
String : o nome da variável |
Confira também:
uploadCache
public abstract void uploadCache (ICacheClient cacheClient, ExecutableActionResult actionResult)
Faz o upload da última ExecutableActionResult
executada com um cacheClient.
Parâmetros | |
---|---|
cacheClient |
ICacheClient : o ICacheClient usado para fazer o upload do resultado. |
actionResult |
ExecutableActionResult : o ExecutableActionResult a ser enviado. |