IRunUtil

public interface IRunUtil

com.android.tradefed.util.IRunUtil


Interface permettant d'exécuter des opérations chronométré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/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()

Donne l'état d'interruption à RunUtil.

abstract Process runCmdInBackground(Redirect redirect, command)

Une autre méthode runCmdInBackground(String) qui accepte les arguments de la commande au format ERROR(/List).

abstract Process runCmdInBackground( command)

Une autre méthode runCmdInBackground(String) qui accepte les arguments de la commande au format ERROR(/List).

abstract Process runCmdInBackground( command, OutputStream output)

L'exécution de la commande avec ERROR(/OutputStream) consigne le résultat de la commande.

abstract Process runCmdInBackground(String... command)

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

abstract Process runCmdInBackground(Redirect redirect, String... command)

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

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. L'opération est annulée si elle dépasse le délai spécifié.

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

Méthode d'assistance permettant d'exécuter une commande système, abandonnée si elle prend plus de temps que le temps spécifié et rediriger la sortie vers des fichiers si spécifié.

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

Méthode d'assistance permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel.

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

Méthode d'assistance permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel.

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

Méthode d'assistance permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel.

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

Méthode d'assistance permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel.

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

Méthode d'assistance permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel.

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

Méthode d'assistance permettant d'exécuter une commande système, abandonnée si elle prend plus de temps que le 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 permettant d'exécuter une commande système qui nécessite une entrée stdin et de l'abandonner si elle prend plus de temps que la durée spécifiée.

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

Méthode d'assistance permettant d'exécuter une commande système qui nécessite une entrée stdin et de l'abandonner si elle prend plus de temps que la durée spécifiée.

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

Méthode d'assistance permettant d'exécuter une commande système qui nécessite de rediriger Stdin à partir d'un fichier l'annulation si elle dure plus longtemps que le délai spécifié.

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

Méthode d'assistance permettant d'exécuter une commande système, abandonnée si elle prend plus de temps que le temps spécifié et rediriger la sortie vers des fichiers si spécifié.

abstract CommandResult runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)

Méthode d'assistance permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel.

abstract CommandResult runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)

Méthode d'assistance permettant d'exécuter une commande système avec mise en cache.

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. L'opération est annulée si elle dépasse le délai spécifié.

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éterminer si, lors de la création d'un processus, la désactivation de la variable d'environnement est plus élevée priorité que de les définir.

abstract void setInterruptibleInFuture(Thread thread, long timeMs)

Définir comme interrompable après un certain temps.

abstract void setLinuxInterruptProcess(boolean interrupt)

Autoriser l'utilisation de la commande "kill" Linux interruption du processus s'exécutant via les méthodes #runTimed lorsqu'il arrive à expiration.

abstract void setRedirectStderrToStdout(boolean redirect)

Définir le flux d'erreur standard pour rediriger vers le flux de sortie standard lors de l'exécution du système commandes.

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)

Annule 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/Interdit les interruptions d'exécution sur le thread actuel. Si c'est autorisé, exécutez les opérations le thread actuel peut être interrompu depuis d'autres threads via la méthode interrupt(Thread, String).

Paramètres
allow boolean: autoriser ou non 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é. L'exécution des opérations sur le thread donné génèrera RunInterruptedException.

Paramètres
message String: message pour RunInterruptedException.

errorId ErrorIdentifier: représentation de 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é. L'exécution des opérations sur le thread donné génèrera RunInterruptedException.

Paramètres
message String: message pour RunInterruptedException.

isInterruptAllowed

public abstract boolean isInterruptAllowed ()

Donne l'état d'interruption à RunUtil.

Renvoie
boolean La valeur est "true" si l'exécution peut être interrompue et la valeur "false" dans le cas contraire.

runCmdInBackground

public abstract Process runCmdInBackground (Redirect redirect, 
                 command)

Une autre méthode runCmdInBackground(String) qui accepte les arguments de la commande au format ERROR(/List).

Paramètres
redirect Redirect: ERROR(/Redirect) à appliquer à ProcessBuilder.

command : le ERROR(/List) contenant la commande système spécifiée et éventuellement des arguments pour exécuter

Renvoie
Process Le paramètre Process de la commande exécutée

Génère
Si l'exécution de la commande a échoué

runCmdInBackground

public abstract Process runCmdInBackground ( command)

Une autre méthode runCmdInBackground(String) qui accepte les arguments de la commande au format ERROR(/List).

Paramètres
command : le ERROR(/List) contenant la commande système spécifiée et éventuellement des arguments pour exécuter

Renvoie
Process Le paramètre Process de la commande exécutée

Génère
Si l'exécution de la commande a échoué

runCmdInBackground

public abstract Process runCmdInBackground ( command, 
                OutputStream output)

L'exécution de la commande avec ERROR(/OutputStream) consigne le résultat de la commande. Stdout et stderr sont fusionnés.

Paramètres
command : commande à exécuter

output OutputStream: OutputStream pour l'enregistrement de la sortie

Renvoie
Process Le Process qui exécute la commande

Génère
IOException

runCmdInBackground

public abstract Process runCmdInBackground (String... command)

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

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

Paramètres
command String: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
Process Le paramètre Process de la commande exécutée

Génère
Si l'exécution de la commande a échoué

runCmdInBackground

public abstract Process runCmdInBackground (Redirect redirect, 
                String... command)

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

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

Paramètres
redirect Redirect: ERROR(/Redirect) à appliquer à ProcessBuilder.

command String: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
Process Le paramètre Process de la commande exécutée

Génère
Si l'exécution de la commande a échoué

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.

Augmenter de manière exponentielle le temps d'attente entre les tentatives d'opération Il est destiné à être utilisé lors de l'exécution d'une opération telle que l'interrogation d'un serveur, pour lui laisser le temps de récupérer est temporairement indisponible.

Paramètres
opTimeout long: délai maximal 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: délai maximal d'attente entre les tentatives d'opération

maxTime long: durée maximale totale approximative pour continuer à exécuter l'opération

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

Renvoie
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 aboutisse.

Paramètres
opTimeout long: délai maximal 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: durée maximale totale approximative pour continuer à exécuter l'opération

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

Renvoie
boolean true si l'opération s'est terminée avec succès 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. Surveille également flux de sortie pour l'activité. Abandon si aucune activité de flux n'est observée pendant une période donnée. Si la valeur inactiveOutputTimeout est définie sur zéro, aucune surveillance du flux n'est effectuée.

Paramètres
opTimeout long: délai maximal d'attente (en ms) pour une seule tentative d'opération

idleOutputTimeout long: délai maximal d'attente (en ms) pour la sortie des flux de sortie

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

maxTime long: durée maximale totale approximative pour continuer à exécuter l'opération

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

Renvoie
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. L'opération est annulée si elle dépasse le délai spécifié.

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

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

logErrors boolean: consigne les erreurs en cas d'exception ou non.

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

runTimedCmd

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

Méthode d'assistance permettant d'exécuter une commande système, abandonnée si elle prend plus de temps que le temps spécifié et rediriger la sortie vers des fichiers si spécifié. Lorsque les ERROR(/OutputStream) sont fournies de cette façon, elles resteront ouvertes à la fin de la fonction.

Paramètres
timeout long: délai d'attente maximal en ms. 0 signifie qu'il n'y a pas de délai d'inactivité.

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: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
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 permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel.

Paramètres
timeout long: temps d'attente maximal en ms. 0 signifie qu'il n'y a pas de délai d'inactivité.

command String: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
CommandResult Un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdRéessayer

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

Méthode d'assistance permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel.

Paramètres
timeout long: temps d'attente maximal, en ms, à chaque tentative

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

attempts int: nombre maximal de tentatives

command String: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
CommandResult Un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdRetryWithOutputMonitor

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

Méthode d'assistance permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel. Surveille également l'activité des flux de sortie. L'abandon est annulé si aucune activité de flux n'est observé pendant une période donnée. Si la valeur inactiveOutputTimeout est définie sur zéro, aucune surveillance du flux n'est effectuée. se produira.

Paramètres
timeout long: temps d'attente maximal, en ms, à chaque tentative

idleOutputTimeout long: délai maximal d'attente (en ms) pour la sortie des flux de sortie

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

attempts int: nombre maximal de tentatives

command String: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
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 permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel. Semblable à runTimedCmd(long, String), mais ne consigne aucune erreur sur une exception.

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

command String: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
CommandResult Un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdCmdSilentlyRéessayer

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

Méthode d'assistance permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel. 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: temps d'attente entre les tentatives de commande

attempts int: nombre maximal de tentatives

command String: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
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 permettant d'exécuter une commande système, abandonnée si elle prend plus de temps que le temps spécifié et rediriger la sortie vers des fichiers si spécifié.

Paramètres
timeout long: délai d'attente maximal en ms. 0 signifie qu'il n'y a pas de délai d'inactivité.

input String: entrée stdin à transmettre au traitement

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: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
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 permettant d'exécuter une commande système qui nécessite une entrée stdin et de l'abandonner si elle prend plus de temps que la durée spécifiée.

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

input String: entrée stdin à transmettre au traitement

command String: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
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 permettant d'exécuter une commande système qui nécessite une entrée stdin et de l'abandonner si elle prend plus de temps que la durée spécifiée.

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

input String: entrée stdin à transmettre au traitement

command : ERROR(/List) contenant la commande système et éventuellement les arguments de la commande "exec"

Renvoie
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 permettant d'exécuter une commande système qui nécessite de rediriger Stdin à partir d'un fichier l'annulation si elle dure plus longtemps que le délai spécifié.

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

inputRedirect File: ERROR(/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 arguments facultatifs de la commande "exec"

Renvoie
CommandResult Un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdWithOutputMonitor

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

Méthode d'assistance permettant d'exécuter une commande système, abandonnée si elle prend plus de temps que le temps spécifié et rediriger la sortie vers des fichiers si spécifié. Lorsque les ERROR(/OutputStream) sont fournies de cette façon, elles resteront ouvertes à la fin de la fonction.

Paramètres
timeout long: délai d'attente maximal en ms. 0 signifie qu'il n'y a pas de délai d'inactivité.

idleOutputTimeout long: délai maximal d'attente (en ms) pour la sortie des flux de sortie

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: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
CommandResult Un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdWithOutputMonitor

public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                String... command)

Méthode d'assistance permettant d'exécuter une commande système et d'abandonner si elle dure plus longtemps que la valeur spécifiée en temps réel. Surveille également l'activité des flux de sortie. L'abandon est annulé si aucune activité de flux n'est observé pendant une période donnée. Si la valeur inactiveOutputTimeout est définie sur zéro, aucune surveillance du flux n'est effectuée. se produira.

Paramètres
timeout long: temps d'attente maximal en ms. 0 signifie qu'il n'y a pas de délai d'inactivité.

idleOutputTimeout long: délai maximal d'attente (en ms) pour la sortie des flux de sortie

command String: commande système spécifiée et arguments facultatifs de la commande "exec"

Renvoie
CommandResult Un CommandResult contenant le résultat de l'exécution de la commande

runTimedCmdWithOutputMonitor

public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, 
                long idleOutputTimeout, 
                OutputStream stdout, 
                OutputStream stderr, 
                ICacheClient cacheClient, 
                String... command)

Méthode d'assistance permettant d'exécuter une commande système avec mise en cache.

Si cacheClient est spécifié, la mise en cache est activée. Si le cache est disponible, le résultat mis en cache est renvoyé. Sinon, runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String) sera utilisé pour exécuter la commande et le résultat sera chargé pour la mise en cache.

Paramètres
timeout long: délai d'attente maximal en ms. 0 signifie qu'il n'y a pas de délai d'inactivité.

idleOutputTimeout long: délai maximal d'attente (en ms) pour la sortie des flux de sortie.

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.

cacheClient ICacheClient: instance de ICacheClient utilisée pour gérer la mise en cache.

command String: commande système spécifiée et arguments facultatifs de la commande "exec".

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

runTimedRéessayer

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: délai maximal d'attente (en ms) pour une tentative d'opération

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

attempts int: nombre maximal de tentatives

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

Renvoie
boolean true si l'opération s'est terminée correctement avant le nombre de tentatives 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. Surveille également flux de sortie pour l'activité. Abandon si aucune activité de flux n'est observée pendant une période donnée. Si la valeur inactiveOutputTimeout est définie sur zéro, aucune surveillance du flux n'est effectuée.

Paramètres
opTimeout long: délai maximal d'attente (en ms) pour une tentative d'opération

idleOutputTimeout long: délai maximal d'attente (en ms) pour la sortie des flux de sortie

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

attempts int: nombre maximal de tentatives

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

Renvoie
boolean true si l'opération s'est terminée correctement avant le nombre de tentatives atteint.

runTimedWithOutputMonitor

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

Bloque et exécute une opération. L'opération est annulée si elle dépasse le délai spécifié. Aussi surveille l'activité des flux de sortie et abandonne si aucune activité de flux n'est observée pour une à une heure précise. Si la valeur inactiveOutputTimeout est définie sur zéro, aucune surveillance du flux n'est effectuée.

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

idleOutputTimeout long: délai maximal d'attente (en ms) pour la sortie des flux de sortie

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

logErrors boolean: consigne les erreurs en cas d'exception ou non.

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 de commandes système.

Paramètres
key String: nom de la variable.

value String: valeur de la variable

setEnvVariablePriorité

public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)

Déterminer si, lors de la création d'un processus, la désactivation de la variable d'environnement est plus élevée priorité que de les définir. Par défaut, la désactivation a une priorité plus élevée: c'est-à-dire que si vous tentez de définir une variable avec l'attribut le même nom ne se produira pas, car la variable n'est pas définie. 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 interrompable après un certain temps. ERROR(/CommandScheduler#shutdownHard()) pour nous obliger à résilier le compte à terme.

Paramètres
thread Thread: thread qui pourra être interrompu.

timeMs long: temps d'attente avant de définir une interruption.

setLinuxInterruptProcess

public abstract void setLinuxInterruptProcess (boolean interrupt)

Autoriser l'utilisation de la commande "kill" Linux interruption du processus s'exécutant via les méthodes #runTimed lorsqu'il arrive à 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éfinir le flux d'erreur standard pour rediriger vers le flux de sortie standard lors de l'exécution du système commandes. La valeur initiale est "false".

Paramètres
redirect boolean: nouvelle valeur indiquant si la redirection doit ou non être effectuée

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

sommeil

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 sont ignorées.

unesetEnvVariable

public abstract void unsetEnvVariable (String key)

Annule 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.