Google s'est engagé à promouvoir l'équité raciale pour les communautés noires. Regarde comment.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler


Un planificateur pour exécuter les commandes TradeFederation.

Résumé

Classes imbriquées

interface ICommandScheduler.IScheduledInvocationListener

Écouteur pour les événements d'appel une fois l'appel terminé.

Méthodes publiques

abstract boolean addCommand (String[] args, long totalExecTime)

Un addCommand(String[]) alternatif addCommand(String[]) qui accepte un temps d'exécution total initial pour la commande.

abstract boolean addCommand (String[] args)

Ajoute une commande au planificateur.

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

Ajoute toutes les commandes d'un fichier donné au planificateur

abstract void await ()

Attend que le planificateur démarre, y compris l'attente de la fin du transfert de l'ancien TF, le cas échéant.

abstract void completeHandover ()

Informe le planificateur de commandes qu'une séquence de transfert initiée est complètement terminée et qu'il doit réinitialiser son gestionnaire distant sur le port par défaut.

abstract void displayCommandQueue (PrintWriter printWriter)

Sortie d'informations de débogage détaillées sur l'état de la file d'attente d'exécution de commande.

abstract void displayCommandsInfo (PrintWriter printWriter, String regex)

Sortie d'une liste des commandes actuelles.

abstract void displayInvocationsInfo (PrintWriter printWriter)

Affiche une liste des appels en cours.

abstract void dumpCommandsXml (PrintWriter printWriter, String regex)

Videz le fichier XML développé pour la commande avec toutes les valeurs Option spécifiées pour toutes les commandes actuelles.

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

Alloue directement un périphérique et exécute une commande sans l'ajouter à la file d'attente de commandes à l'aide d'un IInvocationContext déjà existant.

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

Alloue directement un périphérique et exécute une commande sans l'ajouter à la file d'attente de commandes.

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

Exécutez directement la commande sur le périphérique déjà alloué.

abstract CommandFileWatcher getCommandFileWatcher ()

Obtenez le CommandFileWatcher approprié pour ce planificateur

abstract String getInvocationInfo (int invocationId)

Renvoie les informations sur un appel en spécifiant l'ID d'appel.

abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Renvoie le code d'erreur de la dernière invocation exécutée.

abstract Throwable getLastInvocationThrowable ()

Renvoyez le Throwable de la dernière invocation exécutée.

abstract int getReadyCommandCount ()

Renvoie le nombre de commandes à l'état prêt dans la file d'attente.

abstract void handoverInitiationComplete ()

Informe le planificateur de commandes que l'échange de transfert initial des périphériques et des commandes en cours d'utilisation est terminé et qu'il peut commencer l'opération de planification.

abstract boolean handoverShutdown (int handoverPort)

Lance un shutdown() et un transfert vers un autre processus échangé sur ce même hôte.

abstract void join ()

Attend la fin du planificateur.

abstract void join (long millis)

Attend que le planificateur se termine ou expire après la durée spécifiée en millisecondes.

abstract void removeAllCommands ()

Supprimer toutes les commandes du planificateur

abstract void setClearcutClient (ClearcutClient client)

Configurer le client pour qu'il rapporte les données du faisceau

abstract void setLastInvocationExitCode ( CommandRunner.ExitCode code, Throwable stack)

Méthode d'assistance, lors de l'exécution dans un contexte CommandRunner , définissez un code d'erreur de sortie et une trace de pile qui peuvent être renvoyées.

abstract boolean shouldShutdownOnCmdfileError ()

Renvoie true si nous devons arrêter le planificateur sur une erreur de commande

abstract void shutdown ()

Essayez d'arrêter correctement le planificateur de commandes.

abstract void shutdownHard ()

Essayez d'arrêter de force le planificateur de commandes.

abstract void shutdownOnEmpty ()

Similaire à shutdown() , mais attendra à la place que toutes les commandes soient exécutées avant de quitter.

abstract void start ()

Démarrez ICommandScheduler .

abstract boolean stopInvocation (int invocationId)

Arrêtez un appel en cours en spécifiant son id.

abstract boolean stopInvocation ( ITestInvocation invocation)

Arrêtez une invocation en cours.

Méthodes publiques

addCommand

public abstract boolean addCommand (String[] args, 
                long totalExecTime)

Un addCommand(String[]) alternatif addCommand(String[]) qui accepte un temps d'exécution total initial pour la commande.

Utile lors de la transition de commandes préexistantes à partir d'un autre processus d'échange

Paramètres
args String : les arguments de configuration.

totalExecTime long : le temps d'exécution cumulé de la commande

Retour
boolean true si la commande a été ajoutée avec succès

Jette
ConfigurationException si la commande était invalide

addCommand

public abstract boolean addCommand (String[] args)

Ajoute une commande au planificateur.

Une commande est essentiellement une instance d'une configuration à exécuter et ses arguments associés.

Si l'argument "--help" est spécifié, le texte d'aide pour la configuration sera envoyé à stdout. Sinon, la configuration sera ajoutée à la file d'attente à exécuter.

Paramètres
args String : les arguments de configuration.

Retour
boolean true si la commande a été ajoutée avec succès

Jette
ConfigurationException si la commande n'a pas pu être analysée

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Ajoute toutes les commandes d'un fichier donné au planificateur

Paramètres
cmdFile String : le chemin du système de fichiers du fichier de commande

extraArgs : une ERROR(/List) d'arguments String à ajouter à chaque commande analysée à partir du fichier. Peut être vide mais ne doit pas être nul.

Jette
ConfigurationException si le fichier de commande n'a pas pu être analysé

Voir également:

attendre

public abstract void await ()

Attend que le planificateur démarre, y compris l'attente de la fin du transfert de l'ancien TF, le cas échéant.

completeHandover

public abstract void completeHandover ()

Informe le planificateur de commandes qu'une séquence de transfert initiée est complètement terminée et qu'il doit réinitialiser son gestionnaire distant sur le port par défaut.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

Affiche des informations de débogage détaillées sur l'état de la file d'attente d'exécution de commande.

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Sortie d'une liste des commandes actuelles.

Paramètres
printWriter PrintWriter : l' ERROR(/PrintWriter) vers laquelle sortir.

regex String : l'expression régulière à laquelle les commandes doivent être mises en correspondance pour être imprimées. Si nul, toutes les commandes seront imprimées.

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Affiche une liste des appels en cours.

Paramètres
printWriter PrintWriter : l' ERROR(/PrintWriter) vers laquelle sortir.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Videz le fichier XML développé pour la commande avec toutes les valeurs Option spécifiées pour toutes les commandes actuelles.

Paramètres
printWriter PrintWriter : l' ERROR(/PrintWriter) vers laquelle afficher l'état.

regex String : l'expression régulière à laquelle les commandes doivent être mises en correspondance pour que le fichier xml soit vidé. Si nul, toutes les commandes seront vidées.

execCommand

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

Alloue directement un périphérique et exécute une commande sans l'ajouter à la file d'attente de commandes à l'aide d'un IInvocationContext déjà existant.

Paramètres
context IInvocationContext : un IInvocationContext existant.

listener ICommandScheduler.IScheduledInvocationListener : le ICommandScheduler.IScheduledInvocationListener à informer

args String : les arguments de la commande

Jette
ConfigurationException si la commande était invalide
NoDeviceException s'il n'y a pas d'appareil à utiliser

execCommand

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

Alloue directement un périphérique et exécute une commande sans l'ajouter à la file d'attente de commandes.

Paramètres
listener ICommandScheduler.IScheduledInvocationListener : le ICommandScheduler.IScheduledInvocationListener à informer

args String : les arguments de la commande

Jette
ConfigurationException si la commande était invalide
NoDeviceException s'il n'y a pas d'appareil à utiliser

execCommand

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

Exécutez directement la commande sur le périphérique déjà alloué.

Paramètres
listener ICommandScheduler.IScheduledInvocationListener : le ICommandScheduler.IScheduledInvocationListener à informer

device ITestDevice : l' ITestDevice à utiliser

args String : les arguments de la commande

Jette
ConfigurationException si la commande était invalide

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Obtenez le CommandFileWatcher approprié pour ce planificateur

Retour
CommandFileWatcher

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Renvoie les informations sur un appel en spécifiant l'ID d'appel.

Paramètres
invocationId int : l'identifiant de suivi de l'invocation.

Retour
String Une String contenant des informations sur l'appel.

getLastInvocationExitCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Renvoie le code d'erreur de la dernière invocation exécutée. Renvoie 0 (aucune erreur), si aucune invocation n'a encore été exécutée.

Retour
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

Renvoyez le Throwable de la dernière invocation exécutée. Renvoie null, si aucun jetable n'est disponible.

Retour
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

Renvoie le nombre de commandes à l'état prêt dans la file d'attente.

Retour
int

handoverInitiationComplete

public abstract void handoverInitiationComplete ()

Informe le planificateur de commandes que l'échange de transfert initial des périphériques et des commandes en cours d'utilisation est terminé et qu'il peut commencer l'opération de planification.

remise

public abstract boolean handoverShutdown (int handoverPort)

Lance un shutdown() et un transfert vers un autre processus échangé sur ce même hôte.

Le planificateur informera le processus d'échange distant qui écoute sur ce port les périphériques libérés dès qu'ils sont disponibles.

Paramètres
handoverPort int

Retour
boolean true si le lancement du transfert a réussi, false cas contraire

joindre

public abstract void join ()

Attend la fin du planificateur.

Voir également:

joindre

public abstract void join (long millis)

Attend que le planificateur se termine ou expire après la durée spécifiée en millisecondes.

Paramètres
millis long

Voir également:

removeAllCommands

public abstract void removeAllCommands ()

Supprimer toutes les commandes du planificateur

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Configurer le client pour qu'il rapporte les données du faisceau

Paramètres
client ClearcutClient

setLastInvocationExitCode

public abstract void setLastInvocationExitCode ( CommandRunner.ExitCode code, 
                Throwable stack)

Méthode d'assistance, lors de l'exécution dans un contexte CommandRunner , définissez un code d'erreur de sortie et une trace de pile qui peuvent être renvoyées.

Paramètres
code CommandRunner.ExitCode

stack Throwable

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Renvoie true si nous devons arrêter le planificateur sur une erreur de commande

Retour
boolean

fermer

public abstract void shutdown ()

Essayez d'arrêter correctement le planificateur de commandes.

Efface les commandes en attente de test et demande que toutes les invocations en cours s'arrêtent normalement.

Une fois l'arrêt appelé, la boucle principale du planificateur attendra que toutes les invocations en cours se terminent avant de quitter complètement.

shutdownHard

public abstract void shutdownHard ()

Essayez d'arrêter de force le planificateur de commandes.

Similaire à shutdown() , mais tuera également de force la connexion adb, dans une tentative d '«inspirer» les invocations en cours pour se terminer plus rapidement.

shutdownOnEmpty

public abstract void shutdownOnEmpty ()

Similaire à shutdown() , mais attendra à la place que toutes les commandes soient exécutées avant de quitter.

Notez que si des commandes sont en mode boucle, le planificateur ne se fermera jamais.

début

public abstract void start ()

Démarrez ICommandScheduler .

Doit être appelé avant d'appeler d'autres méthodes.

S'exécutera jusqu'à ce que shutdown() soit appelé. voir Thread.start() .

stopInvocation

public abstract boolean stopInvocation (int invocationId)

Arrêtez un appel en cours en spécifiant son id.

Paramètres
invocationId int

Retour
boolean true si l'appel a été arrêté, false dans le cas contraire

Jette
UnsupportedOperationException si l'implémentation ne prend pas en charge cela

stopInvocation

public abstract boolean stopInvocation ( ITestInvocation invocation)

Arrêtez une invocation en cours.

Paramètres
invocation ITestInvocation

Retour
boolean true si l'appel a été arrêté, false dans le cas contraire

Jette
UnsupportedOperationException si l'implémentation ne prend pas en charge cela