RunUtil

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

NOME_DO_NOTIFIER_EXECUTÁVEL

public static final String RUNNABLE_NOTIFIER_NAME

RunUtil

public RunUtil ()

Crie um novo objeto RunUtil para usar.

RunUtil

public RunUtil (boolean inheritEnvVars)

allowInterrupt

public 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).

createProcessBuilder

public ProcessBuilder createProcessBuilder (Redirect redirect, 
                 commandList, 
                boolean enableCache)

getDefault

public static IRunUtil getDefault ()

Receba uma referência ao objeto RunUtil padrão.

Isso é útil para quem quer usar o IRunUtil sem personalização. É recomendável que os autores da chamada que precisam de uma instância personalizada do IRunUtil (ou seja, precisam chamar setEnvVariable(String, String) ou setWorkingDir(File)) criem a própria cópia.

interromper

public 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.

interromper

public 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.

isInterruptAllowed

public boolean isInterruptAllowed ()

Informa o status de interrupção do RunUtil.

linkFile

public static File linkFile (File destRoot, 
                String relToRoot, 
                File target)

Vincula target a um lugar em destRoot.

Se o arquivo de destino ou o link simbólico já existir no destRoot, ele não será vinculado.

runCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                 command)

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

runCmdInBackground

public Process runCmdInBackground ( command)

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

runCmdInBackground

public 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.

runCmdInBackground

public 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.

runCmdInBackground

public 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.

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. 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.

runFixedTimedRetry

public boolean runFixedTimedRetry (long opTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Bloqueia e executa uma operação várias vezes até que seja bem-sucedida.

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 atividades, sendo cancelado 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.

runTimed

public CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

Bloqueia e executa uma operação, cancelando se demorar mais do que um tempo especificado.

runTimedCmd

public 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.

runTimedCmd

public 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.

runTimedCmdRetry

public CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

Método auxiliar para executar um comando do sistema e abortar se demorar mais do que um tempo especificado.

runTimedCmdRetryWithOutputMonitor

public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                long retryInterval, 
                int attempts, 
                String... command)

Método auxiliar para executar um comando do sistema e abortar se 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.

runTimedCmdSilently

public 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.

runTimedCmdSilentlyRepetir

public CommandResult runTimedCmdSilentlyRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

Método auxiliar para executar um comando do sistema e abortar se demorar mais do que um tempo especificado. Semelhante a runTimedCmdRetry(long, long, int, String[]), mas não registra erros em exceções.

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.

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 ele levar mais tempo do que o especificado.

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 ele levar mais tempo do que o especificado.

runTimedCmdWithInputRedirect

public CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

Método auxiliar para executar um comando do sistema que requer o redirecionamento de Stdin de um arquivo e o encerramento se ele levar mais tempo do que o especificado.

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 maneira, eles são deixados abertos no final da função.

runTimedCmdWithOutputMonitor

public 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 missingOutputTimeout for definido como zero, nenhum monitoramento de stream vai ocorrer.

runTimedCmdWithOutputMonitor

public 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.

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.

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 streams de saída em busca de atividades, 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.

runTimedWithOutputMonitor

public CommandStatus runTimedWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

Bloqueia e executa uma operação, cancelando se 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.

setEnvVariable

public void setEnvVariable (String name, 
                String value)

Define uma variável de ambiente para ser usada ao executar comandos do sistema.

setEnvVariablePriority

public 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.

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

Definir como interrompível após algum tempo de espera. ERROR(/CommandScheduler#shutdownHard()) para aplicarmos o encerramento.

setLinuxInterruptProcess

public 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.

setRedirectStderrToStdout

public 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.

setWorkingDir

public void setWorkingDir (File dir)

Define o diretório de trabalho para comandos do sistema.

sono

public void sleep (long time)

Método auxiliar para suspender por determinado tempo, ignorando quaisquer exceções.

toRelativo

public static String toRelative (File start, 
                File target)

toRelative

public static String toRelative (File start, 
                String target)

unsetEnvVariable

public void unsetEnvVariable (String key)

Desativa uma variável de ambiente. Portanto, os comandos do sistema são executados sem ela. As variáveis de ambiente podem herdar do processo pai. Portanto, precisamos excluir a variável de ambiente de ProcessBuilder.environment().

uploadCache

public void uploadCache (ICacheClient cacheClient, 
                ExecutableActionResult actionResult)

Faz upload do último ExecutableActionResult executado com um cacheClient.