IRunUtil
public interface IRunUtil
com.android.tradefed.util.IRunUtil |
Interfaccia per l'esecuzione di operazioni temporizzate 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/disattiva le interruzioni di esecuzione sul thread corrente. |
abstract void | interrupt (Thread thread, String message, ErrorIdentifier errorId) Interrompe le operazioni di esecuzione in corso/prossime sul thread specificato. |
abstract void | interrupt (Thread thread, String message) Interrompe le operazioni di esecuzione in corso/prossime sul thread specificato. |
abstract boolean | isInterruptAllowed () Fornire lo stato di interruzione del RunUtil. |
abstract Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) Un metodo |
abstract Process | runCmdInBackground ( command) runCmdInBackground ( command) Un metodo |
abstract Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) L'esecuzione del comando con |
abstract Process | runCmdInBackground (String... command) Metodo di supporto per eseguire un comando di sistema in modo asincrono. |
abstract Process | runCmdInBackground (Redirect redirect, String... command) Metodo di supporto 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 finché non ha esito positivo. |
abstract boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blocca ed esegue un'operazione più volte finché non ha esito positivo. |
abstract CommandStatus | runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Blocca ed esegue un'operazione, interrompendola se impiega più tempo di un tempo specificato. |
abstract CommandResult | runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command) Metodo di supporto per eseguire un comando di sistema, interromperlo se impiega più tempo di un tempo specificato e reindirizzare l'output ai file se specificato. |
abstract CommandResult | runTimedCmd (long timeout, String... command) Metodo di supporto per eseguire un comando di sistema e interromperlo se impiega più tempo di un tempo specificato. |
abstract CommandResult | runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command) Metodo di supporto per eseguire un comando di sistema e interromperlo se impiega più tempo di un tempo specificato. |
abstract CommandResult | runTimedCmdSilently (long timeout, String... command) Metodo di supporto per eseguire un comando di sistema e interromperlo se impiega più tempo di un tempo specificato. |
abstract CommandResult | runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command) Metodo di supporto per eseguire un comando di sistema e interromperlo se impiega più tempo di un tempo specificato. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command) Metodo di supporto per eseguire un comando di sistema, interromperlo se impiega più tempo di un tempo specificato e reindirizzare l'output ai file se specificato. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, String... command) Metodo di supporto per eseguire un comando di sistema che richiede input stdin e che viene interrotto se impiega più tempo di un tempo specificato. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) Metodo di supporto per eseguire un comando di sistema che richiede input stdin e che viene interrotto se impiega più tempo di un tempo specificato. |
abstract CommandResult | runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) Metodo di supporto per eseguire un comando di sistema che richiede il reindirizzamento di Stdin da un file e l'interruzione se impiega più tempo di un tempo specificato. |
abstract boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Blocca ed esegue un'operazione più volte finché non ha esito positivo. |
abstract void | setEnvVariable (String key, String value) Imposta una variabile di ambiente da utilizzare durante l'esecuzione dei comandi di sistema. |
abstract void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) Decidere se durante la creazione di un processo, la disattivazione delle variabili di ambiente ha o meno una priorità maggiore rispetto alla loro impostazione. |
abstract void | setInterruptibleInFuture (Thread thread, long timeMs) Impostato come interrompibile dopo un certo tempo di attesa. |
abstract void | setLinuxInterruptProcess (boolean interrupt) Consenti di utilizzare l'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 errore standard per reindirizzare al flusso di output standard durante l'esecuzione dei 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 l'impostazione di una variabile di ambiente, quindi i comandi di sistema vengono eseguiti senza questa variabile di ambiente. |
Metodi pubblici
consentireInterrupt
public abstract void allowInterrupt (boolean allow)
Consente/disattiva le interruzioni di esecuzione sul thread corrente. Se è consentito, le operazioni di esecuzione del thread corrente possono essere interrotte da altri thread tramite il metodo interrupt(Thread, String)
.
Parametri | |
---|---|
allow | boolean : se consentire le interruzioni di esecuzione sul thread corrente. |
interrompere
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Interrompe le operazioni di esecuzione in corso/prossime 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 quando nota. |
interrompere
public abstract void interrupt (Thread thread, String message)
Interrompe le operazioni di esecuzione in corso/prossime sul thread specificato. Le operazioni di esecuzione sul thread specificato genereranno RunInterruptedException
.
Parametri | |
---|---|
message | String : il messaggio per RunInterruptedException . |
èInterruptAllowed
public abstract boolean isInterruptAllowed ()
Fornire lo stato di interruzione del RunUtil.
ritorna | |
---|---|
boolean | true se l'esecuzione può essere interrotta, false altrimenti. |
eseguiCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect,command)
Un metodo runCmdInBackground(String)
alternativo che accetta gli argomenti del comando nel formato ERROR(/List)
.
Parametri | |
---|---|
redirect | Redirect : ERROR(/Redirect) da applicare a ProcessBuilder . |
command | ERROR(/List) contenente il comando di sistema specificato e facoltativamente argomenti da exec |
ritorna | |
---|---|
Process | il Process del comando eseguito |
Lancia | |
---|---|
| se il comando non è stato eseguito |
eseguiCmdInBackground
public abstract Process runCmdInBackground (command)
Un metodo runCmdInBackground(String)
alternativo che accetta gli argomenti del comando nel formato ERROR(/List)
.
Parametri | |
---|---|
command | ERROR(/List) contenente il comando di sistema specificato e facoltativamente argomenti da exec |
ritorna | |
---|---|
Process | il Process del comando eseguito |
Lancia | |
---|---|
| se il comando non è stato eseguito |
eseguiCmdInBackground
public abstract Process runCmdInBackground (command, OutputStream output)
L'esecuzione del comando con ERROR(/OutputStream)
registra l'output del comando. Stdout e stderr vengono uniti insieme.
Parametri | |
---|---|
command | |
output | OutputStream : OutputStream per salvare l'output |
ritorna | |
---|---|
Process | il Process che esegue il comando |
Lancia | |
---|---|
| IOException |
eseguiCmdInBackground
public abstract Process runCmdInBackground (String... command)
Metodo di supporto per eseguire un comando di sistema in modo asincrono.
Tornerà immediatamente dopo aver lanciato il comando.
Parametri | |
---|---|
command | String : il comando di sistema specificato e facoltativamente gli argomenti da exec |
ritorna | |
---|---|
Process | il Process del comando eseguito |
Lancia | |
---|---|
| se il comando non è stato eseguito |
eseguiCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect, String... command)
Metodo di supporto per eseguire un comando di sistema in modo asincrono.
Tornerà immediatamente dopo aver lanciato il comando.
Parametri | |
---|---|
redirect | Redirect : ERROR(/Redirect) da applicare a ProcessBuilder . |
command | String : il comando di sistema specificato e facoltativamente gli argomenti da exec |
ritorna | |
---|---|
Process | il Process del comando eseguito |
Lancia | |
---|---|
| se il comando non è stato eseguito |
runEscalatingTimedRetry
public abstract 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 esponenzialmente il tempo di attesa tra i tentativi di operazione. Questo è pensato per essere utilizzato quando si esegue un'operazione come il polling di un server, per dargli il tempo di riprendersi nel caso sia temporaneamente inattivo.Parametri | |
---|---|
opTimeout | long : tempo massimo di attesa in ms per un singolo tentativo di operazione |
initialPollInterval | long : tempo iniziale di attesa tra i tentativi di operazione |
maxPollInterval | long : il tempo massimo di attesa tra i tentativi di operazione |
maxTime | long : il tempo massimo approssimativo totale per continuare a provare l'operazione |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult da eseguire |
ritorna | |
---|---|
boolean | true se l'operazione è stata completata correttamente prima della scadenza di maxTime |
eseguiFixedTimedRetry
public abstract boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blocca ed esegue un'operazione più volte finché non ha esito positivo.
Parametri | |
---|---|
opTimeout | long : tempo massimo di attesa in ms per un singolo tentativo di operazione |
pollInterval | long : tempo iniziale di attesa tra i tentativi di operazione |
maxTime | long : il tempo massimo approssimativo totale per continuare a provare l'operazione |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult da eseguire |
ritorna | |
---|---|
boolean | true se l'operazione è stata completata correttamente prima della scadenza di maxTime |
runTimed
public abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blocca ed esegue un'operazione, interrompendola se impiega più tempo di un tempo specificato.
Parametri | |
---|---|
timeout | long : tempo massimo di attesa in ms |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult da eseguire |
logErrors | boolean : registra gli errori in caso di eccezione o meno. |
ritorna | |
---|---|
CommandStatus | il risultato CommandStatus dell'operazione. |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metodo di supporto per eseguire un comando di sistema, interromperlo se impiega più tempo di un tempo specificato e reindirizzare l'output ai file se specificato. Quando ERROR(/OutputStream)
vengono forniti in questo modo, verranno lasciati aperti alla fine della funzione.
Parametri | |
---|---|
timeout | long : timeout tempo massimo di attesa in ms. 0 significa nessun timeout. |
stdout | OutputStream : ERROR(/OutputStream) in cui verrà reindirizzato l'output std. Può essere nullo. |
stderr | OutputStream : ERROR(/OutputStream) dove verrà reindirizzato l'output dell'errore. Può essere nullo. |
command | String : il comando di sistema specificato e facoltativamente gli argomenti da exec |
ritorna | |
---|---|
CommandResult | un CommandResult contenente il risultato dell'esecuzione del comando |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
Metodo di supporto per eseguire un comando di sistema e interromperlo se impiega più tempo di un tempo specificato.
Parametri | |
---|---|
timeout | long : tempo massimo di attesa in ms. 0 significa nessun timeout. |
command | String : il comando di sistema specificato e facoltativamente gli argomenti da exec |
ritorna | |
---|---|
CommandResult | un CommandResult contenente il risultato dell'esecuzione del comando |
runTimedCmdRetry
public abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Metodo di supporto per eseguire un comando di sistema e interromperlo se impiega più tempo di un tempo specificato.
Parametri | |
---|---|
timeout | long : tempo massimo di attesa in ms per ogni tentativo |
retryInterval | long : tempo di attesa tra i tentativi di comando |
attempts | int : il numero massimo di tentativi da provare |
command | String : il comando di sistema specificato e facoltativamente gli argomenti da exec |
ritorna | |
---|---|
CommandResult | un CommandResult contenente il risultato dell'esecuzione del comando |
runTimedCmdSilently
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
Metodo di supporto per eseguire un comando di sistema e interromperlo se impiega più tempo di un tempo specificato. Simile a runTimedCmd(long, String)
, ma non registra alcun errore nell'eccezione.
Parametri | |
---|---|
timeout | long : tempo massimo di attesa in ms |
command | String : il comando di sistema specificato e facoltativamente gli argomenti da exec |
ritorna | |
---|---|
CommandResult | un CommandResult contenente il risultato dell'esecuzione del comando |
runTimedCmdSilentlyRetry
public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Metodo di supporto per eseguire un comando di sistema e interromperlo se impiega più tempo di un tempo specificato. Simile a runTimedCmdRetry(long, long, int, String[])
, ma non registra alcun errore nell'eccezione.
Parametri | |
---|---|
timeout | long : tempo massimo di attesa in ms |
retryInterval | long : tempo di attesa tra i tentativi di comando |
attempts | int : il numero massimo di tentativi da provare |
command | String : il comando di sistema specificato e facoltativamente gli argomenti da exec |
ritorna | |
---|---|
CommandResult | un CommandResult contenente il risultato dell'esecuzione del comando |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Metodo di supporto per eseguire un comando di sistema, interromperlo se impiega più tempo di un tempo specificato e reindirizzare l'output ai file se specificato.
Parametri | |
---|---|
timeout | long : timeout tempo massimo di attesa in ms. 0 significa nessun timeout. |
input | String : l'input stdin da passare al processo |
stdoutFile | File : ERROR(/File) in cui verrà reindirizzato l'output std. Può essere nullo. |
stderrFile | File : ERROR(/File) dove verrà reindirizzato l'output dell'errore. Può essere nullo. |
command | String : il comando di sistema specificato e facoltativamente gli argomenti da exec |
ritorna | |
---|---|
CommandResult | un CommandResult contenente il risultato dell'esecuzione del comando |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Metodo di supporto per eseguire un comando di sistema che richiede input stdin e che viene interrotto se impiega più tempo di un tempo specificato.
Parametri | |
---|---|
timeout | long : tempo massimo di attesa in ms |
input | String : l'input stdin da passare al processo |
command | String : il comando di sistema specificato e facoltativamente gli argomenti da exec |
ritorna | |
---|---|
CommandResult | un CommandResult contenente il risultato dell'esecuzione del comando |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input,command)
Metodo di supporto per eseguire un comando di sistema che richiede input stdin e che viene interrotto se impiega più tempo di un tempo specificato.
Parametri | |
---|---|
timeout | long : tempo massimo di attesa in ms |
input | String : l'input stdin da passare al processo |
command | ERROR(/List) contenente il comando di sistema e facoltativamente argomenti da exec |
ritorna | |
---|---|
CommandResult | un CommandResult contenente il risultato dell'esecuzione del comando |
runTimedCmdWithInputRedirect
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Metodo di supporto per eseguire un comando di sistema che richiede il reindirizzamento di Stdin da un file e l'interruzione se impiega più tempo di un tempo specificato.
Parametri | |
---|---|
timeout | long : tempo massimo di attesa in ms |
inputRedirect | File : l' ERROR(/File) da reindirizzare come input standard utilizzando ProcessBuilder.redirectInput() . Se null, stdin non verrà reindirizzato. |
command | String : il comando di sistema specificato e facoltativamente gli argomenti da exec |
ritorna | |
---|---|
CommandResult | un CommandResult contenente il risultato dell'esecuzione del comando |
runTimedRetry
public abstract boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blocca ed esegue un'operazione più volte finché non ha esito positivo.
Parametri | |
---|---|
opTimeout | long : tempo massimo di attesa in ms per un tentativo di operazione |
pollInterval | long : tempo di attesa tra i tentativi di comando |
attempts | int : il numero massimo di tentativi da provare |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult da eseguire |
ritorna | |
---|---|
boolean | true se l'operazione è stata completata correttamente prima del raggiungimento dei tentativi. |
setEnvVariable
public abstract void setEnvVariable (String key, String value)
Imposta 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 |
Guarda anche:
setEnvVariablePriority
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Decidere se durante la creazione di un processo, la disattivazione delle variabili di ambiente ha o meno una priorità maggiore rispetto alla loro impostazione. Per impostazione predefinita, il disinserimento ha una priorità più alta: ciò significa che se viene effettuato un tentativo di impostare una variabile con lo stesso nome, ciò non avverrà poiché la variabile verrà disimpostata. Non può essere utilizzato sull'istanza IRunUtil
predefinita.
Parametri | |
---|---|
priority | IRunUtil.EnvPriority |
setInterruptibleInFuture
public abstract void setInterruptibleInFuture (Thread thread, long timeMs)
Impostato come interrompibile dopo un certo tempo di attesa. ERROR(/CommandScheduler#shutdownHard())
per imporre la terminazione alla fine.
Parametri | |
---|---|
thread | Thread : il thread che diventerà interrompibile. |
timeMs | long : tempo di attesa prima dell'impostazione interrompibile. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Consenti di utilizzare l'interruzione "kill" di Linux sul processo in esecuzione tramite i metodi #runTimed quando raggiunge un timeout. Non può essere utilizzato sull'istanza IRunUtil
predefinita.
Parametri | |
---|---|
interrupt | boolean |
setRedirectStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
Imposta il flusso di errore standard per reindirizzare al flusso di output standard durante l'esecuzione dei comandi di sistema. Il valore iniziale è falso.
Parametri | |
---|---|
redirect | boolean : nuovo valore per stabilire se reindirizzare o meno |
Guarda anche:
setWorkingDir
public abstract void setWorkingDir (File dir)
Imposta la directory di lavoro per i comandi di sistema.
Parametri | |
---|---|
dir | File : la directory di lavoro |
Guarda anche:
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 inferiori o uguali a 0 verranno ignorati |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
Annulla l'impostazione di una variabile di ambiente, quindi i comandi di sistema vengono eseguiti senza questa variabile di ambiente.
Parametri | |
---|---|
key | String : il nome della variabile |
Guarda anche:
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2023-12-01 UTC.