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 runCmdInBackground(String) , która akceptuje argumenty polecenia w postaci ERROR(/List) .

abstract Process runCmdInBackground (String... command)

Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego.

abstract Process runCmdInBackground ( command) runCmdInBackground ( command)

Alternatywna runCmdInBackground(String) , która akceptuje argumenty polecenia w postaci ERROR(/List) .

abstract Process runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output)

Uruchamianie polecenia z ERROR(/OutputStream) rejestruje dane wyjściowe polecenia.

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 : polecenie do uruchomienia

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

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

setWorkingDir

public abstract void setWorkingDir (File dir)

Ustawia katalog roboczy dla poleceń systemowych.

Parametry
dir File : katalog roboczy

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