UruchomUtil

public class RunUtil
extends Object implements IRunUtil

Obiekt Java.lang.Object
com.android.tradefed.util.RunUtil


Zbiór metod pomocniczych do wykonywania operacji.

Streszczenie

Pola

public static final String INHERITIO_PREFIX

public static final String RUNNABLE_NOTIFIER_NAME

Konstruktorzy publiczni

RunUtil ()

Utwórz nowy obiekt RunUtil do użycia.

Metody publiczne

void allowInterrupt (boolean allow)

Zezwala/zabrania wykonywania przerwań w bieżącym wątku.

static IRunUtil getDefault ()

Uzyskaj odwołanie do domyślnego obiektu RunUtil .

void interrupt (Thread thread, String message, ErrorIdentifier errorId)

Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku.

void interrupt (Thread thread, String message)

Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku.

boolean isInterruptAllowed ()

Podaj status przerwania RunUtil.

Process runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command)

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

Process runCmdInBackground ( command) runCmdInBackground ( command)

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

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

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

Process runCmdInBackground (String... command)

Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.

Process runCmdInBackground (Redirect redirect, String... command)

Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.

boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

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.

CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono.

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.

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.

CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, 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.

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.

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.

CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono.

CommandResult runTimedCmdWithInput (long timeout, String input, String... command)

Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.

CommandResult runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command)

Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.

CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)

Metoda pomocnicza do wykonania polecenia systemowego, które wymaga przekierowania Stdin z pliku i przerwania, jeśli zajmie to więcej czasu niż określony czas.

CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono.

CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas.

boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

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.

void setEnvVariable (String name, String value)

Ustawia zmienną środowiskową, która będzie używana podczas uruchamiania poleceń systemowych.

void setEnvVariablePriority ( IRunUtil.EnvPriority priority)

Zdecyduj, czy podczas tworzenia procesu rozbrojenie zmiennej środowiskowej ma wyższy priorytet niż jej ustawienie.

void setInterruptibleInFuture (Thread thread, long timeMs)

Ustaw jako przerywalne po pewnym czasie oczekiwania.

void setLinuxInterruptProcess (boolean interrupt)

Zezwalaj na używanie przerwania „zabicia” systemu Linux w procesie uruchamianym metodami #runTimed, gdy osiągnie limit czasu.

void setRedirectStderrToStdout (boolean redirect)

Ustaw standardowy strumień błędów, aby przekierowywał do standardowego strumienia wyjściowego podczas uruchamiania poleceń systemowych.

void setWorkingDir (File dir)

Ustawia katalog roboczy dla poleceń systemowych.

void sleep (long time)

Metoda pomocnicza usypiająca przez określony czas, ignorująca wszelkie wyjątki.

void unsetEnvVariable (String key)

Anuluje ustawienie zmiennej środowiskowej, więc polecenia systemowe działają bez tej zmiennej środowiskowej. Zmienne środowiskowe mogą dziedziczyć z procesu nadrzędnego, dlatego musimy usunąć zmienną środowiskową z ProcessBuilder.environment()

Pola

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

Konstruktorzy publiczni

UruchomUtil

public RunUtil ()

Utwórz nowy obiekt RunUtil do użycia.

Metody publiczne

zezwól na przerwanie

public void allowInterrupt (boolean allow)

Zezwala/zabrania wykonywania przerwań w bieżącym wątku. Jeśli jest to dozwolone, operacje bieżącego wątku można przerwać z innych wątków za pomocą metody interrupt(Thread, String) .

Parametry
allow boolean : czy zezwolić na wykonywanie przerwań w bieżącym wątku.

pobierz domyślny

public static IRunUtil getDefault ()

Uzyskaj odwołanie do domyślnego obiektu RunUtil .

Jest to przydatne dla osób dzwoniących, które chcą używać IRunUtil bez dostosowywania. Zaleca się, aby osoby wywołujące, które potrzebują niestandardowej instancji IRunUtil (tzn. muszą wywołać setEnvVariable(String, String) lub setWorkingDir(File) utworzyły własną kopię.

Zwroty
IRunUtil

przerywać

public void interrupt (Thread thread, 
                String message, 
                ErrorIdentifier errorId)

Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiania w danym wątku zgłoszą RunInterruptedException .

Parametry
message String : komunikat dotyczący RunInterruptedException .

errorId ErrorIdentifier : Reprezentuje przyczynę przerwania, jeśli jest znana.

przerywać

public void interrupt (Thread thread, 
                String message)

Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiania w danym wątku zgłoszą RunInterruptedException .

Parametry
message String : komunikat dotyczący RunInterruptedException .

isInterruptAllowed

public boolean isInterruptAllowed ()

Podaj status przerwania RunUtil.

Zwroty
boolean true, jeśli Run można przerwać, false w przeciwnym razie.

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) do zastosowania do ProcessBuilder .

command : ERROR(/List) zawierający określone polecenie systemowe i opcjonalnie argumenty do exec

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 : ERROR(/List) zawierający określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
Process Process wykonanego polecenia

uruchomCmdInBackground

public Process runCmdInBackground ( command, 
                OutputStream output)

Uruchamianie polecenia z ERROR(/OutputStream) rejestruje dane wyjściowe polecenia. Stdout i stderr są łączone razem.

Parametry
command : polecenie uruchomienia

output OutputStream : OutputStream, w którym zapisywane są dane wyjściowe

Zwroty
Process Process uruchamiający polecenie

uruchomCmdInBackground

public Process runCmdInBackground (String... command)

Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.

Wróci natychmiast po uruchomieniu polecenia.

Parametry
command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
Process Process wykonanego polecenia

uruchomCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                String... command)

Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.

Wróci natychmiast po uruchomieniu polecenia.

Parametry
redirect Redirect : ERROR(/Redirect) do zastosowania do ProcessBuilder .

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
Process Process wykonanego polecenia

runEscalatingTimedRetry

public boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

Wykładniczo zwiększ czas oczekiwania między próbami operacji. Jest to przeznaczone do użycia podczas wykonywania operacji, takich jak odpytywanie serwera, aby dać mu czas na regenerację w przypadku tymczasowej awarii.

Parametry
opTimeout long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji

initialPollInterval long : początkowy czas oczekiwania pomiędzy próbami operacji

maxPollInterval long : maksymalny czas oczekiwania pomiędzy próbami operacji

maxTime long : całkowity przybliżony maksymalny czas trwania próby operacji

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

Zwroty
boolean true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime

runFixedTimedPonów próbę

public boolean runFixedTimedRetry (long opTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

Parametry
opTimeout long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji

pollInterval long : początkowy czas oczekiwania pomiędzy próbami operacji

maxTime long : całkowity przybliżony maksymalny czas trwania próby operacji

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

Zwroty
boolean true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime

runFixedTimedRetryWithOutputMonitor

public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.

Parametry
opTimeout long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

pollInterval long : początkowy czas oczekiwania pomiędzy próbami operacji

maxTime long : całkowity przybliżony maksymalny czas trwania próby operacji

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

Zwroty
boolean true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime

Uruchomione w określonym czasie

public CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

Blokuje i wykonuje operację, przerywając ją, jeśli trwa dłużej niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

logErrors boolean : rejestruje błędy w przypadku wyjątku lub nie.

Zwroty
CommandStatus wynik operacji CommandStatus .

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. Jeśli w ten sposób zostanie podany ERROR(/OutputStream) , pozostawiony zostanie on otwarty na końcu funkcji.

Parametry
timeout long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu.

stdout OutputStream : ERROR(/OutputStream) gdzie standardowe wyjście zostanie przekierowane. Może mieć wartość zerową.

stderr OutputStream : ERROR(/OutputStream) , gdzie zostanie przekierowane wyjście błędu. Może mieć wartość zerową.

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu.

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdPonów próbę

public CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms przy każdej próbie

retryInterval long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia

attempts int : maksymalna liczba prób

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdRetryWithOutputMonitor

public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                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. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.

Parametry
timeout long : maksymalny czas oczekiwania w ms przy każdej próbie

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

retryInterval long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia

attempts int : maksymalna liczba prób

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdSilently

public CommandResult runTimedCmdSilently (long timeout, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Podobny do runTimedCmd(long, String) , ale w przypadku wyjątku nie rejestruje żadnych błędów.

Parametry
timeout long : maksymalny czas oczekiwania w ms

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdSilentlyPonów próbę

public CommandResult runTimedCmdSilentlyRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Podobny do runTimedCmdRetry(long, long, int, String[]) , ale w przypadku wyjątku nie rejestruje żadnych błędów.

Parametry
timeout long : maksymalny czas oczekiwania w ms

retryInterval long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia

attempts int : maksymalna liczba prób

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono.

Parametry
timeout long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu.

input String : wejście stdin do przekazania do procesu

stdoutFile File : ERROR(/File) , do którego zostanie przekierowane standardowe wyjście. Może mieć wartość zerową.

stderrFile File : ERROR(/File) , do którego zostanie przekierowane wyjście błędu. Może mieć wartość zerową.

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms

input String : wejście stdin do przekazania do procesu

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                 command)

Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms

input String : wejście stdin do przekazania do procesu

command : ERROR(/List) zawierający polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithInputRedirect

public CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego, które wymaga przekierowania Stdin z pliku i przerwania, jeśli zajmie to więcej czasu niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms

inputRedirect File : ERROR(/File) do przekierowania jako standardowe wejście przy użyciu ProcessBuilder.redirectInput() . Jeśli ma wartość null, standardowe wejście nie zostanie przekierowane.

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. Jeśli w ten sposób zostanie podany ERROR(/OutputStream) , pozostawiony zostanie on otwarty na końcu funkcji.

Parametry
timeout long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu.

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

stdout OutputStream : ERROR(/OutputStream) gdzie standardowe wyjście zostanie przekierowane. Może mieć wartość zerową.

stderr OutputStream : ERROR(/OutputStream) , gdzie zostanie przekierowane wyjście błędu. Może mieć wartość zerową.

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.

Parametry
timeout long : maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu.

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedPonów próbę

public boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

Parametry
opTimeout long : maksymalny czas oczekiwania w ms na jedną próbę operacji

pollInterval long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia

attempts int : maksymalna liczba prób

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

Zwroty
boolean true , jeśli operacja zakończyła się pomyślnie przed osiągnięciem liczby prób.

runTimedRetryWithOutputMonitor

public boolean runTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.

Parametry
opTimeout long : maksymalny czas oczekiwania w ms na jedną próbę operacji

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

pollInterval long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia

attempts int : maksymalna liczba prób

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

Zwroty
boolean true , jeśli operacja zakończyła się pomyślnie przed osiągnięciem liczby prób.

runTimedWithOutputMonitor

public 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 również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.

Parametry
timeout long : maksymalny czas oczekiwania w ms

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

logErrors boolean : rejestruje błędy w przypadku wyjątku lub nie.

Zwroty
CommandStatus wynik operacji CommandStatus .

ustaw zmienną Env

public void setEnvVariable (String name, 
                String value)

Ustawia zmienną środowiskową, która będzie używana podczas uruchamiania poleceń systemowych.

Parametry
name String : nazwa zmiennej

value String : wartość zmiennej

setEnvVariablePriority

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

Zdecyduj, czy podczas tworzenia procesu rozbrojenie zmiennej środowiskowej ma wyższy priorytet niż jej ustawienie. Domyślnie rozbrojenie ma wyższy priorytet: co oznacza, że ​​jeśli zostanie podjęta próba ustawienia zmiennej o tej samej nazwie, nie nastąpi to, ponieważ zmienna zostanie rozbrojona. Nie można użyć w domyślnej instancji IRunUtil .

Parametry
priority IRunUtil.EnvPriority

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

Ustaw jako przerywalne po pewnym czasie oczekiwania. ERROR(/CommandScheduler#shutdownHard()) , aby wymusić, ostatecznie zakończymy działanie.

Parametry
thread Thread : wątek, który będzie można przerwać.

timeMs long : czas oczekiwania przed ustawieniem możliwości przerywania.

setLinuxInterruptProcess

public void setLinuxInterruptProcess (boolean interrupt)

Zezwalaj na używanie przerwania „zabicia” systemu Linux w procesie uruchamianym metodami #runTimed, gdy osiągnie limit czasu. Nie można użyć w domyślnej instancji IRunUtil .

Parametry
interrupt boolean

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

Ustaw standardowy strumień błędów, aby przekierowywał do standardowego strumienia wyjściowego podczas uruchamiania poleceń systemowych. Wartość początkowa jest fałszywa.

Parametry
redirect boolean : nowa wartość określająca, czy przekierować

setWorkingDir

public void setWorkingDir (File dir)

Ustawia katalog roboczy dla poleceń systemowych.

Parametry
dir File : katalog roboczy

spać

public void sleep (long time)

Metoda pomocnicza usypiająca przez określony czas, ignorująca wszelkie wyjątki.

Parametry
time long : ms do snu. wartości mniejsze lub równe 0 będą ignorowane

unsetEnvZmienna

public void unsetEnvVariable (String key)

Anuluje ustawienie zmiennej środowiskowej, więc polecenia systemowe działają bez tej zmiennej środowiskowej. Zmienne środowiskowe mogą dziedziczyć z procesu nadrzędnego, dlatego musimy usunąć zmienną środowiskową z ProcessBuilder.environment()

Parametry
key String : nazwa zmiennej

,

UruchomUtil

public class RunUtil
extends Object implements IRunUtil

Obiekt Java.lang.Object
com.android.tradefed.util.RunUtil


Zbiór metod pomocniczych do wykonywania operacji.

Streszczenie

Pola

public static final String INHERITIO_PREFIX

public static final String RUNNABLE_NOTIFIER_NAME

Konstruktorzy publiczni

RunUtil ()

Utwórz nowy obiekt RunUtil do użycia.

Metody publiczne

void allowInterrupt (boolean allow)

Zezwala/zabrania wykonywania przerwań w bieżącym wątku.

static IRunUtil getDefault ()

Uzyskaj odwołanie do domyślnego obiektu RunUtil .

void interrupt (Thread thread, String message, ErrorIdentifier errorId)

Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku.

void interrupt (Thread thread, String message)

Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku.

boolean isInterruptAllowed ()

Podaj status przerwania RunUtil.

Process runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command)

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

Process runCmdInBackground ( command) runCmdInBackground ( command)

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

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

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

Process runCmdInBackground (String... command)

Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.

Process runCmdInBackground (Redirect redirect, String... command)

Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.

boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

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.

CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono.

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.

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.

CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, 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.

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.

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.

CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono.

CommandResult runTimedCmdWithInput (long timeout, String input, String... command)

Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.

CommandResult runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command)

Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.

CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)

Metoda pomocnicza do wykonania polecenia systemowego, które wymaga przekierowania Stdin z pliku i przerwania, jeśli zajmie to więcej czasu niż określony czas.

CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono.

CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas.

boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

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.

void setEnvVariable (String name, String value)

Ustawia zmienną środowiskową, która będzie używana podczas uruchamiania poleceń systemowych.

void setEnvVariablePriority ( IRunUtil.EnvPriority priority)

Zdecyduj, czy podczas tworzenia procesu rozbrojenie zmiennej środowiskowej ma wyższy priorytet niż jej ustawienie.

void setInterruptibleInFuture (Thread thread, long timeMs)

Ustaw jako przerywalne po pewnym czasie oczekiwania.

void setLinuxInterruptProcess (boolean interrupt)

Zezwalaj na używanie przerwania „zabicia” systemu Linux w procesie uruchamianym metodami #runTimed, gdy osiągnie limit czasu.

void setRedirectStderrToStdout (boolean redirect)

Ustaw standardowy strumień błędów, aby przekierowywał do standardowego strumienia wyjściowego podczas uruchamiania poleceń systemowych.

void setWorkingDir (File dir)

Ustawia katalog roboczy dla poleceń systemowych.

void sleep (long time)

Metoda pomocnicza usypiająca przez określony czas, ignorująca wszelkie wyjątki.

void unsetEnvVariable (String key)

Anuluje ustawienie zmiennej środowiskowej, więc polecenia systemowe działają bez tej zmiennej środowiskowej. Zmienne środowiskowe mogą dziedziczyć z procesu nadrzędnego, dlatego musimy usunąć zmienną środowiskową z ProcessBuilder.environment()

Pola

INHERITIO_PREFIX

public static final String INHERITIO_PREFIX

RUNNABLE_NOTIFIER_NAME

public static final String RUNNABLE_NOTIFIER_NAME

Konstruktorzy publiczni

UruchomUtil

public RunUtil ()

Utwórz nowy obiekt RunUtil do użycia.

Metody publiczne

zezwól na przerwanie

public void allowInterrupt (boolean allow)

Zezwala/zabrania wykonywania przerwań w bieżącym wątku. Jeśli jest to dozwolone, operacje bieżącego wątku można przerwać z innych wątków za pomocą metody interrupt(Thread, String) .

Parametry
allow boolean : czy zezwolić na wykonywanie przerwań w bieżącym wątku.

pobierz domyślny

public static IRunUtil getDefault ()

Uzyskaj odwołanie do domyślnego obiektu RunUtil .

Jest to przydatne dla osób dzwoniących, które chcą używać IRunUtil bez dostosowywania. Zaleca się, aby osoby wywołujące, które potrzebują niestandardowej instancji IRunUtil (tzn. muszą wywołać setEnvVariable(String, String) lub setWorkingDir(File) utworzyły własną kopię.

Zwroty
IRunUtil

przerywać

public void interrupt (Thread thread, 
                String message, 
                ErrorIdentifier errorId)

Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiania w danym wątku zgłoszą RunInterruptedException .

Parametry
message String : komunikat dotyczący RunInterruptedException .

errorId ErrorIdentifier : Reprezentuje przyczynę przerwania, jeśli jest znana.

przerywać

public void interrupt (Thread thread, 
                String message)

Przerywa trwające/nadchodzące operacje uruchamiania w danym wątku. Operacje uruchamiania w danym wątku zgłoszą RunInterruptedException .

Parametry
message String : komunikat dotyczący RunInterruptedException .

isInterruptAllowed

public boolean isInterruptAllowed ()

Podaj status przerwania RunUtil.

Zwroty
boolean true, jeśli Run można przerwać, false w przeciwnym razie.

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) do zastosowania do ProcessBuilder .

command : ERROR(/List) zawierający określone polecenie systemowe i opcjonalnie argumenty do exec

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 : ERROR(/List) zawierający określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
Process Process wykonanego polecenia

uruchomCmdInBackground

public Process runCmdInBackground ( command, 
                OutputStream output)

Uruchamianie polecenia z ERROR(/OutputStream) rejestruje dane wyjściowe polecenia. Stdout i stderr są łączone razem.

Parametry
command : polecenie uruchomienia

output OutputStream : OutputStream, w którym zapisywane są dane wyjściowe

Zwroty
Process Process uruchamiający polecenie

uruchomCmdInBackground

public Process runCmdInBackground (String... command)

Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.

Wróci natychmiast po uruchomieniu polecenia.

Parametry
command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
Process Process wykonanego polecenia

uruchomCmdInBackground

public Process runCmdInBackground (Redirect redirect, 
                String... command)

Metoda pomocnicza umożliwiająca asynchroniczne wykonanie polecenia systemowego.

Wróci natychmiast po uruchomieniu polecenia.

Parametry
redirect Redirect : ERROR(/Redirect) do zastosowania do ProcessBuilder .

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
Process Process wykonanego polecenia

runEscalatingTimedRetry

public boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

Wykładniczo zwiększ czas oczekiwania między próbami operacji. Jest to przeznaczone do użycia podczas wykonywania operacji, takich jak odpytywanie serwera, aby dać mu czas na regenerację w przypadku tymczasowej awarii.

Parametry
opTimeout long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji

initialPollInterval long : początkowy czas oczekiwania pomiędzy próbami operacji

maxPollInterval long : maksymalny czas oczekiwania pomiędzy próbami operacji

maxTime long : całkowity przybliżony maksymalny czas trwania próby operacji

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

Zwroty
boolean true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime

runFixedTimedPonów próbę

public boolean runFixedTimedRetry (long opTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

Parametry
opTimeout long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji

pollInterval long : początkowy czas oczekiwania pomiędzy próbami operacji

maxTime long : całkowity przybliżony maksymalny czas trwania próby operacji

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

Zwroty
boolean true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime

runFixedTimedRetryWithOutputMonitor

public boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.

Parametry
opTimeout long : maksymalny czas oczekiwania w ms na pojedynczą próbę operacji

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

pollInterval long : początkowy czas oczekiwania pomiędzy próbami operacji

maxTime long : całkowity przybliżony maksymalny czas trwania próby operacji

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

Zwroty
boolean true , jeśli operacja zakończyła się pomyślnie przed upływem terminu maxTime

Uruchomione w określonym czasie

public CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

Blokuje i wykonuje operację, przerywając ją, jeśli trwa dłużej niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

logErrors boolean : rejestruje błędy w przypadku wyjątku lub nie.

Zwroty
CommandStatus wynik operacji CommandStatus .

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. Jeśli w ten sposób zostanie podany ERROR(/OutputStream) , pozostawiony zostanie on otwarty na końcu funkcji.

Parametry
timeout long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu.

stdout OutputStream : ERROR(/OutputStream) gdzie standardowe wyjście zostanie przekierowane. Może mieć wartość zerową.

stderr OutputStream : ERROR(/OutputStream) , gdzie zostanie przekierowane wyjście błędu. Może mieć wartość zerową.

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmd

public CommandResult runTimedCmd (long timeout, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu.

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdPonów próbę

public CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms przy każdej próbie

retryInterval long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia

attempts int : maksymalna liczba prób

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdRetryWithOutputMonitor

public CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                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. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.

Parametry
timeout long : maksymalny czas oczekiwania w ms przy każdej próbie

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

retryInterval long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia

attempts int : maksymalna liczba prób

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdSilently

public CommandResult runTimedCmdSilently (long timeout, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Podobny do runTimedCmd(long, String) , ale w przypadku wyjątku nie rejestruje żadnych błędów.

Parametry
timeout long : maksymalny czas oczekiwania w ms

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdSilentlyPonów próbę

public CommandResult runTimedCmdSilentlyRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Podobny do runTimedCmdRetry(long, long, int, String[]) , ale w przypadku wyjątku nie rejestruje żadnych błędów.

Parametry
timeout long : maksymalny czas oczekiwania w ms

retryInterval long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia

attempts int : maksymalna liczba prób

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                File stdoutFile, 
                File stderrFile, 
                String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono.

Parametry
timeout long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu.

input String : wejście stdin do przekazania do procesu

stdoutFile File : ERROR(/File) , do którego zostanie przekierowane standardowe wyjście. Może mieć wartość zerową.

stderrFile File : ERROR(/File) , do którego zostanie przekierowane wyjście błędu. Może mieć wartość zerową.

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms

input String : wejście stdin do przekazania do procesu

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithInput

public CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                 command)

Metoda pomocnicza umożliwiająca wykonanie polecenia systemowego wymagającego wejścia na standardowe wejście i przerwanie, jeśli trwa to dłużej niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms

input String : wejście stdin do przekazania do procesu

command : ERROR(/List) zawierający polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithInputRedirect

public CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego, które wymaga przekierowania Stdin z pliku i przerwania, jeśli zajmie to więcej czasu niż określony czas.

Parametry
timeout long : maksymalny czas oczekiwania w ms

inputRedirect File : ERROR(/File) do przekierowania jako standardowe wejście przy użyciu ProcessBuilder.redirectInput() . Jeśli ma wartość null, standardowe wejście nie zostanie przekierowane.

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

Metoda pomocnicza wykonująca polecenie systemowe, przerywająca, jeśli trwa to dłużej niż określony czas, i przekierowująca dane wyjściowe do plików, jeśli określono. Jeśli w ten sposób zostanie podany ERROR(/OutputStream) , pozostawiony zostanie on otwarty na końcu funkcji.

Parametry
timeout long : limit czasu maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu.

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

stdout OutputStream : ERROR(/OutputStream) gdzie standardowe wyjście zostanie przekierowane. Może mieć wartość zerową.

stderr OutputStream : ERROR(/OutputStream) , gdzie zostanie przekierowane wyjście błędu. Może mieć wartość zerową.

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedCmdWithOutputMonitor

public CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

Metoda pomocnicza do wykonania polecenia systemowego i przerwania, jeśli trwa to dłużej niż określony czas. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.

Parametry
timeout long : maksymalny czas oczekiwania w ms. 0 oznacza brak limitu czasu.

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

command String : określone polecenie systemowe i opcjonalnie argumenty do exec

Zwroty
CommandResult CommandResult zawierający wynik uruchomienia polecenia

runTimedPonów próbę

public boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie.

Parametry
opTimeout long : maksymalny czas oczekiwania w ms na jedną próbę operacji

pollInterval long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia

attempts int : maksymalna liczba prób

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

Zwroty
boolean true , jeśli operacja zakończyła się pomyślnie przed osiągnięciem liczby prób.

runTimedRetryWithOutputMonitor

public boolean runTimedRetryWithOutputMonitor (long opTimeout, 
                long idleOutputTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

Blokuje i wykonuje operację wiele razy, aż zakończy się pomyślnie. Monitoruje również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.

Parametry
opTimeout long : maksymalny czas oczekiwania w ms na jedną próbę operacji

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

pollInterval long : czas oczekiwania pomiędzy ponownymi próbami wykonania polecenia

attempts int : maksymalna liczba prób

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

Zwroty
boolean true , jeśli operacja zakończyła się pomyślnie przed osiągnięciem liczby prób.

runTimedWithOutputMonitor

public 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 również strumienie wyjściowe pod kątem aktywności, przerywając, jeśli przez określony czas nie zostanie zaobserwowana żadna aktywność strumienia. Jeśli idleOutputTimeout jest ustawione na zero, monitorowanie strumienia nie będzie wykonywane.

Parametry
timeout long : maksymalny czas oczekiwania w ms

idleOutputTimeout long : maksymalny czas oczekiwania w ms na wyjście w strumieniach wyjściowych

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult do wykonania

logErrors boolean : rejestruje błędy w przypadku wyjątku lub nie.

Zwroty
CommandStatus wynik operacji CommandStatus .

ustaw zmienną Env

public void setEnvVariable (String name, 
                String value)

Ustawia zmienną środowiskową, która będzie używana podczas uruchamiania poleceń systemowych.

Parametry
name String : nazwa zmiennej

value String : wartość zmiennej

setEnvVariablePriority

public void setEnvVariablePriority (IRunUtil.EnvPriority priority)

Zdecyduj, czy podczas tworzenia procesu rozbrojenie zmiennej środowiskowej ma wyższy priorytet niż jej ustawienie. Domyślnie rozbrojenie ma wyższy priorytet: co oznacza, że ​​jeśli zostanie podjęta próba ustawienia zmiennej o tej samej nazwie, nie nastąpi to, ponieważ zmienna zostanie rozbrojona. Nie można użyć w domyślnej instancji IRunUtil .

Parametry
priority IRunUtil.EnvPriority

setInterruptibleInFuture

public void setInterruptibleInFuture (Thread thread, 
                long timeMs)

Ustaw jako przerywalne po pewnym czasie oczekiwania. ERROR(/CommandScheduler#shutdownHard()) , aby wymusić, ostatecznie zakończymy działanie.

Parametry
thread Thread : wątek, który będzie można przerwać.

timeMs long : czas oczekiwania przed ustawieniem możliwości przerywania.

setLinuxInterruptProcess

public void setLinuxInterruptProcess (boolean interrupt)

Zezwalaj na używanie przerwania „zabicia” systemu Linux w procesie uruchamianym metodami #runTimed, gdy osiągnie limit czasu. Nie można użyć w domyślnej instancji IRunUtil .

Parametry
interrupt boolean

setRedirectStderrToStdout

public void setRedirectStderrToStdout (boolean redirect)

Ustaw standardowy strumień błędów, aby przekierowywał do standardowego strumienia wyjściowego podczas uruchamiania poleceń systemowych. Wartość początkowa jest fałszywa.

Parametry
redirect boolean : nowa wartość określająca, czy przekierować

setWorkingDir

public void setWorkingDir (File dir)

Ustawia katalog roboczy dla poleceń systemowych.

Parametry
dir File : katalog roboczy

spać

public void sleep (long time)

Metoda pomocnicza usypiająca przez określony czas, ignorująca wszelkie wyjątki.

Parametry
time long : ms do snu. wartości mniejsze lub równe 0 będą ignorowane

unsetEnvZmienna

public void unsetEnvVariable (String key)

Anuluje ustawienie zmiennej środowiskowej, więc polecenia systemowe działają bez tej zmiennej środowiskowej. Zmienne środowiskowe mogą dziedziczyć z procesu nadrzędnego, dlatego musimy usunąć zmienną środowiskową z ProcessBuilder.environment()

Parametry
key String : nazwa zmiennej