RunUtil
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
Constantes | |
|---|---|
String |
INHERITIO_PREFIX
|
String |
RUNNABLE_NOTIFIER_NAME
|
Construtores públicos | |
|---|---|
RunUtil()
Crie um novo objeto |
|
RunUtil(boolean inheritEnvVars)
|
|
Métodos públicos | |
|---|---|
void
|
allowInterrupt(boolean allow)
Permite/não permite interrupções de execução na linha de execução atual. |
ProcessBuilder
|
createProcessBuilder(Redirect redirect,
|
static
IRunUtil
|
getDefault()
Receba uma referência ao objeto |
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
Interrompe as operações de execução em andamento/futuras na determinada linha de execução. |
void
|
interrupt(Thread thread, String message)
Interrompe as operações de execução em andamento/futuras na determinada linha de execução. |
boolean
|
isInterruptAllowed()
Fornece o status de interrupção do RunUtil. |
Process
|
runCmdInBackground(Redirect redirect,
Um método |
Process
|
runCmdInBackground(
Um método |
Process
|
runCmdInBackground(
Executar o comando com um registro |
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é que ela seja concluída. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
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. |
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. |
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. |
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. |
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. |
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. |
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. |
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 remoção de uma variável de ambiente tem prioridade maior do que a definição delas. |
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Definido como interrompível após algum tempo de espera. |
void
|
setLinuxInterruptProcess(boolean interrupt)
Permite usar a interrupção "kill" do Linux em processos executados pelos métodos #runTimed quando atingem um tempo limite. |
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. |
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 período, ignorando exceções. |
void
|
unsetEnvVariable(String key)
Cancela a definição de uma variável de ambiente para que os comandos do sistema sejam executados sem ela.
As variáveis de ambiente podem ser herdadas do processo pai. Portanto, precisamos excluir a variável de ambiente de |
Constantes
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
Valor da constante: "inheritio-"
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
Valor da constante: "RunnableNotifier"
Construtores públicos
RunUtil
public RunUtil (boolean inheritEnvVars)
| Parâmetros | |
|---|---|
inheritEnvVars |
boolean |
Métodos públicos
allowInterrupt
public 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 de outras linhas de execução pelo 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. |
createProcessBuilder
public ProcessBuilder createProcessBuilder (Redirect redirect,
commandList,
boolean enableCache) | Parâmetros | |
|---|---|
redirect |
Redirect |
commandList |
|
enableCache |
boolean |
| Retorna | |
|---|---|
ProcessBuilder |
|
getDefault
public static IRunUtil getDefault ()
Receba uma referência ao objeto RunUtil padrão.
Isso é útil para chamadores que querem usar IRunUtil sem personalização.
Recomendamos que os chamadores que precisam de uma instância IRunUtil personalizada
(ou seja, precisam chamar setEnvVariable(String, String) ou
setWorkingDir(File)) criem a própria cópia.
| Retorna | |
|---|---|
IRunUtil |
|
interromper
public 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
determinada linha de execução vão gerar RunInterruptedException.
| Parâmetros | |
|---|---|
message |
String: a mensagem para RunInterruptedException. |
errorId |
ErrorIdentifier: representa 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 na determinada linha de execução. As operações de execução na
determinada linha de execução vão gerar RunInterruptedException.
| Parâmetros | |
|---|---|
message |
String: a mensagem para RunInterruptedException. |
isInterruptAllowed
public 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 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 |
: o ERROR(/List) que contém o comando do sistema especificado e, opcionalmente, argumentos
para execução |
| Retorna | |
|---|---|
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 |
: o ERROR(/List) que contém o comando do sistema especificado e, opcionalmente, argumentos
para execução |
| Retorna | |
|---|---|
Process |
o Process do comando executado |
runCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
Executar o comando com um registro ERROR(/OutputStream) da saída do comando.
Stdout e 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 |
runCmdInBackground
public 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 |
runCmdInBackground
public Process runCmdInBackground (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 |
Redirect: o ERROR(/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 |
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é que ela seja concluída.
Aumente exponencialmente o tempo de espera entre as tentativas de operação. Isso é usado ao realizar uma operação como consultar 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 para executar |
| Retorna | |
|---|---|
boolean |
true se a operação for concluída com sucesso antes da expiração de maxTime |
runFixedTimedRetry
public 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 para executar |
| Retorna | |
|---|---|
boolean |
true se a operação for concluída com sucesso antes da expiração de maxTime |
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é que ela seja concluída. 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 | |
|---|---|
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 para executar |
| Retorna | |
|---|---|
boolean |
true se a operação for concluída com sucesso antes da expiração de maxTime |
runTimed
public 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 para executar |
logErrors |
boolean: registra erros em exceção ou não. |
| Retorna | |
|---|---|
CommandStatus |
o resultado CommandStatus da operação. |
runTimedCmd
public 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 ERROR(/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: 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, argumentos para execução |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmd
public 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 |
runTimedCmdRetry
public 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 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, 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 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 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 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 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 |
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 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: 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, argumentos para execução |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
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 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 CommandResult runTimedCmdWithInput (long timeout, String input,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 |
: ERROR(/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 |
runTimedCmdWithInputRedirect
public 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 ERROR(/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 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 ERROR(/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: 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, argumentos para execução |
| Retorna | |
|---|---|
CommandResult |
um CommandResult que contém o resultado do comando executado |
runTimedCmdWithOutputMonitor
public 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, 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. 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 |
runTimedRetry
public 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 para executar |
| Retorna | |
|---|---|
boolean |
true se a operação for concluída com sucesso antes de atingir o número máximo de tentativas. |
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é que ela seja concluída. 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 | |
|---|---|
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 para executar |
| Retorna | |
|---|---|
boolean |
true se a operação for concluída com sucesso antes de atingir o número máximo de tentativas. |
runTimedWithOutputMonitor
public 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, 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 |
idleOutputTimeout |
long: tempo máximo de espera em ms para saída nos fluxos de saída |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult para executar |
logErrors |
boolean: registra erros em exceções ou não. |
| Retorna | |
|---|---|
CommandStatus |
o resultado CommandStatus da 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 da variável |
setEnvVariablePriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Decida se, ao criar um processo, a remoção de uma variável de ambiente tem prioridade maior do que a definição delas.
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 void setInterruptibleInFuture (Thread thread,
long timeMs)Definido como interrompível após algum tempo de espera.
ERROR(/CommandScheduler#shutdownHard()) para garantir que vamos encerrar eventualmente.
| 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 void setLinuxInterruptProcess (boolean interrupt)
Permite usar a interrupção "kill" do Linux em processos executados pelos métodos #runTimed quando atingem 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 é "false".
| 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 |
sono
public 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 void unsetEnvVariable (String key)
Cancela a definição de uma variável de ambiente para que os comandos do sistema sejam executados sem ela.
As variáveis de ambiente podem ser herdadas do processo pai. Portanto, precisamos excluir a variável de ambiente de ProcessBuilder.environment().
| Parâmetros | |
|---|---|
key |
String: o nome da variável |
Confira também: