Questa pagina è stata tradotta dall'API Cloud Translation.

IRunUtil

public interface IRunUtil

com.android.tradefed.util.IRunUtil

Sottoclassi indirette note

RunUtil Una raccolta di metodi helper per l'esecuzione delle operazioni.

Interfaccia per l'esecuzione di operazioni a tempo e comandi di sistema.

Riepilogo

Classi nidificate
`interface`	`IRunUtil.IRunnableResult` Un'interfaccia per l'esecuzione asincrona di un'operazione che restituisce uno stato booleano.

Metodi pubblici
`abstract void`	`allowInterrupt(boolean allow)` Consente/non consente l'esecuzione di interruzioni sul thread corrente.
`abstract void`	`interrupt(Thread thread, String message, ErrorIdentifier errorId)` Interrompe le operazioni di esecuzione in corso/successive sul thread specificato.
`abstract void`	`interrupt(Thread thread, String message)` Interrompe le operazioni di esecuzione in corso/successive sul thread specificato.
`abstract boolean`	`isInterruptAllowed()` Specifica lo stato di interruzione di RunUtil.
`abstract Process`	`runCmdInBackground(Redirect redirect, command)` Un metodo `runCmdInBackground(String)` alternativo che accetta gli argomenti del comando in formato `ERROR(/List)`.
`abstract Process`	`runCmdInBackground( command)` Un metodo `runCmdInBackground(String)` alternativo che accetta gli argomenti del comando in formato `ERROR(/List)`.
`abstract Process`	`runCmdInBackground( command, OutputStream output)` L'esecuzione del comando con `ERROR(/OutputStream)` registra l'output del comando.
`abstract Process`	`runCmdInBackground(String... command)` Metodo helper per eseguire un comando di sistema in modo asincrono.
`abstract Process`	`runCmdInBackground(Redirect redirect, String... command)` Metodo helper per eseguire un comando di sistema in modo asincrono.
`abstract boolean`	`runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` Blocca ed esegue un'operazione più volte fino a quando non riesce.
`abstract boolean`	`runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` Blocca ed esegue un'operazione più volte fino a quando non riesce.
`abstract boolean`	`runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)` Blocca ed esegue un'operazione più volte fino a quando non riesce.
`abstract CommandStatus`	`runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` Blocca ed esegue un'operazione, interrompendola se richiede più tempo di quello specificato.
`abstract CommandResult`	`runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)` Metodo helper per eseguire un comando di sistema, interromperlo se richiede più tempo di quello specificato e reindirizzare l'output ai file se specificato.
`abstract CommandResult`	`runTimedCmd(long timeout, String... command)` Metodo helper per eseguire un comando di sistema e l'interruzione se richiede più tempo rispetto a quello specificato.
`abstract CommandResult`	`runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)` Metodo helper per eseguire un comando di sistema e l'interruzione se richiede più tempo rispetto a quello specificato.
`abstract CommandResult`	`runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)` Metodo helper per eseguire un comando di sistema e l'interruzione se richiede più tempo rispetto a quello specificato.
`abstract CommandResult`	`runTimedCmdSilently(long timeout, String... command)` Metodo helper per eseguire un comando di sistema e l'interruzione se richiede più tempo rispetto a quello specificato.
`abstract CommandResult`	`runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)` Metodo helper per eseguire un comando di sistema e l'interruzione se richiede più tempo rispetto a quello specificato.
`abstract CommandResult`	`runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)` Metodo helper per eseguire un comando di sistema, interromperlo se richiede più tempo di quello specificato e reindirizzare l'output ai file se specificato.
`abstract CommandResult`	`runTimedCmdWithInput(long timeout, String input, String... command)` Metodo helper per eseguire un comando di sistema che richiede l'input stdin e da interrompersi se richiede più tempo di quello specificato.
`abstract CommandResult`	`runTimedCmdWithInput(long timeout, String input, command)` Metodo helper per eseguire un comando di sistema che richiede l'input stdin e da interrompersi se richiede più tempo di quello specificato.
`abstract CommandResult`	`runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)` Metodo helper per eseguire un comando di sistema che richiede il reindirizzamento dello standard Stdin da un file e l'interruzione se richiede più tempo di quello specificato.
`abstract CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)` Metodo helper per eseguire un comando di sistema, interromperlo se richiede più tempo di quello specificato e reindirizzare l'output ai file se specificato.
`abstract CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)` Metodo helper per eseguire un comando di sistema e l'interruzione se richiede più tempo rispetto a quello specificato.
`abstract CommandResult`	`runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)` Metodo helper per eseguire un comando di sistema con memorizzazione nella cache.
`abstract boolean`	`runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` Blocca ed esegue un'operazione più volte fino a quando non riesce.
`abstract boolean`	`runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)` Blocca ed esegue un'operazione più volte fino a quando non riesce.
`abstract CommandStatus`	`runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)` Blocca ed esegue un'operazione, interrompendola se richiede più tempo di quello specificato.
`abstract void`	`setEnvVariable(String key, String value)` Consente di impostare una variabile di ambiente da utilizzare durante l'esecuzione dei comandi di sistema.
`abstract void`	`setEnvVariablePriority(IRunUtil.EnvPriority priority)` Quando crei un processo, decidi se annullare l'impostazione di una variabile di ambiente ha una priorità maggiore rispetto all'impostazione.
`abstract void`	`setInterruptibleInFuture(Thread thread, long timeMs)` Imposta come "interrompibile" dopo un po' di tempo di attesa.
`abstract void`	`setLinuxInterruptProcess(boolean interrupt)` Consenti l'utilizzo dell'interruzione "kill" di Linux sul processo in esecuzione tramite i metodi #runTimed quando raggiunge un timeout.
`abstract void`	`setRedirectStderrToStdout(boolean redirect)` Imposta il flusso di errori standard in modo che reindirizzi al flusso di output standard quando vengono eseguiti i comandi di sistema.
`abstract void`	`setWorkingDir(File dir)` Imposta la directory di lavoro per i comandi di sistema.
`abstract void`	`sleep(long time)` Metodo di supporto per dormire per un determinato periodo di tempo, ignorando eventuali eccezioni.
`abstract void`	`unsetEnvVariable(String key)` Annulla la configurazione di una variabile di ambiente, in modo che i comandi di sistema vengano eseguiti senza questa variabile di ambiente.

Metodi pubblici

allowInterrupt

public abstract void allowInterrupt (boolean allow)

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

Parametri
`allow`	`boolean`: se consentire l'esecuzione di interruzioni sul thread corrente.

interrompere

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

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

Parametri
`message`	`String`: il messaggio per `RunInterruptedException`.
`errorId`	`ErrorIdentifier`: rappresenta la causa dell'interruzione, se nota.

interrompere

public abstract void interrupt (Thread thread, 
                String message)

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

Parametri
`message`	`String`: il messaggio per `RunInterruptedException`.

èInterruptAllowed

public abstract boolean isInterruptAllowed ()

Specifica lo stato di interruzione di RunUtil.

Ritorni
`boolean`	true se l'esecuzione può essere interrotta, false in caso contrario.

eseguiCmdInBackground

public abstract Process runCmdInBackground (Redirect redirect, 
                 command)

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

Parametri
`redirect`	`Redirect`: il valore `ERROR(/Redirect)` da applicare a `ProcessBuilder`.
`command`	: `ERROR(/List)` contenente il comando di sistema specificato e argomenti facoltativi per exec

Ritorni
`Process`	il `Process` del comando eseguito

Lanci
	Impossibile eseguire il comando if

eseguiCmdInBackground

public abstract Process runCmdInBackground ( command)

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

Parametri
`command`	: `ERROR(/List)` contenente il comando di sistema specificato e argomenti facoltativi per exec

Ritorni
`Process`	il `Process` del comando eseguito

Lanci
	Impossibile eseguire il comando if

eseguiCmdInBackground

public abstract Process runCmdInBackground ( command, 
                OutputStream output)

L'esecuzione del comando con ERROR(/OutputStream) registra l'output del comando. Stdout e stderr sono uniti.

Parametri
`command`	: il comando da eseguire
`output`	`OutputStream`: OutputStream per salvare l'output

Ritorni
`Process`	`Process` che esegue il comando

Lanci
	Eccezione IO

eseguiCmdInBackground

public abstract Process runCmdInBackground (String... command)

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

Viene restituito subito dopo l'avvio del comando.

Parametri
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`Process`	il `Process` del comando eseguito

Lanci
	Impossibile eseguire il comando if

eseguiCmdInBackground

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

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

Viene restituito subito dopo l'avvio del comando.

Parametri
`redirect`	`Redirect`: il valore `ERROR(/Redirect)` da applicare a `ProcessBuilder`.
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`Process`	il `Process` del comando eseguito

Lanci
	Impossibile eseguire il comando if

runEscalatingTimedRiprova

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

Blocca ed esegue un'operazione più volte fino a quando non riesce.

Aumenta in modo esponenziale il tempo di attesa tra un tentativo e l'altro. È destinato a essere utilizzato durante l'esecuzione di un'operazione come il polling di un server, per dargli il tempo di recuperare in caso di malfunzionamento temporaneo.

Parametri
`opTimeout`	`long`: tempo massimo di attesa in ms per un singolo tentativo di operazione
`initialPollInterval`	`long`: tempo di attesa iniziale tra un tentativo e l'altro
`maxPollInterval`	`long`: tempo massimo di attesa tra un tentativo e l'altro
`maxTime`	`long`: il tempo massimo totale approssimativo per continuare a provare l'operazione
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` da eseguire

Ritorni
`boolean`	`true` se l'operazione viene completata correttamente prima della scadenza di maxTime

runFixedTimedRiprova

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

Blocca ed esegue un'operazione più volte fino a quando non riesce.

Parametri
`opTimeout`	`long`: tempo massimo di attesa in ms per un singolo tentativo di operazione
`pollInterval`	`long`: tempo di attesa iniziale tra un tentativo e l'altro
`maxTime`	`long`: il tempo massimo totale approssimativo per continuare a provare l'operazione
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` da eseguire

Ritorni
`boolean`	`true` se l'operazione viene completata correttamente prima della scadenza di maxTime

runFixedTimedRiprovaWithOutputMonitor

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

Blocca ed esegue un'operazione più volte fino a quando non riesce. Monitora anche l'attività dei flussi di output, interrompendo se non viene osservata alcuna attività di flusso per un periodo di tempo specificato. Se il valore di idleOutputTimeout è impostato su zero, non viene eseguito il monitoraggio del flusso.

Parametri
`opTimeout`	`long`: tempo massimo di attesa in ms per un singolo tentativo di operazione
`idleOutputTimeout`	`long`: tempo massimo di attesa in ms per l'output nei flussi di output
`pollInterval`	`long`: tempo di attesa iniziale tra un tentativo e l'altro
`maxTime`	`long`: il tempo massimo totale approssimativo per continuare a provare l'operazione
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` da eseguire

Ritorni
`boolean`	`true` se l'operazione viene completata correttamente prima della scadenza di maxTime

tempo di esecuzione

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

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

Parametri
`timeout`	`long`: tempo di attesa massimo in ms
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` da eseguire
`logErrors`	`boolean`: registra gli errori in caso di eccezione o meno.

Ritorni
`CommandStatus`	il risultato dell'operazione `CommandStatus`.

runTimedCmd

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

Metodo helper per eseguire un comando di sistema, interromperlo se richiede più tempo di quello specificato e reindirizzare l'output ai file se specificato. Quando gli elementi ERROR(/OutputStream) vengono forniti in questo modo, verranno lasciati aperti alla fine della funzione.

Parametri
`timeout`	`long`: tempo massimo di attesa per timeout in ms. 0 indica nessun timeout.
`stdout`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'output standard. Può essere null.
`stderr`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'output dell'errore. Può essere null.
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmd

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

Metodo helper per eseguire un comando di sistema e l'interruzione se richiede più tempo rispetto a quello specificato.

Parametri
`timeout`	`long`: tempo di attesa massimo in ms. 0 indica nessun timeout.
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdRiprova

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

Metodo helper per eseguire un comando di sistema e l'interruzione se richiede più tempo rispetto a quello specificato.

Parametri
`timeout`	`long`: tempo massimo di attesa in ms per ogni tentativo
`retryInterval`	`long`: tempo di attesa tra un nuovo tentativo e l'altro
`attempts`	`int`: numero massimo di tentativi
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdRiprovaWithOutputMonitor

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

Metodo helper per eseguire un comando di sistema e l'interruzione se richiede più tempo rispetto a quello specificato. Monitora anche l'attività dei flussi di output, interrompendo se non viene osservata alcuna attività di flusso per un periodo di tempo specificato. Se il valore di idleOutputTimeout è impostato su zero, non verrà effettuato alcun monitoraggio del flusso.

Parametri
`timeout`	`long`: tempo massimo di attesa in ms per ogni tentativo
`idleOutputTimeout`	`long`: tempo massimo di attesa in ms per l'output nei flussi di output
`retryInterval`	`long`: tempo di attesa tra un nuovo tentativo e l'altro
`attempts`	`int`: numero massimo di tentativi
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdSilently

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

Metodo helper per eseguire un comando di sistema e l'interruzione se richiede più tempo rispetto a quello specificato. Simile a runTimedCmd(long, String), ma non registra alcun errore in caso di eccezione.

Parametri
`timeout`	`long`: tempo di attesa massimo in ms
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdSilentlyRiprova

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

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

Parametri
`timeout`	`long`: tempo di attesa massimo in ms
`retryInterval`	`long`: tempo di attesa tra un nuovo tentativo e l'altro
`attempts`	`int`: numero massimo di tentativi
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdWithInput

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

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

Parametri
`timeout`	`long`: tempo massimo di attesa per timeout in ms. 0 indica nessun timeout.
`input`	`String`: l'input stdin da passare al processo
`stdoutFile`	`File`: `ERROR(/File)` dove verrà reindirizzato l'output standard. Può essere null.
`stderrFile`	`File`: `ERROR(/File)` dove verrà reindirizzato l'output dell'errore. Può essere null.
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdWithInput

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

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

Parametri
`timeout`	`long`: tempo di attesa massimo in ms
`input`	`String`: l'input stdin da passare al processo
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdWithInput

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

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

Parametri
`timeout`	`long`: tempo di attesa massimo in ms
`input`	`String`: l'input stdin da passare al processo
`command`	: `ERROR(/List)` contenente il comando di sistema e argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdWithInputReindirizzamento

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

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

Parametri
`timeout`	`long`: tempo di attesa massimo in ms
`inputRedirect`	`File`: il valore `ERROR(/File)` da reindirizzare come input standard utilizzando `ProcessBuilder.redirectInput()`. Se il valore è null, stdin non verrà reindirizzato.
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdWithOutputMonitor

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

Parametri
`timeout`	`long`: tempo massimo di attesa per timeout in ms. 0 indica nessun timeout.
`idleOutputTimeout`	`long`: tempo massimo di attesa in ms per l'output nei flussi di output
`stdout`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'output standard. Può essere null.
`stderr`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'output dell'errore. Può essere null.
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdWithOutputMonitor

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

Parametri
`timeout`	`long`: tempo di attesa massimo in ms. 0 indica nessun timeout.
`idleOutputTimeout`	`long`: tempo massimo di attesa in ms per l'output nei flussi di output
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando

runTimedCmdWithOutputMonitor

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

Metodo helper per eseguire un comando di sistema con memorizzazione nella cache.

Se cacheClient è specificato, la memorizzazione nella cache verrà abilitata. Se la cache è disponibile, verrà restituito il risultato memorizzato nella cache. In caso contrario, runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String) verrà utilizzato per eseguire il comando e il risultato verrà caricato per la memorizzazione nella cache.

Parametri
`timeout`	`long`: tempo massimo di attesa per timeout in ms. 0 indica nessun timeout.
`idleOutputTimeout`	`long`: tempo massimo di attesa in ms per l'output nei flussi di output.
`stdout`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'output standard. Può essere null.
`stderr`	`OutputStream`: `ERROR(/OutputStream)` dove verrà reindirizzato l'output dell'errore. Può essere null.
`cacheClient`	`ICacheClient`: un'istanza di `ICacheClient` utilizzata per gestire la memorizzazione nella cache.
`command`	`String`: il comando di sistema specificato e gli argomenti facoltativi per exec.

Ritorni
`CommandResult`	un'istruzione `CommandResult` contenente il risultato dell'esecuzione del comando.

runTimedRiprova

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

Blocca ed esegue un'operazione più volte fino a quando non riesce.

Parametri
`opTimeout`	`long`: tempo massimo di attesa in ms per un tentativo di operazione
`pollInterval`	`long`: tempo di attesa tra un nuovo tentativo e l'altro
`attempts`	`int`: numero massimo di tentativi
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` da eseguire

Ritorni
`boolean`	`true` se l'operazione è stata completata prima del raggiungimento dei tentativi.

runTimedRiprovaWithOutputMonitor

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

Parametri
`opTimeout`	`long`: tempo massimo di attesa in ms per un tentativo di operazione
`idleOutputTimeout`	`long`: tempo massimo di attesa in ms per l'output nei flussi di output
`pollInterval`	`long`: tempo di attesa tra un nuovo tentativo e l'altro
`attempts`	`int`: numero massimo di tentativi
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` da eseguire

Ritorni
`boolean`	`true` se l'operazione è stata completata prima del raggiungimento dei tentativi.

runTimedWithOutputMonitor

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

Blocca ed esegue un'operazione, interrompendola se richiede più tempo di quello specificato. Monitora anche l'attività dei flussi di output, interrompendo se non viene osservata alcuna attività di flusso per un periodo di tempo specificato. Se il valore di idleOutputTimeout è impostato su zero, non viene eseguito il monitoraggio del flusso.

Parametri
`timeout`	`long`: tempo di attesa massimo in ms
`idleOutputTimeout`	`long`: tempo massimo di attesa in ms per l'output nei flussi di output
`runnable`	`IRunUtil.IRunnableResult`: `IRunUtil.IRunnableResult` da eseguire
`logErrors`	`boolean`: registra gli errori in caso di eccezione o meno.

Ritorni
`CommandStatus`	il risultato dell'operazione `CommandStatus`.

setEnvVariable

public abstract void setEnvVariable (String key, 
                String value)

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

Parametri
`key`	`String`: il nome della variabile
`value`	`String`: il valore della variabile

Vedi anche:

ProcessBuilder.environment()

setEnvVariablePriority

public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)

Quando crei un processo, decidi se annullare l'impostazione di una variabile di ambiente ha una priorità maggiore rispetto all'impostazione. Per impostazione predefinita, l'annullamento dell'impostazione ha una priorità più alta, ovvero se viene effettuato un tentativo di impostare una variabile con lo stesso nome, l'operazione non avverrà poiché la variabile non verrà impostata. Non può essere utilizzato sull'istanza predefinita IRunUtil.

Parametri
`priority`	`IRunUtil.EnvPriority`

impostaInterruptibleInFuture

public abstract void setInterruptibleInFuture (Thread thread, 
                long timeMs)

Imposta come "interrompibile" dopo un po' di tempo di attesa. ERROR(/CommandScheduler#shutdownHard()) per applicare la chiusura definitiva.

Parametri
`thread`	`Thread`: il thread che diventerà interrotto.
`timeMs`	`long`: tempo di attesa prima di impostare l'interruzione.

setLinuxInterruptProcess

public abstract void setLinuxInterruptProcess (boolean interrupt)

Consenti l'utilizzo dell'interruzione "kill" di Linux sul processo in esecuzione tramite i metodi #runTimed quando raggiunge un timeout. Non può essere utilizzato sull'istanza predefinita IRunUtil.

Parametri
`interrupt`	`boolean`

setReindirizzamentoStderrToStdout

public abstract void setRedirectStderrToStdout (boolean redirect)

Imposta il flusso di errori standard in modo che reindirizzi al flusso di output standard quando vengono eseguiti i comandi di sistema. Il valore iniziale è false.

Parametri
`redirect`	`boolean`: nuovo valore per indicare se reindirizzare o meno

Vedi anche:

ProcessBuilder.redirectErrorStream(boolean)

setWorkingDir

public abstract void setWorkingDir (File dir)

Imposta la directory di lavoro per i comandi di sistema.

Parametri
`dir`	`File`: la directory di lavoro

Vedi anche:

ProcessBuilder.directory(File)

sonno

public abstract void sleep (long time)

Metodo di supporto per dormire per un determinato periodo di tempo, ignorando eventuali eccezioni.

Parametri
`time`	`long`: ms per dormire. I valori minori o uguali a 0 verranno ignorati

unsetEnvVariable

public abstract void unsetEnvVariable (String key)

Annulla la configurazione di una variabile di ambiente, in modo che i comandi di sistema vengano eseguiti senza questa variabile di ambiente.

Parametri
`key`	`String`: il nome della variabile

Vedi anche:

ProcessBuilder.environment()

IRunUtil

Riepilogo

Classi nidificate

Metodi pubblici

Metodi pubblici

allowInterrupt

interrompere

interrompere

èInterruptAllowed

eseguiCmdInBackground

eseguiCmdInBackground

eseguiCmdInBackground

eseguiCmdInBackground

eseguiCmdInBackground

runEscalatingTimedRiprova

runFixedTimedRiprova

runFixedTimedRiprovaWithOutputMonitor

tempo di esecuzione

runTimedCmd

runTimedCmd

runTimedCmdRiprova

runTimedCmdRiprovaWithOutputMonitor

runTimedCmdSilently

runTimedCmdSilentlyRiprova

runTimedCmdWithInput

runTimedCmdWithInput

runTimedCmdWithInput

runTimedCmdWithInputReindirizzamento

runTimedCmdWithOutputMonitor

runTimedCmdWithOutputMonitor

runTimedCmdWithOutputMonitor

runTimedRiprova

runTimedRiprovaWithOutputMonitor

runTimedWithOutputMonitor

setEnvVariable

setEnvVariablePriority

impostaInterruptibleInFuture

setLinuxInterruptProcess

setReindirizzamentoStderrToStdout

setWorkingDir

sonno

unsetEnvVariable