ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler.ar


Un programador para ejecutar comandos de TradeFederation.

Resumen

Clases anidadas

interface ICommandScheduler.IScheduledInvocationListener

Objeto de escucha para eventos de invocación cuando se completa la invocación. 

Métodos públicos

abstract boolean addCommand(String[] args)

Agrega un comando al programador.

abstract void addCommandFile(String cmdFile, extraArgs)

Agrega todos los comandos de un archivo determinado al programador.

abstract void await()

Espera a que el programador comience a ejecutarse, incluida la espera a que se complete el traspaso del TF anterior si corresponde.

abstract void completeHandover()

Informa al programador de comandos que una secuencia de traspaso iniciada está completamente completa y debería volver a inicializar su administrador remoto en el puerto predeterminado.

abstract void displayCommandQueue(PrintWriter printWriter)

Muestra información de depuración detallada sobre el estado de la cola de ejecución de comandos.

abstract void displayCommandsInfo(PrintWriter printWriter, String regex)

Muestra una lista de los comandos actuales.

abstract void displayInvocationsInfo(PrintWriter printWriter)

Muestra una lista de invocaciones actuales.

abstract void dumpCommandsXml(PrintWriter printWriter, String regex)

Vuelca el archivo XML expandido del comando con todos Valores de Option especificados para todos los comandos actuales.

abstract void execCommand(IInvocationContext context, ICommandScheduler.IScheduledInvocationListener listener, String[] args)

Asigna un dispositivo directamente y ejecuta un comando sin agregarlo a la cola de comandos. con un IInvocationContext existente.

abstract void execCommand(ICommandScheduler.IScheduledInvocationListener listener, String[] args)

Asigna directamente un dispositivo y ejecuta un comando sin agregarlo a la cola de comandos.

abstract void execCommand(ICommandScheduler.IScheduledInvocationListener listener, ITestDevice device, String[] args)

Ejecuta el comando directamente en un dispositivo ya asignado.

abstract CommandFileWatcher getCommandFileWatcher()

Obtener el CommandFileWatcher adecuado para este programador

abstract int getExecutingCommandCount()

Muestra la cantidad de comandos en estado de ejecución.

abstract String getInvocationInfo(int invocationId)

Muestra la información de un buzón de invocación en especificar el ID de invocación.

abstract CommandRunner.ExitCode getLastInvocationExitCode()

Muestra el código de error de la última invocación que se ejecutó.

abstract Throwable getLastInvocationThrowable()

Muestra el Throwable de la última invocación que se ejecutó.

abstract int getReadyCommandCount()

Muestra la cantidad de comandos en estado listo en la cola.

abstract void handoverInitiationComplete()

Informa al programador de comandos que el intercambio inicial de traspaso de los dispositivos y los comandos en uso esté completa y se pueda comenzar a programar la operación.

abstract boolean handoverShutdown(int handoverPort)

Inicia un shutdown() y se transfiere a otro proceso de intercambio en este mismo host.

abstract void join()

Espera a que se complete el programador.

abstract void join(long millis)

Espera a que el programador se complete o se agote el tiempo de espera después del tiempo especificado en milisegundos.

abstract void removeAllCommands()

Quitar todos los comandos del programador

abstract void setClearcutClient(ClearcutClient client)

Configura el cliente para que informe los datos del aprovechamiento

abstract boolean shouldShutdownOnCmdfileError()

El resultado es verdadero si necesitamos cerrar el programador en un comando con errores.

abstract void shutdown()

Intenta cerrar correctamente el programador de comandos.

abstract void shutdownHard(boolean killAdb)

Intenta cerrar el programador de comandos de manera forzosa.

abstract void shutdownHard()

Intenta cerrar el programador de comandos de manera forzosa.

abstract void shutdownOnEmpty()

Similar a shutdown(), pero esperará a que se ejecuten todos los comandos. antes de salir.

abstract void start()

Inicia la ICommandScheduler.

abstract boolean stopInvocation(int invocationId, String cause)

Para detener una invocación en ejecución, especifica su ID.

default boolean stopInvocation(int invocationId)

Para detener una invocación en ejecución, especifica su ID.

abstract boolean stopInvocation(ITestInvocation invocation)

Detén una invocación en ejecución.

Métodos públicos

Comando add

public abstract boolean addCommand (String[] args)

Agrega un comando al programador.

En esencia, un comando es una instancia de una configuración que se ejecutará y sus argumentos asociados.

Si "--help" argumento se especifica el texto de ayuda para la configuración se enviará a stdout. De lo contrario, la configuración se agregará a la cola para cuando se ejecute.

Parámetros
args String: Son los argumentos de configuración.

Muestra
boolean true si el comando se agregó correctamente

Arroja
ConfigurationException No se pudo analizar el comando if

Archivo addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Agrega todos los comandos de un archivo determinado al programador.

Parámetros
cmdFile String: Es la ruta del sistema de archivos del archivo comando.

extraArgs : Una ERROR(/List) de argumentos String para agregar a cada comando analizado desde el archivo. Puede estar vacío, pero no debe ser nulo.

Arroja
ConfigurationException No se pudo analizar el archivo de comando if

También:

espera

public abstract void await ()

Espera a que el programador comience a ejecutarse, incluida la espera a que se complete el traspaso del TF anterior si corresponde.

completar la transferencia

public abstract void completeHandover ()

Informa al programador de comandos que una secuencia de traspaso iniciada está completamente completa y debería volver a inicializar su administrador remoto en el puerto predeterminado.

Fila de comandos de display

public abstract void displayCommandQueue (PrintWriter printWriter)

Muestra información de depuración detallada sobre el estado de la cola de ejecución de comandos.

Información de comandos de display

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Muestra una lista de los comandos actuales.

Parámetros
printWriter PrintWriter: Es el ERROR(/PrintWriter) al que se enviará la salida.

regex String: La expresión regular con la que deben coincidir los comandos para que se detecte imprimirlo. Si es nulo, se imprimirán todos los comandos.

InfoInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Muestra una lista de invocaciones actuales.

Parámetros
printWriter PrintWriter: Es el ERROR(/PrintWriter) al que se enviará la salida.

Comandosdevol poderXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Vuelca el archivo XML expandido del comando con todos Valores de Option especificados para todos los comandos actuales.

Parámetros
printWriter PrintWriter: Es el ERROR(/PrintWriter) al que se mostrará el estado.

regex String: Es la expresión regular con la que deben coincidir los comandos para que .xml se vuelquen. Si es nulo, se volcarán todos los comandos.

execCommand

public abstract void execCommand (IInvocationContext context, 
                ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

Asigna un dispositivo directamente y ejecuta un comando sin agregarlo a la cola de comandos. con un IInvocationContext existente.

Parámetros
context IInvocationContext: Es un IInvocationContext existente.

listener ICommandScheduler.IScheduledInvocationListener: Es el ICommandScheduler.IScheduledInvocationListener que se debe informar.

args String: Los argumentos del comando

Arroja
ConfigurationException si el comando no es válido
NoDeviceException si no hay ningún dispositivo para usar

execCommand

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                String[] args)

Asigna directamente un dispositivo y ejecuta un comando sin agregarlo a la cola de comandos.

Parámetros
listener ICommandScheduler.IScheduledInvocationListener: Es el ICommandScheduler.IScheduledInvocationListener que se debe informar.

args String: Los argumentos del comando

Arroja
ConfigurationException si el comando no es válido
NoDeviceException si no hay ningún dispositivo para usar

execCommand

public abstract void execCommand (ICommandScheduler.IScheduledInvocationListener listener, 
                ITestDevice device, 
                String[] args)

Ejecuta el comando directamente en un dispositivo ya asignado.

Parámetros
listener ICommandScheduler.IScheduledInvocationListener: Es el ICommandScheduler.IScheduledInvocationListener que se debe informar.

device ITestDevice: Es el ITestDevice que se usará.

args String: Los argumentos del comando

Arroja
ConfigurationException si el comando no es válido

getCommandFileWatcher.

public abstract CommandFileWatcher getCommandFileWatcher ()

Obtener el CommandFileWatcher adecuado para este programador

Muestra
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Muestra la cantidad de comandos en estado de ejecución.

Muestra
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Muestra la información de un buzón de invocación en especificar el ID de invocación.

Parámetros
invocationId int: Es el ID de seguimiento de la invocación.

Muestra
String Un String que contiene información sobre la invocación

getLastInvocationExitCode.

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

Muestra el código de error de la última invocación que se ejecutó. Muestra 0 (sin error) si aún no se ejecutó ninguna invocación.

Muestra
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

Muestra el Throwable de la última invocación que se ejecutó. Se muestra un valor nulo si no hay un throwable disponible.

Muestra
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

Muestra la cantidad de comandos en estado listo en la cola.

Muestra
int

HandoverInitiationComplete

public abstract void handoverInitiationComplete ()

Informa al programador de comandos que el intercambio inicial de traspaso de los dispositivos y los comandos en uso esté completa y se pueda comenzar a programar la operación.

Transferencia

public abstract boolean handoverShutdown (int handoverPort)

Inicia un shutdown() y se transfiere a otro proceso de intercambio en este mismo host.

El programador informará al proceso de intercambio remoto que escucha en ese puerto los dispositivos liberados. a medida que están disponibles.

Parámetros
handoverPort int

Muestra
boolean true si el proceso de traspaso se realizó correctamente, false de lo contrario

join

public abstract void join ()

Espera a que se complete el programador.

También:

join

public abstract void join (long millis)

Espera a que el programador se complete o se agote el tiempo de espera después del tiempo especificado en milisegundos.

Parámetros
millis long

También:

removeAllCommands

public abstract void removeAllCommands ()

Quitar todos los comandos del programador

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Configura el cliente para que informe los datos del aprovechamiento

Parámetros
client ClearcutClient

Debe cerrarseOnCmdfileError.

public abstract boolean shouldShutdownOnCmdfileError ()

El resultado es verdadero si necesitamos cerrar el programador en un comando con errores.

Muestra
boolean

apagado

public abstract void shutdown ()

Intenta cerrar correctamente el programador de comandos.

Borra los comandos que esperan a probarse y solicita que todas las invocaciones en curso apagarse con facilidad.

Después de llamar al cierre, el bucle principal del programador esperará todas las invocaciones en curso. para completar antes de salir por completo.

apagarDuro

public abstract void shutdownHard (boolean killAdb)

Intenta cerrar el programador de comandos de manera forzosa.

Es similar a shutdown(), pero también eliminará la conexión de adb de manera opcional, de una intenta "inspirar" invocaciones en curso para que se completen más rápido.

Parámetros
killAdb boolean

apagarDuro

public abstract void shutdownHard ()

Intenta cerrar el programador de comandos de manera forzosa. Igual que shutdownHard(true).

cierre_vacío

public abstract void shutdownOnEmpty ()

Similar a shutdown(), pero esperará a que se ejecuten todos los comandos. antes de salir.

Ten en cuenta que si algún comando está en modo de bucle, el programador nunca se cerrará.

start

public abstract void start ()

Inicia la ICommandScheduler.

Se debe llamar antes de llamar a otros métodos.

Se ejecutará hasta que se llame a shutdown(). consulta Thread.start().

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Para detener una invocación en ejecución, especifica su ID.

Parámetros
invocationId int: Es el ID de seguimiento de la invocación.

cause String: Es la causa por la que se detiene la invocación.

Muestra
boolean true si se detiene la invocación; de lo contrario, false

Arroja
UnsupportedOperationException si la implementación no admite esto

stopInvocation

public boolean stopInvocation (int invocationId)

Para detener una invocación en ejecución, especifica su ID.

Parámetros
invocationId int

Muestra
boolean true si se detiene la invocación; de lo contrario, false

Arroja
UnsupportedOperationException si la implementación no admite esto

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

Detén una invocación en ejecución.

Parámetros
invocation ITestInvocation

Muestra
boolean true si se detiene la invocación; de lo contrario, false

Arroja
UnsupportedOperationException si la implementación no admite esto