IRunUtil
public
interface
IRunUtil
com.android.tradefed.util.IRunUtil |
Interfaz para ejecutar operaciones programadas y comandos del sistema.
Resumen
Clases anidadas | |
---|---|
interface |
IRunUtil.IRunnableResult
Es una interfaz para ejecutar de forma asíncrona una operación que muestra un estado booleano. |
Métodos públicos | |
---|---|
abstract
void
|
allowInterrupt(boolean allow)
Permite o inhabilita las interrupciones de ejecución en el subproceso actual. |
abstract
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
Interrumpe las operaciones de ejecución en curso o próximas en el subproceso determinado. |
abstract
void
|
interrupt(Thread thread, String message)
Interrumpe las operaciones de ejecución en curso o próximas en el subproceso determinado. |
abstract
boolean
|
isInterruptAllowed()
Proporciona el estado de interrupción de RunUtil. |
abstract
Process
|
runCmdInBackground(Redirect redirect,
Un método |
abstract
Process
|
runCmdInBackground(
Un método |
abstract
Process
|
runCmdInBackground(
Ejecutar un comando con un |
abstract
Process
|
runCmdInBackground(String... command)
Método auxiliar para ejecutar un comando del sistema de forma asíncrona. |
abstract
Process
|
runCmdInBackground(Redirect redirect, String... command)
Es un método de ayuda para ejecutar un comando del sistema de forma asíncrona. |
abstract
boolean
|
runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se complete correctamente. |
abstract
boolean
|
runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se complete correctamente. |
abstract
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloquear y ejecutar una operación varias veces hasta que tenga éxito |
abstract
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloquea y ejecuta una operación, y la aborta si tarda más de un tiempo especificado. |
abstract
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
Es un método auxiliar para ejecutar un comando del sistema, anularlo si tarda más de un tiempo especificado y redireccionar el resultado a archivos si se especifica. |
abstract
CommandResult
|
runTimedCmd(long timeout, String... command)
Es un método auxiliar para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. |
abstract
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado. |
abstract
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado. |
abstract
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado. |
abstract
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
Es un método auxiliar para ejecutar un comando del sistema, abortarlo si tarda más de un tiempo especificado y redireccionar el resultado a archivos si se especifica. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
Es un método auxiliar para ejecutar un comando del sistema que requiere una entrada de stdin y abortar si tarda más que un tiempo especificado. |
abstract
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
Método auxiliar para ejecutar un comando del sistema que requiere una entrada stdin y que se anula si tarda más de un tiempo especificado. |
abstract
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
Es un método auxiliar para ejecutar un comando del sistema que requiere redireccionar Stdin desde un archivo y anularlo si tarda más de un tiempo especificado. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Es un método auxiliar para ejecutar un comando del sistema, abortarlo si tarda más de un tiempo especificado y redireccionar el resultado a archivos si se especifica. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado. |
abstract
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
Método de ayuda para ejecutar un comando del sistema con almacenamiento en caché. |
abstract
boolean
|
runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se complete correctamente. |
abstract
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloquear y ejecutar una operación varias veces hasta que tenga éxito |
abstract
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloquea y ejecuta una operación, y la aborta si tarda más de un tiempo especificado. |
abstract
void
|
setEnvVariable(String key, String value)
Establece una variable de entorno para usar cuando se ejecutan comandos del sistema. |
abstract
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
Decide si, cuando creas un proceso, quitar la variable de entorno tiene mayor prioridad que configurarlas. |
abstract
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Establecer como interrumpible después de un tiempo de espera. |
abstract
void
|
setLinuxInterruptProcess(boolean interrupt)
Permite usar la interrupción "kill" de Linux en el proceso que se ejecuta a través de métodos #runTimed cuando se alcanza un tiempo de espera. |
abstract
void
|
setRedirectStderrToStdout(boolean redirect)
Establece el flujo de error estándar para que redireccione al flujo de salida estándar cuando se ejecuten comandos del sistema. |
abstract
void
|
setWorkingDir(File dir)
Configura el directorio de trabajo para los comandos del sistema. |
abstract
void
|
sleep(long time)
Es un método auxiliar para suspender la ejecución durante un tiempo determinado, sin tener en cuenta las excepciones. |
abstract
void
|
unsetEnvVariable(String key)
Desactiva una variable de entorno, de modo que los comandos del sistema se ejecuten sin ella. |
abstract
void
|
uploadCache(ICacheClient cacheClient, ExecutableActionResult actionResult)
Sube el último |
Métodos públicos
allowInterrupt
public abstract void allowInterrupt (boolean allow)
Permite o inhabilita las interrupciones de ejecución en el subproceso actual. Si está permitido, las operaciones de ejecución del subproceso actual pueden interrumpirse desde otros subprocesos mediante el método interrupt(Thread, String)
.
Parámetros | |
---|---|
allow |
boolean : Indica si se permiten interrupciones de ejecución en el subproceso actual. |
interrumpir
public abstract void interrupt (Thread thread, String message, ErrorIdentifier errorId)
Interrumpe las operaciones de ejecución en curso o próximas en el subproceso determinado. Las operaciones de ejecución en el subproceso determinado arrojarán RunInterruptedException
.
Parámetros | |
---|---|
message |
String : Es el mensaje para RunInterruptedException . |
errorId |
ErrorIdentifier : Representa la causa de la interrupción cuando se conoce. |
interrumpir
public abstract void interrupt (Thread thread, String message)
Interrumpe las operaciones de ejecución en curso o próximas en el subproceso determinado. Las operaciones de ejecución en el subproceso determinado arrojarán RunInterruptedException
.
Parámetros | |
---|---|
message |
String : Es el mensaje para RunInterruptedException . |
isInterruptAllowed
public abstract boolean isInterruptAllowed ()
Proporciona el estado de interrupción de RunUtil.
Muestra | |
---|---|
boolean |
true si se puede interrumpir la ejecución; de lo contrario, false. |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect,command)
Un método runCmdInBackground(String)
alternativo que acepta los argumentos del comando en formato ERROR(/List)
.
Parámetros | |
---|---|
redirect |
Redirect : Es el ERROR(/Redirect) que se aplicará a ProcessBuilder . |
command |
: Es el ERROR(/List) que contiene el comando del sistema especificado y, de manera opcional, los argumentos para ejecutar. |
Muestra | |
---|---|
Process |
el Process del comando ejecutado |
Arroja | |
---|---|
|
if command failed to run |
runCmdInBackground
public abstract Process runCmdInBackground (command)
Un método runCmdInBackground(String)
alternativo que acepta los argumentos del comando en formato ERROR(/List)
.
Parámetros | |
---|---|
command |
: Es el ERROR(/List) que contiene el comando del sistema especificado y, de manera opcional, los argumentos para ejecutar. |
Muestra | |
---|---|
Process |
el Process del comando ejecutado |
Arroja | |
---|---|
|
if command failed to run |
runCmdInBackground
public abstract Process runCmdInBackground (command, OutputStream output)
Ejecutar un comando con un ERROR(/OutputStream)
registra el resultado del comando.
Stdout y stderr se combinan.
Parámetros | |
---|---|
command |
: Es el comando que se ejecutará. |
output |
OutputStream : Es el OutputStream para guardar el resultado. |
Muestra | |
---|---|
Process |
el Process que ejecuta el comando |
Arroja | |
---|---|
|
IOException |
runCmdInBackground
public abstract Process runCmdInBackground (String... command)
Es un método auxiliar para ejecutar un comando del sistema de forma asíncrona.
Se mostrará de inmediato después de iniciar el comando.
Parámetros | |
---|---|
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
Process |
el Process del comando ejecutado |
Arroja | |
---|---|
|
if command failed to run |
runCmdInBackground
public abstract Process runCmdInBackground (Redirect redirect, String... command)
Es un método auxiliar para ejecutar un comando del sistema de forma asíncrona.
Se mostrará de inmediato después de iniciar el comando.
Parámetros | |
---|---|
redirect |
Redirect : Es el ERROR(/Redirect) que se aplicará a ProcessBuilder . |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
Process |
el Process del comando ejecutado |
Arroja | |
---|---|
|
if command failed to run |
runEscalatingTimedRetry
public abstract boolean runEscalatingTimedRetry (long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se complete correctamente.
Aumenta exponencialmente el tiempo de espera entre los intentos de operación. Esto está diseñado para usarse cuando se realiza una operación, como sondear un servidor, a fin de que se recupere en caso de que se encuentre temporalmente fuera de servicio.
Parámetros | |
---|---|
opTimeout |
long : Es el tiempo máximo de espera en ms para un solo intento de operación. |
initialPollInterval |
long : Es el tiempo inicial de espera entre los intentos de operación. |
maxPollInterval |
long : Es el tiempo máximo de espera entre los intentos de operación. |
maxTime |
long : Es el tiempo máximo aproximado total para seguir intentando la operación. |
runnable |
IRunUtil.IRunnableResult : Es IRunUtil.IRunnableResult para ejecutar. |
Muestra | |
---|---|
boolean |
true si la operación se completó correctamente antes de que venciera maxTime |
runFixedTimedRetry
public abstract boolean runFixedTimedRetry (long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se complete correctamente.
Parámetros | |
---|---|
opTimeout |
long : Es el tiempo máximo de espera en ms para un solo intento de operación. |
pollInterval |
long : Es el tiempo inicial de espera entre los intentos de operación. |
maxTime |
long : Es el tiempo máximo aproximado total para seguir intentando la operación. |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para ejecutar |
Muestra | |
---|---|
boolean |
true si la operación se completó correctamente antes de que venciera maxTime |
runFixedTimedRetryWithOutputMonitor
public abstract boolean runFixedTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se complete correctamente. También supervisa la actividad de las transmisiones de salida y se anulan si no se observa ninguna actividad de transmisión durante un tiempo especificado. Si inactivoOutputTimeout se establece en cero, no se realizará ninguna supervisión de transmisión.
Parámetros | |
---|---|
opTimeout |
long : Es el tiempo máximo de espera en ms para un solo intento de operación. |
idleOutputTimeout |
long : Es el tiempo máximo en ms que se debe esperar para obtener resultados en los flujos de salida. |
pollInterval |
long : Es el tiempo inicial de espera entre los intentos de operación. |
maxTime |
long : Es el tiempo máximo aproximado total para seguir intentando la operación. |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para ejecutar |
Muestra | |
---|---|
boolean |
true si la operación se completó correctamente antes de que venciera maxTime |
cronometrado de ejecución
public abstract CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloquea y ejecuta una operación, y la aborta si tarda más de un tiempo especificado.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para ejecutar |
logErrors |
boolean : Registra errores en la excepción o no. |
Muestra | |
---|---|
CommandStatus |
el resultado CommandStatus de la operación. |
Comando de ejecución de tiempo
public abstract CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Es un método auxiliar para ejecutar un comando del sistema, anularlo si tarda más de un tiempo especificado y redireccionar el resultado a archivos si se especifica. Cuando se proporcionen ERROR(/OutputStream)
de esta manera, quedarán abiertos al final de la función.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. 0 significa que no hay tiempo de espera. |
stdout |
OutputStream : ERROR(/OutputStream) donde se redireccionará el resultado estándar. Puede ser nulo. |
stderr |
OutputStream : ERROR(/OutputStream) a la que se redireccionará el resultado del error. Puede ser nulo. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmd
public abstract CommandResult runTimedCmd (long timeout, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. 0 significa que no hay tiempo de espera. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdRetry
public abstract CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms para cada intento. |
retryInterval |
long : Es el tiempo de espera entre las reintentos de comandos. |
attempts |
int : Es la cantidad máxima de intentos que se pueden intentar. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdRetryWithOutputMonitor
public abstract CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado. También supervisa las transmisiones de salida en busca de actividad y se cancela si no se observa actividad de transmisión durante un tiempo determinado. Si idleOutputTimeout se establece en cero, no se realizará ninguna supervisión de transmisión.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms para cada intento. |
idleOutputTimeout |
long : Es el tiempo máximo en ms que se debe esperar para obtener resultados en los flujos de salida. |
retryInterval |
long : Es el tiempo de espera entre las reintentos de comandos. |
attempts |
int : Es la cantidad máxima de intentos que se pueden intentar. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdSilently
public abstract CommandResult runTimedCmdSilently (long timeout, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado. Es similar a runTimedCmd(long, String)
, pero no registra ningún error ante una excepción.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdSilentlyRetry
public abstract CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado. Es similar a runTimedCmdRetry(long, long, int, String[])
, pero no registra ningún error ante una excepción.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. |
retryInterval |
long : Es el tiempo de espera entre las reintentos de comandos. |
attempts |
int : Es la cantidad máxima de intentos que se pueden intentar. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Método auxiliar para ejecutar un comando del sistema, abortarlo si tarda más de un tiempo especificado y redireccionar el resultado a archivos si se especifica.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. 0 significa que no hay tiempo de espera. |
input |
String : Es la entrada de stdin que se pasará para procesar. |
stdoutFile |
File : ERROR(/File) a la que se redireccionará el resultado estándar. Puede ser nulo. |
stderrFile |
File : ERROR(/File) a la que se redireccionará el resultado del error. Puede ser nulo. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdWithInput
public abstract CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Es un método auxiliar para ejecutar un comando del sistema que requiere una entrada de stdin y abortar si tarda más que un tiempo especificado.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. |
input |
String : Es la entrada de stdin que se pasará para procesar. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdconentrada
public abstract CommandResult runTimedCmdWithInput (long timeout, String input,command)
Es un método auxiliar para ejecutar un comando del sistema que requiere una entrada de stdin y abortar si tarda más que un tiempo especificado.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. |
input |
String : Es la entrada de stdin que se pasará para procesar. |
command |
: ERROR(/List) que contiene el comando del sistema y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdWithInputRedirect
public abstract CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Es un método auxiliar para ejecutar un comando del sistema que requiere redireccionar Stdin desde un archivo y abortarlo si tarda más de un tiempo especificado.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. |
inputRedirect |
File : Es el ERROR(/File) que se redireccionará como entrada estándar con ProcessBuilder.redirectInput() . Si es nulo, no se redireccionará stdin. |
command |
String : Es el comando del sistema especificado y, opcionalmente, argumentos para ejecutar. |
Muestra | |
---|---|
CommandResult |
un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Es un método auxiliar para ejecutar un comando del sistema, abortarlo si tarda más de un tiempo especificado y redireccionar el resultado a archivos si se especifica. Cuando se proporcionen ERROR(/OutputStream)
de esta manera,
se dejarán abiertos al final de la función.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. 0 significa que no hay tiempo de espera. |
idleOutputTimeout |
long : Es el tiempo máximo de espera en ms para obtener un resultado en las transmisiones de salida. |
stdout |
OutputStream : ERROR(/OutputStream) a la que se redireccionará el resultado estándar. Puede ser nulo. |
stderr |
OutputStream : ERROR(/OutputStream) donde se redireccionará el resultado del error. Puede ser nulo. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Es un método de ayuda para ejecutar un comando del sistema y abortarlo si tarda más que un tiempo especificado. También supervisa las transmisiones de salida en busca de actividad y se cancela si no se observa actividad de transmisión durante un tiempo determinado. Si inactivoOutputTimeout se establece en cero, no se realizará ninguna supervisión de transmisión.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. 0 significa que no hay tiempo de espera. |
idleOutputTimeout |
long : Es el tiempo máximo en ms que se debe esperar para obtener resultados en los flujos de salida. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar |
Muestra | |
---|---|
CommandResult |
un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdWithOutputMonitor
public abstract CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, ICacheClient cacheClient, String... command)
Método auxiliar para ejecutar un comando del sistema con almacenamiento en caché.
Si se especifica cacheClient
, se habilitará el almacenamiento en caché. Si la caché está disponible, se mostrará el resultado almacenado en caché. De lo contrario, se usará runTimedCmdWithOutputMonitor(long, long, OutputStream, OutputStream, String)
para ejecutar el comando y el resultado se subirá para almacenar en caché.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. 0 significa que no hay tiempo de espera. |
idleOutputTimeout |
long : Es el tiempo máximo de espera en ms para obtener un resultado en las transmisiones de salida. |
stdout |
OutputStream : ERROR(/OutputStream) donde se redireccionará el resultado estándar. Puede ser nulo. |
stderr |
OutputStream : ERROR(/OutputStream) , a la que se redireccionará el resultado del error. Puede ser nulo. |
cacheClient |
ICacheClient : Es una instancia de ICacheClient que se usa para controlar el almacenamiento en caché. |
command |
String : El comando del sistema especificado y, de manera opcional, los argumentos para ejecutar. |
Muestra | |
---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedRetry
public abstract boolean runTimedRetry (long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se complete correctamente.
Parámetros | |
---|---|
opTimeout |
long : Es el tiempo máximo en ms que se espera para un intento de operación. |
pollInterval |
long : Es el tiempo de espera entre las reintentos de comandos. |
attempts |
int : Es la cantidad máxima de intentos que se deben realizar. |
runnable |
IRunUtil.IRunnableResult : Es IRunUtil.IRunnableResult para ejecutar. |
Muestra | |
---|---|
boolean |
true si la operación se completó correctamente antes de que se alcanzaran los intentos. |
runTimedRetryWithOutputMonitor
public abstract boolean runTimedRetryWithOutputMonitor (long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se complete correctamente. También supervisa las transmisiones de salida en busca de actividad y se cancela si no se observa actividad de transmisión durante un tiempo especificado. Si idleOutputTimeout se establece en cero, no se realizará ninguna supervisión de transmisión.
Parámetros | |
---|---|
opTimeout |
long : Es el tiempo máximo en ms que se espera para un intento de operación. |
idleOutputTimeout |
long : Es el tiempo máximo en ms que se debe esperar para obtener resultados en los flujos de salida. |
pollInterval |
long : Es el tiempo de espera entre las reintentos de comandos. |
attempts |
int : Es la cantidad máxima de intentos que se deben realizar. |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para ejecutar |
Muestra | |
---|---|
boolean |
Es true si la operación se completó correctamente antes de que se alcancen los intentos. |
runTimedWithOutputMonitor
public abstract CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloquea y ejecuta una operación, y la aborta si tarda más de un tiempo especificado. También supervisa las transmisiones de salida en busca de actividad y se cancela si no se observa actividad de transmisión durante un tiempo especificado. Si idleOutputTimeout se establece en cero, no se realizará ninguna supervisión de transmisión.
Parámetros | |
---|---|
timeout |
long : Es el tiempo máximo de espera en ms. |
idleOutputTimeout |
long : Es el tiempo máximo en ms que se debe esperar para obtener resultados en los flujos de salida. |
runnable |
IRunUtil.IRunnableResult : IRunUtil.IRunnableResult para ejecutar |
logErrors |
boolean : Registra errores en la excepción o no. |
Muestra | |
---|---|
CommandStatus |
el resultado CommandStatus de la operación. |
setEnvVariable
public abstract void setEnvVariable (String key, String value)
Establece una variable de entorno que se usará cuando se ejecuten comandos del sistema.
Parámetros | |
---|---|
key |
String : Es el nombre de la variable. |
value |
String : El valor de la variable |
También:
setEnvVariablePriority
public abstract void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Decide si, cuando creas un proceso, anular la configuración de la variable de entorno tiene una prioridad más alta que configurarla.
De forma predeterminada, la anulación de configuración tiene una prioridad más alta, lo que significa que, si se intenta establecer una variable con el mismo nombre, no se hará, ya que la variable no se establecerá.
No se puede usar en la instancia predeterminada de IRunUtil
.
Parámetros | |
---|---|
priority |
IRunUtil.EnvPriority |
setInterruptibleInFuture
public abstract void setInterruptibleInFuture (Thread thread, long timeMs)
Se establece como interrumpible después de un tiempo de espera.
ERROR(/CommandScheduler#shutdownHard())
para aplicar la cancelación en algún momento.
Parámetros | |
---|---|
thread |
Thread : Es el subproceso que se volverá interrumpible. |
timeMs |
long : Es el tiempo de espera antes de establecer la interrupción. |
setLinuxInterruptProcess
public abstract void setLinuxInterruptProcess (boolean interrupt)
Permite usar la interrupción "kill" de Linux en el proceso que se ejecuta a través de métodos #runTimed cuando se alcanza un tiempo de espera.
No se puede usar en la instancia IRunUtil
predeterminada.
Parámetros | |
---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public abstract void setRedirectStderrToStdout (boolean redirect)
Establece el flujo de error estándar para que redireccione al flujo de salida estándar cuando se ejecuten comandos del sistema. El valor inicial es falso.
Parámetros | |
---|---|
redirect |
boolean : Es el valor nuevo para redireccionar o no. |
setWorkingDir
public abstract void setWorkingDir (File dir)
Establece el directorio de trabajo para los comandos del sistema.
Parámetros | |
---|---|
dir |
File : El directorio de trabajo |
También:
sleep
public abstract void sleep (long time)
Es un método auxiliar para suspender la ejecución durante un tiempo determinado, sin tener en cuenta las excepciones.
Parámetros | |
---|---|
time |
long : Es la cantidad de milisegundos que se deben suspender. Se ignorarán los valores inferiores o iguales a 0. |
unsetEnvVariable
public abstract void unsetEnvVariable (String key)
Anula una variable de entorno para que los comandos del sistema se ejecuten sin esta variable de entorno.
Parámetros | |
---|---|
key |
String : Es el nombre de la variable. |
También:
uploadCache
public abstract void uploadCache (ICacheClient cacheClient, ExecutableActionResult actionResult)
Sube el último ExecutableActionResult
ejecutado con un cacheClient.
Parámetros | |
---|---|
cacheClient |
ICacheClient : Es el ICacheClient que se usa para subir el resultado. |
actionResult |
ExecutableActionResult : Es el ExecutableActionResult que se subirá. |