ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler


Uno scheduler per l'esecuzione dei comandi TradeFederation.

Riepilogo

Classi nidificate

interface ICommandScheduler.IScheduledInvocationListener

Listener per gli eventi di chiamata al termine della chiamata.

Metodi pubblici

abstract Pair <Boolean, Integer> addCommand (String[] args)

Aggiunge un comando allo scheduler.

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

Aggiunge tutti i comandi dal file specificato allo scheduler

abstract void await ()

Attende che lo scheduler inizi a funzionare, inclusa l'attesa del completamento del trasferimento dal vecchio TF, se applicabile.

abstract void displayCommandQueue (PrintWriter printWriter)

Genera informazioni di debug dettagliate sullo stato della coda di esecuzione dei comandi.

abstract void displayCommandsInfo (PrintWriter printWriter, String regex)

Produce un elenco di comandi correnti.

abstract void displayInvocationsInfo (PrintWriter printWriter)

Visualizza un elenco di chiamate correnti.

abstract void dumpCommandsXml (PrintWriter printWriter, String regex)

Scarica il file xml espanso per il comando con tutti i valori Option specificati per tutti i comandi correnti.

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

Alloca direttamente un dispositivo ed esegue un comando senza aggiungerlo alla coda comandi usando un IInvocationContext già esistente.

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

Alloca direttamente un dispositivo ed esegue un comando senza aggiungerlo alla coda dei comandi.

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

Esegui direttamente il comando su dispositivi già allocati.

abstract CommandFileWatcher getCommandFileWatcher ()

Ottieni il CommandFileWatcher appropriato per questo programma di pianificazione

abstract int getExecutingCommandCount ()

Restituisce il numero di comandi in stato di esecuzione.

abstract String getInvocationInfo (int invocationId)

Restituisce le informazioni su una chiamata bu specificando l'ID chiamata.

abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Restituisce il codice di errore dell'ultima chiamata eseguita.

abstract Throwable getLastInvocationThrowable ()

Restituisci il Throwable dall'ultima invocazione eseguita.

abstract int getReadyCommandCount ()

Restituisce il numero di comandi in stato pronto nella coda.

abstract boolean isDeviceInInvocationThread ( ITestDevice device)

Restituisce true se il dispositivo è utilizzato da un thread di chiamata attivo.

abstract void join ()

Attende il completamento dello scheduler.

abstract void join (long millis)

Attende il completamento dell'utilità di pianificazione o il timeout dopo la durata specificata in millisecondi.

abstract void removeAllCommands ()

Rimuovi tutti i comandi dallo scheduler

abstract void setClearcutClient (ClearcutClient client)

Impostare il client per segnalare i dati del cablaggio

abstract boolean shouldShutdownOnCmdfileError ()

Restituisce true se è necessario arrestare lo scheduler in caso di errori di comando

default void shutdown ()

Tentativo di arrestare correttamente lo scheduler dei comandi.

abstract void shutdown (boolean notifyStop)

Tentativo di arrestare correttamente lo scheduler dei comandi.

abstract void shutdownHard (boolean killAdb)

Tentativo di arresto forzato dell'utilità di pianificazione dei comandi.

abstract void shutdownHard ()

Tentativo di arresto forzato dell'utilità di pianificazione dei comandi.

abstract void shutdownOnEmpty ()

Simile a shutdown() , ma attenderà invece l'esecuzione di tutti i comandi prima di uscire.

abstract void start ()

Avviare ICommandScheduler .

abstract boolean stopInvocation (int invocationId, String cause)

Arrestare una chiamata in esecuzione specificandone l'id.

default boolean stopInvocation (int invocationId)

Arrestare una chiamata in esecuzione specificandone l'id.

abstract boolean stopInvocation ( ITestInvocation invocation)

Arrestare una chiamata in esecuzione.

Metodi pubblici

addCommand

public abstract Pair<Boolean, Integer> addCommand (String[] args)

Aggiunge un comando allo scheduler.

Un comando è essenzialmente un'istanza di una configurazione da eseguire e i suoi argomenti associati.

Se viene specificato l'argomento "--help", il testo di aiuto per la configurazione verrà inviato a stdout. In caso contrario, la configurazione verrà aggiunta alla coda per l'esecuzione.

Parametri
args String : gli argomenti di configurazione.

ritorna
Pair <Boolean, Integer> Una coppia di valori, il primo valore è un booleano true se il comando è stato aggiunto correttamente. Il secondo valore è l'ID tracker comando noto (valore non negativo) se il comando è stato aggiunto correttamente, restituisce 0 quando il comando viene aggiunto per tutti i dispositivi, altrimenti -1.

Getta
ConfigurationException se il comando non può essere analizzato

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Aggiunge tutti i comandi dal file specificato allo scheduler

Parametri
cmdFile String : il percorso del filesystem del file comand

extraArgs : un ERROR(/List) di argomenti String da aggiungere a ciascun comando analizzato dal file. Può essere vuoto ma non deve essere nullo.

Getta
ConfigurationException se il file di comando non può essere analizzato

Guarda anche:

aspetta

public abstract void await ()

Attende che lo scheduler inizi a funzionare, inclusa l'attesa del completamento del trasferimento dal vecchio TF, se applicabile.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

Genera informazioni di debug dettagliate sullo stato della coda di esecuzione dei comandi.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Produce un elenco di comandi correnti.

Parametri
printWriter PrintWriter : l' ERROR(/PrintWriter) in cui eseguire l'output.

regex String : l'espressione regolare a cui i comandi devono essere abbinati per essere stampati. Se nullo, verranno stampati tutti i comandi.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Visualizza un elenco di chiamate correnti.

Parametri
printWriter PrintWriter : l' ERROR(/PrintWriter) in cui eseguire l'output.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Scarica il file xml espanso per il comando con tutti i valori Option specificati per tutti i comandi correnti.

Parametri
printWriter PrintWriter : l' ERROR(/PrintWriter) a cui restituire lo stato.

regex String : l'espressione regolare a cui i comandi devono essere abbinati per eseguire il dump del file xml. Se nullo, tutti i comandi verranno scaricati.

execCommand

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

Alloca direttamente un dispositivo ed esegue un comando senza aggiungerlo alla coda comandi usando un IInvocationContext già esistente.

Parametri
context IInvocationContext : un IInvocationContext esistente .

listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener da informare

args String : gli argomenti del comando

ritorna
long

Getta
ConfigurationException se il comando non era valido
NoDeviceException se non c'è nessun dispositivo da usare

execCommand

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

Alloca direttamente un dispositivo ed esegue un comando senza aggiungerlo alla coda dei comandi.

Parametri
listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener da informare

args String : gli argomenti del comando

ritorna
long L'id di chiamata del comando pianificato.

Getta
ConfigurationException se il comando non era valido
NoDeviceException se non c'è nessun dispositivo da usare

execCommand

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

Esegui direttamente il comando su dispositivi già allocati.

Parametri
listener ICommandScheduler.IScheduledInvocationListener : ICommandScheduler.IScheduledInvocationListener da informare

devices : l' ERROR(/List ) ERROR(/List ) da usare

args String : gli argomenti del comando

ritorna
long L'id di chiamata del comando pianificato.

Getta
ConfigurationException se il comando non era valido

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Ottieni il CommandFileWatcher appropriato per questo programma di pianificazione

ritorna
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Restituisce il numero di comandi in stato di esecuzione.

ritorna
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Restituisce le informazioni su una chiamata bu specificando l'ID chiamata.

Parametri
invocationId int : l'ID di tracciamento dell'invocazione.

ritorna
String String contenente informazioni sulla chiamata.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Restituisce il codice di errore dell'ultima chiamata eseguita. Restituisce 0 (nessun errore), se non è stata ancora eseguita alcuna chiamata.

ritorna
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

Restituisci il Throwable dall'ultima invocazione eseguita. Restituisci null, se non è disponibile alcun gettabile.

ritorna
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

Restituisce il numero di comandi in stato pronto nella coda.

ritorna
int

isDeviceInInvocationThread

public abstract boolean isDeviceInInvocationThread (ITestDevice device)

Restituisce true se il dispositivo è utilizzato da un thread di chiamata attivo.

Parametri
device ITestDevice

ritorna
boolean

giuntura

public abstract void join ()

Attende il completamento dello scheduler.

Guarda anche:

giuntura

public abstract void join (long millis)

Attende il completamento dell'utilità di pianificazione o il timeout dopo la durata specificata in millisecondi.

Parametri
millis long

Guarda anche:

removeAllCommands

public abstract void removeAllCommands ()

Rimuovi tutti i comandi dallo scheduler

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Impostare il client per segnalare i dati del cablaggio

Parametri
client ClearcutClient

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Restituisce true se è necessario arrestare lo scheduler in caso di errori di comando

ritorna
boolean

fermare

public void shutdown ()

Tentativo di arrestare correttamente lo scheduler dei comandi.

Cancella i comandi in attesa di essere testati e richiede che tutte le chiamate in corso vengano arrestate correttamente.

Dopo la chiamata all'arresto, il ciclo principale dello scheduler attenderà il completamento di tutte le chiamate in corso prima di uscire completamente.

fermare

public abstract void shutdown (boolean notifyStop)

Tentativo di arrestare correttamente lo scheduler dei comandi.

Parametri
notifyStop boolean : se true, notifica le invocazioni dell'arresto di TF.

shutdownHard

public abstract void shutdownHard (boolean killAdb)

Tentativo di arresto forzato dell'utilità di pianificazione dei comandi.

Simile a shutdown() , ma facoltativamente interromperà anche la connessione adb, nel tentativo di "ispirare" le chiamate in corso per un completamento più rapido.

Parametri
killAdb boolean

shutdownHard

public abstract void shutdownHard ()

Tentativo di arresto forzato dell'utilità di pianificazione dei comandi. Uguale a shutdownHard(true).

shutdownOnEmpty

public abstract void shutdownOnEmpty ()

Simile a shutdown() , ma attenderà invece l'esecuzione di tutti i comandi prima di uscire.

Nota che se qualche comando è in modalità loop, lo scheduler non uscirà mai.

inizio

public abstract void start ()

Avviare ICommandScheduler .

Deve essere chiamato prima di chiamare altri metodi.

Verrà eseguito fino a quando non viene chiamato shutdown() . vedi Thread.start() .

stopInvocazione

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Arrestare una chiamata in esecuzione specificandone l'id.

Parametri
invocationId int : l'ID di tracciamento dell'invocazione.

cause String : la causa dell'interruzione dell'invocazione.

ritorna
boolean true se l'invocazione è stata interrotta, false in caso contrario

Getta
UnsupportedOperationException se l'implementazione non lo supporta

stopInvocazione

public boolean stopInvocation (int invocationId)

Arrestare una chiamata in esecuzione specificandone l'id.

Parametri
invocationId int

ritorna
boolean true se l'invocazione è stata interrotta, false in caso contrario

Getta
UnsupportedOperationException se l'implementazione non lo supporta

stopInvocazione

public abstract boolean stopInvocation (ITestInvocation invocation)

Arrestare una chiamata in esecuzione.

Parametri
invocation ITestInvocation

ritorna
boolean true se l'invocazione è stata interrotta, false in caso contrario

Getta
UnsupportedOperationException se l'implementazione non lo supporta