IrunUtil
public interface IRunUtil
com.android.tradefed.util.IRunUtil |
Interfejs do wykonywania operacji czasowych i poleceń systemowych.
Streszczenie
Klasy zagnieżdżone | |
---|---|
enum | IRunUtil.EnvPriority Wyliczenie określające, czy ustawiać, czy rozbrajać określone środowisko. |
interface | IRunUtil.IRunnableResult Interfejs do asynchronicznego wykonywania operacji, która zwraca stan logiczny. |
Metody publiczne | |
---|---|
abstract void | allowInterrupt (boolean allow) Zezwala/nie zezwala na uruchamianie 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 |
abstract Process | runCmdInBackground (String... command) Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego. |
abstract Process | runCmdInBackground ( command) runCmdInBackground ( command) Alternatywna |
abstract Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) Uruchamianie polecenia z |
abstract Process | runCmdInBackground (Redirect redirect, String... command) Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego. |
abstract boolean | runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokuj i wykonuje operację wiele razy, aż się powiedzie. |
abstract boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Blokuj i wykonuje operację wiele razy, aż się powiedzie. |
abstract CommandStatus | runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors) Blokuje i wykonuje operację, przerywając, jeśli trwa ona dłużej niż określony czas. |
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 | runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command) Metoda pomocnicza do wykonania polecenia systemowego, przerwania, jeśli trwa to dłużej niż określony czas, i przekierowania danych wyjściowych do plików, jeśli jest określony. |
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 do wykonania polecenia systemowego, przerwania, jeśli trwa to dłużej niż określony czas, i przekierowania danych wyjściowych do plików, jeśli jest określony. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command) Metoda pomocnicza do wykonania polecenia systemowego, które wymaga wejścia stdin i przerwania, jeśli trwa to dłużej niż określony czas. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, String... command) Metoda pomocnicza do wykonania polecenia systemowego, które wymaga wejścia stdin i przerwania, 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 trwa to dłużej niż określony czas. |
abstract boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Blokuj i wykonuje operację wiele razy, aż się powiedzie. |
abstract void | setEnvVariable (String key, String value) Ustawia zmienną środowiskową, która ma być używana podczas uruchamiania poleceń systemowych. |
abstract void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) Zdecyduj, czy podczas tworzenia procesu anulowanie ustawienia zmiennej środowiskowej ma wyższy priorytet niż ustawienie ich. |
abstract void | setInterruptibleInFuture (Thread thread, long timeMs) Ustaw jako przerywany po pewnym czasie oczekiwania. |
abstract void | setLinuxInterruptProcess (boolean interrupt) Zezwól na użycie przerwania linux 'kill' w procesie uruchamianym przez metody #runTimed, gdy przekroczy 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 pomocnika spać przez określony czas, ignorując wszelkie wyjątki. |
abstract void | unsetEnvVariable (String key) Anuluje zmienną środowiskową, więc polecenia systemowe są uruchamiane bez tej zmiennej środowiskowej. |
Metody publiczne
zezwól na przerwanie
public abstract void allowInterrupt (boolean allow)
Zezwala/nie zezwala na uruchamianie przerwań w bieżącym wątku. Jeśli jest to dozwolone, uruchomione operacje bieżącego wątku mogą zostać przerwane z innych wątków za pomocą metody interrupt(Thread, String)
.
Parametry | |
---|---|
allow | boolean : czy zezwolić na uruchamianie przerwań w bieżącym wątku. |
przerwać
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiania na danym wątku RunInterruptedException
.
Parametry | |
---|---|
message | String : komunikat dla RunInterruptedException . |
errorId | ErrorIdentifier : reprezentuje przyczynę przerwania, jeśli jest znana. |
przerwać
public abstract void interrupt (Thread thread, String message)
Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiania na danym wątku RunInterruptedException
.
Parametry | |
---|---|
message | String : komunikat dla RunInterruptedException . |
Czy przerwanie jest dozwolone
public abstract boolean isInterruptAllowed ()
Podaj status przerwania RunUtil.
Zwroty | |
---|---|
boolean | prawda, jeśli przebieg można przerwać, w przeciwnym razie fałsz. |
uruchomCmdw tle
public abstract Process runCmdInBackground (Redirect redirect,command)
Alternatywna 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 wykonywanego polecenia |
Rzuty | |
---|---|
| jeśli polecenie nie zostało uruchomione |
uruchomCmdw tle
public abstract Process runCmdInBackground (String... command)
Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego.
Powróci natychmiast po uruchomieniu polecenia.
Parametry | |
---|---|
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
Process | Process wykonywanego polecenia |
Rzuty | |
---|---|
| jeśli polecenie nie zostało uruchomione |
uruchomCmdw tle
public abstract Process runCmdInBackground (command)
Alternatywna 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 wykonywanego polecenia |
Rzuty | |
---|---|
| jeśli polecenie nie zostało uruchomione |
uruchomCmdw tle
public abstract Process runCmdInBackground (command, OutputStream output)
Uruchamianie polecenia z ERROR(/OutputStream)
rejestruje dane wyjściowe polecenia. Stdout i stderr są połączone.
Parametry | |
---|---|
command | |
output | OutputStream : OutputStream do zapisania danych wyjściowych |
Zwroty | |
---|---|
Process | Process uruchamiający polecenie |
uruchomCmdw tle
public abstract Process runCmdInBackground (Redirect redirect, String... command)
Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego.
Powró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 wykonywanego polecenia |
Rzuty | |
---|---|
| jeśli polecenie nie zostało uruchomione |
runEscalatingTimedRetry
public abstract boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuje operację wiele razy, aż się powiedzie.
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 odzyskanie sprawności w przypadku tymczasowego wyłączenia.Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji |
initialPollInterval | long : początkowy czas oczekiwania między próbami operacji |
maxPollInterval | long : maksymalny czas oczekiwania między próbami operacji |
maxTime | long : całkowity przybliżony maksymalny czas na kontynuowanie 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 maxTime |
runFixedTimedRetry
public abstract boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuje operację wiele razy, aż się powiedzie.
Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji |
pollInterval | long : początkowy czas oczekiwania między próbami operacji |
maxTime | long : całkowity przybliżony maksymalny czas na kontynuowanie 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 maxTime |
runTimed
public abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blokuje i wykonuje operację, przerywając, jeśli trwa ona dłużej niż określony czas.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
logErrors | boolean : loguj błędy przy wyjątku lub nie. |
Zwroty | |
---|---|
CommandStatus | wynik operacji CommandStatus . |
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 z uruchomienia polecenia |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza do wykonania polecenia systemowego, przerwania, jeśli trwa to dłużej niż określony czas, i przekierowania danych wyjściowych do plików, jeśli jest określony. Gdy ERROR(/OutputStream)
są dostarczane w ten sposób, pozostaną otwarte 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 dane wyjściowe błędu zostaną przekierowane. Może mieć wartość zerową. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik z uruchomienia polecenia |
runTimedCmdRetry
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 na każdą próbę |
retryInterval | long : czas oczekiwania między kolejnymi próbami polecenia |
attempts | int : maksymalna liczba prób, aby spróbować |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik z 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 nie rejestruje żadnych błędów w przypadku wyjątku.
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 z uruchomienia polecenia |
runTimedCmdSilentlyRetry
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 nie rejestruje żadnych błędów w przypadku wyjątku.
Parametry | |
---|---|
timeout | long : maksymalny czas oczekiwania w ms |
retryInterval | long : czas oczekiwania między kolejnymi próbami polecenia |
attempts | int : maksymalna liczba prób, aby spróbować |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik z uruchomienia polecenia |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Metoda pomocnicza do wykonania polecenia systemowego, przerwania, jeśli trwa to dłużej niż określony czas, i przekierowania danych wyjściowych do plików, jeśli jest określony.
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) gdzie standardowe wyjście zostanie przekierowane. Może mieć wartość zerową. |
stderrFile | File : ERROR(/File) , gdzie wyjście błędu zostanie przekierowane. Może mieć wartość zerową. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik z uruchomienia polecenia |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input,command)
Metoda pomocnicza do wykonania polecenia systemowego, które wymaga wejścia stdin i przerwania, 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 z uruchomienia polecenia |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Metoda pomocnicza do wykonania polecenia systemowego, które wymaga wejścia stdin i przerwania, 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 z 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 trwa to dłużej 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 null, stdin nie zostanie przekierowany. |
command | String : określone polecenie systemowe i opcjonalnie argumenty do exec |
Zwroty | |
---|---|
CommandResult | CommandResult zawierający wynik z uruchomienia polecenia |
runTimedRetry
public abstract boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuje operację wiele razy, aż się powiedzie.
Parametry | |
---|---|
opTimeout | long : maksymalny czas oczekiwania w ms na jedną próbę operacji |
pollInterval | long : czas oczekiwania między kolejnymi próbami polecenia |
attempts | int : maksymalna liczba prób, aby spróbować |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean | true , jeśli operacja zakończyła się pomyślnie przed osiągnięciem prób. |
setEnvVariable
public abstract void setEnvVariable (String key, String value)
Ustawia zmienną środowiskową, która ma być 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 anulowanie ustawienia zmiennej środowiskowej ma wyższy priorytet niż ustawienie ich. Domyślnie rozbrojenie ma wyższy priorytet: co oznacza, że jeśli podjęta zostanie próba ustawienia zmiennej o tej samej nazwie, nie nastąpi to, ponieważ zmienna będzie nieustawiona. Nie można użyć w domyślnym wystąpieniu IRunUtil
.
Parametry | |
---|---|
priority | IRunUtil.EnvPriority |
setPrzerywalnyInFuture
public abstract void setInterruptibleInFuture (Thread thread, long timeMs)
Ustaw jako przerywany po pewnym czasie oczekiwania. ERROR(/CommandScheduler#shutdownHard())
aby wymusić zakończenie działania.
Parametry | |
---|---|
thread | Thread : wątek, który będzie można przerwać. |
timeMs | long : czas oczekiwania przed ustawieniem opcji przerywanej. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Zezwól na użycie przerwania linux 'kill' w procesie uruchamianym przez metody #runTimed, gdy przekroczy limit czasu. Nie można użyć w domyślnym wystąpieniu 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 to fałsz.
Parametry | |
---|---|
redirect | boolean : nowa wartość określająca, czy przekierować, czy nie |
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 pomocnika spać przez określony czas, ignorując wszelkie wyjątki.
Parametry | |
---|---|
time | long : ms spać. wartości mniejsze lub równe 0 będą ignorowane |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
Anuluje zmienną środowiskową, więc polecenia systemowe są uruchamiane 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.
Last updated 2022-08-15 UTC.