IRunUtil

public interface IRunUtil

com.android.tradefed.util.IRunUtil

Bekannte indirekte Unterklassen RunUtil RunUtil Eine Sammlung von Hilfsmethoden zum Ausführen von Vorgängen.

---

Schnittstelle zum Ausführen zeitgesteuerter Vorgänge und Systembefehle.

Zusammenfassung

Verschachtelte Klassen
interface	IRunUtil.IRunnableResult Eine Schnittstelle zum asynchronen Ausführen eines Vorgangs, der einen booleschen Status zurückgibt.

Öffentliche Methoden
abstract void	allowInterrupt(boolean allow) Ermöglicht/verhindert Unterbrechungen der Ausführung im aktuellen Thread.
abstract void	interrupt(Thread thread, String message, ErrorIdentifier errorId) Unterbricht die laufenden/bevorstehenden Ausführungsvorgänge im angegebenen Thread.
abstract void	interrupt(Thread thread, String message) Unterbricht die laufenden/bevorstehenden Ausführungsvorgänge im angegebenen Thread.
abstract boolean	isInterruptAllowed() Gibt den Unterbrechungsstatus von RunUtil an.
abstract Process	runCmdInBackground(ProcessBuilder.Redirect redirect, List<String> command) Eine alternative runCmdInBackground(String...)-Methode, die die Befehlsargumente im Format List akzeptiert.
abstract Process	runCmdInBackground(ProcessBuilder.Redirect redirect, String... command) Hilfsmethode zum asynchronen Ausführen eines Systembefehls.
abstract Process	runCmdInBackground(List<String> command) Eine alternative runCmdInBackground(String...)-Methode, die die Befehlsargumente im Format List akzeptiert.
abstract Process	runCmdInBackground(String... command) Hilfsmethode zum asynchronen Ausführen eines Systembefehls.
abstract Process	runCmdInBackground(List<String> command, OutputStream output) Wenn Sie einen Befehl mit einem OutputStream ausführen, wird die Ausgabe des Befehls protokolliert.
abstract boolean	runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blockiert und führt einen Vorgang mehrmals aus, bis er erfolgreich ist.
abstract boolean	runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blockiert und führt einen Vorgang mehrmals aus, bis er erfolgreich ist.
abstract boolean	runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blockiert und führt 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. Der Vorgang wird abgebrochen, wenn er länger als eine angegebene Zeit dauert.
abstract CommandResult	runTimedCmd(long timeout, String... command) Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte 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	runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command) Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert.
abstract CommandResult	runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command) Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert.
abstract CommandResult	runTimedCmdSilently(long timeout, String... command) Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert.
abstract CommandResult	runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command) Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert.
abstract CommandResult	runTimedCmdWithInput(long timeout, String input, String... command) Hilfsmethode zum Ausführen eines Systembefehls, der eine stdin-Eingabe erfordert, und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert.
abstract CommandResult	runTimedCmdWithInput(long timeout, String input, List<String> command) Hilfsmethode zum Ausführen eines Systembefehls, der eine stdin-Eingabe erfordert, 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	runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command) Hilfsmethode zum Ausführen eines Systembefehls, für den Stdin aus einer Datei umgeleitet werden muss, und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert.
abstract CommandResult	runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command) Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert.
abstract CommandResult	runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, 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 boolean	runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Blockiert und führt einen Vorgang mehrmals aus, bis er erfolgreich ist.
abstract boolean	runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Blockiert und führt einen Vorgang mehrmals aus, bis er erfolgreich ist.
abstract CommandStatus	runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Blockiert und führt einen Vorgang aus. Der Vorgang wird abgebrochen, wenn er länger als eine angegebene Zeit dauert.
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 Aufheben der Festlegung von Umgebungsvariablen eine höhere Priorität hat als das Festlegen von Umgebungsvariablen.
abstract void	setInterruptibleInFuture(Thread thread, long timeMs) Nach einer gewissen Wartezeit als unterbrechbar festlegen.
abstract void	setLinuxInterruptProcess(boolean interrupt) Ermögliche die Verwendung der Linux-Unterbrechung „kill“ für Prozesse, die über #runTimed-Methoden ausgeführt werden, wenn ein Zeitlimit erreicht wird.
abstract void	setRedirectStderrToStdout(boolean redirect) Legt den Standardfehlerstream so fest, dass er beim Ausführen von Systembefehlen in den Standardausgabestream umgeleitet wird.
abstract void	setWorkingDir(File dir) Legt das Arbeitsverzeichnis für Systembefehle fest.
abstract void	sleep(long time) Hilfsmethode zum Schlafen für einen bestimmten Zeitraum, wobei alle Ausnahmen ignoriert werden.
abstract void	unsetEnvVariable(String key) Hebt die Festlegung einer Umgebungsvariable auf, sodass die Systembefehle ohne diese Umgebungsvariable ausgeführt werden.

Öffentliche Methoden

allowInterrupt

public abstract void allowInterrupt (boolean allow)

Ermöglicht/verhindert Unterbrechungen der Ausführung im aktuellen Thread. Wenn dies zulässig ist, können Vorgänge des aktuellen Threads über die Methode interrupt(Thread, String) von anderen Threads unterbrochen werden.

Parameter
allow	boolean: Gibt an, ob Unterbrechungen des Laufs im aktuellen Thread zulässig sind.

unterbrechen

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

Unterbricht die laufenden/bevorstehenden Ausführungsvorgänge im angegebenen Thread. Die Ausführung von Vorgängen für den angegebenen Thread löst RunInterruptedException aus.

Parameter
message	String: Die Nachricht für RunInterruptedException.
errorId	ErrorIdentifier: Stellt die Ursache der Unterbrechung dar, sofern bekannt.

unterbrechen

public abstract void interrupt (Thread thread, 
                String message)

Unterbricht die laufenden/bevorstehenden Ausführungsvorgänge im angegebenen Thread. Die Ausführung von Vorgängen für den angegebenen Thread löst RunInterruptedException aus.

Parameter
message	String: Die Nachricht für RunInterruptedException.

isInterruptAllowed

public abstract boolean isInterruptAllowed ()

Gibt den Unterbrechungsstatus von RunUtil an.

Gibt Folgendes zurück:
boolean	„true“, wenn der Lauf unterbrochen werden kann, andernfalls „false“.

runCmdInBackground

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

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

Parameter
redirect	ProcessBuilder.Redirect: Die Redirect, die auf die ProcessBuilder angewendet werden soll.
command	List: das List mit dem angegebenen Systembefehl und optionalen Argumenten, die ausgeführt werden sollen

Gibt Folgendes zurück:
Process	die Process des ausgeführten Befehls

Löst aus
IOException	wenn der Befehl nicht ausgeführt werden konnte

runCmdInBackground

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

Hilfsmethode zum asynchronen Ausführen eines Systembefehls.

Wird sofort nach dem Start des Befehls zurückgegeben.

Parameter
redirect	ProcessBuilder.Redirect: Die Redirect, die auf die ProcessBuilder angewendet werden soll.
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
Process	die Process des ausgeführten Befehls

Löst aus
IOException	wenn der Befehl nicht ausgeführt werden konnte

runCmdInBackground

public abstract Process runCmdInBackground (List<String> command)

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

Parameter
command	List: das List mit dem angegebenen Systembefehl und optionalen Argumenten, die ausgeführt werden sollen

Gibt Folgendes zurück:
Process	die Process des ausgeführten Befehls

Löst aus
IOException	wenn der Befehl nicht ausgeführt werden konnte

runCmdInBackground

public abstract Process runCmdInBackground (String... command)

Hilfsmethode zum asynchronen Ausführen eines Systembefehls.

Wird sofort nach dem Start des Befehls zurückgegeben.

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

Gibt Folgendes zurück:
Process	die Process des ausgeführten Befehls

Löst aus
IOException	wenn der Befehl nicht ausgeführt werden konnte

runCmdInBackground

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

Wenn Sie einen Befehl mit einem OutputStream ausführen, wird die Ausgabe des Befehls protokolliert. Stdout und stderr werden zusammengeführt.

Parameter
command	List: der auszuführende Befehl
output	OutputStream: Der OutputStream zum Speichern der Ausgabe

Gibt Folgendes zurück:
Process	Process, auf dem der Befehl ausgeführt wird

Löst aus
	java.io.IOException
IOException

runEscalatingTimedRetry

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

Blockiert und führt einen Vorgang mehrmals aus, bis er erfolgreich ist.

Erhöhen Sie die Wartezeit zwischen den Versuchen exponentiell. Diese Funktion soll verwendet werden, wenn ein Vorgang wie das Abrufen von Daten von einem Server ausgeführt wird, damit der Server Zeit hat, sich zu erholen, falls er vorübergehend nicht verfügbar ist.

Parameter
opTimeout	long: Maximale Wartezeit in Millisekunden für einen einzelnen Vorgangsversuch
initialPollInterval	long: Die anfängliche Wartezeit zwischen den Versuchen, den Vorgang auszuführen.
maxPollInterval	long: Die maximale Wartezeit zwischen Versuchen, einen Vorgang auszuführen.
maxTime	long: Die ungefähre maximale Gesamtzeit, in der der Vorgang wiederholt werden soll.
runnable	IRunUtil.IRunnableResult: IRunUtil.IRunnableResult zum Ausführen

Gibt Folgendes 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)

Blockiert und führt einen Vorgang mehrmals aus, bis er erfolgreich ist.

Parameter
opTimeout	long: Maximale Wartezeit in Millisekunden für einen einzelnen Vorgangsversuch
pollInterval	long: Die anfängliche Wartezeit zwischen den Versuchen, den Vorgang auszuführen.
maxTime	long: Die ungefähre maximale Gesamtzeit, in der der Vorgang wiederholt werden soll.
runnable	IRunUtil.IRunnableResult: IRunUtil.IRunnableResult zum Ausführen

Gibt Folgendes zurück:
boolean	true, wenn der Vorgang vor Ablauf von „maxTime“ erfolgreich abgeschlossen wurde

runFixedTimedRetryWithOutputMonitor

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

Blockiert und führt einen Vorgang mehrmals aus, bis er erfolgreich ist. Außerdem werden die Ausgabestreams auf Aktivität überwacht und abgebrochen, wenn für einen bestimmten Zeitraum keine Streamaktivität beobachtet wird. Wenn „idleOutputTimeout“ auf null gesetzt ist, findet kein Stream-Monitoring statt.

Parameter
opTimeout	long: Maximale Wartezeit in Millisekunden für einen einzelnen Vorgangsversuch
idleOutputTimeout	long: Maximale Wartezeit in Millisekunden für die Ausgabe in den Ausgabestreams
pollInterval	long: Die anfängliche Wartezeit zwischen den Versuchen, den Vorgang auszuführen.
maxTime	long: Die ungefähre maximale Gesamtzeit, in der der Vorgang wiederholt werden soll.
runnable	IRunUtil.IRunnableResult: IRunUtil.IRunnableResult zum Ausführen

Gibt Folgendes 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. Der Vorgang wird abgebrochen, wenn er länger als eine angegebene Zeit dauert.

Parameter
timeout	long: Maximale Wartezeit in Millisekunden
runnable	IRunUtil.IRunnableResult: IRunUtil.IRunnableResult zum Ausführen
logErrors	boolean: Gibt an, ob Fehler bei Ausnahmen protokolliert werden sollen.

Gibt Folgendes zurück:
CommandStatus	das CommandStatus-Ergebnis des Vorgangs.

runTimedCmd

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

Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert.

Parameter
timeout	long: Maximale Wartezeit in Millisekunden. 0 bedeutet kein Zeitlimit.
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

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 OutputStream auf diese Weise bereitgestellt werden, bleiben sie am Ende der Funktion geöffnet.

Parameter
timeout	long: Maximales Zeitlimit für das Warten in Millisekunden. 0 bedeutet kein Zeitlimit.
stdout	OutputStream: OutputStream, in die die Standardausgabe umgeleitet wird. Kann null sein.
stderr	OutputStream: OutputStream, wohin die Fehlerausgabe umgeleitet wird. Kann null sein.
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

runTimedCmdRetry

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

Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert.

Parameter
timeout	long: Maximale Wartezeit in Millisekunden für jeden Versuch
retryInterval	long: Wartezeit zwischen Befehlsversuchen
attempts	int: Die maximale Anzahl der Versuche.
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

runTimedCmdRetryWithOutputMonitor

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

Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert. Außerdem werden die Ausgabestreams auf Aktivität überwacht und der Vorgang wird abgebrochen, wenn für einen bestimmten Zeitraum keine Streamaktivität beobachtet wird. Wenn „idleOutputTimeout“ auf null gesetzt ist, findet keine Streamüberwachung statt.

Parameter
timeout	long: Maximale Wartezeit in Millisekunden für jeden Versuch
idleOutputTimeout	long: Maximale Wartezeit in Millisekunden für die Ausgabe in den Ausgabestreams
retryInterval	long: Wartezeit zwischen Befehlsversuchen
attempts	int: Die maximale Anzahl der Versuche.
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

runTimedCmdSilently

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

Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert. Ähnlich wie runTimedCmd(long,String...), aber es werden keine Fehler bei Ausnahmen protokolliert.

Parameter
timeout	long: Maximale Wartezeit in Millisekunden
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

runTimedCmdSilentlyRetry

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

Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert. Ähnlich wie runTimedCmdRetry(long,long,int,String[]), aber es werden keine Fehler bei Ausnahmen protokolliert.

Parameter
timeout	long: Maximale Wartezeit in Millisekunden
retryInterval	long: Wartezeit zwischen Befehlsversuchen
attempts	int: Die maximale Anzahl der Versuche.
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

runTimedCmdWithInput

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

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

Parameter
timeout	long: Maximale Wartezeit in Millisekunden
input	String: die stdin-Eingabe, die an den Prozess übergeben werden soll
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

runTimedCmdWithInput

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

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

Parameter
timeout	long: Maximale Wartezeit in Millisekunden
input	String: die stdin-Eingabe, die an den Prozess übergeben werden soll
command	List: List mit dem Systembefehl und optionalen Argumenten für die Ausführung

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

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: Maximales Zeitlimit für das Warten in Millisekunden. 0 bedeutet kein Zeitlimit.
input	String: die stdin-Eingabe, die an den Prozess übergeben werden soll
stdoutFile	File: File, in die die Standardausgabe umgeleitet wird. Kann null sein.
stderrFile	File: File, wohin die Fehlerausgabe umgeleitet wird. Kann null sein.
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

runTimedCmdWithInputRedirect

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

Hilfsmethode zum Ausführen eines Systembefehls, für den Stdin aus einer Datei umgeleitet werden muss, und zum Abbrechen, wenn er länger als eine angegebene Zeit dauert.

Parameter
timeout	long: Maximale Wartezeit in Millisekunden
inputRedirect	File: Die File, die mit ProcessBuilder.redirectInput() als Standardeingabe weitergeleitet werden soll. Wenn null, wird stdin nicht umgeleitet.
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

runTimedCmdWithOutputMonitor

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

Hilfsmethode zum Ausführen eines Systembefehls, die abgebrochen wird, wenn sie länger als eine bestimmte Zeit dauert. Außerdem werden die Ausgabestreams auf Aktivität überwacht und der Vorgang wird abgebrochen, wenn für einen bestimmten Zeitraum keine Streamaktivität beobachtet wird. Wenn „idleOutputTimeout“ auf null gesetzt ist, findet keine Streamüberwachung statt.

Parameter
timeout	long: Maximale Wartezeit in Millisekunden. 0 bedeutet kein Zeitlimit.
idleOutputTimeout	long: Maximale Wartezeit in Millisekunden für die Ausgabe in den Ausgabestreams
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

runTimedCmdWithOutputMonitor

public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                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 OutputStream auf diese Weise bereitgestellt werden, bleiben sie am Ende der Funktion geöffnet.

Parameter
timeout	long: Maximales Zeitlimit für das Warten in Millisekunden. 0 bedeutet kein Zeitlimit.
idleOutputTimeout	long: Maximale Wartezeit in Millisekunden für die Ausgabe in den Ausgabestreams
stdout	OutputStream: OutputStream, in die die Standardausgabe umgeleitet wird. Kann null sein.
stderr	OutputStream: OutputStream, wohin die Fehlerausgabe umgeleitet wird. Kann null sein.
command	String: der angegebene Systembefehl und optional Argumente für „exec“

Gibt Folgendes zurück:
CommandResult	eine CommandResult mit dem Ergebnis des Befehlsausführung

runTimedRetry

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

Blockiert und führt einen Vorgang mehrmals aus, bis er erfolgreich ist.

Parameter
opTimeout	long: Maximale Wartezeit in Millisekunden für einen Vorgangsversuch
pollInterval	long: Wartezeit zwischen Befehlsversuchen
attempts	int: Die maximale Anzahl der Versuche.
runnable	IRunUtil.IRunnableResult: IRunUtil.IRunnableResult zum Ausführen

Gibt Folgendes zurück:
boolean	true, wenn der Vorgang erfolgreich abgeschlossen wurde, bevor die Versuche erreicht wurden.

runTimedRetryWithOutputMonitor

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

Blockiert und führt einen Vorgang mehrmals aus, bis er erfolgreich ist. Außerdem werden die Ausgabestreams auf Aktivität überwacht und abgebrochen, wenn für einen bestimmten Zeitraum keine Streamaktivität beobachtet wird. Wenn „idleOutputTimeout“ auf null gesetzt ist, findet kein Stream-Monitoring statt.

Parameter
opTimeout	long: Maximale Wartezeit in Millisekunden für einen Vorgangsversuch
idleOutputTimeout	long: Maximale Wartezeit in Millisekunden für die Ausgabe in den Ausgabestreams
pollInterval	long: Wartezeit zwischen Befehlsversuchen
attempts	int: Die maximale Anzahl der Versuche.
runnable	IRunUtil.IRunnableResult: IRunUtil.IRunnableResult zum Ausführen

Gibt Folgendes zurück:
boolean	true, wenn der Vorgang erfolgreich abgeschlossen wurde, bevor die Versuche erreicht wurden.

runTimedWithOutputMonitor

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

Blockiert und führt einen Vorgang aus. Der Vorgang wird abgebrochen, wenn er länger als eine angegebene Zeit dauert. Außerdem werden die Ausgabestreams auf Aktivität überwacht und der Vorgang wird abgebrochen, wenn für einen bestimmten Zeitraum keine Streamaktivität beobachtet wird. Wenn „idleOutputTimeout“ auf null gesetzt ist, findet kein Stream-Monitoring statt.

Parameter
timeout	long: Maximale Wartezeit in Millisekunden
idleOutputTimeout	long: Maximale Wartezeit in Millisekunden für die Ausgabe in den Ausgabestreams
runnable	IRunUtil.IRunnableResult: IRunUtil.IRunnableResult zum Ausführen
logErrors	boolean: Gibt an, ob Fehler bei Ausnahmen protokolliert werden sollen.

Gibt Folgendes zurück:
CommandStatus	das CommandStatus-Ergebnis des Vorgangs.

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

Weitere Informationen

• ProcessBuilder.environment()

setEnvVariablePriority

public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)

Entscheiden Sie, ob beim Erstellen eines Prozesses das Aufheben der Festlegung von Umgebungsvariablen eine höhere Priorität hat als das Festlegen von Umgebungsvariablen. Standardmäßig hat das Aufheben der Einstellung eine höhere Priorität. Wenn also versucht wird, eine Variable mit demselben Namen festzulegen, geschieht dies nicht, da die Einstellung der Variablen aufgehoben wird. Kann nicht für die Standardinstanz IRunUtil verwendet werden.

Parameter
priority	IRunUtil.EnvPriority

setInterruptibleInFuture

public abstract void setInterruptibleInFuture (Thread thread, 
                long timeMs)

Nach einer gewissen Wartezeit als unterbrechbar festlegen. ERROR(/CommandScheduler#shutdownHard()), um sicherzustellen, dass wir die Ausführung schließlich beenden.

Parameter
thread	Thread: Der Thread, der unterbrechbar wird.
timeMs	long: Zeit, die gewartet werden soll, bevor der Vorgang unterbrechbar gemacht wird.

setLinuxInterruptProcess

public abstract void setLinuxInterruptProcess (boolean interrupt)

Ermögliche die Verwendung der Linux-Unterbrechung „kill“ für Prozesse, die über #runTimed-Methoden ausgeführt werden, wenn ein Zeitlimit erreicht wird. Kann nicht für die Standardinstanz IRunUtil verwendet werden.

Parameter
interrupt	boolean

setRedirectStderrToStdout

public abstract void setRedirectStderrToStdout (boolean redirect)

Legt den Standardfehlerstream so fest, dass er beim Ausführen von Systembefehlen in den Standardausgabestream umgeleitet wird. Der Anfangswert ist „false“.

Parameter
redirect	boolean: Neuer Wert für die Weiterleitung

Weitere Informationen

• ProcessBuilder.redirectErrorStream(boolean)

setWorkingDir

public abstract void setWorkingDir (File dir)

Legt das Arbeitsverzeichnis für Systembefehle fest.

Parameter
dir	File: das Arbeitsverzeichnis

Weitere Informationen

• ProcessBuilder.directory(File)

Schlafen

public abstract void sleep (long time)

Hilfsmethode zum Schlafen für einen bestimmten Zeitraum, wobei alle Ausnahmen ignoriert werden.

Parameter
time	long: Millisekunden für den Ruhezustand. Werte kleiner oder gleich 0 werden ignoriert.

unsetEnvVariable

public abstract void unsetEnvVariable (String key)

Hebt die Festlegung einer Umgebungsvariable auf, sodass die Systembefehle ohne diese Umgebungsvariable ausgeführt werden.

Parameter
key	String: der Variablenname

Weitere Informationen

• ProcessBuilder.environment()