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 |
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 |
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 |
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 |
abstract void | start () Avviare |
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 | 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 | 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.
inizio
public abstract void start ()
Avviare ICommandScheduler
.
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 |
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2023-07-19 UTC.