Google is committed to advancing racial equity for Black communities. See how.
Se usó la API de Cloud Translation para traducir esta página.
Switch to English

ICommandScheduler

public interface ICommandScheduler

com.android.tradefed.command.ICommandScheduler


Un programador para ejecutar comandos de TradeFederation.

Resumen

Clases anidadas

interface ICommandScheduler.IScheduledInvocationListener

Escucha de 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) addCommandFile (String cmdFile, extraArgs)

Agrega todos los comandos del archivo dado al programador

abstract void await ()

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

abstract void completeHandover ()

Informa al programador de comandos que una secuencia de traspaso iniciada está completamente completa y que debe reinicializar su administrador remoto en el puerto predeterminado.

abstract void displayCommandQueue (PrintWriter printWriter)

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

abstract void displayCommandsInfo (PrintWriter printWriter, String regex)

Genera una lista de comandos actuales.

abstract void displayInvocationsInfo (PrintWriter printWriter)

Muestra una lista de invocaciones actuales.

abstract void dumpCommandsXml (PrintWriter printWriter, String regex)

Vuelque el archivo xml expandido para el comando con todos los valores de Option especificados para todos los comandos actuales.

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

Asigna directamente un dispositivo y ejecuta un comando sin agregarlo a la cola de comandos utilizando un IInvocationContext ya 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)

Ejecute directamente el comando en el dispositivo ya asignado.

abstract CommandFileWatcher getCommandFileWatcher ()

Obtenga el CommandFileWatcher apropiado para este programador

abstract int getExecutingCommandCount ()

Devuelve el número de comandos en estado de ejecución.

abstract String getInvocationInfo (int invocationId)

Devuelve la información sobre un bu de invocación especificando el ID de invocación.

abstract CommandRunner.ExitCode getLastInvocationExitCode ()

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

abstract Throwable getLastInvocationThrowable ()

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

abstract int getReadyCommandCount ()

Devuelve el número de comandos en estado listo en la cola.

abstract void handoverInitiationComplete ()

Informa al programador de comandos que el intercambio de transferencia inicial de dispositivos y comandos en uso se ha completado y puede comenzar a programar la operación.

abstract boolean handoverShutdown (int handoverPort)

Inicia un shutdown() y un traspaso 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 de la duración especificada en milisegundos.

abstract void removeAllCommands ()

Eliminar todos los comandos del planificador

abstract void setClearcutClient (ClearcutClient client)

Configurar el cliente para que informe los datos del aprovechamiento

abstract void setLastInvocationExitCode ( CommandRunner.ExitCode code, Throwable stack)

El método auxiliar, cuando se ejecuta dentro de un contexto CommandRunner , establece un código de error de salida y un seguimiento de pila que se puede devolver.

abstract boolean shouldShutdownOnCmdfileError ()

Devuelve verdadero si necesitamos apagar el programador en un error de comando

abstract void shutdown ()

Intente cerrar correctamente el programador de comandos.

abstract void shutdownHard ()

Intente cerrar forzosamente el programador de comandos.

abstract void shutdownOnEmpty ()

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

abstract void start ()

Inicie ICommandScheduler .

abstract boolean stopInvocation (int invocationId, String cause)

Detenga una invocación en ejecución especificando su id.

default boolean stopInvocation (int invocationId)

Detenga una invocación en ejecución especificando su id.

abstract boolean stopInvocation ( ITestInvocation invocation)

Detenga una invocación en ejecución.

Métodos públicos

addCommand

public abstract boolean addCommand (String[] args)

Agrega un comando al programador.

Un comando es esencialmente una instancia de una configuración para ejecutar y sus argumentos asociados.

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

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

Devoluciones
boolean true si el comando se agregó correctamente

Lanza
ConfigurationException si el comando no se pudo analizar

addCommandFile

public abstract void addCommandFile (String cmdFile, 
                 extraArgs)

Agrega todos los comandos del archivo dado al programador

Parámetros
cmdFile String : la ruta del sistema de archivos del archivo comand

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

Lanza
ConfigurationException si el archivo de comando no se pudo analizar

Ver también:

esperar

public abstract void await ()

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

completeHandover

public abstract void completeHandover ()

Informa al programador de comandos que una secuencia de traspaso iniciada está completamente completa y que debe reinicializar su administrador remoto en el puerto predeterminado.

displayCommandQueue

public abstract void displayCommandQueue (PrintWriter printWriter)

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

displayCommandsInfo

public abstract void displayCommandsInfo (PrintWriter printWriter, 
                String regex)

Genera una lista de comandos actuales.

Parámetros
printWriter PrintWriter : el ERROR(/PrintWriter) al que enviar.

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

displayInvocationsInfo

public abstract void displayInvocationsInfo (PrintWriter printWriter)

Muestra una lista de invocaciones actuales.

Parámetros
printWriter PrintWriter : el ERROR(/PrintWriter) al que enviar.

dumpCommandsXml

public abstract void dumpCommandsXml (PrintWriter printWriter, 
                String regex)

Vierta el archivo xml expandido para el comando con todos los valores de Option especificados para todos los comandos actuales.

Parámetros
printWriter PrintWriter : el ERROR(/PrintWriter) al que enviar el estado.

regex String : la expresión regular con la que deben coincidir los comandos para que se descargue el archivo xml. Si es nulo, se descartarán todos los comandos.

execCommand

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

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

Parámetros
context IInvocationContext : un IInvocationContext existente.

listener ICommandScheduler.IScheduledInvocationListener : el ICommandScheduler.IScheduledInvocationListener para ser informado

args String : los argumentos del comando

Lanza
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 : el ICommandScheduler.IScheduledInvocationListener para ser informado

args String : los argumentos del comando

Lanza
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)

Ejecute directamente el comando en el dispositivo ya asignado.

Parámetros
listener ICommandScheduler.IScheduledInvocationListener : el ICommandScheduler.IScheduledInvocationListener para ser informado

device ITestDevice : el ITestDevice a utilizar

args String : los argumentos del comando

Lanza
ConfigurationException si el comando no es válido

getCommandFileWatcher

public abstract CommandFileWatcher getCommandFileWatcher ()

Obtenga el CommandFileWatcher apropiado para este programador

Devoluciones
CommandFileWatcher

getExecutingCommandCount

public abstract int getExecutingCommandCount ()

Devuelve el número de comandos en estado de ejecución.

Devoluciones
int

getInvocationInfo

public abstract String getInvocationInfo (int invocationId)

Devuelve la información sobre un bu de invocación especificando el ID de invocación.

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

Devoluciones
String Una String contiene información sobre la invocación.

getLastInvocationSalirCode

public abstract CommandRunner.ExitCode getLastInvocationExitCode ()

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

Devoluciones
CommandRunner.ExitCode

getLastInvocationThrowable

public abstract Throwable getLastInvocationThrowable ()

Devuelve el Throwable de la última invocación que se ejecutó. Devuelve nulo, si no hay ningún elemento arrojadizo disponible.

Devoluciones
Throwable

getReadyCommandCount

public abstract int getReadyCommandCount ()

Devuelve el número de comandos en estado listo en la cola.

Devoluciones
int

handoverInitiationComplete

public abstract void handoverInitiationComplete ()

Informa al programador de comandos que el intercambio inicial de transferencia de dispositivos y comandos en uso está completo y puede comenzar a programar la operación.

traspaso

public abstract boolean handoverShutdown (int handoverPort)

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

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

Parámetros
handoverPort int

Devoluciones
boolean true si el inicio del traspaso fue exitoso, false caso contrario

unirse

public abstract void join ()

Espera a que se complete el programador.

Ver también:

unirse

public abstract void join (long millis)

Espera a que el programador se complete o se agote el tiempo de espera después de la duración especificada en milisegundos.

Parámetros
millis long

Ver también:

removeAllCommands

public abstract void removeAllCommands ()

Eliminar todos los comandos del planificador

setClearcutClient

public abstract void setClearcutClient (ClearcutClient client)

Configurar el cliente para que informe los datos del aprovechamiento

Parámetros
client ClearcutClient

setLastInvocationSalirCode

public abstract void setLastInvocationExitCode (CommandRunner.ExitCode code, 
                Throwable stack)

El método auxiliar, cuando se ejecuta dentro de un contexto CommandRunner , establece un código de error de salida y un seguimiento de pila que se puede devolver.

Parámetros
code CommandRunner.ExitCode

stack Throwable

shouldShutdownOnCmdfileError

public abstract boolean shouldShutdownOnCmdfileError ()

Devuelve verdadero si necesitamos apagar el programador en un error de comando

Devoluciones
boolean

apagar

public abstract void shutdown ()

Intente cerrar correctamente el programador de comandos.

Borra los comandos que esperan ser probados y solicita que todas las invocaciones en curso se apaguen correctamente.

Después de llamar a shutdown, el ciclo principal del planificador esperará a que se completen todas las invocaciones en curso antes de salir por completo.

shutdownHard

public abstract void shutdownHard ()

Intente cerrar forzosamente el programador de comandos.

Similar a shutdown() , pero también matará a la fuerza la conexión adb, en un intento de "inspirar" las invocaciones en curso para que se completen más rápido.

shutdownOnEmpty

public abstract void shutdownOnEmpty ()

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

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

comienzo

public abstract void start ()

Inicie ICommandScheduler .

Debe llamarse antes de llamar a otros métodos.

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

stopInvocation

public abstract boolean stopInvocation (int invocationId, 
                String cause)

Detenga una invocación en ejecución especificando su id.

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

cause String : la causa para detener la invocación.

Devoluciones
boolean Es verdadero si la invocación se detuvo, falso en caso contrario

Lanza
UnsupportedOperationException si la implementación no es compatible con esto

stopInvocation

public boolean stopInvocation (int invocationId)

Detenga una invocación en ejecución especificando su id.

Parámetros
invocationId int

Devoluciones
boolean Es verdadero si la invocación se detuvo, falso en caso contrario

Lanza
UnsupportedOperationException si la implementación no es compatible con esto

stopInvocation

public abstract boolean stopInvocation (ITestInvocation invocation)

Detenga una invocación en ejecución.

Parámetros
invocation ITestInvocation

Devoluciones
boolean Es verdadero si la invocación se detuvo, falso en caso contrario

Lanza
UnsupportedOperationException si la implementación no es compatible con esto