Console

public class Console
extends Object

java.lang.Object
   ↳ com.android.tradefed.command.Console

Console principal do TradeFederation que oferece ao usuário a interface para interagir.

No momento, ela aceita operações como

  • adicionar um comando para teste
  • listar dispositivos e o estado deles
  • listar invocações em andamento
  • listar comandos na fila
  • despejar o registro de invocação em um arquivo/stdout
  • desligamento

Resumo

Classes aninhadas

class Console.ArgRunnable<T>

Um Runnable com um método run que pode receber um argumento 

class Console.CaptureList

Um tipo de conveniência para List<List<String>> 

Constantes

String DEBUG_PATTERN

String DUMP_PATTERN

String EXIT_PATTERN

String HELP_PATTERN

String INVOC_PATTERN

String LIST_COMMANDS_PATTERN

String LIST_PATTERN

String REMOVE_PATTERN

String RUN_PATTERN

String SET_PATTERN

String VERSION_PATTERN

Campos

protected static final String LINE_SEPARATOR

protected LineReader mConsoleReader

protected IKeyStoreFactory mKeyStoreFactory

protected ICommandScheduler mScheduler

Construtores protegidos

Console()

Métodos públicos

static void main(String[] mainArgs)
void run()

O método principal para iniciar o console.

void setArgs( mainArgs)

Define os argumentos de inicialização do console.

static void startConsole(Console console, String[] args)

Inicia o console Tradefed especificado com os argumentos fornecidos.

Métodos protegidos

String getConsolePrompt()
String getGenericHelpString( genericHelp)

Retorna a string de ajuda genérica a ser mostrada.

static LineReader getReader()

Retorna um novo LineReader ou null se ocorrer uma IOException.

void printLine(String output)

Mostrar uma linha de texto no console

void printLine(String output, PrintStream pw)

Imprimir a linha em um Printwriter

void setCustomCommands(RegexTrie<Runnable> trie, genericHelp, commandHelp)

Um ponto de personalização que as subclasses podem usar para alterar quais comandos estão disponíveis no console.

Constantes

DEBUG_PATTERN

protected static final String DEBUG_PATTERN

Valor da constante: "debug"

DUMP_PATTERN

protected static final String DUMP_PATTERN

Valor da constante: "d(?:ump)?"

EXIT_PATTERN

protected static final String EXIT_PATTERN

Valor da constante: "(?:q|exit)"

HELP_PATTERN

protected static final String HELP_PATTERN

Valor da constante: "\?|h|help"

INVOC_PATTERN

protected static final String INVOC_PATTERN

Valor da constante: "i(?:nvocation)?"

LIST_COMMANDS_PATTERN

protected static final String LIST_COMMANDS_PATTERN

Valor da constante: "c(?:ommands)?"

LIST_PATTERN

protected static final String LIST_PATTERN

Valor da constante: "l(?:ist)?"

REMOVE_PATTERN

protected static final String REMOVE_PATTERN

Valor da constante: "remove"

RUN_PATTERN

protected static final String RUN_PATTERN

Valor da constante: "r(?:un)?"

SET_PATTERN

protected static final String SET_PATTERN

Valor da constante: "s(?:et)?"

VERSION_PATTERN

protected static final String VERSION_PATTERN

Valor da constante: "version"

Campos

LINE_SEPARATOR

protected static final String LINE_SEPARATOR

mConsoleReader

protected LineReader mConsoleReader

mKeyStoreFactory

protected IKeyStoreFactory mKeyStoreFactory

mScheduler

protected ICommandScheduler mScheduler

Construtores protegidos

Console

protected Console ()

Métodos públicos

principal

public static void main (String[] mainArgs)

Parâmetros
mainArgs String

Gera
ConfigurationException

run

public void run ()

O método principal para iniciar o console. Vai continuar em execução até que um comando de desligamento seja emitido.

setArgs

public void setArgs ( mainArgs)

Define os argumentos de inicialização do console.

Parâmetros
mainArgs : os argumentos

startConsole

public static void startConsole (Console console, 
                String[] args)

Inicia o console Tradefed especificado com os argumentos fornecidos.

Parâmetros
console Console: o Console a ser iniciado
args String: os argumentos da linha de comando
Gera
ConfigurationException

Métodos protegidos

getConsolePrompt

protected String getConsolePrompt ()

Retorna
String o texto String a ser exibido no console

getGenericHelpString

protected String getGenericHelpString ( genericHelp)

Retorna a string de ajuda genérica a ser mostrada.

Parâmetros
genericHelp : uma lista de String que representam a ajuda genérica a ser agregada.
Retorna
String

getReader

protected static LineReader getReader ()

Retorna um novo LineReader ou null se ocorrer uma IOException. Essa função precisa ser estática para que possamos executá-la antes do construtor da superclasse.

Retorna
LineReader

printLine

protected void printLine (String output)

Mostrar uma linha de texto no console

printLine

protected void printLine (String output, 
                PrintStream pw)

Imprimir a linha em um Printwriter

Parâmetros
pw PrintStream

setCustomCommands

protected void setCustomCommands (RegexTrie<Runnable> trie, 
                 genericHelp, 
                 commandHelp)

Um ponto de personalização que as subclasses podem usar para alterar quais comandos estão disponíveis no console.

As implementações precisam modificar as variáveis genericHelp e commandHelp para documentar qual funcionalidade foi adicionada, modificada ou removida.

Parâmetros
trie RegexTrie: o RegexTrie a que os comandos serão adicionados
genericHelp : um ERROR(/List) de linhas a serem impressas quando o usuário executa o comando "help" sem argumentos.
commandHelp : um ERROR(/Map) que contém documentação para todos os novos comandos que podem ter sido adicionados. A chave é uma expressão regular a ser usada como chave para RegexTrie. O valor precisa ser uma string que contenha o texto de ajuda a ser impresso para esse comando.