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, command)

Um método runCmdInBackground(String) alternativo que aceita os argumentos de comando no formato ERROR(/List).

abstract Process runCmdInBackground( command)

Um método runCmdInBackground(String) alternativo que aceita os argumentos de comando no formato ERROR(/List).

abstract Process runCmdInBackground( command, OutputStream output)

Executar o comando com um ERROR(/OutputStream) registra a saída do comando.

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, 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 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 ExecutableActionResult executada com um cacheClient.

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

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

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.