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 de forma assíncrona uma operação que retorna um status booleano. |
Métodos públicos | |
|---|---|
abstract
void
|
allowInterrupt(boolean allow)
Permite/não permite 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 em andamento/futuras na determinada linha de execução. |
abstract
void
|
interrupt(Thread thread, String message)
Interrompe as operações de execução em andamento/futuras na determinada linha de execução. |
abstract
boolean
|
isInterruptAllowed()
Fornece o status de interrupção do RunUtil. |
abstract
Process
|
runCmdInBackground(ProcessBuilder.Redirect redirect, List<String> command)
Um método |
abstract
Process
|
runCmdInBackground(ProcessBuilder.Redirect redirect, String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona. |
abstract
Process
|
runCmdInBackground(List<String> command)
Um método |
abstract
Process
|
runCmdInBackground(String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona. |
abstract
Process
|
runCmdInBackground(List<String> command, OutputStream output)
Executar o comando com um |
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, cancelando se ela demorar mais do que um tempo especificado. |
abstract
CommandResult
|
runTimedCmd(long timeout, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período especificado. |
abstract
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, cancelar se demorar mais do que um tempo especificado e redirecionar a saída para arquivos, se especificado. |
abstract
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período especificado. |
abstract
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período especificado. |
abstract
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período especificado. |
abstract
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período 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 levar mais tempo do que um período especificado. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, List<String> command)
Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se levar mais tempo do que um período especificado. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
Método auxiliar para executar um comando do sistema, cancelar se demorar mais do que um tempo especificado e redirecionar a saída para arquivos, se especificado. |
abstract
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
Método auxiliar para executar um comando do sistema que exige o redirecionamento de Stdin de um arquivo e a interrupção se demorar mais do que um tempo especificado. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período especificado. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, cancelar se demorar mais do que um tempo especificado e redirecionar a saída para arquivos, se especificado. |
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, cancelando se ela demorar mais do que um tempo especificado. |
abstract
void
|
setEnvVariable(String key, String value)
Define uma variável de ambiente a ser usada ao executar comandos do sistema. |
abstract
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
Decida se, ao criar um processo, a prioridade de remover a definição de uma variável de ambiente é maior do que a de definir. |
abstract
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Definido como interrompível após algum tempo de espera. |
abstract
void
|
setLinuxInterruptProcess(boolean interrupt)
Permite usar a interrupção "kill" do Linux em processos executados pelos métodos #runTimed quando um tempo limite é atingido. |
abstract
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. |
abstract
void
|
setWorkingDir(File dir)
Define o diretório de trabalho para comandos do sistema. |
abstract
void
|
sleep(long time)
Método auxiliar para dormir por um determinado período, ignorando exceções. |
abstract
void
|
unsetEnvVariable(String key)
Cancela a definição de uma variável de ambiente para que os comandos do sistema sejam executados sem ela. |
Métodos públicos
allowInterrupt
public abstract void allowInterrupt (boolean allow)
Permite/não permite interrupções de execução na linha de execução atual. Se permitido, as operações da
linha de execução atual poderão ser interrompidas por outras linhas de execução usando o método interrupt(Thread, String).
| Parâmetros | |
|---|---|
allow |
boolean: indica se as interrupções de execução são permitidas na linha de execução atual. |
interromper
public abstract void interrupt (Thread thread,
String message,
ErrorIdentifier errorId)Interrompe as operações de execução em andamento/futuras na determinada linha de execução. As operações de execução na
thread 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 em andamento/futuras na determinada linha de execução. As operações de execução na
thread especificada vão gerar RunInterruptedException.
| Parâmetros | |
|---|---|
message |
String: a mensagem para RunInterruptedException. |
isInterruptAllowed
public abstract boolean isInterruptAllowed ()
Fornece o status de interrupção do RunUtil.
| Retorna | |
|---|---|
boolean |
"true" se a execução puder ser interrompida. Caso contrário, "false". |
runCmdInBackground
public abstract Process runCmdInBackground (ProcessBuilder.Redirect redirect,
List<String> command)Um método runCmdInBackground(String...) alternativo que aceita os argumentos do comando
no formato List.
| Parâmetros | |
|---|---|
redirect |
ProcessBuilder.Redirect: o Redirect a ser aplicado ao ProcessBuilder. |
command |
List: o List que contém o comando do sistema especificado e, opcionalmente, argumentos
para execução |
| Retorna | |
|---|---|
Process |
o Process do comando executado |
| Gera | |
|---|---|
IOException |
se o comando não foi executado |
runCmdInBackground
public abstract Process runCmdInBackground (ProcessBuilder.Redirect redirect,
String... command)Método auxiliar para executar um comando do sistema de forma assíncrona.
Retorna imediatamente após o comando de inicialização.
| Parâmetros | |
|---|---|
redirect |
ProcessBuilder.Redirect: o Redirect a ser aplicado ao ProcessBuilder. |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
Process |
o Process do comando executado |
| Gera | |
|---|---|
IOException |
se o comando não foi executado |
runCmdInBackground
public abstract Process runCmdInBackground (List<String> command)
Um método runCmdInBackground(String...) alternativo que aceita os argumentos do comando
no formato List.
| Parâmetros | |
|---|---|
command |
List: o List que contém o comando do sistema especificado e, opcionalmente, argumentos
para execução |
| Retorna | |
|---|---|
Process |
o Process do comando executado |
| Gera | |
|---|---|
IOException |
se o comando não foi executado |
runCmdInBackground
public abstract Process runCmdInBackground (String... command)
Método auxiliar para executar um comando do sistema de forma assíncrona.
Retorna imediatamente após o comando de inicialização.
| Parâmetros | |
|---|---|
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
Process |
o Process do comando executado |
| Gera | |
|---|---|
IOException |
se o comando não foi executado |
runCmdInBackground
public abstract Process runCmdInBackground (List<String> command,
OutputStream output)Executar o comando com um OutputStream registra a saída do comando.
Stdout e stderr são mesclados.
| Parâmetros | |
|---|---|
command |
List: o comando a ser executado |
output |
OutputStream: o OutputStream para salvar a saída |
| Retorna | |
|---|---|
Process |
o Process que executa o comando |
| Gera | |
|---|---|
|
java.io.IOException |
IOException |
|
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. Isso deve ser usado ao realizar uma operação como sondar um servidor, para dar tempo de recuperação caso ele 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 tentativas de operação. |
maxPollInterval |
long: o tempo máximo de espera entre tentativas de operação. |
maxTime |
long: o tempo total aproximado máximo para continuar tentando a operação. |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult a ser executado |
| Retorna | |
|---|---|
boolean |
true se a operação for concluída com sucesso antes da expiração de 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 tentativas de operação. |
maxTime |
long: o tempo total aproximado máximo para continuar tentando a operação. |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult a ser executado |
| Retorna | |
|---|---|
boolean |
true se a operação for concluída com sucesso antes da expiração de 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 fluxos de saída em busca de atividade, interrompendo se nenhuma atividade de fluxo 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 saída nos fluxos de saída |
pollInterval |
long: tempo inicial de espera entre tentativas de operação. |
maxTime |
long: o tempo total aproximado máximo para continuar tentando a operação. |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult a ser executado |
| Retorna | |
|---|---|
boolean |
true se a operação for concluída com sucesso antes da expiração de maxTime |
runTimed
public abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloqueia e executa uma operação, cancelando 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 a ser executado |
logErrors |
boolean: registra erros em exceções ou não. |
| Retorna | |
|---|---|
CommandStatus |
o resultado CommandStatus da operação. |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período 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 execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, cancelar se demorar mais do que um tempo especificado
e redirecionar a saída para arquivos, se especificado. Quando OutputStream são fornecidos dessa forma, eles ficam abertos no final da função.
| Parâmetros | |
|---|---|
timeout |
long: tempo máximo de espera do tempo limite em ms. 0 significa que não há tempo limite. |
stdout |
OutputStream: OutputStream em que a saída padrão será redirecionada. Pode ser nulo. |
stderr |
OutputStream: OutputStream em que a saída de erro será redirecionada. Pode ser nulo. |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmdRetry
public abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período 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 |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
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 interromper se ele levar mais tempo do que um período especificado. Também monitora os fluxos de saída em busca de atividade, interrompendo se nenhuma atividade de fluxo 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 para cada tentativa |
idleOutputTimeout |
long: tempo máximo de espera em ms para 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 |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmdSilently
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período especificado. Semelhante a runTimedCmd(long,String...), mas não registra erros em
exceção.
| Parâmetros | |
|---|---|
timeout |
long: tempo máximo de espera em ms |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmdSilentlyRetry
public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período especificado. Semelhante a runTimedCmdRetry(long,long,int,String[]), mas não registra erros em 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 |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
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 levar mais tempo do que um período especificado.
| Parâmetros | |
|---|---|
timeout |
long: tempo máximo de espera em ms |
input |
String: a entrada stdin a ser transmitida ao processo. |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, List<String> command)
Método auxiliar para executar um comando do sistema que requer entrada stdin e abortar se levar mais tempo do que um período especificado.
| Parâmetros | |
|---|---|
timeout |
long: tempo máximo de espera em ms |
input |
String: a entrada stdin a ser transmitida ao processo. |
command |
List: List que contém o comando do sistema e, opcionalmente, argumentos para execução |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Método auxiliar para executar um comando do sistema, cancelar se demorar mais do que um tempo especificado e redirecionar a saída para arquivos, se especificado.
| Parâmetros | |
|---|---|
timeout |
long: tempo máximo de espera do tempo limite em ms. 0 significa que não há tempo limite. |
input |
String: a entrada stdin a ser transmitida ao processo. |
stdoutFile |
File: File em que a saída padrão será redirecionada. Pode ser nulo. |
stderrFile |
File: File em que a saída de erro será redirecionada. Pode ser nulo. |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmdWithInputRedirect
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Método auxiliar para executar um comando do sistema que exige o redirecionamento de Stdin de um arquivo e a interrupção se demorar mais do que um tempo especificado.
| Parâmetros | |
|---|---|
timeout |
long: tempo máximo de espera em ms |
inputRedirect |
File: o File a ser redirecionado como entrada padrão usando ProcessBuilder.redirectInput(). Se for nulo, stdin não será redirecionado. |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Método auxiliar para executar um comando do sistema e interromper se ele levar mais tempo do que um período especificado. Também monitora os fluxos de saída em busca de atividade, interrompendo se nenhuma atividade de fluxo 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. 0 significa que não há tempo limite. |
idleOutputTimeout |
long: tempo máximo de espera em ms para saída nos fluxos de saída |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Método auxiliar para executar um comando do sistema, cancelar se demorar mais do que um tempo especificado
e redirecionar a saída para arquivos, se especificado. Quando OutputStream são fornecidos dessa forma, eles ficam abertos no final da função.
| Parâmetros | |
|---|---|
timeout |
long: tempo máximo de espera do tempo limite em ms. 0 significa que não há tempo limite. |
idleOutputTimeout |
long: tempo máximo de espera em ms para saída nos fluxos de saída |
stdout |
OutputStream: OutputStream em que a saída padrão será redirecionada. Pode ser nulo. |
stderr |
OutputStream: OutputStream em que a saída de erro será redirecionada. Pode ser nulo. |
command |
String: o comando do sistema especificado e, opcionalmente, argumentos para execução. |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
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 novas tentativas de comando. |
attempts |
int: o número máximo de tentativas |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult a ser executado |
| Retorna | |
|---|---|
boolean |
true se a operação for concluída com sucesso antes de atingir o número máximo de 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 fluxos de saída em busca de atividade, interrompendo se nenhuma atividade de fluxo 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 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 |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult a ser executado |
| Retorna | |
|---|---|
boolean |
true se a operação for concluída com sucesso antes de atingir o número máximo de tentativas. |
runTimedWithOutputMonitor
public abstract CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloqueia e executa uma operação, cancelando se ela demorar mais do que um tempo especificado. Também monitora os fluxos de saída em busca de atividade, cancelando se nenhuma atividade de fluxo 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 saída nos fluxos de saída |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult a ser executado |
logErrors |
boolean: registra erros em exceções 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 a 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)
Decida se, ao criar um processo, a prioridade de remover a definição de uma variável de ambiente é maior do que a de definir.
Por padrão, a remoção tem maior prioridade. Isso significa que, se houver uma tentativa de definir uma variável com o mesmo nome, ela não vai acontecer porque a variável será removida.
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)Definido como interrompível após algum tempo de espera.
ERROR(/CommandScheduler#shutdownHard()) para forçar 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 como interrompível. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Permite usar a interrupção "kill" do Linux em processos executados pelos métodos #runTimed quando um
tempo limite é atingido.
Não pode ser usado na instância IRunUtil padrão.
| Parâmetros | |
|---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public abstract 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 é "false".
| 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 dormir por um determinado período, ignorando exceções.
| Parâmetros | |
|---|---|
time |
long: ms para suspender. Valores menores ou iguais a 0 serão ignorados |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
Cancela a definição de uma variável de ambiente para que os comandos do sistema sejam executados sem ela.
| Parâmetros | |
|---|---|
key |
String: o nome da variável |
Confira também: