Uruchom narzędzie
public
class
RunUtil
extends Object
implements
IRunUtil
java.lang.Object | |
↳ | com.android.tradefed.util.Runutil |
Zbiór metod pomocniczych do wykonywania operacji.
Podsumowanie
Fieldsem | |
---|---|
public
static
final
String |
INHERITIO_PREFIX
|
public
static
final
String |
RUNNABLE_NOTIFIER_NAME
|
Konstruktory publiczne | |
---|---|
RunUtil()
Utwórz nowy obiekt |
Metody publiczne | |
---|---|
void
|
allowInterrupt(boolean allow)
Zezwala lub nie zezwala na przerwy w uruchamianiu 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 lub nadchodzące operacje uruchomienia w danym wątku. |
void
|
interrupt(Thread thread, String message)
Przerywa trwające lub nadchodzące operacje uruchomienia w danym wątku. |
boolean
|
isInterruptAllowed()
Podaj stan przerwy w narzędziu RunUtil. |
Process
|
runCmdInBackground(Redirect redirect,
Alternatywna metoda |
Process
|
runCmdInBackground(
Alternatywna metoda |
Process
|
runCmdInBackground(
Uruchomione polecenie z |
Process
|
runCmdInBackground(String... command)
Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego. |
Process
|
runCmdInBackground(Redirect redirect, String... command)
Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego. |
boolean
|
runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuj daną operację wiele razy, aż się zakończy. |
boolean
|
runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuj daną operację wiele razy, aż się zakończy. |
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuj daną operację wiele razy, aż się zakończy. |
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blokuje i wykonuje operację, przerywając działanie, jeśli trwa dłużej niż określony czas. |
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywana, jeśli trwa to dłużej niż określony czas, i przekierowywanie danych wyjściowych do plików, jeśli jest określona. |
CommandResult
|
runTimedCmd(long timeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, jeśli trwa to dłużej niż określony czas. |
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, 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 wykonywania polecenia systemowego i przerywania, jeśli trwa to dłużej niż określony czas. |
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, jeśli trwa to dłużej niż określony czas. |
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, 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 do wykonywania polecenia systemowego, przerywana, jeśli trwa to dłużej niż określony czas, i przekierowywanie danych wyjściowych do plików, jeśli jest określona. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga danych wejściowych stdin, i przerywania, jeśli trwa to dłużej niż określony czas. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga danych wejściowych stdin, i przerywania, jeśli trwa to dłużej niż określony czas. |
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga przekierowania Stdin z pliku, i przerywania, jeśli trwa to dłużej niż określony czas. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywana, jeśli trwa to dłużej niż określony czas, i przekierowywanie danych wyjściowych do plików, jeśli jest określona. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, jeśli trwa to dłużej niż określony czas. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego z pamięcią podręczną. |
boolean
|
runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuj daną operację wiele razy, aż się zakończy. |
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuj daną operację wiele razy, aż się zakończy. |
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blokuje i wykonuje operację, przerywając działanie, jeśli trwa dłużej niż określony czas. |
void
|
setEnvVariable(String name, String value)
Ustawia zmienną środowiskową używaną do uruchamiania poleceń systemowych. |
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
Zdecyduj, czy podczas tworzenia procesu cofnięcie ustawienia zmiennej środowiskowej ma wyższy priorytet niż samo ustawienie. |
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Ustawiono jako z przerwami po pewnym czasie. |
void
|
setLinuxInterruptProcess(boolean interrupt)
Zezwalaj na przerywanie działania systemu Linux w trakcie procesu realizowanego za pomocą metod #runTimed po osiągnięciu limitu czasu. |
void
|
setRedirectStderrToStdout(boolean redirect)
Ustaw standardowy strumień błędów, tak aby po uruchomieniu poleceń systemowych przekierowywał go do standardowego strumienia wyjściowego. |
void
|
setWorkingDir(File dir)
Ustawia katalog roboczy na polecenia systemowe. |
void
|
sleep(long time)
Metoda pomocnicza zasypiania o określonym czasie, ignorowana. |
void
|
unsetEnvVariable(String key)
Usuwa zmienną środowiskową, więc polecenia systemowe są uruchamiane bez tej zmiennej.
Zmienne środowiskowe mogą dziedziczyć z procesu nadrzędnego, więc musimy usunąć zmienną środowiskową z metody |
Fieldsem
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
NAZWA_POWIADOMIENIA_URUCHAMIANIA
public static final String RUNNABLE_NOTIFIER_NAME
Konstruktory publiczne
Metody publiczne
allowInterrupt
public void allowInterrupt (boolean allow)
Zezwala lub nie zezwala na przerwy w uruchamianiu w bieżącym wątku. Jeśli jest dozwolone, operacje uruchamiania bieżącego wątku można przerwać z innych wątków za pomocą metody interrupt(Thread, String)
.
Parametry | |
---|---|
allow |
boolean : określa, czy zezwolić na przerwy w uruchamianiu w bieżącym wątku. |
getDefault
public static IRunUtil getDefault ()
Uzyskaj odwołanie do domyślnego obiektu RunUtil
.
Jest to przydatne dla osób wywołujących, które chcą używać IRunutil bez dostosowywania.
Zaleca się, aby osoby wywołujące, które potrzebują niestandardowej instancji IRunutil, (np. muszą wywołać metodę setEnvVariable(String, String)
lub setWorkingDir(File)
, utworzą własną kopię.
Zwroty | |
---|---|
IRunUtil |
przerywać
public void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Przerywa trwające lub nadchodzące operacje uruchomienia w danym wątku. Operacje uruchomienia w danym wątku wywołają żądanie RunInterruptedException
.
Parametry | |
---|---|
message |
String : wiadomość dla: RunInterruptedException . |
errorId |
ErrorIdentifier : podaje przyczynę przerwy w działaniu, jeśli jest znana. |
przerywać
public void interrupt (Thread thread, String message)
Przerywa trwające lub nadchodzące operacje uruchomienia w danym wątku. Operacje uruchomienia w danym wątku wywołają żądanie RunInterruptedException
.
Parametry | |
---|---|
message |
String : wiadomość dla: RunInterruptedException . |
Przerwanie jest dozwolone
public boolean isInterruptAllowed ()
Podaj stan przerwy w narzędziu RunUtil.
Zwroty | |
---|---|
boolean |
true (prawda), jeśli uruchomienie można przerwać. W przeciwnym razie ma wartość false (fałsz). |
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) , który ma zostać zastosowany w tabeli ProcessBuilder . |
command |
: pole ERROR(/List) zawierające określone polecenie systemowe i opcjonalnie argumenty do wykonania |
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 |
: pole ERROR(/List) zawierające określone polecenie systemowe i opcjonalnie argumenty do wykonania |
Zwroty | |
---|---|
Process |
Process wykonanego polecenia |
uruchomCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
Uruchomione polecenie z ERROR(/OutputStream)
loguje dane wyjściowe polecenia.
Standardowe stdout i stderr są łączone ze sobą.
Parametry | |
---|---|
command |
: polecenie do uruchomienia, |
output |
OutputStream : strumień wyjściowy, w którym mają być zapisywane dane wyjściowe. |
Zwroty | |
---|---|
Process |
Process wykonujący polecenie |
uruchomCmdInBackground
public Process runCmdInBackground (String... command)
Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego.
Wrócą natychmiast po uruchomieniu polecenia.
Parametry | |
---|---|
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
Process |
Process wykonanego polecenia |
uruchomCmdInBackground
public Process runCmdInBackground (Redirect redirect, String... command)
Metoda pomocnicza do asynchronicznego wykonywania polecenia systemowego.
Wrócą natychmiast po uruchomieniu polecenia.
Parametry | |
---|---|
redirect |
Redirect : ERROR(/Redirect) , który ma zostać zastosowany w tabeli ProcessBuilder . |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
Process |
Process wykonanego polecenia |
runEscalatingTimedPonów
public boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuj daną operację wiele razy, aż się zakończy.
Wykładniczo wydłuż czas oczekiwania między kolejnymi próbami wykonania operacji. Powinien być używany podczas wykonywania operacji takich jak odpytywanie serwera, aby zapewnić mu czas na przywrócenie jego działania w przypadku tymczasowej awarii.
Parametry | |
---|---|
opTimeout |
long : maksymalny czas oczekiwania w ms na jedną próbę wykonania jednej operacji |
initialPollInterval |
long : początkowy czas oczekiwania między kolejnymi próbami wykonania operacji |
maxPollInterval |
long : maksymalny czas oczekiwania między próbami wykonania operacji |
maxTime |
long : przybliżony maksymalny czas wykonywania operacji |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean |
true , jeśli operacja została ukończona przed upływem czasu maxTime |
runFixedTimedPonów
public boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuj daną operację wiele razy, aż się zakończy.
Parametry | |
---|---|
opTimeout |
long : maksymalny czas oczekiwania w ms na jedną próbę wykonania jednej operacji |
pollInterval |
long : początkowy czas oczekiwania między kolejnymi próbami wykonania operacji |
maxTime |
long : przybliżony maksymalny czas wykonywania operacji |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean |
true , jeśli operacja została ukończona przed upływem czasu maxTime |
uruchomStały Czas ponownej próbyZ Monitorem Wyjściowym
public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuj daną operację wiele razy, aż się zakończy. Monitoruje też strumienie wyjściowe pod kątem aktywności i przerywa działanie, jeśli przez określony czas nie jest zaobserwowana żadna aktywność. Jeśli parametr idleOutputTimeout ma wartość 0, monitorowanie strumienia nie jest wykonywane.
Parametry | |
---|---|
opTimeout |
long : maksymalny czas oczekiwania w ms na jedną próbę wykonania jednej operacji |
idleOutputTimeout |
long : maksymalny czas oczekiwania (w ms) na sygnał wyjściowy w strumieniach wyjściowych |
pollInterval |
long : początkowy czas oczekiwania między kolejnymi próbami wykonania operacji |
maxTime |
long : przybliżony maksymalny czas wykonywania operacji |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
Zwroty | |
---|---|
boolean |
true , jeśli operacja została ukończona przed upływem czasu maxTime |
czas wykonywania
public CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blokuje i wykonuje operację, przerywając działanie, 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 : błędy w logu dotyczące wyjątków. |
Zwroty | |
---|---|
CommandStatus |
wynik operacji CommandStatus . |
runTimedCmd
public CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywana, jeśli trwa to dłużej niż określony czas, i przekierowywanie danych wyjściowych do plików, jeśli jest określona. Jeśli pola ERROR(/OutputStream)
zostaną podane w ten sposób, na końcu funkcji pozostaną otwarte.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania (w ms). Wartość 0 oznacza brak limitu czasu. |
stdout |
OutputStream : ERROR(/OutputStream) , do którego zostaną przekierowane standardowe dane wyjściowe. Może mieć wartość null. |
stderr |
OutputStream : ERROR(/OutputStream) , gdzie zostaną przekierowane dane wyjściowe błędu. Może mieć wartość null. |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
runTimedCmd
public CommandResult runTimedCmd (long timeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania w ms, a 0 oznacza brak limitu czasu. |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
runTimedCmdPonów próbę
public CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania (w ms) dla każdej próby |
retryInterval |
long : czas oczekiwania między kolejnymi próbami polecenia |
attempts |
int : maksymalna liczba prób |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
RunTimedCmdPonowna próbaZ użyciem Monitora Wyjściowego
public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, jeśli trwa to 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 jest zaobserwowana żadna aktywność. Jeśli parametr idleOutputTimeout ma wartość 0, monitorowanie strumienia nie będzie działać.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania (w ms) dla każdej próby |
idleOutputTimeout |
long : maksymalny czas oczekiwania (w ms) na sygnał wyjściowy w strumieniach wyjściowych |
retryInterval |
long : czas oczekiwania między kolejnymi próbami polecenia |
attempts |
int : maksymalna liczba prób |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
UruchomTimedCmdCicha bez dźwięku
public CommandResult runTimedCmdSilently (long timeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, jeśli trwa to dłużej niż określony czas. Podobny do runTimedCmd(long, String)
, ale nie rejestruje żadnych błędów w wyjątku.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania w ms |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
RunTimedCmdCimna próba cichego ponowienia
public CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, 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 dotyczących 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 |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
RunTimedCmdz danymi wejściowymi
public CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywana, jeśli trwa to dłużej niż określony czas, i przekierowywanie danych wyjściowych do plików, jeśli jest określona.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania (w ms). Wartość 0 oznacza brak limitu czasu. |
input |
String : dane standardowe, które mają zostać przetworzone |
stdoutFile |
File : ERROR(/File) , do którego zostaną przekierowane standardowe dane wyjściowe. Może mieć wartość null. |
stderrFile |
File : ERROR(/File) , gdzie zostaną przekierowane dane wyjściowe błędu. Może mieć wartość null. |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
RunTimedCmdz danymi wejściowymi
public CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga danych wejściowych stdin, i przerywania, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania w ms |
input |
String : dane standardowe, które mają zostać przetworzone |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
RunTimedCmdz danymi wejściowymi
public CommandResult runTimedCmdWithInput (long timeout, String input,command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga danych wejściowych stdin, i przerywania, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania w ms |
input |
String : dane standardowe, które mają zostać przetworzone |
command |
: ERROR(/List) zawierający polecenie systemowe i opcjonalnie argumenty do wykonania |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
RunTimedCmdWithInputRedirect
public CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, które wymaga przekierowania Stdin z pliku, i przerywania, jeśli trwa to dłużej niż określony czas.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania w ms |
inputRedirect |
File : element ERROR(/File) , który ma przekierowywać jako standardowe dane wejściowe za pomocą funkcji ProcessBuilder.redirectInput() . Jeśli ma wartość null, stdin nie jest przekierowywany. |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
RunTimedCmdzMonitorem wyjściowym
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego, przerywana, jeśli trwa to dłużej niż określony czas, i przekierowywanie danych wyjściowych do plików, jeśli jest określona. Jeśli pola ERROR(/OutputStream)
zostaną podane w ten sposób, na końcu funkcji pozostaną otwarte.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania (w ms). Wartość 0 oznacza brak limitu czasu. |
idleOutputTimeout |
long : maksymalny czas oczekiwania (w ms) na sygnał wyjściowy w strumieniach wyjściowych |
stdout |
OutputStream : ERROR(/OutputStream) , do którego zostaną przekierowane standardowe dane wyjściowe. Może mieć wartość null. |
stderr |
OutputStream : ERROR(/OutputStream) , gdzie zostaną przekierowane dane wyjściowe błędu. Może mieć wartość null. |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
RunTimedCmdzMonitorem wyjściowym
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego i przerywania, jeśli trwa to 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 jest zaobserwowana żadna aktywność. Jeśli parametr idleOutputTimeout ma wartość 0, monitorowanie strumienia nie będzie działać.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania w ms, a 0 oznacza brak limitu czasu. |
idleOutputTimeout |
long : maksymalny czas oczekiwania (w ms) na sygnał wyjściowy w strumieniach wyjściowych |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
pole CommandResult zawierające wynik działania polecenia |
RunTimedCmdzMonitorem wyjściowym
public CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
Metoda pomocnicza do wykonywania polecenia systemowego z pamięcią podręczną.
Jeśli określisz cacheClient
, buforowanie zostanie włączone. Jeśli pamięć podręczna jest dostępna, zostanie zwrócony wynik z pamięci podręcznej. W przeciwnym razie do wykonania polecenia zostanie użyty runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String)
, a wynik zostanie przesłany do buforowania.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania (w ms). Wartość 0 oznacza brak limitu czasu. |
idleOutputTimeout |
long : maksymalny czas oczekiwania (w ms) na pojawienie się danych wyjściowych ze strumieni wyjściowych. |
stdout |
OutputStream : ERROR(/OutputStream) , do którego zostaną przekierowane standardowe dane wyjściowe. Może mieć wartość null. |
stderr |
OutputStream : ERROR(/OutputStream) , gdzie zostaną przekierowane dane wyjściowe błędu. Może mieć wartość null. |
cacheClient |
ICacheClient : instancja instancji ICacheClient używana do obsługi buforowania. |
command |
String : podane polecenie systemowe i opcjonalnie argumenty do wykonania. |
Zwroty | |
---|---|
CommandResult |
CommandResult zawierający wynik działania polecenia. |
runTimedPonów
public boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuj daną operację wiele razy, aż się zakończy.
Parametry | |
---|---|
opTimeout |
long : maksymalny czas oczekiwania w ms na 1 próbę operacji |
pollInterval |
long : czas oczekiwania między kolejnymi próbami 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 prób. |
uruchom
public boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Blokuj i wykonuj daną operację wiele razy, aż się zakończy. Monitoruje też strumienie wyjściowe pod kątem aktywności i przerywa działanie, jeśli przez określony czas nie jest zaobserwowana żadna aktywność. Jeśli parametr idleOutputTimeout ma wartość 0, monitorowanie strumienia nie jest wykonywane.
Parametry | |
---|---|
opTimeout |
long : maksymalny czas oczekiwania w ms na 1 próbę operacji |
idleOutputTimeout |
long : maksymalny czas oczekiwania (w ms) na sygnał wyjściowy w strumieniach wyjściowych |
pollInterval |
long : czas oczekiwania między kolejnymi próbami 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 prób. |
Czas uruchomienia z monitorem danych wyjściowych
public CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Blokuje i wykonuje operację, przerywając działanie, 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 jest zaobserwowana żadna aktywność. Jeśli parametr idleOutputTimeout ma wartość 0, monitorowanie strumienia nie jest wykonywane.
Parametry | |
---|---|
timeout |
long : maksymalny czas oczekiwania w ms |
idleOutputTimeout |
long : maksymalny czas oczekiwania (w ms) na sygnał wyjściowy w strumieniach wyjściowych |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania |
logErrors |
boolean : błędy w logu dotyczące wyjątków. |
Zwroty | |
---|---|
CommandStatus |
wynik operacji CommandStatus . |
setEnvZmienna
public void setEnvVariable (String name, String value)
Ustawia zmienną środowiskową używaną do uruchamiania poleceń systemowych.
Parametry | |
---|---|
name |
String : nazwa zmiennej |
value |
String : wartość zmiennej |
setEnvZmiennePriority (Priorytet zmiennej)
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Zdecyduj, czy podczas tworzenia procesu cofnięcie ustawienia zmiennej środowiskowej ma wyższy priorytet niż samo ustawienie.
Domyślnie anulowanie ustawienia ma wyższy priorytet, co oznacza, że próba ustawienia zmiennej o tej samej nazwie nie powiedzie się, ponieważ zmienna jest nieskonfigurowana.
Nie można go używać w domyślnej instancji IRunUtil
.
Parametry | |
---|---|
priority |
IRunUtil.EnvPriority |
W przyszłości
public void setInterruptibleInFuture (Thread thread, long timeMs)
Ustawiono jako z przerwami po pewnym czasie.
ERROR(/CommandScheduler#shutdownHard())
, aby wyegzekwować, w końcu nastąpi zamknięcie.
Parametry | |
---|---|
thread |
Thread : wątek, który zostanie przerwany. |
timeMs |
long : czas oczekiwania przed ustawieniem trybu przerywanego. |
setLinuxInterruptProcess
public void setLinuxInterruptProcess (boolean interrupt)
Zezwalaj na przerywanie działania systemu Linux w trakcie procesu realizowanego za pomocą metod #runTimed po osiągnięciu limitu czasu.
Nie można go używać w domyślnej instancji IRunUtil
.
Parametry | |
---|---|
interrupt |
boolean |
ustawPrzekierowanieStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
Ustaw standardowy strumień błędów, tak aby po uruchomieniu poleceń systemowych przekierowywał go do standardowego strumienia wyjściowego. Początkowa wartość to false (fałsz).
Parametry | |
---|---|
redirect |
boolean : nowa wartość przekierowania |
setWorkingDir
public void setWorkingDir (File dir)
Ustawia katalog roboczy na polecenia systemowe.
Parametry | |
---|---|
dir |
File : katalog roboczy |
do spania
public void sleep (long time)
Metoda pomocnicza zasypiania o określonym czasie, ignorowana.
Parametry | |
---|---|
time |
long : ms do uśpienia. Wartości mniejsze lub równe 0 będą ignorowane. |
nieskonfigurowanaZmienna środowiska
public void unsetEnvVariable (String key)
Usuwa zmienną środowiskową, więc polecenia systemowe są uruchamiane bez tej zmiennej.
Zmienne środowiskowe mogą dziedziczyć z procesu nadrzędnego, więc musimy usunąć zmienną środowiskową z metody ProcessBuilder.environment()
.
Parametry | |
---|---|
key |
String : nazwa zmiennej |
Zobacz też: