IRunUtil

public interface IRunUtil

com.android.tradefed.util.IRunUtil

Schnittstelle zum Ausführen zeitgesteuerter Operationen und Systembefehle.

Zusammenfassung

Verschachtelte Klassen

interface IRunUtil.IRunnableResult

Eine Schnittstelle zum asynchronen Ausführen einer Operation, die einen booleschen Status zurückgibt.

Öffentliche Methoden

abstract void allowInterrupt (boolean allow)

Erlaubt/verbietet Ausführungsinterrupts für den aktuellen Thread.

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

Unterbricht die laufenden/anstehenden Ausführungsvorgänge für den angegebenen Thread.

abstract void interrupt (Thread thread, String message)

Unterbricht die laufenden/anstehenden Ausführungsvorgänge für den angegebenen Thread.

abstract boolean isInterruptAllowed ()

Geben Sie den Interrupt-Status von RunUtil an.

abstract Process runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command)

Eine alternative runCmdInBackground(String) -Methode, die die Befehlsargumente im ERROR(/List) -Format akzeptiert.

abstract Process runCmdInBackground ( command) runCmdInBackground ( command)

Eine alternative runCmdInBackground(String) -Methode, die die Befehlsargumente im ERROR(/List) -Format akzeptiert.

abstract Process runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output)

Das Ausführen eines Befehls mit einem ERROR(/OutputStream) protokolliert die Ausgabe des Befehls.

abstract Process runCmdInBackground (String... command)

Hilfsmethode zum asynchronen Ausführen eines Systembefehls.

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

Hilfsmethode zum asynchronen Ausführen eines Systembefehls.

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

Blockieren und führen Sie einen Vorgang mehrmals aus, bis er erfolgreich ist.

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

Blockieren und führen Sie einen Vorgang mehrmals aus, bis er erfolgreich ist.

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

Blockiert und führt einen Vorgang aus und bricht ihn ab, wenn er länger als eine angegebene Zeit dauert.

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

Hilfsmethode zum Ausführen eines Systembefehls, zum Abbrechen, wenn er länger als eine angegebene Zeit dauert, und zum Umleiten der Ausgabe in Dateien, falls angegeben.

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

Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert.

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

Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert.

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

Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert.

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

Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert.

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

Hilfsmethode zum Ausführen eines Systembefehls, zum Abbrechen, wenn er länger als eine angegebene Zeit dauert, und zum Umleiten der Ausgabe in Dateien, falls angegeben.

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

Hilfsmethode zum Ausführen eines Systembefehls, der eine Standardeingabe erfordert, und zum Abbrechen, wenn die Ausführung länger als eine angegebene Zeit dauert.

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

Hilfsmethode zum Ausführen eines Systembefehls, der eine Standardeingabe erfordert, und zum Abbrechen, wenn die Ausführung länger als eine angegebene Zeit dauert.

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

Hilfsmethode zum Ausführen eines Systembefehls, der die Umleitung von Stdin aus einer Datei und den Abbruch erfordert, wenn der Vorgang länger als eine angegebene Zeit dauert.

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

Blockieren und führen Sie einen Vorgang mehrmals aus, bis er erfolgreich ist.

abstract void setEnvVariable (String key, String value)

Legt eine Umgebungsvariable fest, die beim Ausführen von Systembefehlen verwendet werden soll.

abstract void setEnvVariablePriority ( IRunUtil.EnvPriority priority)

Entscheiden Sie, ob beim Erstellen eines Prozesses das Deaktivieren von Umgebungsvariablen eine höhere Priorität hat als das Festlegen.

abstract void setInterruptibleInFuture (Thread thread, long timeMs)

Nach einiger Wartezeit als unterbrechbar festlegen.

abstract void setLinuxInterruptProcess (boolean interrupt)

Ermöglicht die Verwendung einer Linux-Kill-Unterbrechung für Prozesse, die über #runTimed-Methoden ausgeführt werden, wenn eine Zeitüberschreitung erreicht wird.

abstract void setRedirectStderrToStdout (boolean redirect)

Legen Sie den Standardfehlerstrom so fest, dass beim Ausführen von Systembefehlen zum Standardausgabestrom umgeleitet wird.

abstract void setWorkingDir (File dir)

Legt das Arbeitsverzeichnis für Systembefehle fest.

abstract void sleep (long time)

Hilfsmethode zum Ruhen für eine bestimmte Zeit, wobei alle Ausnahmen ignoriert werden.

abstract void unsetEnvVariable (String key)

Setzt eine Umgebungsvariable zurück, sodass die Systembefehle ohne diese Umgebungsvariable ausgeführt werden.

Öffentliche Methoden

erlaubenInterrupt

public abstract void allowInterrupt (boolean allow)

Erlaubt/verbietet Ausführungsinterrupts für den aktuellen Thread. Wenn es erlaubt ist, können Ausführungsvorgänge des aktuellen Threads von anderen Threads über die Methode interrupt(Thread, String) unterbrochen werden.

Parameter
allow boolean : Gibt an, ob Ausführungsinterrupts für den aktuellen Thread zugelassen werden sollen.

unterbrechen

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

Unterbricht die laufenden/anstehenden Ausführungsvorgänge für den angegebenen Thread. Die Ausführungsvorgänge für den angegebenen Thread lösen RunInterruptedException aus.

Parameter
message String : die Nachricht für RunInterruptedException .

errorId ErrorIdentifier : Stellt die Ursache der Unterbrechung dar, sofern diese bekannt ist.

unterbrechen

public abstract void interrupt (Thread thread, 
                String message)

Unterbricht die laufenden/anstehenden Ausführungsvorgänge für den angegebenen Thread. Die Ausführungsvorgänge für den angegebenen Thread lösen RunInterruptedException aus.

Parameter
message String : die Nachricht für RunInterruptedException .

isInterruptAllowed

public abstract boolean isInterruptAllowed ()

Geben Sie den Interrupt-Status von RunUtil an.

Kehrt zurück
boolean true, wenn der Lauf unterbrochen werden kann, andernfalls false.

runCmdInBackground

public abstract Process runCmdInBackground (Redirect redirect, 
                 command)

Eine alternative runCmdInBackground(String) -Methode, die die Befehlsargumente im ERROR(/List) -Format akzeptiert.

Parameter
redirect Redirect : Der ERROR(/Redirect) , der auf den ProcessBuilder angewendet werden soll.

command : die ERROR(/List) , die den angegebenen Systembefehl und optional Argumente für exec enthält

Kehrt zurück
Process der Process des ausgeführten Befehls

Würfe
wenn der Befehl nicht ausgeführt werden konnte

runCmdInBackground

public abstract Process runCmdInBackground ( command)

Eine alternative runCmdInBackground(String) -Methode, die die Befehlsargumente im ERROR(/List) -Format akzeptiert.

Parameter
command : die ERROR(/List) , die den angegebenen Systembefehl und optional Argumente für exec enthält

Kehrt zurück
Process der Process des ausgeführten Befehls

Würfe
wenn der Befehl nicht ausgeführt werden konnte

runCmdInBackground

public abstract Process runCmdInBackground ( command, 
                OutputStream output)

Das Ausführen eines Befehls mit einem ERROR(/OutputStream) protokolliert die Ausgabe des Befehls. Stdout und stderr werden zusammengeführt.

Parameter
command : der auszuführende Befehl

output OutputStream : der OutputStream zum Speichern der Ausgabe

Kehrt zurück
Process Der Process der den Befehl ausführt

Würfe
IOException

runCmdInBackground

public abstract Process runCmdInBackground (String... command)

Hilfsmethode zum asynchronen Ausführen eines Systembefehls.

Kehrt sofort nach dem Starten des Befehls zurück.

Parameter
command String : der angegebene Systembefehl und optional Argumente für exec

Kehrt zurück
Process der Process des ausgeführten Befehls

Würfe
wenn der Befehl nicht ausgeführt werden konnte

runCmdInBackground

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

Hilfsmethode zum asynchronen Ausführen eines Systembefehls.

Kehrt sofort nach dem Starten des Befehls zurück.

Parameter
redirect Redirect : Der ERROR(/Redirect) , der auf den ProcessBuilder angewendet werden soll.

command String : der angegebene Systembefehl und optional Argumente für exec

Kehrt zurück
Process der Process des ausgeführten Befehls

Würfe
wenn der Befehl nicht ausgeführt werden konnte

runEscalatingTimedRetry

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

Blockieren und führen Sie einen Vorgang mehrmals aus, bis er erfolgreich ist.

Erhöhen Sie die Wartezeit zwischen Operationsversuchen exponentiell. Dies soll bei der Durchführung einer Operation wie der Abfrage eines Servers verwendet werden, um ihm Zeit zur Wiederherstellung zu geben, falls er vorübergehend ausfällt.

Parameter
opTimeout long : maximale Wartezeit in ms für einen einzelnen Operationsversuch

initialPollInterval long : anfängliche Wartezeit zwischen Operationsversuchen

maxPollInterval long : Die maximale Wartezeit zwischen Operationsversuchen

maxTime long : Die ungefähre Gesamtzeit, die maximal für die weitere Ausführung des Vorgangs benötigt wird

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult zum Ausführen

Kehrt zurück
boolean true , wenn der Vorgang vor Ablauf von maxTime erfolgreich abgeschlossen wurde

runFixedTimedRetry

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

Blockieren und führen Sie einen Vorgang mehrmals aus, bis er erfolgreich ist.

Parameter
opTimeout long : maximale Wartezeit in ms für einen einzelnen Operationsversuch

pollInterval long : anfängliche Wartezeit zwischen Operationsversuchen

maxTime long : Die ungefähre Gesamtzeit, die maximal für die weitere Ausführung des Vorgangs benötigt wird

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult zum Ausführen

Kehrt zurück
boolean true , wenn der Vorgang vor Ablauf von maxTime erfolgreich abgeschlossen wurde

runTimed

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

Blockiert und führt einen Vorgang aus und bricht ihn ab, wenn er länger als eine angegebene Zeit dauert.

Parameter
timeout long : maximale Wartezeit in ms

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult zum Ausführen

logErrors boolean : Fehler bei Ausnahme protokollieren oder nicht.

Kehrt zurück
CommandStatus das CommandStatus Ergebnis der Operation.

runTimedCmd

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

Hilfsmethode zum Ausführen eines Systembefehls, zum Abbrechen, wenn er länger als eine angegebene Zeit dauert, und zum Umleiten der Ausgabe in Dateien, falls angegeben. Wenn ERROR(/OutputStream) auf diese Weise bereitgestellt werden, bleiben sie am Ende der Funktion offen.

Parameter
timeout long : maximale Wartezeit in ms. 0 bedeutet kein Timeout.

stdout OutputStream : ERROR(/OutputStream) , wohin die Standardausgabe umgeleitet wird. Kann null sein.

stderr OutputStream : ERROR(/OutputStream) , wohin die Fehlerausgabe umgeleitet wird. Kann null sein.

command String : der angegebene Systembefehl und optional Argumente für exec

Kehrt zurück
CommandResult ein CommandResult , das das Ergebnis der Befehlsausführung enthält

runTimedCmd

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

Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert.

Parameter
timeout long : maximale Wartezeit in ms. 0 bedeutet kein Timeout.

command String : der angegebene Systembefehl und optional Argumente für exec

Kehrt zurück
CommandResult ein CommandResult , das das Ergebnis der Befehlsausführung enthält

runTimedCmdRetry

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

Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert.

Parameter
timeout long : maximale Wartezeit in ms für jeden Versuch

retryInterval long : Wartezeit zwischen Befehlswiederholungen

attempts int : die maximale Anzahl der Versuchsversuche

command String : der angegebene Systembefehl und optional Argumente für exec

Kehrt zurück
CommandResult ein CommandResult , das das Ergebnis der Befehlsausführung enthält

runTimedCmdSilently

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

Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert. Ähnlich wie runTimedCmd(long, String) , protokolliert jedoch keine Fehler bei Ausnahmen.

Parameter
timeout long : maximale Wartezeit in ms

command String : der angegebene Systembefehl und optional Argumente für exec

Kehrt zurück
CommandResult ein CommandResult , das das Ergebnis der Befehlsausführung enthält

runTimedCmdSilentlyRetry

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

Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert. Ähnlich wie runTimedCmdRetry(long, long, int, String[]) , protokolliert jedoch keine Fehler bei Ausnahmen.

Parameter
timeout long : maximale Wartezeit in ms

retryInterval long : Wartezeit zwischen Befehlswiederholungen

attempts int : die maximale Anzahl der Versuchsversuche

command String : der angegebene Systembefehl und optional Argumente für exec

Kehrt zurück
CommandResult ein CommandResult , das das Ergebnis der Befehlsausführung enthält

runTimedCmdWithInput

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

Hilfsmethode zum Ausführen eines Systembefehls, zum Abbrechen, wenn er länger als eine angegebene Zeit dauert, und zum Umleiten der Ausgabe in Dateien, falls angegeben.

Parameter
timeout long : maximale Wartezeit in ms. 0 bedeutet kein Timeout.

input String : die Standardeingabe, die an den Prozess übergeben werden soll

stdoutFile File : ERROR(/File) , wohin die Standardausgabe umgeleitet wird. Kann null sein.

stderrFile File : ERROR(/File) , wohin die Fehlerausgabe umgeleitet wird. Kann null sein.

command String : der angegebene Systembefehl und optional Argumente für exec

Kehrt zurück
CommandResult ein CommandResult , das das Ergebnis der Befehlsausführung enthält

runTimedCmdWithInput

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

Hilfsmethode zum Ausführen eines Systembefehls, der eine Standardeingabe erfordert, und zum Abbrechen, wenn die Ausführung länger als eine angegebene Zeit dauert.

Parameter
timeout long : maximale Wartezeit in ms

input String : die Standardeingabe, die an den Prozess übergeben werden soll

command String : der angegebene Systembefehl und optional Argumente für exec

Kehrt zurück
CommandResult ein CommandResult , das das Ergebnis der Befehlsausführung enthält

runTimedCmdWithInput

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

Hilfsmethode zum Ausführen eines Systembefehls, der eine Standardeingabe erfordert, und zum Abbrechen, wenn die Ausführung länger als eine angegebene Zeit dauert.

Parameter
timeout long : maximale Wartezeit in ms

input String : die Standardeingabe, die an den Prozess übergeben werden soll

command : ERROR(/List) enthält den Systembefehl und optional Argumente für exec

Kehrt zurück
CommandResult ein CommandResult , das das Ergebnis der Befehlsausführung enthält

runTimedCmdWithInputRedirect

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

Hilfsmethode zum Ausführen eines Systembefehls, der die Umleitung von Stdin aus einer Datei und den Abbruch erfordert, wenn der Vorgang länger als eine angegebene Zeit dauert.

Parameter
timeout long : maximale Wartezeit in ms

inputRedirect File : der ERROR(/File) , der mit ProcessBuilder.redirectInput() als Standardeingabe umgeleitet werden soll. Wenn null, wird stdin nicht umgeleitet.

command String : der angegebene Systembefehl und optional Argumente für exec

Kehrt zurück
CommandResult ein CommandResult , das das Ergebnis der Befehlsausführung enthält

runTimedRetry

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

Blockieren und führen Sie einen Vorgang mehrmals aus, bis er erfolgreich ist.

Parameter
opTimeout long : maximale Wartezeit in ms für einen Operationsversuch

pollInterval long : Wartezeit zwischen Befehlswiederholungen

attempts int : die maximale Anzahl der Versuchsversuche

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult zum Ausführen

Kehrt zurück
boolean true , wenn der Vorgang erfolgreich abgeschlossen wurde, bevor Versuche erreicht wurden.

setEnvVariable

public abstract void setEnvVariable (String key, 
                String value)

Legt eine Umgebungsvariable fest, die beim Ausführen von Systembefehlen verwendet werden soll.

Parameter
key String : der Variablenname

value String : der Variablenwert

setEnvVariablePriority

public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)

Entscheiden Sie, ob beim Erstellen eines Prozesses das Deaktivieren von Umgebungsvariablen eine höhere Priorität hat als das Festlegen. Standardmäßig hat das Aufheben der Einstellung eine höhere Priorität: Das heißt, wenn versucht wird, eine Variable mit demselben Namen zu setzen, wird dies nicht passieren, da die Variable nicht gesetzt wird. Kann nicht auf der Standard IRunUtil Instanz verwendet werden.

Parameter
priority IRunUtil.EnvPriority

setInterruptibleInFuture

public abstract void setInterruptibleInFuture (Thread thread, 
                long timeMs)

Nach einiger Wartezeit als unterbrechbar festlegen. ERROR(/CommandScheduler#shutdownHard()) um zu erzwingen, dass wir irgendwann beenden.

Parameter
thread Thread : Der Thread, der unterbrechbar wird.

timeMs long : Wartezeit, bevor unterbrechbar eingestellt wird.

setLinuxInterruptProcess

public abstract void setLinuxInterruptProcess (boolean interrupt)

Ermöglicht die Verwendung einer Linux-Kill-Unterbrechung für Prozesse, die über #runTimed-Methoden ausgeführt werden, wenn eine Zeitüberschreitung erreicht wird. Kann nicht auf der Standard IRunUtil Instanz verwendet werden.

Parameter
interrupt boolean

setRedirectStderrToStdout

public abstract void setRedirectStderrToStdout (boolean redirect)

Legen Sie den Standardfehlerstrom so fest, dass beim Ausführen von Systembefehlen zum Standardausgabestrom umgeleitet wird. Der Anfangswert ist falsch.

Parameter
redirect boolean : neuer Wert dafür, ob umgeleitet werden soll oder nicht

setWorkingDir

public abstract void setWorkingDir (File dir)

Legt das Arbeitsverzeichnis für Systembefehle fest.

Parameter
dir File : das Arbeitsverzeichnis

schlafen

public abstract void sleep (long time)

Hilfsmethode zum Ruhen für eine bestimmte Zeit, wobei alle Ausnahmen ignoriert werden.

Parameter
time long : ms zum Schlafen. Werte kleiner oder gleich 0 werden ignoriert

unsetEnvVariable

public abstract void unsetEnvVariable (String key)

Setzt eine Umgebungsvariable zurück, sodass die Systembefehle ohne diese Umgebungsvariable ausgeführt werden.

Parameter
key String : der Variablenname