IRunUtil
public
interface
IRunUtil
| com.android.tradefed.util.IRunUtil |
Interfejs do uruchamiania operacji czasowych i poleceń systemowych.
Podsumowanie
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 na przerywanie działania bieżącego wątku lub nie zezwala na nie. |
abstract
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
Przerywa trwające lub nadchodzące operacje uruchamiania w danym wątku. |
abstract
void
|
interrupt(Thread thread, String message)
Przerywa trwające lub nadchodzące operacje uruchamiania w danym wątku. |
abstract
boolean
|
isInterruptAllowed()
Zwraca stan przerwania RunUtil. |
abstract
Process
|
runCmdInBackground(ProcessBuilder.Redirect redirect, List<String> command)
Alternatywna metoda |
abstract
Process
|
runCmdInBackground(ProcessBuilder.Redirect redirect, String... command)
Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego. |
abstract
Process
|
runCmdInBackground(List<String> command)
Alternatywna metoda |
abstract
Process
|
runCmdInBackground(String... command)
Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego. |
abstract
Process
|
runCmdInBackground(List<String> command, OutputStream output)
Uruchom polecenie z parametrem |
abstract
boolean
|
runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wielokrotnie, dopóki nie zakończy się ona powodzeniem. |
abstract
boolean
|
runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wielokrotnie, dopóki nie zakończy się ona powodzeniem. |
abstract
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wielokrotnie, dopóki nie zakończy się ona powodzeniem. |
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, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas. |
abstract
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywania działania, jeśli trwa ono dłużej niż określony czas, i przekierowywania danych wyjściowych do plików (jeśli jest to określone). |
abstract
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas. |
abstract
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas. |
abstract
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas. |
abstract
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga danych wejściowych stdin, i przerywania działania, jeśli trwa dłużej niż określony czas. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, List<String> command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga danych wejściowych stdin, i przerywania działania, jeśli trwa dłużej niż określony czas. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywania działania, jeśli trwa ono dłużej niż określony czas, i przekierowywania danych wyjściowych do plików (jeśli jest to określone). |
abstract
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga przekierowania Stdin z pliku i przerwania działania, jeśli trwa dłużej niż określony czas. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywania działania, jeśli trwa ono dłużej niż określony czas, i przekierowywania danych wyjściowych do plików (jeśli jest to określone). |
abstract
boolean
|
runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wielokrotnie, dopóki nie zakończy się ona powodzeniem. |
abstract
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuje i wykonuje operację wielokrotnie, dopóki nie zakończy się ona powodzeniem. |
abstract
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. |
abstract
void
|
setEnvVariable(String key, String value)
Ustawia zmienną środowiskową, która będzie używana podczas wykonywania poleceń systemowych. |
abstract
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
Określ, czy podczas tworzenia procesu wyłączenie 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 „kill” w systemie Linux w przypadku procesu uruchomionego za pomocą metod #runTimed, gdy osiągnie on limit czasu. |
abstract
void
|
setRedirectStderrToStdout(boolean redirect)
Ustaw standardowy strumień błędów tak, aby podczas wykonywania poleceń systemowych przekierowywał dane do standardowego strumienia wyjściowego. |
abstract
void
|
setWorkingDir(File dir)
Ustawia katalog roboczy dla poleceń systemowych. |
abstract
void
|
sleep(long time)
Metoda pomocnicza do spania przez określony czas z ignorowaniem wyjątków. |
abstract
void
|
unsetEnvVariable(String key)
Usuwa zmienną środowiskową, dzięki czemu polecenia systemowe są uruchamiane bez tej zmiennej. |
Metody publiczne
allowInterrupt
public abstract void allowInterrupt (boolean allow)
Zezwala na przerywanie działania bieżącego wątku lub nie zezwala na nie. 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 zezwalać na przerwanie uruchomienia w bieżącym wątku. |
przerwać,
public abstract void interrupt (Thread thread,
String message,
ErrorIdentifier errorId)Przerywa trwające lub nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiane w danym wątku będą zgłaszać wyjątek RunInterruptedException.
| Parametry | |
|---|---|
message |
String: wiadomość dotycząca: RunInterruptedException. |
errorId |
ErrorIdentifier: reprezentuje przyczynę przerwy, jeśli jest znana. |
przerwać,
public abstract void interrupt (Thread thread,
String message)Przerywa trwające lub nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiane w danym wątku będą zgłaszać wyjątek RunInterruptedException.
| Parametry | |
|---|---|
message |
String: wiadomość dotycząca: RunInterruptedException. |
isInterruptAllowed
public abstract boolean isInterruptAllowed ()
Zwraca stan przerwania RunUtil.
| Zwraca | |
|---|---|
boolean |
Wartość true, jeśli działanie można przerwać. W przeciwnym razie wartość false. |
runCmdInBackground
public abstract Process runCmdInBackground (ProcessBuilder.Redirect redirect,
List<String> command)Alternatywna metoda runCmdInBackground(String...), która akceptuje argumenty polecenia w formie List.
| Parametry | |
|---|---|
redirect |
ProcessBuilder.Redirect: Redirect, które ma zostać zastosowane do ProcessBuilder. |
command |
List: List zawierający określone polecenie systemowe i opcjonalnie argumenty
do wykonania |
| Zwraca | |
|---|---|
Process |
Process wykonanego polecenia, |
| Zgłasza | |
|---|---|
IOException |
jeśli nie udało się uruchomić polecenia. |
runCmdInBackground
public abstract Process runCmdInBackground (ProcessBuilder.Redirect redirect,
String... command)Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego.
Zwraca wartość natychmiast po uruchomieniu polecenia.
| Parametry | |
|---|---|
redirect |
ProcessBuilder.Redirect: Redirect, które ma zostać zastosowane do ProcessBuilder. |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
Process |
Process wykonanego polecenia, |
| Zgłasza | |
|---|---|
IOException |
jeśli nie udało się uruchomić polecenia. |
runCmdInBackground
public abstract Process runCmdInBackground (List<String> command)
Alternatywna metoda runCmdInBackground(String...), która akceptuje argumenty polecenia w formie List.
| Parametry | |
|---|---|
command |
List: List zawierający określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
Process |
Process wykonanego polecenia, |
| Zgłasza | |
|---|---|
IOException |
jeśli nie udało się uruchomić polecenia. |
runCmdInBackground
public abstract Process runCmdInBackground (String... command)
Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego.
Zwraca wartość natychmiast po uruchomieniu polecenia.
| Parametry | |
|---|---|
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
Process |
Process wykonanego polecenia, |
| Zgłasza | |
|---|---|
IOException |
jeśli nie udało się uruchomić polecenia. |
runCmdInBackground
public abstract Process runCmdInBackground (List<String> command,
OutputStream output)Uruchom polecenie z parametrem OutputStream, aby zarejestrować dane wyjściowe polecenia.
Stdout i stderr są scalane.
| Parametry | |
|---|---|
command |
List: polecenie do uruchomienia |
output |
OutputStream: OutputStream do zapisania danych wyjściowych. |
| Zwraca | |
|---|---|
Process |
Process uruchamiający polecenie, |
| Zgłasza | |
|---|---|
|
java.io.IOException |
IOException |
|
runEscalatingTimedRetry
public abstract boolean runEscalatingTimedRetry (long opTimeout,
long initialPollInterval,
long maxPollInterval,
long maxTime,
IRunUtil.IRunnableResult runnable)Blokuje i wykonuje operację wielokrotnie, dopóki nie zakończy się ona powodzeniem.
Wykładniczo zwiększaj czas oczekiwania między próbami operacji. Jest to przydatne podczas wykonywania operacji takich jak odpytywanie serwera, aby dać mu czas na przywrócenie działania w przypadku tymczasowej awarii.
| Parametry | |
|---|---|
opTimeout |
long: maksymalny czas oczekiwania w milisekundach 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: łączny przybliżony maksymalny czas ponawiania próby wykonania operacji. |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult do wykonania |
| Zwraca | |
|---|---|
boolean |
true, jeśli operacja została ukończona przed upływem maksymalnego czasu |
runFixedTimedRetry
public abstract boolean runFixedTimedRetry (long opTimeout,
long pollInterval,
long maxTime,
IRunUtil.IRunnableResult runnable)Blokuje i wykonuje operację wielokrotnie, dopóki nie zakończy się ona powodzeniem.
| Parametry | |
|---|---|
opTimeout |
long: maksymalny czas oczekiwania w milisekundach na pojedynczą próbę operacji. |
pollInterval |
long: początkowy czas oczekiwania między próbami operacji |
maxTime |
long: łączny przybliżony maksymalny czas ponawiania próby wykonania operacji. |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult do wykonania |
| Zwraca | |
|---|---|
boolean |
true, jeśli operacja została ukończona przed upływem maksymalnego czasu |
runFixedTimedRetryWithOutputMonitor
public abstract boolean runFixedTimedRetryWithOutputMonitor (long opTimeout,
long idleOutputTimeout,
long pollInterval,
long maxTime,
IRunUtil.IRunnableResult runnable)Blokuje i wykonuje operację wielokrotnie, dopóki nie zakończy się ona powodzeniem. Monitoruje też strumienie wyjściowe pod kątem aktywności i przerywa działanie, jeśli przez określony czas nie wykryje żadnej aktywności. Jeśli wartość idleOutputTimeout jest ustawiona na zero, monitorowanie strumienia nie będzie się odbywać.
| Parametry | |
|---|---|
opTimeout |
long: maksymalny czas oczekiwania w milisekundach na pojedynczą próbę operacji. |
idleOutputTimeout |
long: maksymalny czas oczekiwania w milisekundach na dane wyjściowe w strumieniach wyjściowych. |
pollInterval |
long: początkowy czas oczekiwania między próbami operacji |
maxTime |
long: łączny przybliżony maksymalny czas ponawiania próby wykonania operacji. |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult do wykonania |
| Zwraca | |
|---|---|
boolean |
true, jeśli operacja została ukończona przed upływem maksymalnego czasu |
runTimed
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 milisekundach |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult do wykonania |
logErrors |
boolean: czy rejestrować błędy w przypadku wyjątku. |
| Zwraca | |
|---|---|
CommandStatus |
CommandStatuswynik operacji. |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach. 0 oznacza brak limitu czasu. |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywania działania, jeśli trwa ono dłużej niż określony czas, i przekierowywania danych wyjściowych do plików (jeśli jest to określone). Jeśli OutputStream są podawane w ten sposób, po zakończeniu funkcji pozostaną otwarte.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach. 0 oznacza brak limitu czasu. |
stdout |
OutputStream: OutputStream miejsce, do którego zostanie przekierowane standardowe wyjście. Może mieć wartość null. |
stderr |
OutputStream: OutputStream miejsce przekierowania danych wyjściowych błędu. Może mieć wartość null. |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmdRetry
public abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach dla każdej próby. |
retryInterval |
long: czas oczekiwania między ponownymi próbami wykonania polecenia |
attempts |
int: maksymalna liczba prób |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmdRetryWithOutputMonitor
public abstract CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas. Monitoruje też strumienie wyjściowe pod kątem aktywności i przerywa działanie, jeśli przez określony czas nie wykryje żadnej aktywności. Jeśli wartość idleOutputTimeout jest ustawiona na 0, monitorowanie strumienia nie będzie się odbywać.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach dla każdej próby. |
idleOutputTimeout |
long: maksymalny czas oczekiwania w milisekundach na dane wyjściowe w strumieniach wyjściowych. |
retryInterval |
long: czas oczekiwania między ponownymi próbami wykonania polecenia |
attempts |
int: maksymalna liczba prób |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmdSilently
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas. Podobne do runTimedCmd(long,String...), ale nie rejestruje żadnych błędów w przypadku wyjątku.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmdSilentlyRetry
public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas. Podobne do runTimedCmdRetry(long,long,int,String[]), ale nie rejestruje żadnych błędów w przypadku wyjątku.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach |
retryInterval |
long: czas oczekiwania między ponownymi próbami wykonania polecenia |
attempts |
int: maksymalna liczba prób |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga danych wejściowych stdin, i przerywania działania, jeśli trwa dłużej niż określony czas.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach |
input |
String: dane wejściowe stdin do przekazania do procesu |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, List<String> command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga danych wejściowych stdin, i przerywania działania, jeśli trwa dłużej niż określony czas.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach |
input |
String: dane wejściowe stdin do przekazania do procesu |
command |
List: List zawierający polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywania działania, jeśli trwa ono dłużej niż określony czas, i przekierowywania danych wyjściowych do plików (jeśli jest to określone).
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach. 0 oznacza brak limitu czasu. |
input |
String: dane wejściowe stdin do przekazania do procesu |
stdoutFile |
File: File miejsce, do którego zostanie przekierowane standardowe wyjście. Może mieć wartość null. |
stderrFile |
File: File miejsce przekierowania danych wyjściowych błędu. Może mieć wartość null. |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmdWithInputRedirect
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga przekierowania Stdin z pliku i przerwania działania, jeśli trwa dłużej niż określony czas.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach |
inputRedirect |
File: File do przekierowania jako standardowe dane wejściowe za pomocą ProcessBuilder.redirectInput(). Jeśli wartość to null, stdin nie zostanie przekierowany. |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania go, jeśli trwa dłużej niż określony czas. Monitoruje też strumienie wyjściowe pod kątem aktywności i przerywa działanie, jeśli przez określony czas nie wykryje żadnej aktywności. Jeśli wartość idleOutputTimeout jest ustawiona na 0, monitorowanie strumienia nie będzie się odbywać.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach. 0 oznacza brak limitu czasu. |
idleOutputTimeout |
long: maksymalny czas oczekiwania w milisekundach na dane wyjściowe w strumieniach wyjściowych. |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywania działania, jeśli trwa ono dłużej niż określony czas, i przekierowywania danych wyjściowych do plików (jeśli jest to określone). Jeśli OutputStream są podawane w ten sposób, po zakończeniu funkcji pozostaną otwarte.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach. 0 oznacza brak limitu czasu. |
idleOutputTimeout |
long: maksymalny czas oczekiwania w milisekundach na dane wyjściowe w strumieniach wyjściowych. |
stdout |
OutputStream: OutputStream miejsce, do którego zostanie przekierowane standardowe wyjście. Może mieć wartość null. |
stderr |
OutputStream: OutputStream miejsce przekierowania danych wyjściowych błędu. Może mieć wartość null. |
command |
String: określone polecenie systemowe i opcjonalnie argumenty do wykonania |
| Zwraca | |
|---|---|
CommandResult |
CommandResult zawierający wynik uruchomionego polecenia. |
runTimedRetry
public abstract boolean runTimedRetry (long opTimeout,
long pollInterval,
int attempts,
IRunUtil.IRunnableResult runnable)Blokuje i wykonuje operację wielokrotnie, dopóki nie zakończy się ona powodzeniem.
| Parametry | |
|---|---|
opTimeout |
long: maksymalny czas oczekiwania w milisekundach na jedną próbę operacji |
pollInterval |
long: czas oczekiwania między ponownymi próbami wykonania polecenia |
attempts |
int: maksymalna liczba prób |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult do wykonania |
| Zwraca | |
|---|---|
boolean |
true, jeśli operacja została ukończona przed osiągnięciem limitu prób. |
runTimedRetryWithOutputMonitor
public abstract boolean runTimedRetryWithOutputMonitor (long opTimeout,
long idleOutputTimeout,
long pollInterval,
int attempts,
IRunUtil.IRunnableResult runnable)Blokuje i wykonuje operację wielokrotnie, dopóki nie zakończy się ona powodzeniem. Monitoruje też strumienie wyjściowe pod kątem aktywności i przerywa działanie, jeśli przez określony czas nie wykryje żadnej aktywności. Jeśli wartość idleOutputTimeout jest ustawiona na zero, monitorowanie strumienia nie będzie się odbywać.
| Parametry | |
|---|---|
opTimeout |
long: maksymalny czas oczekiwania w milisekundach na jedną próbę operacji |
idleOutputTimeout |
long: maksymalny czas oczekiwania w milisekundach na dane wyjściowe w strumieniach wyjściowych. |
pollInterval |
long: czas oczekiwania między ponownymi próbami wykonania polecenia |
attempts |
int: maksymalna liczba prób |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult do wykonania |
| Zwraca | |
|---|---|
boolean |
true, jeśli operacja została ukończona przed osiągnięciem limitu prób. |
runTimedWithOutputMonitor
public abstract 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 też strumienie wyjściowe pod kątem aktywności i przerywa działanie, jeśli przez określony czas nie zaobserwuje żadnej aktywności w strumieniu. Jeśli wartość idleOutputTimeout jest ustawiona na zero, monitorowanie strumienia nie będzie się odbywać.
| Parametry | |
|---|---|
timeout |
long: maksymalny czas oczekiwania w milisekundach |
idleOutputTimeout |
long: maksymalny czas oczekiwania w milisekundach na dane wyjściowe w strumieniach wyjściowych. |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult do wykonania |
logErrors |
boolean: czy rejestrować błędy w przypadku wyjątku. |
| Zwraca | |
|---|---|
CommandStatus |
CommandStatuswynik operacji. |
setEnvVariable
public abstract void setEnvVariable (String key,
String value)Ustawia zmienną środowiskową, która będzie używana podczas wykonywania poleceń systemowych.
| Parametry | |
|---|---|
key |
String: nazwa zmiennej; |
value |
String: wartość zmiennej, |
Zobacz też:
setEnvVariablePriority
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Określ, czy podczas tworzenia procesu wyłączenie zmiennej środowiskowej ma wyższy priorytet niż jej ustawienie.
Domyślnie wyższy priorytet ma usunięcie ustawienia, co oznacza, że jeśli podjęta zostanie próba ustawienia zmiennej o tej samej nazwie, nie powiedzie się ona, ponieważ zmienna zostanie usunięta.
Nie można go używać w przypadku 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ć ostateczne zakończenie.
| Parametry | |
|---|---|
thread |
Thread: wątek, który będzie można przerwać. |
timeMs |
long: czas oczekiwania przed ustawieniem stanu przerywalności. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Zezwalaj na używanie przerwania „kill” w systemie Linux w przypadku procesu uruchomionego za pomocą metod #runTimed, gdy osiągnie on limit czasu.
Nie można go używać w przypadku domyślnej instancji IRunUtil.
| Parametry | |
|---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
Ustaw standardowy strumień błędów tak, aby podczas wykonywania poleceń systemowych przekierowywał dane do standardowego strumienia wyjściowego. Wartość początkowa to fałsz.
| Parametry | |
|---|---|
redirect |
boolean: nowa wartość określająca, czy przekierowanie ma nastąpić |
Zobacz też:
setWorkingDir
public abstract void setWorkingDir (File dir)
Ustawia katalog roboczy dla poleceń systemowych.
| Parametry | |
|---|---|
dir |
File: katalog roboczy |
Zobacz też:
do spania
public abstract void sleep (long time)
Metoda pomocnicza do spania przez określony czas z ignorowaniem wyjątków.
| Parametry | |
|---|---|
time |
long: ms do zaśnięcia. Wartości mniejsze lub równe 0 będą ignorowane. |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
Usuwa zmienną środowiskową, dzięki czemu polecenia systemowe są uruchamiane bez tej zmiennej.
| Parametry | |
|---|---|
key |
String: nazwa zmiennej; |
Zobacz też: