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

IRunUtil

public interface IRunUtil

com.android.tradefed.util.IRunUtil


Interface pour exécuter des opérations chronométrées et des commandes système.

Résumé

Classes imbriquées

enum IRunUtil.EnvPriority

Énumération qui définit s'il s'agit de définir ou de désactiver un env particulier.

interface IRunUtil.IRunnableResult

Une interface pour exécuter de manière asynchrone une opération qui renvoie un état booléen.

Méthodes publiques

abstract void allowInterrupt (boolean allow)

Autorise / interdit les interruptions d'exécution sur le thread actuel.

abstract void interrupt (Thread thread, String message)

Interrompt les opérations d'exécution en cours / à venir sur le thread donné.

abstract boolean isInterruptAllowed ()

Donnez le statut d'interruption de RunUtil.

abstract Process runCmdInBackground (String... command)

Méthode d'assistance pour exécuter une commande système de manière asynchrone.

abstract Process runCmdInBackground ( command) runCmdInBackground ( command)

Une autre runCmdInBackground(String) qui accepte les arguments de commande sous la forme ERROR(/List) .

abstract Process runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output)

L'exécution de la commande avec une ERROR(/OutputStream) enregistre la sortie de la commande.

abstract boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

Bloque et exécute une opération plusieurs fois jusqu'à ce qu'elle réussisse.

abstract boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)

Bloque et exécute une opération plusieurs fois jusqu'à ce qu'elle réussisse.

abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)

Bloque et exécute une opération, abandonnant si elle prend plus de temps qu'un temps spécifié.

abstract CommandResult runTimedCmd (long timeout, String... command)

Méthode d'assistance pour exécuter une commande système, et abandon si cela prend plus de temps qu'un temps spécifié.

abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)

Méthode d'assistance pour exécuter une commande système, abandonner si cela prend plus de temps que le temps spécifié et rediriger la sortie vers les fichiers si spécifié.

abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)

Méthode d'assistance pour exécuter une commande système, et abandon si cela prend plus de temps qu'un temps spécifié.

abstract CommandResult runTimedCmdSilently (long timeout, String... command)

Méthode d'assistance pour exécuter une commande système, et abandon si cela prend plus de temps qu'un temps spécifié.

abstract CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)

Méthode d'assistance pour exécuter une commande système, et abandon si cela prend plus de temps qu'un temps spécifié.

abstract CommandResult runTimedCmdWithInput (long timeout, String input, command) runTimedCmdWithInput (long timeout, String input, command)

Méthode d'assistance pour exécuter une commande système qui nécessite une entrée stdin, et abandonner si cela prend plus de temps que le temps spécifié.

abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)

Méthode d'assistance pour exécuter une commande système qui nécessite une entrée stdin, et abandonner si cela prend plus de temps que le temps spécifié.

abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)

Méthode d'assistance pour exécuter une commande système qui nécessite la redirection de Stdin à partir d'un fichier et l'abandon si cela prend plus de temps que le temps spécifié.

abstract boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)

Bloque et exécute une opération plusieurs fois jusqu'à ce qu'elle réussisse.

abstract void setEnvVariable (String key, String value)

Définit une variable d'environnement à utiliser lors de l'exécution des commandes système.

abstract void setEnvVariablePriority ( IRunUtil.EnvPriority priority)

Décidez si, lors de la création d'un processus, la désactivation de la variable d'environnement est une priorité plus élevée que leur définition.

abstract void setInterruptibleInFuture (Thread thread, long timeMs)

Défini comme interruptible après un certain temps d'attente.

abstract void setRedirectStderrToStdout (boolean redirect)

Définissez le flux d'erreur standard pour qu'il soit redirigé vers le flux de sortie standard lors de l'exécution des commandes système.

abstract void setWorkingDir (File dir)

Définit le répertoire de travail des commandes système.

abstract void sleep (long time)

Méthode d'assistance pour dormir pendant un temps donné, en ignorant les exceptions.

abstract void unsetEnvVariable (String key)

Annule une variable d'environnement, de sorte que les commandes système s'exécutent sans cette variable d'environnement.

Méthodes publiques

allowInterrupt

public abstract void allowInterrupt (boolean allow)

Autorise / interdit les interruptions d'exécution sur le thread actuel. Si cela est autorisé, les opérations d'exécution du thread actuel peuvent être interrompues à partir d'autres threads via la méthode d' interrupt(Thread, String) .

Paramètres
allow boolean : s'il faut autoriser les interruptions d'exécution sur le thread actuel.

interrompre

public abstract void interrupt (Thread thread, 
                String message)

Interrompt les opérations d'exécution en cours / à venir sur le thread donné. Les opérations d'exécution sur le thread donné RunInterruptedException .

Paramètres
message String : le message pour RunInterruptedException .

isInterruptAllowed

public abstract boolean isInterruptAllowed ()

Donnez le statut d'interruption de RunUtil.

Retour
boolean true si le Run peut être interrompu, false dans le cas contraire.

runCmdInBackground

public abstract Process runCmdInBackground (String... command)

Méthode d'assistance pour exécuter une commande système de manière asynchrone.

Reviendra immédiatement après le lancement de la commande.

Paramètres
command String : la commande système spécifiée et éventuellement les arguments à exécuter

Retour
Process le Process de la commande exécutée

Jette
si la commande n'a pas pu s'exécuter

runCmdInBackground

public abstract Process runCmdInBackground ( command)

Une autre runCmdInBackground(String) qui accepte les arguments de commande sous la forme ERROR(/List) .

Paramètres
command : l' ERROR(/List) contenant la commande système spécifiée et éventuellement les arguments à exécuter

Retour
Process le Process de la commande exécutée

Jette
si la commande n'a pas pu s'exécuter

runCmdInBackground

public abstract Process runCmdInBackground ( command, 
                OutputStream output)

L'exécution de la commande avec une ERROR(/OutputStream) enregistre la sortie de la commande. Stdout et stderr sont fusionnés.

Paramètres
command : la commande à exécuter

output OutputStream : le OutputStream pour enregistrer la sortie

Retour
Process le Process exécutant la commande

runEscalatingTimedRetry

public abstract boolean runEscalatingTimedRetry (long opTimeout, 
                long initialPollInterval, 
                long maxPollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Bloque et exécute une opération plusieurs fois jusqu'à ce qu'elle réussisse.

Augmentez de manière exponentielle le temps d'attente entre les tentatives d'opération. Ceci est destiné à être utilisé lors de l'exécution d'une opération telle que l'interrogation d'un serveur, pour lui donner le temps de récupérer en cas de panne temporaire.

Paramètres
opTimeout long : temps maximum d'attente en ms pour une seule tentative d'opération

initialPollInterval long : délai initial d'attente entre les tentatives d'opération

maxPollInterval long : le temps maximum d'attente entre les tentatives d'opération

maxTime long : le temps maximum approximatif total pour continuer à essayer l'opération

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter

Retour
boolean true si l'opération s'est terminée avec succès avant l'expiration de maxTime

runFixedTimedRetry

public abstract boolean runFixedTimedRetry (long opTimeout, 
                long pollInterval, 
                long maxTime, 
                IRunUtil.IRunnableResult runnable)

Bloque et exécute une opération plusieurs fois jusqu'à ce qu'elle réussisse.

Paramètres
opTimeout long : temps maximum d'attente en ms pour une seule tentative d'opération

pollInterval long : délai initial d'attente entre les tentatives d'opération

maxTime long : le temps maximum approximatif total pour continuer à essayer l'opération

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter

Retour
boolean true si l'opération s'est terminée avec succès avant l'expiration de maxTime

runTimed

public abstract CommandStatus runTimed (long timeout, 
                IRunUtil.IRunnableResult runnable, 
                boolean logErrors)

Bloque et exécute une opération, abandonnant si elle prend plus de temps qu'un temps spécifié.

Paramètres
timeout long : temps d'attente maximum en ms

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter

logErrors boolean : consigner les erreurs sur exception ou non.

Retour
CommandStatus le résultat de l'opération CommandStatus .

runTimedCmd

public abstract CommandResult runTimedCmd (long timeout, 
                String... command)

Méthode d'assistance pour exécuter une commande système, et abandon si cela prend plus de temps qu'un temps spécifié.

Paramètres
timeout long : temps d'attente maximum en ms. 0 signifie pas de délai.

command String : la commande système spécifiée et éventuellement les arguments à exécuter

Retour
CommandResult un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmd

public abstract CommandResult runTimedCmd (long timeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                String... command)

Méthode d'assistance pour exécuter une commande système, abandonner si cela prend plus de temps que le temps spécifié et rediriger la sortie vers les fichiers si spécifié. Lorsque ERROR(/OutputStream) est fourni de cette façon, ils seront laissés ouverts à la fin de la fonction.

Paramètres
timeout long : délai d'attente maximum en ms. 0 signifie pas de délai.

stdout OutputStream : ERROR(/OutputStream) où la sortie std sera redirigée. Peut être nul.

stderr OutputStream : ERROR(/OutputStream) où la sortie d'erreur sera redirigée. Peut être nul.

command String : la commande système spécifiée et éventuellement les arguments à exécuter

Retour
CommandResult un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdRetry

public abstract CommandResult runTimedCmdRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

Méthode d'assistance pour exécuter une commande système, et abandon si cela prend plus de temps qu'un temps spécifié.

Paramètres
timeout long : temps d'attente maximum en ms pour chaque tentative

retryInterval long : temps d'attente entre les tentatives de commande

attempts int : le nombre maximum de tentatives d'essayer

command String : la commande système spécifiée et éventuellement les arguments à exécuter

Retour
CommandResult un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdSilently

public abstract CommandResult runTimedCmdSilently (long timeout, 
                String... command)

Méthode d'assistance pour exécuter une commande système, et abandon si cela prend plus de temps qu'un temps spécifié. Similaire à runTimedCmd(long, String) , mais ne consigne aucune erreur en cas d'exception.

Paramètres
timeout long : temps d'attente maximum en ms

command String : la commande système spécifiée et éventuellement les arguments à exécuter

Retour
CommandResult un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdSilentlyRetry

public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, 
                long retryInterval, 
                int attempts, 
                String... command)

Méthode d'assistance pour exécuter une commande système, et abandon si cela prend plus de temps qu'un temps spécifié. Similaire à runTimedCmdRetry(long, long, int, String[]) , mais ne consigne aucune erreur en cas d'exception.

Paramètres
timeout long : temps d'attente maximum en ms

retryInterval long : temps d'attente entre les tentatives de commande

attempts int : le nombre maximum de tentatives d'essayer

command String : la commande système spécifiée et éventuellement les arguments à exécuter

Retour
CommandResult un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdWithInput

public abstract CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                 command)

Méthode d'assistance pour exécuter une commande système qui nécessite une entrée stdin, et abandonner si cela prend plus de temps que le temps spécifié.

Paramètres
timeout long : temps d'attente maximum en ms

input String : l'entrée stdin à passer au processus

command : ERROR(/List) contenant la commande système et éventuellement des arguments à exécuter

Retour
CommandResult un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdWithInput

public abstract CommandResult runTimedCmdWithInput (long timeout, 
                String input, 
                String... command)

Méthode d'assistance pour exécuter une commande système qui nécessite une entrée stdin, et abandonner si cela prend plus de temps que le temps spécifié.

Paramètres
timeout long : temps d'attente maximum en ms

input String : l'entrée stdin à passer au processus

command String : la commande système spécifiée et éventuellement les arguments à exécuter

Retour
CommandResult un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdWithInputRedirect

public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, 
                File inputRedirect, 
                String... command)

Méthode d'assistance pour exécuter une commande système qui nécessite la redirection de Stdin à partir d'un fichier et l'abandon si cela prend plus de temps que le temps spécifié.

Paramètres
timeout long : temps d'attente maximum en ms

inputRedirect File : l' ERROR(/File) à rediriger comme entrée standard à l'aide de ProcessBuilder.redirectInput() . Si nul, stdin ne sera pas redirigé.

command String : la commande système spécifiée et éventuellement les arguments à exécuter

Retour
CommandResult un CommandResult contenant le résultat de l'exécution de la commande

runTimedRetry

public abstract boolean runTimedRetry (long opTimeout, 
                long pollInterval, 
                int attempts, 
                IRunUtil.IRunnableResult runnable)

Bloque et exécute une opération plusieurs fois jusqu'à ce qu'elle réussisse.

Paramètres
opTimeout long : temps maximum d'attente en ms pour une tentative d'opération

pollInterval long : temps d'attente entre les tentatives de commande

attempts int : le nombre maximum de tentatives d'essayer

runnable IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter

Retour
boolean true si l'opération s'est terminée avec succès avant que les tentatives ne soient atteintes.

setEnvVariable

public abstract void setEnvVariable (String key, 
                String value)

Définit une variable d'environnement à utiliser lors de l'exécution des commandes système.

Paramètres
key String : le nom de la variable

value String : la valeur de la variable

Voir également:

setEnvVariablePriority

public abstract void setEnvVariablePriority ( IRunUtil.EnvPriority priority)

Décidez si, lors de la création d'un processus, la désactivation de la variable d'environnement est une priorité plus élevée que leur définition. Par défaut, la désactivation est une priorité plus élevée: ce qui signifie que si une tentative de définition d'une variable avec le même nom est faite, cela ne se produira pas car la variable sera annulée. Ne peut pas être utilisé sur l'instance IRunUtil par défaut.

Paramètres
priority IRunUtil.EnvPriority

setInterruptibleInFuture

public abstract void setInterruptibleInFuture (Thread thread, 
                long timeMs)

Défini comme interruptible après un certain temps d'attente. CommandScheduler#shutdownHard() pour appliquer nous nous terminons finalement.

Paramètres
thread Thread : le fil qui deviendra interruptible.

timeMs long : temps d'attente avant de régler interruptible.

setRedirectStderrToStdout

public abstract void setRedirectStderrToStdout (boolean redirect)

Définissez le flux d'erreur standard pour qu'il soit redirigé vers le flux de sortie standard lors de l'exécution des commandes système. La valeur initiale est fausse.

Paramètres
redirect boolean : nouvelle valeur pour rediriger ou non

setWorkingDir

public abstract void setWorkingDir (File dir)

Définit le répertoire de travail des commandes système.

Paramètres
dir File : le répertoire de travail

dormir

public abstract void sleep (long time)

Aide à dormir pendant un temps donné, en ignorant les exceptions.

Paramètres
time long : ms pour dormir. les valeurs inférieures ou égales à 0 seront ignorées

unsetEnvVariable

public abstract void unsetEnvVariable (String key)

Annule une variable d'environnement, de sorte que les commandes système s'exécutent sans cette variable d'environnement.

Paramètres
key String : le nom de la variable

Voir également: