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 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 da un determinato file allo scheduler

abstract void await ()

Attende l'avvio dello scheduler, inclusa l'attesa del completamento della consegna dalla vecchia TF, se applicabile.

abstract void displayCommandQueue (PrintWriter printWriter)

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

abstract void displayCommandsInfo (PrintWriter printWriter, String regex)

Emette un elenco di comandi correnti.

abstract void displayInvocationsInfo (PrintWriter printWriter)

Visualizza un elenco di chiamate correnti.

abstract void dumpCommandsXml (PrintWriter printWriter, String regex)

Esegui il dump del file xml espanso per il comando con tutti i valori di Option specificati per tutti i comandi correnti.

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

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

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

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

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

Esegui direttamente il comando sul dispositivo già allocato.

abstract CommandFileWatcher getCommandFileWatcher ()

Ottieni il CommandFileWatcher appropriato per questo scheduler

abstract int getExecutingCommandCount ()

Restituisce il numero di comandi in esecuzione.

abstract String getInvocationInfo (int invocationId)

Restituisce le informazioni su una chiamata bu specificando l'id di 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 di pronto nella coda.

abstract void join ()

Attende il completamento della pianificazione.

abstract void join (long millis)

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

abstract void removeAllCommands ()

Rimuovere tutti i comandi dall'utilità di pianificazione

abstract void setClearcutClient (ClearcutClient client)

Imposta il client per segnalare i dati del cablaggio

abstract boolean shouldShutdownOnCmdfileError ()

Restituisce true se è necessario arrestare lo scheduler su un comando errori

abstract void shutdown ()

Tentare di arrestare correttamente l'utilità di pianificazione dei comandi.

abstract void shutdownHard (boolean killAdb)

Tentare di arrestare forzatamente l'utilità di pianificazione dei comandi.

abstract void shutdownHard ()

Tentare di arrestare forzatamente l'utilità di pianificazione dei comandi.

abstract void shutdownOnEmpty ()

Simile a shutdown() , ma attenderà invece che tutti i comandi vengano eseguiti prima di uscire.

abstract void start ()

Avviare ICommandScheduler .

abstract boolean stopInvocation (int invocationId, String cause)

Arresta una chiamata in esecuzione specificando il suo id.

default boolean stopInvocation (int invocationId)

Arresta una chiamata in esecuzione specificando il suo id.

abstract boolean stopInvocation ( ITestInvocation invocation)

Interrompi una chiamata in corso.

Metodi pubblici

aggiungiComando

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

Aggiunge un comando allo scheduler.

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

Se viene specificato l'argomento "--help", il testo della guida 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 valore booleano true se il comando è stato aggiunto correttamente. Il secondo valore è l'id del tracker dei comandi noto (valore non negativo) se il comando è stato aggiunto correttamente, restituisce 0 quando il comando viene aggiunto per tutti i dispositivi, altrimenti -1.

Tiri
ConfigurationException se il comando non può essere analizzato

aggiungiFileComando

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Aggiunge tutti i comandi da un determinato file allo scheduler

Parametri
cmdFile String : il percorso del filesystem del file di comando

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

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

Guarda anche:

aspettare

public abstract void await ()

Attende l'avvio dello scheduler, inclusa l'attesa del completamento della consegna dalla vecchia TF, se applicabile.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

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

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Emette un elenco di comandi correnti.

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

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

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Visualizza un elenco di chiamate correnti.

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

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Esegui il dump del file xml espanso per il comando con tutti i valori di Option specificati per tutti i comandi correnti.

Parametri
printWriter PrintWriter : ERROR(/PrintWriter) a cui inviare lo stato.

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

execCommand

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

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

Parametri
context IInvocationContext : un IInvocationContext esistente.

listener ICommandScheduler.IScheduledInvocationListener : l' ICommandScheduler.IScheduledInvocationListener da informare

args String : gli argomenti del comando

Tiri
ConfigurationException se il comando non era valido
NoDeviceException se non è presente alcun dispositivo da utilizzare

execCommand

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

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

Parametri
listener ICommandScheduler.IScheduledInvocationListener : l' ICommandScheduler.IScheduledInvocationListener da informare

args String : gli argomenti del comando

Tiri
ConfigurationException se il comando non era valido
NoDeviceException se non è presente alcun dispositivo da utilizzare

execCommand

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

Esegui direttamente il comando sul dispositivo già allocato.

Parametri
listener ICommandScheduler.IScheduledInvocationListener : l' ICommandScheduler.IScheduledInvocationListener da informare

device ITestDevice : l' ITestDevice da utilizzare

args String : gli argomenti del comando

Tiri
ConfigurationException se il comando non era valido

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Ottieni il CommandFileWatcher appropriato per questo scheduler

ritorna
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Restituisce il numero di comandi in esecuzione.

ritorna
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Restituisce le informazioni su una chiamata bu specificando l'id di chiamata.

Parametri
invocationId int : l'ID di tracciamento della chiamata.

ritorna
String Una String contenente informazioni sull'invocazione.

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. Restituisce null, se non è disponibile alcun throwable.

ritorna
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

Restituisce il numero di comandi in stato di pronto nella coda.

ritorna
int

giuntura

public abstract void join ()

Attende il completamento della pianificazione.

Guarda anche:

giuntura

public abstract void join (long millis)

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

Parametri
millis long

Guarda anche:

removeAllCommands

public abstract void removeAllCommands ()

Rimuovere tutti i comandi dall'utilità di pianificazione

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Imposta il client per segnalare i dati del cablaggio

Parametri
client ClearcutClient

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Restituisce true se è necessario arrestare lo scheduler su un comando errori

ritorna
boolean

spegnimento

public abstract void shutdown ()

Tentare di arrestare correttamente l'utilità di pianificazione dei comandi.

Cancella i comandi in attesa di essere testati e richiede la chiusura regolare di tutte le chiamate in corso.

Dopo aver chiamato lo spegnimento, il ciclo principale dello scheduler attende il completamento di tutte le chiamate in corso prima di uscire completamente.

shutdownHard

public abstract void shutdownHard (boolean killAdb)

Tentare di arrestare forzatamente l'utilità di pianificazione dei comandi.

Simile a shutdown() , ma facoltativamente ucciderà anche la connessione adb, nel tentativo di "ispirare" le invocazioni in corso per completare più rapidamente.

Parametri
killAdb boolean

shutdownHard

public abstract void shutdownHard ()

Tentare di arrestare forzatamente l'utilità di pianificazione dei comandi. Uguale a shutdownHard(true).

shutdownOnEmpty

public abstract void shutdownOnEmpty ()

Simile a shutdown() , ma attenderà invece che tutti i comandi vengano eseguiti prima di uscire.

Si noti che se alcuni comandi sono 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() . vedere Thread.start() .

stopInvocazione

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Arresta una chiamata in esecuzione specificando il suo id.

Parametri
invocationId int : l'ID di tracciamento della chiamata.

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

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

Tiri
UnsupportedOperationException se l'implementazione non lo supporta

stopInvocazione

public boolean stopInvocation (int invocationId)

Arresta una chiamata in esecuzione specificando il suo id.

Parametri
invocationId int

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

Tiri
UnsupportedOperationException se l'implementazione non lo supporta

stopInvocazione

public abstract boolean stopInvocation (ITestInvocation invocation)

Interrompi una chiamata in corso.

Parametri
invocation ITestInvocation

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

Tiri
UnsupportedOperationException se l'implementazione non lo supporta