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 | |
---|---|
interface | IRunUtil.IRunnableResult Une interface pour exécuter de manière asynchrone une opération qui renvoie un statut 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, ErrorIdentifier errorId) Interrompt les opérations d'exécution en cours/à venir sur le thread donné. |
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 l'état d'interruption de RunUtil. |
abstract Process | runCmdInBackground (Redirect redirect, command) runCmdInBackground (Redirect redirect, command) Une autre méthode |
abstract Process | runCmdInBackground ( command) runCmdInBackground ( command) Une autre méthode |
abstract Process | runCmdInBackground ( command, OutputStream output) runCmdInBackground ( command, OutputStream output) L'exécution de la commande avec une |
abstract Process | runCmdInBackground (String... command) Méthode d'assistance pour exécuter une commande système de manière asynchrone. |
abstract Process | runCmdInBackground (Redirect redirect, String... command) Méthode d'assistance pour exécuter une commande système de manière asynchrone. |
abstract boolean | runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Bloquez et exécutez une opération plusieurs fois jusqu'à ce qu'elle réussisse. |
abstract boolean | runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable) Bloquez et exécutez 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, en l'abandonnant si elle 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 qu'un temps spécifié et rediriger la sortie vers des fichiers si spécifié. |
abstract CommandResult | runTimedCmd (long timeout, String... command) Méthode d'assistance pour exécuter une commande système et abandonner si cela prend plus de temps qu'un temps 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 abandonner 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 abandonner 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 abandonner si cela prend plus de temps qu'un temps spécifié. |
abstract CommandResult | runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command) Méthode d'assistance pour exécuter une commande système, abandonner si cela prend plus de temps qu'un temps spécifié et rediriger la sortie vers des fichiers si 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 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 qu'un 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 son abandon si cela prend plus de temps qu'un temps spécifié. |
abstract boolean | runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable) Bloquez et exécutez 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 de commandes système. |
abstract void | setEnvVariablePriority ( IRunUtil.EnvPriority priority) Décidez si, lors de la création d'un processus, la suppression des variables d'environnement est une priorité plus élevée que leur définition. |
abstract void | setInterruptibleInFuture (Thread thread, long timeMs) Définir comme interruption après un certain temps d'attente. |
abstract void | setLinuxInterruptProcess (boolean interrupt) Autoriser l'utilisation de l'interruption Linux 'kill' sur le processus exécuté via les méthodes #runTimed lorsqu'il atteint un délai d'attente. |
abstract void | setRedirectStderrToStdout (boolean redirect) Définissez le flux d'erreurs standard pour qu'il soit redirigé vers le flux de sortie standard lors de l'exécution de commandes système. |
abstract void | setWorkingDir (File dir) Définit le répertoire de travail pour les commandes système. |
abstract void | sleep (long time) Méthode d'assistance pour dormir pendant une durée donnée, en ignorant les exceptions. |
abstract void | unsetEnvVariable (String key) Désactive une variable d'environnement, de sorte que les commandes système s'exécutent sans cette variable d'environnement. |
Méthodes publiques
autoriser l'interruption
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 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, ErrorIdentifier errorId)
Interrompt les opérations d'exécution en cours/à venir sur le thread donné. Les opérations d'exécution sur le thread donné lanceront RunInterruptedException
.
Paramètres | |
---|---|
message | String : le message pour RunInterruptedException . |
errorId | ErrorIdentifier : Représentant la cause de l’interruption lorsqu’elle est connue. |
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é lanceront RunInterruptedException
.
Paramètres | |
---|---|
message | String : le message pour RunInterruptedException . |
isInterruptAllowed
public abstract boolean isInterruptAllowed ()
Donnez l'état d'interruption de RunUtil.
Retour | |
---|---|
boolean | true si l'exécution peut être interrompue, false sinon. |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect,command)
Une autre méthode runCmdInBackground(String)
qui accepte les arguments de commande sous la forme ERROR(/List)
.
Paramètres | |
---|---|
redirect | Redirect : L' ERROR(/Redirect) à appliquer au ProcessBuilder . |
command | ERROR(/List) contenant la commande système spécifiée et éventuellement les arguments à exec |
Retour | |
---|---|
Process | le Process de la commande exécutée |
Jetés | |
---|---|
| si la commande n'a pas pu s'exécuter |
runCmdInBackground
public abstract Process runCmdInBackground (command)
Une autre méthode runCmdInBackground(String)
qui accepte les arguments de commande sous la forme ERROR(/List)
.
Paramètres | |
---|---|
command | ERROR(/List) contenant la commande système spécifiée et éventuellement les arguments à exec |
Retour | |
---|---|
Process | le Process de la commande exécutée |
Jetés | |
---|---|
| 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 | |
output | OutputStream : le OutputStream pour enregistrer la sortie |
Retour | |
---|---|
Process | le Process exécutant la commande |
Jetés | |
---|---|
| IOException |
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 |
Jetés | |
---|---|
| si la commande n'a pas pu s'exécuter |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect, 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 | |
---|---|
redirect | Redirect : L' ERROR(/Redirect) à appliquer au ProcessBuilder . |
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 |
Jetés | |
---|---|
| si la commande n'a pas pu s'exécuter |
runEscalatingTimedRetry
public abstract boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloquez et exécutez 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 d'attente maximum en ms pour une seule tentative d'opération |
initialPollInterval | long : temps d'attente initial entre les tentatives d'opération |
maxPollInterval | long : le temps d'attente maximum 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)
Bloquez et exécutez une opération plusieurs fois jusqu'à ce qu'elle réussisse.
Paramètres | |
---|---|
opTimeout | long : temps d'attente maximum en ms pour une seule tentative d'opération |
pollInterval | long : temps d'attente initial 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, en l'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 : consigne les erreurs en cas d'exception ou non. |
Retour | |
---|---|
CommandStatus | le résultat de l’opération CommandStatus . |
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 qu'un temps spécifié et rediriger la sortie vers des fichiers si spécifié. Lorsque ERROR(/OutputStream)
sont fournis de cette façon, ils resteront ouverts à la fin de la fonction.
Paramètres | |
---|---|
timeout | long : délai d'attente maximum en ms. 0 signifie pas de délai d'attente. |
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 |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
Méthode d'assistance pour exécuter une commande système et abandonner 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 d'attente. |
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 abandonner 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 pour 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 abandonner si cela prend plus de temps qu'un temps spécifié. Similaire à runTimedCmd(long, String)
, mais n'enregistre 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 abandonner si cela prend plus de temps qu'un temps spécifié. Similaire à runTimedCmdRetry(long, long, int, String[])
, mais n'enregistre 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 pour 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, File stdoutFile, File stderrFile, String... command)
Méthode d'assistance pour exécuter une commande système, abandonner si cela prend plus de temps qu'un temps spécifié et rediriger la sortie vers des fichiers si spécifié.
Paramètres | |
---|---|
timeout | long : délai d'attente maximum en ms. 0 signifie pas de délai d'attente. |
input | String : l'entrée stdin à transmettre au processus |
stdoutFile | File : ERROR(/File) où la sortie std sera redirigée. Peut être nul. |
stderrFile | File : ERROR(/File) 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 |
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 qu'un temps spécifié.
Paramètres | |
---|---|
timeout | long : temps d'attente maximum en ms |
input | String : l'entrée stdin à transmettre 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 |
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 qu'un temps spécifié.
Paramètres | |
---|---|
timeout | long : temps d'attente maximum en ms |
input | String : l'entrée stdin à transmettre au processus |
command | ERROR(/List) contenant la commande système et éventuellement les arguments à exec |
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 son abandon si cela prend plus de temps qu'un 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)
Bloquez et exécutez une opération plusieurs fois jusqu'à ce qu'elle réussisse.
Paramètres | |
---|---|
opTimeout | long : temps d'attente maximum 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 pour essayer |
runnable | IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter |
Retour | |
---|---|
boolean | true si l’opération s’est terminée avec succès avant les tentatives. |
setEnvVariable
public abstract void setEnvVariable (String key, String value)
Définit une variable d'environnement à utiliser lors de l'exécution de 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 suppression des variables d'environnement est une priorité plus élevée que leur définition. Par défaut, la désactivation a une priorité plus élevée : ce qui signifie que si une tentative de définition d'une variable portant le même nom est effectuée, cela n'arrivera pas puisque la variable sera désactivé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éfinir comme interruption après un certain temps d'attente. ERROR(/CommandScheduler#shutdownHard())
pour forcer, nous finissons par terminer.
Paramètres | |
---|---|
thread | Thread : le fil qui deviendra interruption. |
timeMs | long : temps d'attente avant la mise en interruption. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Autoriser l'utilisation de l'interruption Linux 'kill' sur le processus exécuté via les méthodes #runTimed lorsqu'il atteint un délai d'attente. Ne peut pas être utilisé sur l'instance IRunUtil
par défaut.
Paramètres | |
---|---|
interrupt | boolean |
setRedirectStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
Définissez le flux d'erreurs standard pour qu'il soit redirigé vers le flux de sortie standard lors de l'exécution de commandes système. La valeur initiale est fausse.
Paramètres | |
---|---|
redirect | boolean : nouvelle valeur pour savoir s'il faut ou non rediriger |
Voir également:
setWorkingDir
public abstract void setWorkingDir (File dir)
Définit le répertoire de travail pour les commandes système.
Paramètres | |
---|---|
dir | File : le répertoire de travail |
Voir également:
dormir
public abstract void sleep (long time)
Méthode d'assistance pour dormir pendant une durée donnée, 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)
Désactive 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:
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2023/12/01 (UTC).