ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler


Harmonogram uruchamiania poleceń TradeFederation.

Streszczenie

Zagnieżdżone klasy

interface ICommandScheduler.IScheduledInvocationListener

Odbiornik zdarzeń wywołania po zakończeniu wywołania.

Metody publiczne

abstract boolean addCommand (String[] args)

Dodaje polecenie do harmonogramu.

abstract void addCommandFile (String cmdFile, extraArgs) addCommandFile (String cmdFile, extraArgs)

Dodaje wszystkie polecenia z podanego pliku do harmonogramu

abstract void await ()

Czeka na rozpoczęcie działania programu planującego, łącznie z oczekiwaniem na zakończenie przekazania ze starego TF, jeśli ma to zastosowanie.

abstract void completeHandover ()

Informuje program planujący polecenia, że ​​zainicjowana sekwencja przekazywania została w pełni ukończona i powinien ponownie zainicjować swojego zdalnego menedżera na porcie domyślnym.

abstract void displayCommandQueue (PrintWriter printWriter)

Wyprowadź szczegółowe informacje debugowania dotyczące stanu kolejki wykonywania poleceń.

abstract void displayCommandsInfo (PrintWriter printWriter, String regex)

Wyprowadź listę bieżących poleceń.

abstract void displayInvocationsInfo (PrintWriter printWriter)

Wyświetla listę bieżących wywołań.

abstract void dumpCommandsXml (PrintWriter printWriter, String regex)

Zrzuć rozwinięty plik xml dla polecenia ze wszystkimi wartościami Option określonymi dla wszystkich bieżących poleceń.

abstract void execCommand (IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

Bezpośrednio przydziela urządzenie i wykonuje polecenie bez dodawania go do kolejki poleceń przy użyciu już istniejącego IInvocationContext .

abstract void execCommand ( ICommandScheduler.IScheduledInvocationListener listener, String[] args)

Bezpośrednio przydziela urządzenie i wykonuje polecenie bez dodawania go do kolejki poleceń.

abstract void execCommand ( ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)

Bezpośrednio wykonaj polecenie na już przydzielonym urządzeniu.

abstract CommandFileWatcher getCommandFileWatcher ()

Pobierz odpowiedni CommandFileWatcher dla tego harmonogramu

abstract int getExecutingCommandCount ()

Zwraca liczbę poleceń w stanie wykonywania.

abstract String getInvocationInfo (int invocationId)

Zwróć informacje o wywołaniu, podając identyfikator wywołania.

abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Zwróć kod błędu ostatniego uruchomionego wywołania.

abstract Throwable getLastInvocationThrowable ()

Zwróć obiekt Throwable z ostatniego uruchomionego wywołania.

abstract int getReadyCommandCount ()

Zwraca liczbę poleceń znajdujących się w kolejce w stanie gotowości.

abstract void handoverInitiationComplete ()

Informuje program planujący polecenia, że ​​początkowa wymiana używanych urządzeń i poleceń została zakończona i może rozpocząć planowanie operacji.

abstract boolean handoverShutdown (int handoverPort)

Inicjuje shutdown() i przekazanie do innego procesu na tym samym hoście.

abstract void join ()

Oczekuje na zakończenie działania harmonogramu.

abstract void join (long millis)

Oczekuje na zakończenie harmonogramu lub przekroczenie limitu czasu po upływie czasu określonego w milisekundach.

abstract void removeAllCommands ()

Usuń wszystkie polecenia z harmonogramu

abstract void setClearcutClient (ClearcutClient client)

Ustaw klienta tak, aby raportował dane wiązki przewodów

abstract boolean shouldShutdownOnCmdfileError ()

Zwróć wartość true, jeśli musimy zamknąć program planujący w przypadku błędów polecenia

abstract void shutdown ()

Spróbuj bezpiecznie zamknąć harmonogram poleceń.

abstract void shutdownHard (boolean killAdb)

Spróbuj wymusić zamknięcie harmonogramu poleceń.

abstract void shutdownHard ()

Spróbuj wymusić zamknięcie harmonogramu poleceń.

abstract void shutdownOnEmpty ()

Podobny do shutdown() , ale zamiast tego czeka na wykonanie wszystkich poleceń przed wyjściem.

abstract void start ()

Uruchom ICommandScheduler .

abstract boolean stopInvocation (int invocationId, String cause)

Zatrzymaj uruchomione wywołanie, podając jego identyfikator.

default boolean stopInvocation (int invocationId)

Zatrzymaj uruchomione wywołanie, podając jego identyfikator.

abstract boolean stopInvocation ( ITestInvocation invocation)

Zatrzymaj działające wywołanie.

Metody publiczne

dodajpolecenie

public abstract boolean addCommand (String[] args)

Dodaje polecenie do harmonogramu.

Polecenie jest zasadniczo instancją konfiguracji do uruchomienia i skojarzonymi z nią argumentami.

Jeśli podano argument „--help”, tekst pomocy dla konfiguracji zostanie wypisany na standardowe wyjście. W przeciwnym razie konfiguracja zostanie dodana do kolejki do uruchomienia.

Parametry
args String : argumenty konfiguracyjne.

Zwroty
boolean true , jeśli polecenie zostało pomyślnie dodane

Rzuca
ConfigurationException jeśli nie można przeanalizować polecenia

dodaj plik poleceń

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Dodaje wszystkie polecenia z podanego pliku do harmonogramu

Parametry
cmdFile String : ścieżka systemu plików pliku poleceń

extraArgs : ERROR(/List) argumentów String do dołączenia do każdego polecenia analizowanego z pliku. Może być pusta, ale nie powinna mieć wartości null.

Rzuca
ConfigurationException jeśli nie można przeanalizować pliku poleceń

Zobacz też:

czekać na

public abstract void await ()

Czeka na rozpoczęcie działania programu planującego, łącznie z oczekiwaniem na zakończenie przekazania ze starego TF, jeśli ma to zastosowanie.

kompletnePrzekazanie

public abstract void completeHandover ()

Informuje program planujący polecenia, że ​​zainicjowana sekwencja przekazywania została w pełni ukończona i powinien ponownie zainicjować swojego zdalnego menedżera na porcie domyślnym.

wyświetl kolejkę poleceń

public abstract void displayCommandQueue (PrintWriter printWriter)

Wyprowadź szczegółowe informacje debugowania dotyczące stanu kolejki wykonywania poleceń.

wyświetl informacje o poleceniach

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Wyprowadź listę bieżących poleceń.

Parametry
printWriter PrintWriter : ERROR(/PrintWriter) do wyprowadzania.

regex String : wyrażenie regularne, do którego należy dopasować polecenia, aby zostały wydrukowane. Jeśli ma wartość null, wówczas zostaną wydrukowane wszystkie polecenia.

wyświetl informacje o wywołaniach

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Wyświetla listę bieżących wywołań.

Parametry
printWriter PrintWriter : ERROR(/PrintWriter) do wyprowadzania.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Zrzuć rozwinięty plik xml dla polecenia ze wszystkimi wartościami Option określonymi dla wszystkich bieżących poleceń.

Parametry
printWriter PrintWriter : ERROR(/PrintWriter) do którego ma być wysyłany stan.

regex String : wyrażenie regularne, do którego należy dopasować polecenia, aby plik xml został zrzucony. Jeśli ma wartość null, wszystkie polecenia zostaną zrzucone.

polecenie exec

public abstract void execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

Bezpośrednio przydziela urządzenie i wykonuje polecenie bez dodawania go do kolejki poleceń przy użyciu już istniejącego IInvocationContext .

Parametry
context IInvocationContext : istniejący IInvocationContext .

listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener , który ma zostać poinformowany

args String : argumenty polecenia

Rzuca
ConfigurationException jeśli polecenie było nieprawidłowe
NoDeviceException jeśli nie ma żadnego urządzenia do użycia

polecenie exec

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

Bezpośrednio przydziela urządzenie i wykonuje polecenie bez dodawania go do kolejki poleceń.

Parametry
listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener , który ma zostać poinformowany

args String : argumenty polecenia

Rzuca
ConfigurationException jeśli polecenie było nieprawidłowe
NoDeviceException jeśli nie ma żadnego urządzenia do użycia

polecenie exec

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                ITestDevice device, 
                String[] args)

Bezpośrednio wykonaj polecenie na już przydzielonym urządzeniu.

Parametry
listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener , który ma zostać poinformowany

device ITestDevice : ITestDevice do użycia

args String : argumenty polecenia

Rzuca
ConfigurationException jeśli polecenie było nieprawidłowe

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Pobierz odpowiedni CommandFileWatcher dla tego harmonogramu

Zwroty
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Zwraca liczbę poleceń w stanie wykonywania.

Zwroty
int

pobierzInfo o Inwokacji

public abstract String getInvocationInfo (int invocationId)

Zwróć informacje o wywołaniu, podając identyfikator wywołania.

Parametry
invocationId int : identyfikator śledzenia wywołania.

Zwroty
String String zawierający informacje o wywołaniu.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Zwróć kod błędu ostatniego uruchomionego wywołania. Zwróć 0 (brak błędu), jeśli żadne wywołanie nie zostało jeszcze uruchomione.

Zwroty
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

Zwróć obiekt Throwable z ostatniego uruchomionego wywołania. Zwróć null, jeśli nie jest dostępny żaden obiekt do rzucania.

Zwroty
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

Zwraca liczbę poleceń znajdujących się w kolejce w stanie gotowości.

Zwroty
int

inicjowanie przekazania zakończone

public abstract void handoverInitiationComplete ()

Informuje program planujący polecenia, że ​​początkowa wymiana używanych urządzeń i poleceń została zakończona i może rozpocząć planowanie operacji.

przekazanieZamknięcie

public abstract boolean handoverShutdown (int handoverPort)

Inicjuje shutdown() i przekazanie do innego procesu na tym samym hoście.

Program planujący poinformuje proces zdalnego handlu nasłuchujący na tym porcie o zwolnionych urządzeniach, gdy tylko staną się one dostępne.

Parametry
handoverPort int

Zwroty
boolean true , jeśli inicjacja przekazania zakończyła się pomyślnie, false w przeciwnym razie

dołączyć

public abstract void join ()

Oczekuje na zakończenie działania harmonogramu.

Zobacz też:

dołączyć

public abstract void join (long millis)

Oczekuje na zakończenie harmonogramu lub przekroczenie limitu czasu po upływie czasu określonego w milisekundach.

Parametry
millis long

Zobacz też:

usuńWszystkiepolecenia

public abstract void removeAllCommands ()

Usuń wszystkie polecenia z harmonogramu

ustawClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Ustaw klienta tak, aby raportował dane wiązki przewodów

Parametry
client ClearcutClient

powinienShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Zwróć wartość true, jeśli musimy zamknąć program planujący w przypadku błędów polecenia

Zwroty
boolean

zamknięcie

public abstract void shutdown ()

Spróbuj bezpiecznie zamknąć harmonogram poleceń.

Czyści polecenia oczekujące na przetestowanie i żąda bezpiecznego zamknięcia wszystkich trwających wywołań.

Po wywołaniu zamknięcia główna pętla programu planującego będzie czekać na zakończenie wszystkich trwających wywołań, zanim całkowicie zakończy działanie.

zamknięcieTwarde

public abstract void shutdownHard (boolean killAdb)

Spróbuj wymusić zamknięcie harmonogramu poleceń.

Podobny do shutdown() , ale opcjonalnie również zakończy połączenie adb, próbując „zainspirować” trwające wywołania do szybszego zakończenia.

Parametry
killAdb boolean

zamknięcieTwarde

public abstract void shutdownHard ()

Spróbuj wymusić zamknięcie harmonogramu poleceń. To samo co zamknięcieHard(true).

zamknięcieOnEmpty

public abstract void shutdownOnEmpty ()

Podobny do shutdown() , ale zamiast tego czeka na wykonanie wszystkich poleceń przed wyjściem.

Należy pamiętać, że jeśli jakiekolwiek polecenia są w trybie pętli, program planujący nigdy nie zakończy działania.

początek

public abstract void start ()

Uruchom ICommandScheduler .

Należy wywołać przed wywołaniem innych metod.

Będzie działać do momentu wywołania funkcji shutdown() . zobacz Thread.start() .

zatrzymaj Inwokację

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Zatrzymaj uruchomione wywołanie, podając jego identyfikator.

Parametry
invocationId int : identyfikator śledzenia wywołania.

cause String : przyczyna zatrzymania wywołania.

Zwroty
boolean true, jeśli wywołanie zostało zatrzymane, false w przeciwnym razie

Rzuca
UnsupportedOperationException jeśli implementacja tego nie obsługuje

zatrzymaj Inwokację

public boolean stopInvocation (int invocationId)

Zatrzymaj uruchomione wywołanie, podając jego identyfikator.

Parametry
invocationId int

Zwroty
boolean true, jeśli wywołanie zostało zatrzymane, false w przeciwnym razie

Rzuca
UnsupportedOperationException jeśli implementacja tego nie obsługuje

zatrzymaj Inwokację

public abstract boolean stopInvocation (ITestInvocation invocation)

Zatrzymaj działające wywołanie.

Parametry
invocation ITestInvocation

Zwroty
boolean true, jeśli wywołanie zostało zatrzymane, false w przeciwnym razie

Rzuca
UnsupportedOperationException jeśli implementacja tego nie obsługuje