iRunUtil
public
interface
IRunUtil
com.android.tradefed.util.IRunUtil |
Schnittstelle zum Ausführen von zeitgesteuerten Vorgängen und Systembefehlen.
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/nicht zulässige Ausführungsunterbrechungen für den aktuellen Thread. |
abstract
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
Unterbricht die laufenden/nächsten Ausführungsvorgänge für den angegebenen Thread. |
abstract
void
|
interrupt(Thread thread, String message)
Unterbricht die laufenden/nächsten Ausführungsvorgänge für den angegebenen Thread. |
abstract
boolean
|
isInterruptAllowed()
Geben Sie den Unterbrechungsstatus von RunUtil an. |
abstract
Process
|
runCmdInBackground(Redirect redirect,
Eine alternative |
abstract
Process
|
runCmdInBackground(
Eine alternative |
abstract
Process
|
runCmdInBackground(
Wird ein Befehl mit einem |
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)
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. Dieser Vorgang wird abgebrochen, 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 der Vorgang länger als eine angegebene Zeit dauert, und leitet die Ausgabe gegebenenfalls an Dateien weiter. |
abstract
CommandResult
|
runTimedCmd(long timeout, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene . |
abstract
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene . |
abstract
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene . |
abstract
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene . |
abstract
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene . |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
Hilfsmethode zum Ausführen eines Systembefehls, zum Abbrechen, wenn der Vorgang länger als eine angegebene Zeit dauert, und leitet die Ausgabe gegebenenfalls an Dateien weiter. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
Hilfsmethode zum Ausführen eines Systembefehls, der eine stdin-Eingabe erfordert, und zum Abbrechen, falls sie dauert länger als die angegebene Zeit. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
Hilfsmethode zum Ausführen eines Systembefehls, der eine stdin-Eingabe erfordert, und zum Abbrechen, falls sie dauert länger als die angegebene Zeit. |
abstract
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
Hilfsmethode zum Ausführen eines Systembefehls, bei dem Stdin von einer Datei umgeleitet werden muss, und wird abgebrochen, wenn es länger als eine angegebene Zeit dauert. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Hilfsmethode zum Ausführen eines Systembefehls, zum Abbrechen, wenn der Vorgang länger als eine angegebene Zeit dauert, und leitet die Ausgabe gegebenenfalls an Dateien weiter. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene . |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
Hilfsmethode zum Ausführen eines Systembefehls mit Caching. |
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. Dieser 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 Deaktivieren der Umgebungsvariable höher ist. Priorität hat, als sie festzulegen. |
abstract
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Nach einer gewissen Wartezeit als unterbrechbar festlegen. |
abstract
void
|
setLinuxInterruptProcess(boolean interrupt)
Verwendung von Linux „kill“ zulassen Unterbrechung bei Prozessen, die über #runTimed Methoden ausgeführt werden, eine Zeitüberschreitung erreicht. |
abstract
void
|
setRedirectStderrToStdout(boolean redirect)
Legen Sie fest, dass der Standardfehlerstream beim Ausführen des Systems zum Standardausgabestream weitergeleitet wird . |
abstract
void
|
setWorkingDir(File dir)
Legt das Arbeitsverzeichnis für Systembefehle fest. |
abstract
void
|
sleep(long time)
Hilfsmethode zum Einschlafen für eine bestimmte Zeit, wobei Ausnahmen ignoriert werden. |
abstract
void
|
unsetEnvVariable(String key)
Hebt die Festlegung einer Umgebungsvariable auf, sodass die Systembefehle ohne diese Umgebungsvariablen ausgeführt werden. |
Öffentliche Methoden
allowInterrupt
public abstract void allowInterrupt (boolean allow)
Ermöglicht/nicht zulässige Ausführungsunterbrechungen für den aktuellen Thread. Führen Sie ggf. Vorgänge aus:
Der aktuelle Thread kann mit der Methode interrupt(Thread, String)
von anderen Threads unterbrochen werden.
Parameter | |
---|---|
allow |
boolean : Gibt an, ob Ausführungsunterbrechungen für den aktuellen Thread zulässig sind. |
unterbrechen
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Unterbricht die laufenden/nächsten Ausführungsvorgänge für den angegebenen Thread. Die Ausführungsvorgänge für
Der angegebene Thread gibt RunInterruptedException
aus.
Parameter | |
---|---|
message |
String : die Nachricht für RunInterruptedException . |
errorId |
ErrorIdentifier : Angabe der Ursache der Unterbrechung, sofern bekannt. |
unterbrechen
public abstract void interrupt (Thread thread, String message)
Unterbricht die laufenden/nächsten Ausführungsvorgänge für den angegebenen Thread. Die Ausführungsvorgänge für
Der angegebene Thread gibt RunInterruptedException
aus.
Parameter | |
---|---|
message |
String : die Nachricht für RunInterruptedException . |
isInterruptAllowed
public abstract boolean isInterruptAllowed ()
Geben Sie den Unterbrechungsstatus von RunUtil an.
Returns | |
---|---|
boolean |
"true", wenn die Ausführung unterbrochen werden kann, andernfalls "false". |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect,command)
Eine alternative runCmdInBackground(String)
-Methode, die die Befehlsargumente akzeptiert
im Format ERROR(/List)
.
Parameter | |
---|---|
redirect |
Redirect : Die ERROR(/Redirect) , die auf ProcessBuilder angewendet werden soll. |
command |
: ERROR(/List) , die den angegebenen Systembefehl und optional Argumente enthält
zum Ausführen |
Returns | |
---|---|
Process |
den Process des ausgeführten Befehls |
Ausgabe | |
---|---|
|
Befehl konnte nicht ausgeführt werden |
runCmdInBackground
public abstract Process runCmdInBackground (command)
Eine alternative runCmdInBackground(String)
-Methode, die die Befehlsargumente akzeptiert
im Format ERROR(/List)
.
Parameter | |
---|---|
command |
: ERROR(/List) , die den angegebenen Systembefehl und optional Argumente enthält
zum Ausführen |
Returns | |
---|---|
Process |
den Process des ausgeführten Befehls |
Ausgabe | |
---|---|
|
Befehl konnte nicht ausgeführt werden |
runCmdInBackground
public abstract Process runCmdInBackground (command, OutputStream output)
Wird ein Befehl mit einem ERROR(/OutputStream)
ausgeführt, wird die Ausgabe des Befehls protokolliert.
Stdout und stderr werden zusammengeführt.
Parameter | |
---|---|
command |
: der auszuführende Befehl |
output |
OutputStream : der OutputStream zum Speichern der Ausgabe |
Returns | |
---|---|
Process |
Process , der den Befehl ausführt |
Ausgabe | |
---|---|
|
IOException |
runCmdInBackground
public abstract Process runCmdInBackground (String... command)
Hilfsmethode zum asynchronen Ausführen eines Systembefehls.
Wird sofort nach dem Starten des Befehls zurückgegeben.
Parameter | |
---|---|
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
Process |
den Process des ausgeführten Befehls |
Ausgabe | |
---|---|
|
Befehl konnte nicht ausgeführt werden |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect, String... command)
Hilfsmethode zum asynchronen Ausführen eines Systembefehls.
Wird sofort nach dem Starten des Befehls zurückgegeben.
Parameter | |
---|---|
redirect |
Redirect : Die ERROR(/Redirect) , die auf ProcessBuilder angewendet werden soll. |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
Process |
den Process des ausgeführten Befehls |
Ausgabe | |
---|---|
|
Befehl konnte nicht ausgeführt werden |
runEscalatingTimedWiederholen
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.
Die Wartezeit zwischen Vorgangsversuchen exponentiell erhöhen. Dies ist zur Verwendung wenn Sie einen Vorgang wie das Abfragen eines Servers ausführen, damit dieser Zeit für die Wiederherstellung bleibt, falls er ist vorübergehend nicht verfügbar.
Parameter | |
---|---|
opTimeout |
long : maximale Wartezeit in ms für einen einzelnen Vorgangsversuch |
initialPollInterval |
long : anfängliche Wartezeit zwischen Vorgangsversuchen |
maxPollInterval |
long : die maximale Wartezeit zwischen Vorgangversuchen |
maxTime |
long : die ungefähre Gesamtzeit, die für das weitere Ausführen des Vorgangs benötigt wird. |
runnable |
IRunUtil.IRunnableResult : Auszuführende IRunUtil.IRunnableResult |
Returns | |
---|---|
boolean |
true , wenn der Vorgang vor Ablauf von „maxTime“ erfolgreich abgeschlossen wurde |
runFixedTimedWiederholen
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 ms für einen einzelnen Vorgangsversuch |
pollInterval |
long : anfängliche Wartezeit zwischen Vorgangsversuchen |
maxTime |
long : die ungefähre Gesamtzeit, die für das weitere Ausführen des Vorgangs benötigt wird. |
runnable |
IRunUtil.IRunnableResult : Auszuführende IRunUtil.IRunnableResult |
Returns | |
---|---|
boolean |
true , wenn der Vorgang vor Ablauf von „maxTime“ erfolgreich abgeschlossen wurde |
runFixedTimedWiederholenWithOutputMonitor
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. Überwacht außerdem Ausgabestreams für Aktivität; wird abgebrochen, wenn für eine bestimmte Zeit keine Streamaktivität festgestellt wird. Wenn für „idleOutputTimeout“ null festgelegt ist, erfolgt kein Streammonitoring.
Parameter | |
---|---|
opTimeout |
long : maximale Wartezeit in ms für einen einzelnen Vorgangsversuch |
idleOutputTimeout |
long : maximale Wartezeit in ms auf die Ausgabe an die Ausgabestreams |
pollInterval |
long : anfängliche Wartezeit zwischen Vorgangsversuchen |
maxTime |
long : die ungefähre Gesamtzeit, die für das weitere Ausführen des Vorgangs benötigt wird. |
runnable |
IRunUtil.IRunnableResult : Auszuführende IRunUtil.IRunnableResult |
Returns | |
---|---|
boolean |
true , wenn der Vorgang vor Ablauf von „maxTime“ erfolgreich abgeschlossen wurde |
runTimed (Laufzeit)
public abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blockiert und führt einen Vorgang aus. Dieser Vorgang wird abgebrochen, wenn er länger als eine angegebene Zeit dauert.
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms |
runnable |
IRunUtil.IRunnableResult : Auszuführende IRunUtil.IRunnableResult |
logErrors |
boolean : Protokolliert Fehler bei oder ohne Ausnahme. |
Returns | |
---|---|
CommandStatus |
das Ergebnis des Vorgangs CommandStatus . |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Hilfsmethode zum Ausführen eines Systembefehls, zum Abbrechen, wenn der Vorgang länger als eine angegebene Zeit dauert,
und leitet die Ausgabe gegebenenfalls an Dateien weiter. Wenn ERROR(/OutputStream)
auf diese Weise angegeben werden,
bleiben sie am Ende der Funktion offen.
Parameter | |
---|---|
timeout |
long : Maximale Wartezeit in ms. 0 bedeutet, dass es keine Zeitüberschreitung gibt. |
stdout |
OutputStream : ERROR(/OutputStream) , an den die Standardausgabe weitergeleitet wird. Kann null sein. |
stderr |
OutputStream : ERROR(/OutputStream) , an den die Fehlerausgabe weitergeleitet wird. Kann null sein. |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der Befehlsausführung |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene .
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms. 0 bedeutet, dass es keine Zeitüberschreitung gibt. |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der Befehlsausführung |
runTimedCmdWiederholen
public abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene .
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms für jeden Versuch |
retryInterval |
long : Wartezeit zwischen Befehlswiederholungen |
attempts |
int : die maximale Anzahl von Versuchen für den Versuch |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der Befehlsausführung |
runTimedCmdRepeatWithOutputMonitor
public abstract CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene . Überwacht auch die Ausgabestreams auf Aktivität; der Vorgang wird abgebrochen, wenn keine Streamaktivität für einen bestimmten Zeitraum beobachtet werden. Wenn „IdleOutputTimeout“ auf null gesetzt ist, wird der Stream nicht überwacht erfolgt.
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms für jeden Versuch |
idleOutputTimeout |
long : maximale Wartezeit in ms auf die Ausgabe an die Ausgabestreams |
retryInterval |
long : Wartezeit zwischen Befehlswiederholungen |
attempts |
int : die maximale Anzahl von Versuchen für den Versuch |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der Befehlsausführung |
runTimedCmdSilently
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene
. Ähnlich wie runTimedCmd(long, String)
, protokolliert jedoch keine Fehler unter
Ausnahme.
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der Befehlsausführung |
runTimedCmdSilentlyWiederholen
public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene
. Ähnlich wie runTimedCmdRetry(long, long, int, String[])
,
aber protokolliert bei Ausnahme
keine Fehler.
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms |
retryInterval |
long : Wartezeit zwischen Befehlswiederholungen |
attempts |
int : die maximale Anzahl von Versuchen für den Versuch |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der 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 der Vorgang länger als eine angegebene Zeit dauert, und leitet die Ausgabe gegebenenfalls an Dateien weiter.
Parameter | |
---|---|
timeout |
long : Maximale Wartezeit in ms. 0 bedeutet, dass es keine Zeitüberschreitung gibt. |
input |
String : die an die Verarbeitung zu übergebende stdin-Eingabe |
stdoutFile |
File : ERROR(/File) , an den die Standardausgabe weitergeleitet wird. Kann null sein. |
stderrFile |
File : ERROR(/File) , an den die Fehlerausgabe weitergeleitet wird. Kann null sein. |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der 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, falls sie dauert länger als die angegebene Zeit.
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms |
input |
String : die an die Verarbeitung zu übergebende stdin-Eingabe |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der Befehlsausführung |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input,command)
Hilfsmethode zum Ausführen eines Systembefehls, der eine stdin-Eingabe erfordert, und zum Abbrechen, falls sie dauert länger als die angegebene Zeit.
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms |
input |
String : die an die Verarbeitung zu übergebende stdin-Eingabe |
command |
: ERROR(/List) , die den Systembefehl und optional die auszuführenden Argumente enthält |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der Befehlsausführung |
runTimedCmdWithInputWeiterleitung
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Hilfsmethode zum Ausführen eines Systembefehls, bei dem Stdin von einer Datei umgeleitet werden muss, und wird abgebrochen, wenn es länger als eine angegebene Zeit dauert.
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms |
inputRedirect |
File : Der ERROR(/File) , der als Standardeingabe mit ProcessBuilder.redirectInput() weitergeleitet werden soll. Wenn null, wird stdin nicht weitergeleitet. |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der 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 der Vorgang länger als eine angegebene Zeit dauert,
und leitet die Ausgabe gegebenenfalls an Dateien weiter. Wenn ERROR(/OutputStream)
auf diese Weise angegeben werden,
bleiben sie am Ende der Funktion offen.
Parameter | |
---|---|
timeout |
long : Maximale Wartezeit in ms. 0 bedeutet, dass es keine Zeitüberschreitung gibt. |
idleOutputTimeout |
long : maximale Wartezeit in ms auf die Ausgabe an die Ausgabestreams |
stdout |
OutputStream : ERROR(/OutputStream) , an den die Standardausgabe weitergeleitet wird. Kann null sein. |
stderr |
OutputStream : ERROR(/OutputStream) , an den die Fehlerausgabe weitergeleitet wird. Kann null sein. |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der Befehlsausführung |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Hilfsmethode zum Ausführen eines Systembefehls und zum Abbrechen, wenn die Dauer länger als eine angegebene . Überwacht auch die Ausgabestreams auf Aktivität; der Vorgang wird abgebrochen, wenn keine Streamaktivität für einen bestimmten Zeitraum beobachtet werden. Wenn „IdleOutputTimeout“ auf null gesetzt ist, wird der Stream nicht überwacht erfolgt.
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms. 0 bedeutet, dass es keine Zeitüberschreitung gibt. |
idleOutputTimeout |
long : maximale Wartezeit in ms auf die Ausgabe an die Ausgabestreams |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente |
Returns | |
---|---|
CommandResult |
CommandResult mit dem Ergebnis der Befehlsausführung |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
Hilfsmethode zum Ausführen eines Systembefehls mit Caching.
Wenn cacheClient
angegeben ist, wird das Caching aktiviert. Wenn der Cache
verfügbar ist, wird das im Cache gespeicherte Ergebnis zurückgegeben. Andernfalls runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String)
wird verwendet, um den Befehl auszuführen, und das Ergebnis wird für das Caching hochgeladen.
Parameter | |
---|---|
timeout |
long : Maximale Wartezeit in ms. 0 bedeutet, dass es keine Zeitüberschreitung gibt. |
idleOutputTimeout |
long : maximale Wartezeit in ms auf die Ausgabe an die Ausgabestreams. |
stdout |
OutputStream : ERROR(/OutputStream) , an den die Standardausgabe weitergeleitet wird. Kann null sein. |
stderr |
OutputStream : ERROR(/OutputStream) , an den die Fehlerausgabe weitergeleitet wird. Kann null sein. |
cacheClient |
ICacheClient : Eine Instanz von ICacheClient , die für das Caching verwendet wird. |
command |
String : der angegebene Systembefehl und optional die auszuführenden Argumente. |
Returns | |
---|---|
CommandResult |
Eine CommandResult mit dem Ergebnis der Befehlsausführung. |
runTimedWiederholen
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 ms für einen Vorgangsversuch |
pollInterval |
long : Wartezeit zwischen Befehlswiederholungen |
attempts |
int : die maximale Anzahl von Versuchen für den Versuch |
runnable |
IRunUtil.IRunnableResult : Auszuführende IRunUtil.IRunnableResult |
Returns | |
---|---|
boolean |
true , wenn der Vorgang erfolgreich abgeschlossen wurde, bevor Versuche erreicht wurden. |
runTimedWiederholenWithOutputMonitor
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. Überwacht außerdem Ausgabestreams für Aktivität; wird abgebrochen, wenn für eine bestimmte Zeit keine Streamaktivität festgestellt wird. Wenn für „idleOutputTimeout“ null festgelegt ist, erfolgt kein Streammonitoring.
Parameter | |
---|---|
opTimeout |
long : maximale Wartezeit in ms für einen Vorgangsversuch |
idleOutputTimeout |
long : maximale Wartezeit in ms auf die Ausgabe an die Ausgabestreams |
pollInterval |
long : Wartezeit zwischen Befehlswiederholungen |
attempts |
int : die maximale Anzahl von Versuchen für den Versuch |
runnable |
IRunUtil.IRunnableResult : Auszuführende IRunUtil.IRunnableResult |
Returns | |
---|---|
boolean |
true , wenn der Vorgang erfolgreich abgeschlossen wurde, bevor Versuche erreicht wurden. |
runTimedWithOutputMonitor
public abstract CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blockiert und führt einen Vorgang aus. Dieser Vorgang wird abgebrochen, wenn er länger als eine angegebene Zeit dauert. Ebenfalls überwacht die Ausgabestreams auf Aktivität. Der Vorgang wird abgebrochen, wenn für einen Zeitraum zu einer bestimmten Zeit. Wenn für „idleOutputTimeout“ null festgelegt ist, erfolgt kein Streammonitoring.
Parameter | |
---|---|
timeout |
long : maximale Wartezeit in ms |
idleOutputTimeout |
long : maximale Wartezeit in ms auf die Ausgabe an die Ausgabestreams |
runnable |
IRunUtil.IRunnableResult : Auszuführende IRunUtil.IRunnableResult |
logErrors |
boolean : Protokolliert Fehler bei oder ohne Ausnahme. |
Returns | |
---|---|
CommandStatus |
das Ergebnis des Vorgangs CommandStatus . |
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 Wert der Variablen |
Weitere Informationen:
setEnvVariablePriority (setEnvVariablePriorität)
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Entscheiden Sie, ob beim Erstellen eines Prozesses das Deaktivieren der Umgebungsvariable höher ist.
Priorität hat, als sie festzulegen.
Standardmäßig hat das Aufheben der Einstellung eine höhere Priorität, d. h., wenn beim Versuch, eine Variable mit der
festgelegt wird, kann dies nicht passieren,
da die Variable nicht mehr definiert 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 die Beendigung zu erzwingen.
Parameter | |
---|---|
thread |
Thread : der Thread, der unterbrochen werden soll. |
timeMs |
long : Wartezeit, bevor die Einstellung „Unterbrechbar“ festgelegt wird. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Verwendung von Linux „kill“ zulassen Unterbrechung bei Prozessen, die über #runTimed Methoden ausgeführt werden,
eine Zeitüberschreitung erreicht.
Kann nicht für die Standardinstanz IRunUtil
verwendet werden.
Parameter | |
---|---|
interrupt |
boolean |
setWeiterleitungStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
Legen Sie fest, dass der Standardfehlerstream beim Ausführen des Systems zum Standardausgabestream weitergeleitet wird . Der Anfangswert ist "false".
Parameter | |
---|---|
redirect |
boolean : neuer Wert dafür, ob eine Weiterleitung erfolgen soll oder nicht |
Weitere Informationen:
setWorkingDir
public abstract void setWorkingDir (File dir)
Legt das Arbeitsverzeichnis für Systembefehle fest.
Parameter | |
---|---|
dir |
File : das Arbeitsverzeichnis |
Weitere Informationen:
Schlafen
public abstract void sleep (long time)
Hilfsmethode zum Einschlafen für eine bestimmte Zeit, wobei Ausnahmen ignoriert werden.
Parameter | |
---|---|
time |
long : ms bis zum Ruhemodus. Werte kleiner oder gleich 0 werden ignoriert. |
UnverankerteVariable
public abstract void unsetEnvVariable (String key)
Hebt die Festlegung einer Umgebungsvariable auf, sodass die Systembefehle ohne diese Umgebungsvariablen ausgeführt werden.
Parameter | |
---|---|
key |
String : der Variablenname |
Weitere Informationen: