RunUtil
public
class
RunUtil
extends Object
implements
IRunUtil
| java.lang.Object | |
| ↳ | com.android.tradefed.util.RunUtil |
Es una colección de métodos de ayuda para ejecutar operaciones.
Resumen
Constantes | |
|---|---|
String |
INHERITIO_PREFIX
|
String |
RUNNABLE_NOTIFIER_NAME
|
Constructores públicos | |
|---|---|
RunUtil()
Crea un objeto |
|
RunUtil(boolean inheritEnvVars)
|
|
Métodos públicos | |
|---|---|
void
|
allowInterrupt(boolean allow)
Permite o no las interrupciones de ejecución en el subproceso actual. |
ProcessBuilder
|
createProcessBuilder(Redirect redirect,
|
static
IRunUtil
|
getDefault()
Obtén una referencia al objeto |
void
|
interrupt(Thread thread, String message, ErrorIdentifier errorId)
Interrumpe las operaciones de ejecución en curso o próximas en el subproceso determinado. |
void
|
interrupt(Thread thread, String message)
Interrumpe las operaciones de ejecución en curso o próximas en el subproceso determinado. |
boolean
|
isInterruptAllowed()
Proporciona el estado de interrupción de RunUtil. |
Process
|
runCmdInBackground(Redirect redirect,
Un método |
Process
|
runCmdInBackground(
Un método |
Process
|
runCmdInBackground(
Ejecuta el comando con un registro |
Process
|
runCmdInBackground(String... command)
Método auxiliar para ejecutar un comando del sistema de forma asíncrona. |
Process
|
runCmdInBackground(Redirect redirect, String... command)
Método auxiliar para ejecutar un comando del sistema de forma asíncrona. |
boolean
|
runEscalatingTimedRetry(long opTimeout, long initialPollInterval, long maxPollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se completa correctamente. |
boolean
|
runFixedTimedRetry(long opTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se completa correctamente. |
boolean
|
runFixedTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, long maxTime, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se completa correctamente. |
CommandStatus
|
runTimed(long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloquea y ejecuta una operación, y la anula si tarda más de un tiempo especificado. |
CommandResult
|
runTimedCmd(long timeout, OutputStream stdout, OutputStream stderr, String... command)
Método de ayuda para ejecutar un comando del sistema, anularlo si tarda más de un tiempo especificado y redireccionar la salida a archivos si se especifica. |
CommandResult
|
runTimedCmd(long timeout, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. |
CommandResult
|
runTimedCmdRetry(long timeout, long retryInterval, int attempts, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. |
CommandResult
|
runTimedCmdRetryWithOutputMonitor(long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. |
CommandResult
|
runTimedCmdSilently(long timeout, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. |
CommandResult
|
runTimedCmdSilentlyRetry(long timeout, long retryInterval, int attempts, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, File stdoutFile, File stderrFile, String... command)
Método de ayuda para ejecutar un comando del sistema, anularlo si tarda más de un tiempo especificado y redireccionar la salida a archivos si se especifica. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input, String... command)
Método auxiliar para ejecutar un comando del sistema que requiere entrada stdin y abortar si tarda más de un tiempo especificado. |
CommandResult
|
runTimedCmdWithInput(long timeout, String input,
Método auxiliar para ejecutar un comando del sistema que requiere entrada stdin y abortar si tarda más de un tiempo especificado. |
CommandResult
|
runTimedCmdWithInputRedirect(long timeout, File inputRedirect, String... command)
Método auxiliar para ejecutar un comando del sistema que requiere redireccionar Stdin desde un archivo y abortar si tarda más de un tiempo especificado. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Método de ayuda para ejecutar un comando del sistema, anularlo si tarda más de un tiempo especificado y redireccionar la salida a archivos si se especifica. |
CommandResult
|
runTimedCmdWithOutputMonitor(long timeout, long idleOutputTimeout, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. |
boolean
|
runTimedRetry(long opTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se completa correctamente. |
boolean
|
runTimedRetryWithOutputMonitor(long opTimeout, long idleOutputTimeout, long pollInterval, int attempts, IRunUtil.IRunnableResult runnable)
Bloquea y ejecuta una operación varias veces hasta que se completa correctamente. |
CommandStatus
|
runTimedWithOutputMonitor(long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloquea y ejecuta una operación, y la anula si tarda más de un tiempo especificado. |
void
|
setEnvVariable(String name, String value)
Establece una variable de entorno que se usará cuando se ejecuten comandos del sistema. |
void
|
setEnvVariablePriority(IRunUtil.EnvPriority priority)
Decide si, al crear un proceso, anular la configuración de las variables de entorno tiene mayor prioridad que configurarlas. |
void
|
setInterruptibleInFuture(Thread thread, long timeMs)
Se establece como interrumpible después de un tiempo de espera. |
void
|
setLinuxInterruptProcess(boolean interrupt)
Permite usar la interrupción "kill" de Linux en el proceso que se ejecuta a través de los métodos #runTimed cuando alcanza un tiempo de espera. |
void
|
setRedirectStderrToStdout(boolean redirect)
Establece el flujo de error estándar para redireccionar al flujo de salida estándar cuando se ejecutan comandos del sistema. |
void
|
setWorkingDir(File dir)
Establece el directorio de trabajo para los comandos del sistema. |
void
|
sleep(long time)
Método auxiliar para suspender la ejecución durante un tiempo determinado, ignorando cualquier excepción. |
void
|
unsetEnvVariable(String key)
Anula la configuración de una variable de entorno para que los comandos del sistema se ejecuten sin esta variable.
Las variables de entorno pueden heredarse del proceso principal, por lo que debemos borrar la variable de entorno de |
Constantes
INHERITIO_PREFIX
public static final String INHERITIO_PREFIX
Valor de la constante: "inheritio-"
RUNNABLE_NOTIFIER_NAME
public static final String RUNNABLE_NOTIFIER_NAME
Valor de la constante: "RunnableNotifier"
Constructores públicos
RunUtil
public RunUtil (boolean inheritEnvVars)
| Parámetros | |
|---|---|
inheritEnvVars |
boolean |
Métodos públicos
allowInterrupt
public void allowInterrupt (boolean allow)
Permite o no las interrupciones de ejecución en el subproceso actual. Si se permite, las operaciones de ejecución del subproceso actual se pueden interrumpir desde otros subprocesos a través del método interrupt(Thread, String).
| Parámetros | |
|---|---|
allow |
boolean: Indica si se permiten interrupciones de ejecución en el subproceso actual. |
createProcessBuilder
public ProcessBuilder createProcessBuilder (Redirect redirect,
commandList,
boolean enableCache) | Parámetros | |
|---|---|
redirect |
Redirect |
commandList |
|
enableCache |
boolean |
| Muestra | |
|---|---|
ProcessBuilder |
|
getDefault
public static IRunUtil getDefault ()
Obtén una referencia al objeto RunUtil predeterminado.
Esto es útil para las personas que llaman que desean usar IRunUtil sin personalización.
Se recomienda que los llamadores que necesiten una instancia de IRunUtil personalizada (es decir, que necesiten llamar a setEnvVariable(String, String) o setWorkingDir(File)) creen su propia copia.
| Muestra | |
|---|---|
IRunUtil |
|
Interrumpir
public 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 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 boolean isInterruptAllowed ()
Proporciona el estado de interrupción de RunUtil.
| Muestra | |
|---|---|
boolean |
Es verdadero si se puede interrumpir la ejecución y falso en caso contrario. |
runCmdInBackground
public 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á al ProcessBuilder. |
command |
: Es el ERROR(/List) que contiene el comando del sistema especificado y, de forma opcional, los argumentos para ejecutar. |
| Muestra | |
|---|---|
Process |
El Process del comando ejecutado |
runCmdInBackground
public 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 forma opcional, los argumentos para ejecutar. |
| Muestra | |
|---|---|
Process |
El Process del comando ejecutado |
runCmdInBackground
public Process runCmdInBackground (command, OutputStream output)
Ejecuta el comando con un registro ERROR(/OutputStream) del resultado del comando.
Stdout y stderr se combinan.
| Parámetros | |
|---|---|
command |
: Es el comando que se ejecutará. |
output |
OutputStream: OutputStream para guardar el resultado |
| Muestra | |
|---|---|
Process |
El Process que ejecuta el comando |
runCmdInBackground
public Process runCmdInBackground (String... command)
Método auxiliar para ejecutar un comando del sistema de forma asíncrona.
Se mostrará inmediatamente después de ejecutar el comando.
| Parámetros | |
|---|---|
command |
String: Es el comando del sistema especificado y, de manera opcional, los argumentos para ejecutar. |
| Muestra | |
|---|---|
Process |
El Process del comando ejecutado |
runCmdInBackground
public Process runCmdInBackground (Redirect redirect,
String... command)Método auxiliar para ejecutar un comando del sistema de forma asíncrona.
Se mostrará inmediatamente después de ejecutar el comando.
| Parámetros | |
|---|---|
redirect |
Redirect: Es el ERROR(/Redirect) que se aplicará al ProcessBuilder. |
command |
String: Es el comando del sistema especificado y, de manera opcional, los argumentos para ejecutar. |
| Muestra | |
|---|---|
Process |
El Process del comando ejecutado |
runEscalatingTimedRetry
public boolean runEscalatingTimedRetry (long opTimeout,
long initialPollInterval,
long maxPollInterval,
long maxTime,
IRunUtil.IRunnableResult runnable)Bloquea y ejecuta una operación varias veces hasta que se completa correctamente.
Aumenta de forma exponencial el tiempo de espera entre los intentos de operación. Esto se debe usar cuando se realiza una operación, como sondear un servidor, para darle tiempo a recuperarse en caso de que esté inactivo temporalmente.
| Parámetros | |
|---|---|
opTimeout |
long: Tiempo máximo de espera en ms para un solo intento de operación |
initialPollInterval |
long: 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: IRunUtil.IRunnableResult para ejecutar |
| Muestra | |
|---|---|
boolean |
true si la operación se completó correctamente antes de que venciera maxTime |
runFixedTimedRetry
public boolean runFixedTimedRetry (long opTimeout,
long pollInterval,
long maxTime,
IRunUtil.IRunnableResult runnable)Bloquea y ejecuta una operación varias veces hasta que se completa correctamente.
| Parámetros | |
|---|---|
opTimeout |
long: Tiempo máximo de espera en ms para un solo intento de operación |
pollInterval |
long: 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 boolean runFixedTimedRetryWithOutputMonitor (long opTimeout,
long idleOutputTimeout,
long pollInterval,
long maxTime,
IRunUtil.IRunnableResult runnable)Bloquea y ejecuta una operación varias veces hasta que se completa correctamente. También supervisa los flujos de salida para detectar actividad y anula la operación si no se observa actividad de flujo durante un tiempo especificado. Si idleOutputTimeout se establece en cero, no se realizará ninguna supervisión de la transmisión.
| Parámetros | |
|---|---|
opTimeout |
long: Tiempo máximo de espera en ms para un solo intento de operación |
idleOutputTimeout |
long: Tiempo máximo de espera en ms para la salida en los flujos de salida |
pollInterval |
long: 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 |
runTimed
public CommandStatus runTimed (long timeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloquea y ejecuta una operación, y la anula si tarda más de un tiempo especificado.
| Parámetros | |
|---|---|
timeout |
long: Tiempo máximo de espera en ms |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult para ejecutar |
logErrors |
boolean: Indica si se registran errores en la excepción. |
| Muestra | |
|---|---|
CommandStatus |
El resultado CommandStatus de la operación. |
runTimedCmd
public CommandResult runTimedCmd (long timeout, OutputStream stdout, OutputStream stderr, String... command)
Método de ayuda para ejecutar un comando del sistema, anularlo si tarda más de un tiempo especificado y redireccionar la salida a archivos si se especifica. Cuando se proporcionan 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 del tiempo de espera en ms. El valor 0 significa que no hay tiempo de espera. |
stdout |
OutputStream: ERROR(/OutputStream) donde se redireccionará la salida estándar. Puede ser nulo. |
stderr |
OutputStream: Es el ERROR(/OutputStream) al que se redireccionará el resultado del error. Puede ser nulo. |
command |
String: Es 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 CommandResult runTimedCmd (long timeout, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado.
| Parámetros | |
|---|---|
timeout |
long: Es el tiempo máximo de espera en ms. El valor 0 significa que no hay tiempo de espera. |
command |
String: Es 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 CommandResult runTimedCmdRetry (long timeout, long retryInterval, int attempts, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado.
| Parámetros | |
|---|---|
timeout |
long: Tiempo máximo de espera en ms para cada intento |
retryInterval |
long: Tiempo de espera entre reintentos de comandos |
attempts |
int: Es la cantidad máxima de intentos. |
command |
String: Es 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 CommandResult runTimedCmdRetryWithOutputMonitor (long timeout, long idleOutputTimeout, long retryInterval, int attempts, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. También supervisa los flujos de salida para detectar actividad y anula la operación si no se observa actividad de flujo durante un tiempo especificado. Si idleOutputTimeout se establece en cero, no se realizará ninguna supervisión de la transmisión.
| Parámetros | |
|---|---|
timeout |
long: Tiempo máximo de espera en ms para cada intento |
idleOutputTimeout |
long: Tiempo máximo de espera en ms para la salida en los flujos de salida |
retryInterval |
long: Tiempo de espera entre reintentos de comandos |
attempts |
int: Es la cantidad máxima de intentos. |
command |
String: Es 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 CommandResult runTimedCmdSilently (long timeout, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. Es similar a runTimedCmd(long, String), pero no registra ningún error en la excepción.
| Parámetros | |
|---|---|
timeout |
long: Tiempo máximo de espera en ms |
command |
String: Es 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 CommandResult runTimedCmdSilentlyRetry (long timeout, long retryInterval, int attempts, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. Es similar a runTimedCmdRetry(long, long, int, String[]), pero no registra ningún error en la excepción.
| Parámetros | |
|---|---|
timeout |
long: Tiempo máximo de espera en ms |
retryInterval |
long: Tiempo de espera entre reintentos de comandos |
attempts |
int: Es la cantidad máxima de intentos. |
command |
String: Es 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 CommandResult runTimedCmdWithInput (long timeout, String input, File stdoutFile, File stderrFile, String... command)
Método de ayuda para ejecutar un comando del sistema, anularlo si tarda más de un tiempo especificado y redireccionar la salida a archivos si se especifica.
| Parámetros | |
|---|---|
timeout |
long: Es el tiempo máximo de espera en ms. El valor 0 significa que no hay tiempo de espera. |
input |
String: Es la entrada stdin que se pasará al proceso. |
stdoutFile |
File: ERROR(/File) donde se redireccionará la salida estándar. Puede ser nulo. |
stderrFile |
File: Es el ERROR(/File) al que se redireccionará el resultado del error. Puede ser nulo. |
command |
String: Es 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 CommandResult runTimedCmdWithInput (long timeout, String input, String... command)
Método auxiliar para ejecutar un comando del sistema que requiere entrada stdin y abortar si tarda más de un tiempo especificado.
| Parámetros | |
|---|---|
timeout |
long: Tiempo máximo de espera en ms |
input |
String: Es la entrada stdin que se pasará al proceso. |
command |
String: Es 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 CommandResult runTimedCmdWithInput (long timeout, String input,command)
Método auxiliar para ejecutar un comando del sistema que requiere entrada stdin y abortar si tarda más de un tiempo especificado.
| Parámetros | |
|---|---|
timeout |
long: Tiempo máximo de espera en ms |
input |
String: Es la entrada stdin que se pasará al proceso. |
command |
: ERROR(/List) que contiene el comando del sistema y, de forma opcional, los argumentos para ejecutar |
| Muestra | |
|---|---|
CommandResult |
Un CommandResult que contiene el resultado de la ejecución del comando |
runTimedCmdWithInputRedirect
public CommandResult runTimedCmdWithInputRedirect (long timeout, File inputRedirect, String... command)
Método auxiliar para ejecutar un comando del sistema que requiere redireccionar Stdin desde un archivo y abortar si tarda más de un tiempo especificado.
| Parámetros | |
|---|---|
timeout |
long: Tiempo máximo de espera en ms |
inputRedirect |
File: Es el ERROR(/File) que se redirecciona como entrada estándar con ProcessBuilder.redirectInput(). Si es nulo, no se redireccionará stdin. |
command |
String: Es 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 CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, OutputStream stdout, OutputStream stderr, String... command)
Método de ayuda para ejecutar un comando del sistema, anularlo si tarda más de un tiempo especificado y redireccionar la salida a archivos si se especifica. Cuando se proporcionan 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 del tiempo de espera en ms. El valor 0 significa que no hay tiempo de espera. |
idleOutputTimeout |
long: Tiempo máximo de espera en ms para la salida en los flujos de salida |
stdout |
OutputStream: ERROR(/OutputStream) donde se redireccionará la salida estándar. Puede ser nulo. |
stderr |
OutputStream: Es el ERROR(/OutputStream) al que se redireccionará el resultado del error. Puede ser nulo. |
command |
String: Es 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 CommandResult runTimedCmdWithOutputMonitor (long timeout, long idleOutputTimeout, String... command)
Método de asistencia para ejecutar un comando del sistema y anularlo si tarda más de un tiempo especificado. También supervisa los flujos de salida para detectar actividad y anula la operación si no se observa actividad de flujo durante un tiempo especificado. Si idleOutputTimeout se establece en cero, no se realizará ninguna supervisión de la transmisión.
| Parámetros | |
|---|---|
timeout |
long: Es el tiempo máximo de espera en ms. El valor 0 significa que no hay tiempo de espera. |
idleOutputTimeout |
long: Tiempo máximo de espera en ms para la salida en los flujos de salida |
command |
String: Es 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 boolean runTimedRetry (long opTimeout,
long pollInterval,
int attempts,
IRunUtil.IRunnableResult runnable)Bloquea y ejecuta una operación varias veces hasta que se completa correctamente.
| Parámetros | |
|---|---|
opTimeout |
long: Tiempo máximo de espera en ms para un intento de operación |
pollInterval |
long: Tiempo de espera entre reintentos de comandos |
attempts |
int: Es la cantidad máxima de intentos. |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult para ejecutar |
| Muestra | |
|---|---|
boolean |
true si la operación se completó correctamente antes de que se alcanzaran los intentos. |
runTimedRetryWithOutputMonitor
public boolean runTimedRetryWithOutputMonitor (long opTimeout,
long idleOutputTimeout,
long pollInterval,
int attempts,
IRunUtil.IRunnableResult runnable)Bloquea y ejecuta una operación varias veces hasta que se completa correctamente. También supervisa los flujos de salida para detectar actividad y anula la operación si no se observa actividad de flujo durante un tiempo especificado. Si idleOutputTimeout se establece en cero, no se realizará ninguna supervisión de la transmisión.
| Parámetros | |
|---|---|
opTimeout |
long: Tiempo máximo de espera en ms para un intento de operación |
idleOutputTimeout |
long: Tiempo máximo de espera en ms para la salida en los flujos de salida |
pollInterval |
long: Tiempo de espera entre reintentos de comandos |
attempts |
int: Es la cantidad máxima de intentos. |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult para ejecutar |
| Muestra | |
|---|---|
boolean |
true si la operación se completó correctamente antes de que se alcanzaran los intentos. |
runTimedWithOutputMonitor
public CommandStatus runTimedWithOutputMonitor (long timeout, long idleOutputTimeout, IRunUtil.IRunnableResult runnable, boolean logErrors)
Bloquea y ejecuta una operación, y la anula si tarda más de un tiempo especificado. También supervisa los flujos de salida para detectar actividad y anula la operación si no se observa actividad de flujo durante un período especificado. Si idleOutputTimeout se establece en cero, no se realizará ninguna supervisión de la transmisión.
| Parámetros | |
|---|---|
timeout |
long: Tiempo máximo de espera en ms |
idleOutputTimeout |
long: Tiempo máximo de espera en ms para la salida en los flujos de salida |
runnable |
IRunUtil.IRunnableResult: IRunUtil.IRunnableResult para ejecutar |
logErrors |
boolean: Indica si se registran errores en la excepción. |
| Muestra | |
|---|---|
CommandStatus |
El resultado CommandStatus de la operación. |
setEnvVariable
public void setEnvVariable (String name,
String value)Establece una variable de entorno que se usará cuando se ejecuten comandos del sistema.
| Parámetros | |
|---|---|
name |
String: el nombre de la variable |
value |
String: El valor de la variable |
setEnvVariablePriority
public void setEnvVariablePriority (IRunUtil.EnvPriority priority)
Decide si, al crear un proceso, anular la configuración de las variables de entorno tiene mayor prioridad que configurarlas.
De forma predeterminada, la anulación de la configuración tiene mayor prioridad, lo que significa que, si se intenta establecer una variable con el mismo nombre, no se realizará la acción, ya que se anulará la configuración de la variable.
No se puede usar en la instancia IRunUtil predeterminada.
| Parámetros | |
|---|---|
priority |
IRunUtil.EnvPriority |
setInterruptibleInFuture
public void setInterruptibleInFuture (Thread thread,
long timeMs)Se establece como interrumpible después de un tiempo de espera.
ERROR(/CommandScheduler#shutdownHard()) para garantizar que terminemos en algún momento.
| Parámetros | |
|---|---|
thread |
Thread: Es el subproceso que se podrá interrumpir. |
timeMs |
long: Tiempo de espera antes de establecer la interrupción. |
setLinuxInterruptProcess
public void setLinuxInterruptProcess (boolean interrupt)
Permite usar la interrupción "kill" de Linux en el proceso que se ejecuta a través de los métodos #runTimed cuando alcanza un tiempo de espera.
No se puede usar en la instancia IRunUtil predeterminada.
| Parámetros | |
|---|---|
interrupt |
boolean |
setRedirectStderrToStdout
public void setRedirectStderrToStdout (boolean redirect)
Establece el flujo de error estándar para redireccionar al flujo de salida estándar cuando se ejecutan comandos del sistema. El valor inicial es falso.
| Parámetros | |
|---|---|
redirect |
boolean: Valor nuevo que indica si se debe redireccionar o no |
setWorkingDir
public void setWorkingDir (File dir)
Establece el directorio de trabajo para los comandos del sistema.
| Parámetros | |
|---|---|
dir |
File: El directorio de trabajo |
sleep
public void sleep (long time)
Método auxiliar para suspender la ejecución durante un tiempo determinado, ignorando cualquier excepción.
| Parámetros | |
|---|---|
time |
long: Son los milisegundos que se suspenderá el proceso. Los valores menores o iguales a 0 se ignorarán. |
unsetEnvVariable
public void unsetEnvVariable (String key)
Anula la configuración de una variable de entorno para que los comandos del sistema se ejecuten sin esta variable.
Las variables de entorno pueden heredarse del proceso principal, por lo que debemos borrar la variable de entorno de ProcessBuilder.environment().
| Parámetros | |
|---|---|
key |
String: el nombre de la variable |
También: