IRunUtil
public
interface
IRunUtil
| com.android.tradefed.util.IRunUtil |
Interface permettant d'exécuter des opérations programmées et des commandes système.
Résumé
Classes imbriquées | |
|---|---|
interface |
IRunUtil.IRunnableResult
Interface permettant d'exécuter de manière asynchrone une opération qui renvoie un état booléen. |
Méthodes publiques | |
|---|---|
abstract
void
|
allowInterrupt(boolean allow)
Autorise ou 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()
Indique l'état d'interruption de RunUtil. |
abstract
Process
|
runCmdInBackground(ProcessBuilder.Redirect redirect, List<String> command)
Méthode |
abstract
Process
|
runCmdInBackground(ProcessBuilder.Redirect redirect, String... command)
Méthode d'assistance pour exécuter une commande système de manière asynchrone. |
abstract
Process
|
runCmdInBackground(List<String> command)
Méthode |
abstract
Process
|
runCmdInBackground(String... command)
Méthode d'assistance pour exécuter une commande système de manière asynchrone. |
abstract
Process
|
runCmdInBackground(List<String> command, OutputStream output)
L'exécution d'une commande avec |
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 aboutisse. |
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 aboutisse. |
abstract
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloque et exécute une opération plusieurs fois jusqu'à ce qu'elle aboutisse. |
abstract
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloque et exécute une opération, en l'annulant si elle prend plus de temps que prévu. |
abstract
CommandResult
|
runTimedCmd(long timeout, String... command)
Méthode d'assistance pour exécuter une commande système et l'annuler si elle prend plus de temps que prévu. |
abstract
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
Méthode d'assistance pour exécuter une commande système, l'annuler si elle prend plus de temps que prévu et rediriger la sortie vers des 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 l'annuler si elle prend plus de temps que prévu. |
abstract
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Méthode d'assistance pour exécuter une commande système et l'annuler si elle prend plus de temps que prévu. |
abstract
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Méthode d'assistance pour exécuter une commande système et l'annuler si elle prend plus de temps que prévu. |
abstract
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Méthode d'assistance pour exécuter une commande système et l'annuler si elle prend plus de temps que prévu. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
Méthode d'assistance pour exécuter une commande système nécessitant une entrée stdin et l'annuler si elle prend plus de temps que spécifié. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, List<String> command)
Méthode d'assistance pour exécuter une commande système nécessitant une entrée stdin et l'annuler si elle prend plus de temps que 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, l'annuler si elle prend plus de temps que prévu et rediriger la sortie vers des fichiers si spécifié. |
abstract
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
Méthode d'assistance permettant d'exécuter une commande système qui nécessite la redirection de Stdin à partir d'un fichier et l'abandon si elle prend plus de temps que spécifié. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
Méthode d'assistance pour exécuter une commande système et l'annuler si elle prend plus de temps que prévu. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Méthode d'assistance pour exécuter une commande système, l'annuler si elle prend plus de temps que prévu et rediriger la sortie vers des fichiers si 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 aboutisse. |
abstract
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloque et exécute une opération plusieurs fois jusqu'à ce qu'elle aboutisse. |
abstract
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloque et exécute une opération, en l'annulant si elle prend plus de temps que prévu. |
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 suppression d'une variable d'environnement est plus prioritaire que sa définition. |
abstract
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Définissez-le comme interruptible après un certain temps d'attente. |
abstract
void
|
setLinuxInterruptProcess(boolean interrupt)
Permet d'utiliser l'interruption "kill" de Linux sur les processus exécutés via les méthodes #runTimed lorsqu'ils atteignent un délai d'expiration. |
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 pour les commandes système. |
abstract
void
|
sleep(long time)
Méthode d'assistance pour mettre en veille pendant une durée donnée, en ignorant les exceptions. |
abstract
void
|
unsetEnvVariable(String key)
Annule la définition d'une variable d'environnement afin que les commandes système s'exécutent sans cette variable d'environnement. |
Méthodes publiques
allowInterrupt
public abstract void allowInterrupt (boolean allow)
Autorise ou interdit les interruptions d'exécution sur le thread actuel. Si cela est autorisé, les opérations du thread actuel peuvent être interrompues à partir d'autres threads via la méthode interrupt(Thread, String).
| Paramètres | |
|---|---|
allow |
boolean : indique 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é généreront RunInterruptedException.
| Paramètres | |
|---|---|
message |
String : message pour RunInterruptedException. |
errorId |
ErrorIdentifier : représente la cause de l'interruption, le cas échéant. |
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é généreront RunInterruptedException.
| Paramètres | |
|---|---|
message |
String : message pour RunInterruptedException. |
isInterruptAllowed
public abstract boolean isInterruptAllowed ()
Indique l'état d'interruption de RunUtil.
| Renvoie | |
|---|---|
boolean |
"true" si l'exécution peut être interrompue, "false" dans le cas contraire. |
runCmdInBackground
public abstract Process runCmdInBackground (ProcessBuilder.Redirect redirect,
List<String> command)Méthode runCmdInBackground(String...) alternative qui accepte les arguments de commande au format List.
| Paramètres | |
|---|---|
redirect |
ProcessBuilder.Redirect : Redirect à appliquer à ProcessBuilder. |
command |
List : List contenant la commande système spécifiée et, éventuellement, les arguments à exécuter |
| Renvoie | |
|---|---|
Process |
le Process de la commande exécutée. |
| Génère | |
|---|---|
IOException |
si la commande n'a pas pu s'exécuter. |
runCmdInBackground
public abstract Process runCmdInBackground (ProcessBuilder.Redirect redirect,
String... command)Méthode d'assistance pour exécuter une commande système de manière asynchrone.
Le résultat arrive immédiatement après le lancement de la commande.
| Paramètres | |
|---|---|
redirect |
ProcessBuilder.Redirect : Redirect à appliquer à ProcessBuilder. |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
Process |
le Process de la commande exécutée. |
| Génère | |
|---|---|
IOException |
si la commande n'a pas pu s'exécuter. |
runCmdInBackground
public abstract Process runCmdInBackground (List<String> command)
Méthode runCmdInBackground(String...) alternative qui accepte les arguments de commande au format List.
| Paramètres | |
|---|---|
command |
List : List contenant la commande système spécifiée et, éventuellement, les arguments à exécuter |
| Renvoie | |
|---|---|
Process |
le Process de la commande exécutée. |
| Génère | |
|---|---|
IOException |
si la commande n'a pas pu s'exécuter. |
runCmdInBackground
public abstract Process runCmdInBackground (String... command)
Méthode d'assistance pour exécuter une commande système de manière asynchrone.
Le résultat arrive immédiatement après le lancement de la commande.
| Paramètres | |
|---|---|
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
Process |
le Process de la commande exécutée. |
| Génère | |
|---|---|
IOException |
si la commande n'a pas pu s'exécuter. |
runCmdInBackground
public abstract Process runCmdInBackground (List<String> command,
OutputStream output)L'exécution d'une commande avec OutputStream enregistre la sortie de la commande.
Stdout et stderr sont fusionnés.
| Paramètres | |
|---|---|
command |
List : commande à exécuter |
output |
OutputStream : OutputStream pour enregistrer le résultat |
| Renvoie | |
|---|---|
Process |
le Process exécutant la commande. |
| Génère | |
|---|---|
|
java.io.IOException |
IOException |
|
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 aboutisse.
Augmentez de manière exponentielle le temps d'attente entre les tentatives d'opération. Cette méthode est destinée à être utilisée lors d'une opération telle que l'interrogation d'un serveur, afin de lui donner le temps de se rétablir en cas d'indisponibilité temporaire.
| Paramètres | |
|---|---|
opTimeout |
long : durée d'attente maximale en ms pour une tentative d'opération unique |
initialPollInterval |
long : délai d'attente initial entre les tentatives d'opération |
maxPollInterval |
long : durée maximale d'attente entre les tentatives d'opération |
maxTime |
long : durée maximale approximative totale pour réessayer l'opération |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter |
| Renvoie | |
|---|---|
boolean |
true si l'opération s'est terminée 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 aboutisse.
| Paramètres | |
|---|---|
opTimeout |
long : durée d'attente maximale en ms pour une tentative d'opération unique |
pollInterval |
long : délai d'attente initial entre les tentatives d'opération |
maxTime |
long : durée maximale approximative totale pour réessayer l'opération |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter |
| Renvoie | |
|---|---|
boolean |
true si l'opération s'est terminée avant l'expiration de maxTime |
runFixedTimedRetryWithOutputMonitor
public abstract boolean runFixedTimedRetryWithOutputMonitor (long opTimeout,
long idleOutputTimeout,
long pollInterval,
long maxTime,
IRunUtil.IRunnableResult runnable)Bloque et exécute une opération plusieurs fois jusqu'à ce qu'elle aboutisse. Il surveille également l'activité des flux de sortie et abandonne l'opération si aucune activité de flux n'est observée pendant une durée spécifiée. Si idleOutputTimeout est défini sur zéro, aucune surveillance du flux n'est effectuée.
| Paramètres | |
|---|---|
opTimeout |
long : durée d'attente maximale en ms pour une tentative d'opération unique |
idleOutputTimeout |
long : durée maximale d'attente en ms pour la sortie sur les flux de sortie |
pollInterval |
long : délai d'attente initial entre les tentatives d'opération |
maxTime |
long : durée maximale approximative totale pour réessayer l'opération |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter |
| Renvoie | |
|---|---|
boolean |
true si l'opération s'est terminée 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'annulant si elle prend plus de temps que prévu.
| Paramètres | |
|---|---|
timeout |
long : temps d'attente maximal en ms |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter |
logErrors |
boolean : indique si les erreurs doivent être consignées en cas d'exception. |
| Renvoie | |
|---|---|
CommandStatus |
le résultat CommandStatus de l'opération. |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
Méthode d'assistance pour exécuter une commande système et l'annuler si elle prend plus de temps que prévu.
| Paramètres | |
|---|---|
timeout |
long : temps d'attente maximal en ms. 0 signifie aucune limite de temps. |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Méthode d'assistance pour exécuter une commande système, l'annuler si elle prend plus de temps que prévu et rediriger la sortie vers des fichiers si spécifié. Lorsque les OutputStream sont fournis de cette manière, ils restent ouverts à la fin de la fonction.
| Paramètres | |
|---|---|
timeout |
long : délai maximal d'attente en ms. 0 signifie aucun délai d'attente. |
stdout |
OutputStream : OutputStream où la sortie standard sera redirigée. Ce paramètre peut présenter la valeur null. |
stderr |
OutputStream : OutputStream où la sortie d'erreur sera redirigée. Ce paramètre peut présenter la valeur null. |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
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 l'annuler si elle prend plus de temps que prévu.
| Paramètres | |
|---|---|
timeout |
long : durée d'attente maximale en ms pour chaque tentative |
retryInterval |
long : délai d'attente entre les nouvelles tentatives de commande |
attempts |
int : nombre maximal de tentatives |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
runTimedCmdRetryWithOutputMonitor
public abstract CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Méthode d'assistance pour exécuter une commande système et l'annuler si elle prend plus de temps que prévu. Il surveille également l'activité des flux de sortie et interrompt le processus si aucune activité de flux n'est observée pendant une période spécifiée. Si idleOutputTimeout est défini sur zéro, aucune surveillance du flux n'est effectuée.
| Paramètres | |
|---|---|
timeout |
long : durée d'attente maximale en ms pour chaque tentative |
idleOutputTimeout |
long : durée maximale d'attente en ms pour la sortie sur les flux de sortie |
retryInterval |
long : délai d'attente entre les nouvelles tentatives de commande |
attempts |
int : nombre maximal de tentatives |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
runTimedCmdSilently
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
Méthode d'assistance pour exécuter une commande système et l'annuler si elle prend plus de temps que prévu. Semblable à runTimedCmd(long,String...), mais ne consigne aucune erreur en cas d'exception.
| Paramètres | |
|---|---|
timeout |
long : temps d'attente maximal en ms |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
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 l'annuler si elle prend plus de temps que prévu. Semblable à runTimedCmdRetry(long,long,int,String[]), mais ne consigne aucune erreur en cas d'exception.
| Paramètres | |
|---|---|
timeout |
long : temps d'attente maximal en ms |
retryInterval |
long : délai d'attente entre les nouvelles tentatives de commande |
attempts |
int : nombre maximal de tentatives |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Méthode d'assistance pour exécuter une commande système nécessitant une entrée stdin et l'annuler si elle prend plus de temps que spécifié.
| Paramètres | |
|---|---|
timeout |
long : temps d'attente maximal en ms |
input |
String : entrée stdin à transmettre au processus |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, List<String> command)
Méthode d'assistance pour exécuter une commande système nécessitant une entrée stdin et l'annuler si elle prend plus de temps que spécifié.
| Paramètres | |
|---|---|
timeout |
long : temps d'attente maximal en ms |
input |
String : entrée stdin à transmettre au processus |
command |
List : List contenant la commande système et, éventuellement, les arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
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, l'annuler si elle prend plus de temps que prévu et rediriger la sortie vers des fichiers si spécifié.
| Paramètres | |
|---|---|
timeout |
long : délai maximal d'attente en ms. 0 signifie aucun délai d'attente. |
input |
String : entrée stdin à transmettre au processus |
stdoutFile |
File : File où la sortie standard sera redirigée. Ce paramètre peut présenter la valeur null. |
stderrFile |
File : File où la sortie d'erreur sera redirigée. Ce paramètre peut présenter la valeur null. |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
runTimedCmdWithInputRedirect
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Méthode d'assistance permettant d'exécuter une commande système qui nécessite la redirection de Stdin à partir d'un fichier et l'abandon si elle prend plus de temps que spécifié.
| Paramètres | |
|---|---|
timeout |
long : temps d'attente maximal en ms |
inputRedirect |
File : File à rediriger en tant qu'entrée standard à l'aide de ProcessBuilder.redirectInput(). Si la valeur est nulle, stdin ne sera pas redirigé. |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Méthode d'assistance pour exécuter une commande système et l'annuler si elle prend plus de temps que prévu. Il surveille également l'activité des flux de sortie et interrompt le processus si aucune activité de flux n'est observée pendant une période spécifiée. Si idleOutputTimeout est défini sur zéro, aucune surveillance du flux n'est effectuée.
| Paramètres | |
|---|---|
timeout |
long : temps d'attente maximal en ms. 0 signifie aucune limite de temps. |
idleOutputTimeout |
long : durée maximale d'attente en ms pour la sortie sur les flux de sortie |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Méthode d'assistance pour exécuter une commande système, l'annuler si elle prend plus de temps que prévu et rediriger la sortie vers des fichiers si spécifié. Lorsque les OutputStream sont fournis de cette manière, ils restent ouverts à la fin de la fonction.
| Paramètres | |
|---|---|
timeout |
long : délai maximal d'attente en ms. 0 signifie aucun délai d'attente. |
idleOutputTimeout |
long : durée maximale d'attente en ms pour la sortie sur les flux de sortie |
stdout |
OutputStream : OutputStream où la sortie standard sera redirigée. Ce paramètre peut présenter la valeur null. |
stderr |
OutputStream : OutputStream où la sortie d'erreur sera redirigée. Ce paramètre peut présenter la valeur null. |
command |
String : commande système spécifiée et, éventuellement, arguments à exécuter |
| Renvoie | |
|---|---|
CommandResult |
un CommandResult contenant le résultat de la commande exécutée. |
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 aboutisse.
| Paramètres | |
|---|---|
opTimeout |
long : durée d'attente maximale en ms pour une tentative d'opération |
pollInterval |
long : délai d'attente entre les nouvelles tentatives de commande |
attempts |
int : nombre maximal de tentatives |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter |
| Renvoie | |
|---|---|
boolean |
true si l'opération a abouti avant que le nombre de tentatives ne soit atteint. |
runTimedRetryWithOutputMonitor
public abstract boolean runTimedRetryWithOutputMonitor (long opTimeout,
long idleOutputTimeout,
long pollInterval,
int attempts,
IRunUtil.IRunnableResult runnable)Bloque et exécute une opération plusieurs fois jusqu'à ce qu'elle aboutisse. Il surveille également l'activité des flux de sortie et abandonne l'opération si aucune activité de flux n'est observée pendant une durée spécifiée. Si idleOutputTimeout est défini sur zéro, aucune surveillance du flux n'est effectuée.
| Paramètres | |
|---|---|
opTimeout |
long : durée d'attente maximale en ms pour une tentative d'opération |
idleOutputTimeout |
long : durée maximale d'attente en ms pour la sortie sur les flux de sortie |
pollInterval |
long : délai d'attente entre les nouvelles tentatives de commande |
attempts |
int : nombre maximal de tentatives |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter |
| Renvoie | |
|---|---|
boolean |
true si l'opération a abouti avant que le nombre de tentatives ne soit atteint. |
runTimedWithOutputMonitor
public abstract CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloque et exécute une opération, en l'annulant si elle prend plus de temps que prévu. Il surveille également les flux de sortie pour détecter toute activité et interrompt le processus si aucune activité de flux n'est observée pendant une période spécifiée. Si idleOutputTimeout est défini sur zéro, aucune surveillance du flux n'est effectuée.
| Paramètres | |
|---|---|
timeout |
long : temps d'attente maximal en ms |
idleOutputTimeout |
long : durée maximale d'attente en ms pour la sortie sur les flux de sortie |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult à exécuter |
logErrors |
boolean : indique si les erreurs doivent être consignées en cas d'exception. |
| Renvoie | |
|---|---|
CommandStatus |
le résultat CommandStatus de l'opération. |
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 : nom de la variable |
value |
String : valeur de la variable |
Voir aussi :
setEnvVariablePriority
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Décidez si, lors de la création d'un processus, la suppression d'une variable d'environnement est plus prioritaire que sa définition.
Par défaut, la suppression d'une variable est prioritaire. Cela signifie que si vous essayez de définir une variable portant le même nom, cela ne fonctionnera pas, car la variable sera supprimé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éfinissez-le comme interruptible après un certain temps d'attente.
ERROR(/CommandScheduler#shutdownHard()) pour forcer l'arrêt.
| Paramètres | |
|---|---|
thread |
Thread : thread qui deviendra interruptible. |
timeMs |
long : délai d'attente avant de définir l'état "interruptible". |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Permet d'utiliser l'interruption "kill" de Linux sur les processus exécutés via les méthodes #runTimed lorsqu'ils atteignent un délai d'expiration.
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'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 "false".
| Paramètres | |
|---|---|
redirect |
boolean : nouvelle valeur indiquant s'il faut rediriger ou non |
Voir aussi :
setWorkingDir
public abstract void setWorkingDir (File dir)
Définit le répertoire de travail pour les commandes système.
| Paramètres | |
|---|---|
dir |
File : répertoire de travail |
Voir aussi :
sommeil
public abstract void sleep (long time)
Méthode d'assistance pour mettre en veille pendant une durée donnée, en ignorant les exceptions.
| Paramètres | |
|---|---|
time |
long : nombre de millisecondes de veille. Les valeurs inférieures ou égales à 0 seront ignorées. |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
Annule la définition d'une variable d'environnement afin que les commandes système s'exécutent sans cette variable d'environnement.
| Paramètres | |
|---|---|
key |
String : nom de la variable |
Voir aussi :