UruchomUtil
public class RunUtil
extends Object
implements IRunUtil
Obiekt Java.lang.Object | |
↳ | com.android.tradefed.util.RunUtil |
Zbiór metod pomocniczych do wykonywania operacji.
Streszczenie
Pola | |
---|---|
public static final String | INHERITIO_PREFIX |
public static final String | RUNNABLE_NOTIFIER_NAME
|
Konstruktorzy publiczni | |
---|---|
RunUtil () Utwórz nowy obiekt |
Metody publiczne | |
---|---|
void | allowInterrupt (boolean allow) Zezwala/zabrania wykonywania przerwań w bieżącym wątku. |
static IRunUtil | getDefault () Uzyskaj odwołanie do domyślnego obiektu |
void | interrupt (Thread thread, String message, ErrorIdentifier errorId) Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. |
void | interrupt (Thread thread, String message) Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. |
boolean | isInterruptAllowed () Podaj status przerwania RunUtil. |
Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) Alternatywna metoda |
Process | runCmdInBackground ( command) runCmdInBackground ( command) Alternatywna metoda |
Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) Uruchamianie polecenia z |
Process | runCmdInBackground (String... command) Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego. |
Process | runCmdInBackground (Redirect redirect, String... command) Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego. |
boolean | runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
boolean | runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
CommandStatus | runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Blokuje i wykonuje operację, przerywając ją, jeśli trwa dłużej niż określony czas. |
CommandResult | runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command) Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. |
CommandResult | runTimedCmd (long timeout, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdSilently (long timeout, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command) Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. |
CommandResult | runTimedCmdWithInput (long timeout, String input, String... command) Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) Metoda pomocnicza do wykonania polecenia systemowego, które wymaga przekierowania Stdin z pliku i przerwania, jeśli zajmie to więcej czasu niż określony czas. |
CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command) Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. |
CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
boolean | runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
CommandStatus | runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Blokuje i wykonuje operację, przerywając ją, jeśli trwa dłużej niż określony czas. |
void | setEnvVariable (String name, String value) Ustawia zmienną środowiskową, która będzie używana podczas uruchamiania poleceń systemowych. |
void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) Zdecyduj, czy podczas tworzenia procesu rozbrojenie zmiennej środowiskowej ma wyższy priorytet niż jej ustawienie. |
void | setInterruptibleInFuture (Thread thread, long timeMs) Ustaw jako przerywalne po pewnym czasie oczekiwania. |
void | setLinuxInterruptProcess (boolean interrupt) Zezwalaj na używanie przerwania „zabicia” systemu Linux w procesie uruchamianym metodami #runTimed, gdy osiągnie limit czasu. |
void | setRedirectStderrToStdout (boolean redirect) Ustaw standardowy strumień błędów, aby przekierowywał do standardowego strumienia wyjściowego podczas uruchamiania poleceń systemowych. |
void | setWorkingDir (File dir) Ustawia katalog roboczy dla poleceń systemowych. |
void | sleep (long time) Metoda pomocnicza usypiająca przez określony czas, ignorująca wszelkie wyjątki. |
void | unsetEnvVariable (String key) Anuluje ustawienie zmiennej środowiskowej, więc polecenia systemowe działają bez tej zmiennej środowiskowej. Zmienne środowiskowe mogą dziedziczyć z procesu nadrzędnego, dlatego musimy usunąć zmienną środowiskową z |
Pola
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
Konstruktorzy publiczni
Metody publiczne
zezwól na przerwanie
public void allowInterrupt (boolean allow)
Zezwala/zabrania wykonywania przerwań w bieżącym wątku. Jeśli jest to dozwolone, operacje bieżącego wątku można przerwać z innych wątków za pomocą metody interrupt(Thread, String)
.
Parametry | |
---|---|
allow | boolean : czy zezwolić na wykonywanie przerwań w bieżącym wątku. |
pobierz domyślny
public static IRunUtil getDefault ()
Uzyskaj odwołanie do domyślnego obiektu RunUtil
.
setEnvVariable(String, String)
lub setWorkingDir(File)
utworzyły własną kopię.Zwroty | |
---|---|
IRunUtil |
przerywać
public void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiania w danym wątku zgłoszą RunInterruptedException
.
Parametry | |
---|---|
message | String : komunikat dotyczący RunInterruptedException . |
errorId | ErrorIdentifier : Reprezentuje przyczynę przerwania, jeśli jest znana. |
przerywać
public void interrupt (Thread thread, String message)
Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiania w danym wątku zgłoszą RunInterruptedException
.
Parametry | |
---|---|
message | String : komunikat dotyczący RunInterruptedException . |
isInterruptAllowed
public boolean isInterruptAllowed ()
Podaj status przerwania RunUtil.
Zwroty | |
---|---|
boolean | true, jeśli Run można przerwać, false w przeciwnym razie. |
uruchomCmdInBackground
public Process runCmdInBackground (Redirect redirect,command)
Alternatywna metoda runCmdInBackground(String)
, która akceptuje argumenty polecenia w postaci ERROR(/List)
.
Parametry | |
---|---|
redirect | Redirect : ERROR(/Redirect) do zastosowania do ProcessBuilder . |
command | ERROR(/List) zawierający określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
Process | Process wykonanego polecenia |
uruchomCmdInBackground
public Process runCmdInBackground (command)
Alternatywna metoda runCmdInBackground(String)
, która akceptuje argumenty polecenia w postaci ERROR(/List)
.
Parametry | |
---|---|
command | ERROR(/List) zawierający określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
Process | Process wykonanego polecenia |
uruchomCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
Uruchamianie polecenia z ERROR(/OutputStream)
rejestruje dane wyjściowe polecenia. Stdout i stderr są łączone razem.
Parametry | |
---|---|
command | |
output | OutputStream : OutputStream, w którym zapisywane są dane wyjściowe |
Zwroty | |
---|---|
Process | Process uruchamiający polecenie |
uruchomCmdInBackground
public Process runCmdInBackground (String... command)
Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.
Wróci natychmiast po uruchomieniu polecenia.
Parametry | |
---|---|
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
Process | Process wykonanego polecenia |
uruchomCmdInBackground
public Process runCmdInBackground (Redirect redirect, String... command)
Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.
Wróci natychmiast po uruchomieniu polecenia.
Parametry | |
---|---|
redirect | Redirect : ERROR(/Redirect) do zastosowania do ProcessBuilder . |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
Process | Process wykonanego polecenia |
runEscalatingTimedRetry
public boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.
Wykładniczo zwiększ czas oczekiwania między próbami operacji. Jest to przeznaczone do użycia podczas wykonywania operacji, takich jak odpytywanie serwera, aby dać mu czas na regenerację w przypadku tymczasowej awarii.Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji |
initialPollInterval | long : początkowy czas oczekiwania pomiędzy próbami operacji |
maxPollInterval | long : maksymalny czas oczekiwania pomiędzy próbami operacji |
maxTime | long : całkowity przybliżony maksymalny czas trwania próby operacji |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime |
runFixedTimedPonów próbę
public boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.
Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji |
pollInterval | long : początkowy czas oczekiwania pomiędzy próbami operacji |
maxTime | long : całkowity przybliżony maksymalny czas trwania próby operacji |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime |
runFixedTimedRetryWithOutputMonitor
public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.
Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
pollInterval | long : początkowy czas oczekiwania pomiędzy próbami operacji |
maxTime | long : całkowity przybliżony maksymalny czas trwania próby operacji |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime |
Uruchomione w określonym czasie
public CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blokuje i wykonuje operację, przerywając ją, jeśli trwa dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
logErrors | boolean : rejestruje błędy w przypadku wyjątku lub nie. |
Zwroty | |
---|---|
CommandStatus | wynik operacji CommandStatus . |
runTimedCmd
public CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. Jeśli w ten sposób zostanie podany ERROR(/OutputStream)
, pozostawiony zostanie on otwarty na końcu funkcji.
Parametry | |
---|---|
timeout | long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu. |
stdout | OutputStream : ERROR(/OutputStream) gdzie standardowe wyjście zostanie przekierowane. Może mieć wartość zerową. |
stderr | OutputStream : ERROR(/OutputStream) , gdzie zostanie przekierowane wyjście błędu. Może mieć wartość zerową. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmd
public CommandResult runTimedCmd (long timeout, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdPonów próbę
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms przy każdej próbie |
retryInterval | long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia |
attempts | int : maksymalna liczba prób |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdRetryWithOutputMonitor
public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms przy każdej próbie |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
retryInterval | long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia |
attempts | int : maksymalna liczba prób |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdSilently
public CommandResult runTimedCmdSilently (long timeout, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Podobny do runTimedCmd(long, String)
, ale w przypadku wyjątku nie rejestruje żadnych błędów.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdSilentlyPonów próbę
public CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Podobny do runTimedCmdRetry(long, long, int, String[])
, ale w przypadku wyjątku nie rejestruje żadnych błędów.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
retryInterval | long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia |
attempts | int : maksymalna liczba prób |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono.
Parametry | |
---|---|
timeout | long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu. |
input | String : wejście stdin do przekazania do procesu |
stdoutFile | File : ERROR(/File) , do którego zostanie przekierowane standardowe wyjście. Może mieć wartość zerową. |
stderrFile | File : ERROR(/File) , do którego zostanie przekierowane wyjście błędu. Może mieć wartość zerową. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
input | String : wejście stdin do przekazania do procesu |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
input | String : wejście stdin do przekazania do procesu |
command | ERROR(/List) zawierający polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithInputRedirect
public CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Metoda pomocnicza do wykonania polecenia systemowego, które wymaga przekierowania Stdin z pliku i przerwania, jeśli zajmie to więcej czasu niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
inputRedirect | File : ERROR(/File) do przekierowania jako standardowe wejście przy użyciu ProcessBuilder.redirectInput() . Jeśli ma wartość null, standardowe wejście nie zostanie przekierowane. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. Jeśli w ten sposób zostanie podany ERROR(/OutputStream)
, pozostawiony zostanie on otwarty na końcu funkcji.
Parametry | |
---|---|
timeout | long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu. |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
stdout | OutputStream : ERROR(/OutputStream) gdzie standardowe wyjście zostanie przekierowane. Może mieć wartość zerową. |
stderr | OutputStream : ERROR(/OutputStream) , gdzie zostanie przekierowane wyjście błędu. Może mieć wartość zerową. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu. |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedPonów próbę
public boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.
Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na jedną próbę operacji |
pollInterval | long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia |
attempts | int : maksymalna liczba prób |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed osiągnięciem liczby prób. |
runTimedRetryWithOutputMonitor
public boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.
Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na jedną próbę operacji |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
pollInterval | long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia |
attempts | int : maksymalna liczba prób |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed osiągnięciem liczby prób. |
runTimedWithOutputMonitor
public CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blokuje i wykonuje operację, przerywając ją, jeśli trwa dłużej niż określony czas. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
logErrors | boolean : rejestruje błędy w przypadku wyjątku lub nie. |
Zwroty | |
---|---|
CommandStatus | wynik operacji CommandStatus . |
ustaw zmienną Env
public void setEnvVariable (String name, String value)
Ustawia zmienną środowiskową, która będzie używana podczas uruchamiania poleceń systemowych.
Parametry | |
---|---|
name | String : nazwa zmiennej |
value | String : wartość zmiennej |
setEnvVariablePriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Zdecyduj, czy podczas tworzenia procesu rozbrojenie zmiennej środowiskowej ma wyższy priorytet niż jej ustawienie. Domyślnie rozbrojenie ma wyższy priorytet: co oznacza, że jeśli zostanie podjęta próba ustawienia zmiennej o tej samej nazwie, nie nastąpi to, ponieważ zmienna zostanie rozbrojona. Nie można użyć w domyślnej instancji IRunUtil
.
Parametry | |
---|---|
priority | IRunUtil.EnvPriority |
setInterruptibleInFuture
public void setInterruptibleInFuture (Thread thread, long timeMs)
Ustaw jako przerywalne po pewnym czasie oczekiwania. ERROR(/CommandScheduler#shutdownHard())
, aby wymusić, ostatecznie zakończymy działanie.
Parametry | |
---|---|
thread | Thread : wątek, który będzie można przerwać. |
timeMs | long : czas oczekiwania przed ustawieniem możliwości przerywania. |
setLinuxInterruptProcess
public void setLinuxInterruptProcess (boolean interrupt)
Zezwalaj na używanie przerwania „zabicia” systemu Linux w procesie uruchamianym metodami #runTimed, gdy osiągnie limit czasu. Nie można użyć w domyślnej instancji IRunUtil
.
Parametry | |
---|---|
interrupt | boolean |
setRedirectStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
Ustaw standardowy strumień błędów, aby przekierowywał do standardowego strumienia wyjściowego podczas uruchamiania poleceń systemowych. Wartość początkowa jest fałszywa.
Parametry | |
---|---|
redirect | boolean : nowa wartość określająca, czy przekierować |
setWorkingDir
public void setWorkingDir (File dir)
Ustawia katalog roboczy dla poleceń systemowych.
Parametry | |
---|---|
dir | File : katalog roboczy |
spać
public void sleep (long time)
Metoda pomocnicza usypiająca przez określony czas, ignorująca wszelkie wyjątki.
Parametry | |
---|---|
time | long : ms do snu. wartości mniejsze lub równe 0 będą ignorowane |
unsetEnvZmienna
public void unsetEnvVariable (String key)
Anuluje ustawienie zmiennej środowiskowej, więc polecenia systemowe działają bez tej zmiennej środowiskowej. Zmienne środowiskowe mogą dziedziczyć z procesu nadrzędnego, dlatego musimy usunąć zmienną środowiskową z ProcessBuilder.environment()
Parametry | |
---|---|
key | String : nazwa zmiennej |
Zobacz też:
UruchomUtil
public class RunUtil
extends Object
implements IRunUtil
Obiekt Java.lang.Object | |
↳ | com.android.tradefed.util.RunUtil |
Zbiór metod pomocniczych do wykonywania operacji.
Streszczenie
Pola | |
---|---|
public static final String | INHERITIO_PREFIX |
public static final String | RUNNABLE_NOTIFIER_NAME
|
Konstruktorzy publiczni | |
---|---|
RunUtil () Utwórz nowy obiekt |
Metody publiczne | |
---|---|
void | allowInterrupt (boolean allow) Zezwala/zabrania wykonywania przerwań w bieżącym wątku. |
static IRunUtil | getDefault () Uzyskaj odwołanie do domyślnego obiektu |
void | interrupt (Thread thread, String message, ErrorIdentifier errorId) Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. |
void | interrupt (Thread thread, String message) Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. |
boolean | isInterruptAllowed () Podaj status przerwania RunUtil. |
Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) Alternatywna metoda |
Process | runCmdInBackground ( command) runCmdInBackground ( command) Alternatywna metoda |
Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) Uruchamianie polecenia z |
Process | runCmdInBackground (String... command) Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego. |
Process | runCmdInBackground (Redirect redirect, String... command) Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego. |
boolean | runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
boolean | runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
CommandStatus | runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Blokuje i wykonuje operację, przerywając ją, jeśli trwa dłużej niż określony czas. |
CommandResult | runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command) Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. |
CommandResult | runTimedCmd (long timeout, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdSilently (long timeout, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command) Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. |
CommandResult | runTimedCmdWithInput (long timeout, String input, String... command) Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas. |
CommandResult | runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command) Metoda pomocnicza do wykonania polecenia systemowego, które wymaga przekierowania Stdin z pliku i przerwania, jeśli zajmie to więcej czasu niż określony czas. |
CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command) Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. |
CommandResult | runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command) Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. |
boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
boolean | runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
CommandStatus | runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Blokuje i wykonuje operację, przerywając ją, jeśli trwa dłużej niż określony czas. |
void | setEnvVariable (String name, String value) Ustawia zmienną środowiskową, która będzie używana podczas uruchamiania poleceń systemowych. |
void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) Zdecyduj, czy podczas tworzenia procesu rozbrojenie zmiennej środowiskowej ma wyższy priorytet niż jej ustawienie. |
void | setInterruptibleInFuture (Thread thread, long timeMs) Ustaw jako przerywalne po pewnym czasie oczekiwania. |
void | setLinuxInterruptProcess (boolean interrupt) Zezwalaj na używanie przerwania „zabicia” systemu Linux w procesie uruchamianym metodami #runTimed, gdy osiągnie limit czasu. |
void | setRedirectStderrToStdout (boolean redirect) Ustaw standardowy strumień błędów, aby przekierowywał do standardowego strumienia wyjściowego podczas uruchamiania poleceń systemowych. |
void | setWorkingDir (File dir) Ustawia katalog roboczy dla poleceń systemowych. |
void | sleep (long time) Metoda pomocnicza usypiająca przez określony czas, ignorująca wszelkie wyjątki. |
void | unsetEnvVariable (String key) Anuluje ustawienie zmiennej środowiskowej, więc polecenia systemowe działają bez tej zmiennej środowiskowej. Zmienne środowiskowe mogą dziedziczyć z procesu nadrzędnego, dlatego musimy usunąć zmienną środowiskową z |
Pola
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
Konstruktorzy publiczni
Metody publiczne
zezwól na przerwanie
public void allowInterrupt (boolean allow)
Zezwala/zabrania wykonywania przerwań w bieżącym wątku. Jeśli jest to dozwolone, operacje bieżącego wątku można przerwać z innych wątków za pomocą metody interrupt(Thread, String)
.
Parametry | |
---|---|
allow | boolean : czy zezwolić na wykonywanie przerwań w bieżącym wątku. |
pobierz domyślny
public static IRunUtil getDefault ()
Uzyskaj odwołanie do domyślnego obiektu RunUtil
.
setEnvVariable(String, String)
lub setWorkingDir(File)
utworzyły własną kopię.Zwroty | |
---|---|
IRunUtil |
przerywać
public void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiania w danym wątku zgłoszą RunInterruptedException
.
Parametry | |
---|---|
message | String : komunikat dotyczący RunInterruptedException . |
errorId | ErrorIdentifier : Reprezentuje przyczynę przerwania, jeśli jest znana. |
przerywać
public void interrupt (Thread thread, String message)
Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiania w danym wątku zgłoszą RunInterruptedException
.
Parametry | |
---|---|
message | String : komunikat dotyczący RunInterruptedException . |
isInterruptAllowed
public boolean isInterruptAllowed ()
Podaj status przerwania RunUtil.
Zwroty | |
---|---|
boolean | true, jeśli Run można przerwać, false w przeciwnym razie. |
uruchomCmdInBackground
public Process runCmdInBackground (Redirect redirect,command)
Alternatywna metoda runCmdInBackground(String)
, która akceptuje argumenty polecenia w postaci ERROR(/List)
.
Parametry | |
---|---|
redirect | Redirect : ERROR(/Redirect) do zastosowania do ProcessBuilder . |
command | ERROR(/List) zawierający określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
Process | Process wykonanego polecenia |
uruchomCmdInBackground
public Process runCmdInBackground (command)
Alternatywna metoda runCmdInBackground(String)
, która akceptuje argumenty polecenia w postaci ERROR(/List)
.
Parametry | |
---|---|
command | ERROR(/List) zawierający określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
Process | Process wykonanego polecenia |
uruchomCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
Uruchamianie polecenia z ERROR(/OutputStream)
rejestruje dane wyjściowe polecenia. Stdout i stderr są łączone razem.
Parametry | |
---|---|
command | |
output | OutputStream : OutputStream, w którym zapisywane są dane wyjściowe |
Zwroty | |
---|---|
Process | Process uruchamiający polecenie |
uruchomCmdInBackground
public Process runCmdInBackground (String... command)
Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.
Wróci natychmiast po uruchomieniu polecenia.
Parametry | |
---|---|
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
Process | Process wykonanego polecenia |
uruchomCmdInBackground
public Process runCmdInBackground (Redirect redirect, String... command)
Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.
Wróci natychmiast po uruchomieniu polecenia.
Parametry | |
---|---|
redirect | Redirect : ERROR(/Redirect) do zastosowania do ProcessBuilder . |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
Process | Process wykonanego polecenia |
runEscalatingTimedRetry
public boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.
Wykładniczo zwiększ czas oczekiwania między próbami operacji. Jest to przeznaczone do użycia podczas wykonywania operacji, takich jak odpytywanie serwera, aby dać mu czas na regenerację w przypadku tymczasowej awarii.Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji |
initialPollInterval | long : początkowy czas oczekiwania pomiędzy próbami operacji |
maxPollInterval | long : maksymalny czas oczekiwania pomiędzy próbami operacji |
maxTime | long : całkowity przybliżony maksymalny czas trwania próby operacji |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime |
runFixedTimedPonów próbę
public boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.
Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji |
pollInterval | long : początkowy czas oczekiwania pomiędzy próbami operacji |
maxTime | long : całkowity przybliżony maksymalny czas trwania próby operacji |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime |
runFixedTimedRetryWithOutputMonitor
public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.
Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
pollInterval | long : początkowy czas oczekiwania pomiędzy próbami operacji |
maxTime | long : całkowity przybliżony maksymalny czas trwania próby operacji |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime |
Uruchomione w określonym czasie
public CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blokuje i wykonuje operację, przerywając ją, jeśli trwa dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
logErrors | boolean : rejestruje błędy w przypadku wyjątku lub nie. |
Zwroty | |
---|---|
CommandStatus | wynik operacji CommandStatus . |
runTimedCmd
public CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. Jeśli w ten sposób zostanie podany ERROR(/OutputStream)
, pozostawiony zostanie on otwarty na końcu funkcji.
Parametry | |
---|---|
timeout | long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu. |
stdout | OutputStream : ERROR(/OutputStream) gdzie standardowe wyjście zostanie przekierowane. Może mieć wartość zerową. |
stderr | OutputStream : ERROR(/OutputStream) , gdzie zostanie przekierowane wyjście błędu. Może mieć wartość zerową. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmd
public CommandResult runTimedCmd (long timeout, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdPonów próbę
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms przy każdej próbie |
retryInterval | long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia |
attempts | int : maksymalna liczba prób |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdRetryWithOutputMonitor
public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms przy każdej próbie |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
retryInterval | long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia |
attempts | int : maksymalna liczba prób |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdSilently
public CommandResult runTimedCmdSilently (long timeout, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Podobny do runTimedCmd(long, String)
, ale w przypadku wyjątku nie rejestruje żadnych błędów.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdSilentlyPonów próbę
public CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Podobny do runTimedCmdRetry(long, long, int, String[])
, ale w przypadku wyjątku nie rejestruje żadnych błędów.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
retryInterval | long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia |
attempts | int : maksymalna liczba prób |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono.
Parametry | |
---|---|
timeout | long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu. |
input | String : wejście stdin do przekazania do procesu |
stdoutFile | File : ERROR(/File) , do którego zostanie przekierowane standardowe wyjście. Może mieć wartość zerową. |
stderrFile | File : ERROR(/File) , do którego zostanie przekierowane wyjście błędu. Może mieć wartość zerową. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
input | String : wejście stdin do przekazania do procesu |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithInput
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
input | String : wejście stdin do przekazania do procesu |
command | ERROR(/List) zawierający polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithInputRedirect
public CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Metoda pomocnicza do wykonania polecenia systemowego, które wymaga przekierowania Stdin z pliku i przerwania, jeśli zajmie to więcej czasu niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
inputRedirect | File : ERROR(/File) do przekierowania jako standardowe wejście przy użyciu ProcessBuilder.redirectInput() . Jeśli ma wartość null, standardowe wejście nie zostanie przekierowane. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. Jeśli w ten sposób zostanie podany ERROR(/OutputStream)
, pozostawiony zostanie on otwarty na końcu funkcji.
Parametry | |
---|---|
timeout | long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu. |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
stdout | OutputStream : ERROR(/OutputStream) gdzie standardowe wyjście zostanie przekierowane. Może mieć wartość zerową. |
stderr | OutputStream : ERROR(/OutputStream) , gdzie zostanie przekierowane wyjście błędu. Może mieć wartość zerową. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedCmdWithOutputMonitor
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu. |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik uruchomienia polecenia |
runTimedPonów próbę
public boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.
Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na jedną próbę operacji |
pollInterval | long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia |
attempts | int : maksymalna liczba prób |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed osiągnięciem liczby prób. |
runTimedRetryWithOutputMonitor
public boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.
Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na jedną próbę operacji |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
pollInterval | long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia |
attempts | int : maksymalna liczba prób |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed osiągnięciem liczby prób. |
runTimedWithOutputMonitor
public CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blokuje i wykonuje operację, przerywając ją, jeśli trwa dłużej niż określony czas. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
idleOutputTimeout | long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
logErrors | boolean : rejestruje błędy w przypadku wyjątku lub nie. |
Zwroty | |
---|---|
CommandStatus | wynik operacji CommandStatus . |
ustaw zmienną Env
public void setEnvVariable (String name, String value)
Ustawia zmienną środowiskową, która będzie używana podczas uruchamiania poleceń systemowych.
Parametry | |
---|---|
name | String : nazwa zmiennej |
value | String : wartość zmiennej |
setEnvVariablePriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Zdecyduj, czy podczas tworzenia procesu rozbrojenie zmiennej środowiskowej ma wyższy priorytet niż jej ustawienie. Domyślnie rozbrojenie ma wyższy priorytet: co oznacza, że jeśli zostanie podjęta próba ustawienia zmiennej o tej samej nazwie, nie nastąpi to, ponieważ zmienna zostanie rozbrojona. Nie można użyć w domyślnej instancji IRunUtil
.
Parametry | |
---|---|
priority | IRunUtil.EnvPriority |
setInterruptibleInFuture
public void setInterruptibleInFuture (Thread thread, long timeMs)
Ustaw jako przerywalne po pewnym czasie oczekiwania. ERROR(/CommandScheduler#shutdownHard())
, aby wymusić, ostatecznie zakończymy działanie.
Parametry | |
---|---|
thread | Thread : wątek, który będzie można przerwać. |
timeMs | long : czas oczekiwania przed ustawieniem możliwości przerywania. |
setLinuxInterruptProcess
public void setLinuxInterruptProcess (boolean interrupt)
Zezwalaj na używanie przerwania „zabicia” systemu Linux w procesie uruchamianym metodami #runTimed, gdy osiągnie limit czasu. Nie można użyć w domyślnej instancji IRunUtil
.
Parametry | |
---|---|
interrupt | boolean |
setRedirectStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
Ustaw standardowy strumień błędów, aby przekierowywał do standardowego strumienia wyjściowego podczas uruchamiania poleceń systemowych. Wartość początkowa jest fałszywa.
Parametry | |
---|---|
redirect | boolean : nowa wartość określająca, czy przekierować |
setWorkingDir
public void setWorkingDir (File dir)
Ustawia katalog roboczy dla poleceń systemowych.
Parametry | |
---|---|
dir | File : katalog roboczy |
spać
public void sleep (long time)
Metoda pomocnicza usypiająca przez określony czas, ignorująca wszelkie wyjątki.
Parametry | |
---|---|
time | long : ms do snu. wartości mniejsze lub równe 0 będą ignorowane |
unsetEnvZmienna
public void unsetEnvVariable (String key)
Anuluje ustawienie zmiennej środowiskowej, więc polecenia systemowe działają bez tej zmiennej środowiskowej. Zmienne środowiskowe mogą dziedziczyć z procesu nadrzędnego, dlatego musimy usunąć zmienną środowiskową z ProcessBuilder.environment()
Parametry | |
---|---|
key | String : nazwa zmiennej |
Zobacz też: