IRunUtil
public interface IRunUtil
com.android.tradefed.util.IRunUtil |
Interfejs do wykonywania operacji czasowych i poleceń systemowych.
Streszczenie
Zagnieżdżone klasy | |
---|---|
interface | IRunUtil.IRunnableResult Interfejs do asynchronicznego wykonywania operacji, która zwraca stan logiczny. |
Metody publiczne | |
---|---|
abstract void | allowInterrupt (boolean allow) Zezwala/zabrania wykonywania przerwań w bieżącym wątku. |
abstract void | interrupt (Thread thread, String message, ErrorIdentifier errorId) Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. |
abstract void | interrupt (Thread thread, String message) Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. |
abstract boolean | isInterruptAllowed () Podaj status przerwania RunUtil. |
abstract Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) Alternatywna metoda |
abstract Process | runCmdInBackground ( command) runCmdInBackground ( command) Alternatywna metoda |
abstract Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) Uruchamianie polecenia z |
abstract Process | runCmdInBackground (String... command) Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego. |
abstract Process | runCmdInBackground (Redirect redirect, String... command) Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego. |
abstract 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. |
abstract boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
abstract 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. |
abstract 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. |
abstract 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. |
abstract 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. |
abstract 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. |
abstract 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. |
abstract 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. |
abstract 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. |
abstract 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. |
abstract 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. |
abstract boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. |
abstract void | setEnvVariable (String key, String value) Ustawia zmienną środowiskową, która będzie używana podczas uruchamiania poleceń systemowych. |
abstract void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) Zdecyduj, czy podczas tworzenia procesu rozbrojenie zmiennej środowiskowej ma wyższy priorytet niż jej ustawienie. |
abstract void | setInterruptibleInFuture (Thread thread, long timeMs) Ustaw jako przerywalne po pewnym czasie oczekiwania. |
abstract void | setLinuxInterruptProcess (boolean interrupt) Zezwalaj na używanie przerwania „zabicia” systemu Linux w procesie uruchamianym metodami #runTimed, gdy osiągnie limit czasu. |
abstract void | setRedirectStderrToStdout (boolean redirect) Ustaw standardowy strumień błędów, aby przekierowywał do standardowego strumienia wyjściowego podczas uruchamiania poleceń systemowych. |
abstract void | setWorkingDir (File dir) Ustawia katalog roboczy dla poleceń systemowych. |
abstract void | sleep (long time) Metoda pomocnicza usypiająca przez określony czas, ignorująca wszelkie wyjątki. |
abstract void | unsetEnvVariable (String key) Anuluje ustawienie zmiennej środowiskowej, więc polecenia systemowe działają bez tej zmiennej środowiskowej. |
Metody publiczne
zezwól na przerwanie
public abstract 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. |
przerywać
public abstract 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 abstract 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 abstract boolean isInterruptAllowed ()
Podaj status przerwania RunUtil.
Zwroty | |
---|---|
boolean | true, jeśli Run można przerwać, false w przeciwnym razie. |
uruchomCmdInBackground
public abstract 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 |
Rzuca | |
---|---|
| jeśli polecenie nie zostało wykonane |
uruchomCmdInBackground
public abstract 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 |
Rzuca | |
---|---|
| jeśli polecenie nie zostało wykonane |
uruchomCmdInBackground
public abstract 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 |
Rzuca | |
---|---|
| Wyjątek IO |
uruchomCmdInBackground
public abstract 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 |
Rzuca | |
---|---|
| jeśli polecenie nie zostało wykonane |
uruchomCmdInBackground
public abstract 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 |
Rzuca | |
---|---|
| jeśli polecenie nie zostało wykonane |
runEscalatingTimedRetry
public abstract 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 abstract 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 |
Uruchomione w określonym czasie
public abstract 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 abstract 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 abstract 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 abstract 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 |
runTimedCmdSilently
public abstract 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 abstract 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 abstract 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 abstract 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 abstract 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 abstract 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 |
runTimedPonów próbę
public abstract 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. |
ustaw zmienną Env
public abstract void setEnvVariable (String key, String value)
Ustawia zmienną środowiskową, która będzie używana podczas uruchamiania poleceń systemowych.
Parametry | |
---|---|
key | String : nazwa zmiennej |
value | String : wartość zmiennej |
Zobacz też:
setEnvVariablePriority
public abstract 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 abstract 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 abstract 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 abstract 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ć |
Zobacz też:
setWorkingDir
public abstract void setWorkingDir (File dir)
Ustawia katalog roboczy dla poleceń systemowych.
Parametry | |
---|---|
dir | File : katalog roboczy |
Zobacz też:
spać
public abstract 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 abstract void unsetEnvVariable (String key)
Anuluje ustawienie zmiennej środowiskowej, więc polecenia systemowe działają bez tej zmiennej środowiskowej.
Parametry | |
---|---|
key | String : nazwa zmiennej |
Zobacz też:
Treść strony i umieszczone na niej fragmenty kodu podlegają licencjom opisanym w Licencji na treści. Java i OpenJDK są znakami towarowymi lub zastrzeżonymi znakami towarowymi należącymi do firmy Oracle lub jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2023-12-01 UTC.