RunUtil

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

Valore costante: "inheritio-"

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

Valore costante: "RunnableNotifier"

RunUtil

public RunUtil ()

Crea un nuovo oggetto RunUtil da utilizzare.

RunUtil

public RunUtil (boolean inheritEnvVars)

allowInterrupt

public void allowInterrupt (boolean allow)

Consente/non consente interruzioni di esecuzione sul thread corrente. Se è consentito, le operazioni del thread corrente possono essere interrotte da altri thread tramite il metodo interrupt(Thread, String).

createProcessBuilder

public ProcessBuilder createProcessBuilder (ProcessBuilder.Redirect redirect, 
                List<String> commandList, 
                boolean enableCache)

getDefault

public static IRunUtil getDefault ()

Ottieni un riferimento all'oggetto RunUtil predefinito.

Questa opzione è utile per i chiamanti che vogliono utilizzare IRunUtil senza personalizzazione. È consigliabile che i chiamanti che hanno bisogno di un'istanza IRunUtil personalizzata (ad es. devono chiamare setEnvVariable(String,String) o setWorkingDir(File) creino la propria copia.

interrompere

public void interrupt (Thread thread, 
                String message, 
                ErrorIdentifier errorId)

Interrompe le operazioni di esecuzione in corso/imminenti sul thread specificato. Le operazioni di esecuzione sul thread specificato genereranno RunInterruptedException.

interrompere

public void interrupt (Thread thread, 
                String message)

Interrompe le operazioni di esecuzione in corso/imminenti sul thread specificato. Le operazioni di esecuzione sul thread specificato genereranno RunInterruptedException.

isInterruptAllowed

public boolean isInterruptAllowed ()

Restituisce lo stato di interruzione di RunUtil.

runCmdInBackground

public Process runCmdInBackground (ProcessBuilder.Redirect redirect, 
                List<String> command)

Un metodo runCmdInBackground(String...) alternativo che accetta gli argomenti del comando nel formato List.

runCmdInBackground

public Process runCmdInBackground (ProcessBuilder.Redirect redirect, 
                String... command)

Metodo helper per eseguire un comando di sistema in modo asincrono.

Verrà restituito immediatamente dopo l'esecuzione del comando.

runCmdInBackground

public Process runCmdInBackground (List<String> command)

Un metodo runCmdInBackground(String...) alternativo che accetta gli argomenti del comando nel formato List.

runCmdInBackground

public Process runCmdInBackground (String... command)

Metodo helper per eseguire un comando di sistema in modo asincrono.

Verrà restituito immediatamente dopo l'esecuzione del comando.

runCmdInBackground

public Process runCmdInBackground (List<String> command, 
                OutputStream output)

L'esecuzione del comando con OutputStream registra l'output del comando. Stdout e stderr vengono uniti.

runEscalatingTimedRetry

public boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Blocca ed esegue un'operazione più volte finché non ha esito positivo.

Aumenta in modo esponenziale il tempo di attesa tra i tentativi di operazione. Questo valore deve essere utilizzato quando esegui un'operazione come il polling di un server, per dargli il tempo di ripristinarsi nel caso in cui non sia temporaneamente disponibile.

runFixedTimedRetry

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

Blocca ed esegue un'operazione più volte finché non ha esito positivo.

runFixedTimedRetryWithOutputMonitor

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

Blocca ed esegue un'operazione più volte finché non ha esito positivo. Monitora anche i flussi di output per l'attività, interrompendoli se non viene osservata alcuna attività di streaming per un periodo di tempo specificato. Se idleOutputTimeout è impostato su zero, non verrà eseguito alcun monitoraggio dello stream.

runTimed

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

Blocca ed esegue un'operazione, interrompendola se richiede più tempo di quello specificato.

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                String... command)

Metodo helper per eseguire un comando di sistema e interromperlo se richiede più tempo di quello specificato.

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

Metodo helper per eseguire un comando di sistema, interrompere l'operazione se richiede più tempo di quello specificato e reindirizzare l'output ai file, se specificato. Quando OutputStream vengono forniti in questo modo, rimarranno aperti al termine della funzione.

runTimedCmdRetry

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

Metodo helper per eseguire un comando di sistema e interromperlo se richiede più tempo di quello specificato.

runTimedCmdRetryWithOutputMonitor

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

Metodo helper per eseguire un comando di sistema e interromperlo se richiede più tempo di quello specificato. Monitora anche i flussi di output per l'attività, interrompendola se non viene osservata alcuna attività di flusso per un periodo di tempo specificato. Se idleOutputTimeout è impostato su zero, non verrà eseguito alcun monitoraggio dello stream.

runTimedCmdSilently

public CommandResult runTimedCmdSilently (long timeout, 
                String... command)

Metodo helper per eseguire un comando di sistema e interromperlo se richiede più tempo di quello specificato. Simile a runTimedCmd(long,String...), ma non registra errori in caso di eccezione.

runTimedCmdSilentlyRetry

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

Metodo helper per eseguire un comando di sistema e interromperlo se richiede più tempo di quello specificato. Simile a runTimedCmdRetry(long,long,int,String[]), ma non registra errori in caso di eccezione.

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

Metodo helper per eseguire un comando di sistema che richiede l'input stdin e interrompere l'operazione se richiede più tempo di quello specificato.

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                List<String> command)

Metodo helper per eseguire un comando di sistema che richiede l'input stdin e interrompere l'operazione se richiede più tempo di quello specificato.

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

Metodo helper per eseguire un comando di sistema, interrompere l'operazione se richiede più tempo di quello specificato e reindirizzare l'output ai file, se specificato.

runTimedCmdWithInputRedirect

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

Metodo helper per eseguire un comando di sistema che richiede il reindirizzamento di Stdin da un file e l'interruzione se richiede più tempo di quello specificato.

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

Metodo helper per eseguire un comando di sistema e interromperlo se richiede più tempo di quello specificato. Monitora anche i flussi di output per l'attività, interrompendola se non viene osservata alcuna attività di flusso per un periodo di tempo specificato. Se idleOutputTimeout è impostato su zero, non verrà eseguito alcun monitoraggio dello stream.

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

Metodo helper per eseguire un comando di sistema, interrompere l'operazione se richiede più tempo di quello specificato e reindirizzare l'output ai file, se specificato. Quando OutputStream vengono forniti in questo modo, rimarranno aperti al termine della funzione.

runTimedRetry

public boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

Blocca ed esegue un'operazione più volte finché non ha esito positivo.

runTimedRetryWithOutputMonitor

public boolean runTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

Blocca ed esegue un'operazione più volte finché non ha esito positivo. Monitora anche i flussi di output per l'attività, interrompendoli se non viene osservata alcuna attività di streaming per un periodo di tempo specificato. Se idleOutputTimeout è impostato su zero, non verrà eseguito alcun monitoraggio dello stream.

runTimedWithOutputMonitor

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

Blocca ed esegue un'operazione, interrompendola se richiede più tempo di quello specificato. Inoltre, monitora i flussi di output per rilevare attività, interrompendoli se non viene osservata alcuna attività di streaming per un periodo di tempo specificato. Se idleOutputTimeout è impostato su zero, non verrà eseguito alcun monitoraggio dello stream.

setEnvVariable

public void setEnvVariable (String name, 
                String value)

Imposta una variabile di ambiente da utilizzare durante l'esecuzione dei comandi di sistema.

setEnvVariablePriority

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

Decidi se, durante la creazione di un processo, l'annullamento dell'impostazione della variabile di ambiente abbia una priorità superiore rispetto alla sua impostazione. Per impostazione predefinita, l'annullamento dell'impostazione ha la priorità più alta: ciò significa che se viene effettuato un tentativo di impostare una variabile con lo stesso nome, l'operazione non andrà a buon fine perché la variabile verrà annullata. Non può essere utilizzato sull'istanza IRunUtil predefinita.

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

Impostato come interrompibile dopo un determinato periodo di attesa. ERROR(/CommandScheduler#shutdownHard()) per far sì che la terminazione venga applicata.

setLinuxInterruptProcess

public void setLinuxInterruptProcess (boolean interrupt)

Consente di utilizzare l'interruzione "kill" di Linux per il processo in esecuzione tramite i metodi #runTimed quando raggiunge un timeout. Non può essere utilizzato sull'istanza IRunUtil predefinita.

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

Imposta il flusso di errori standard in modo che venga reindirizzato al flusso di output standard quando esegui comandi di sistema. Il valore iniziale è false.

setWorkingDir

public void setWorkingDir (File dir)

Imposta la directory di lavoro per i comandi di sistema.

sonno

public void sleep (long time)

Metodo helper per sospendere l'esecuzione per un determinato periodo di tempo, ignorando eventuali eccezioni.

unsetEnvVariable

public void unsetEnvVariable (String key)

Annulla l'impostazione di una variabile di ambiente, in modo che i comandi di sistema vengano eseguiti senza questa variabile di ambiente. Le variabili di ambiente potrebbero essere ereditate dal processo padre, quindi dobbiamo eliminare la variabile di ambiente da ProcessBuilder.environment()