OptionSetter

public class OptionSetter
extends Object

java.lang.Object
   ↳ com.android.tradefed.config.OptionSetter

Preenche campos Option.

A definição de campos numéricos, como byte, short, int, long, float e double, é compatível. Isso inclui versões sem e com caixa (por exemplo, int x Integer). Se houver um problema ao definir o argumento para corresponder ao tipo desejado, uma ConfigurationException será gerada.

Os campos de opção de arquivo são compatíveis apenas encapsulando o argumento de string em um objeto "File" sem testar a existência do arquivo.

Campos de coleção parametrizados, como List<File> e Set<String>, são compatíveis desde que o tipo de parâmetro seja compatível com o setter de opções. O campo de coleta precisa ser inicializado com uma instância de coleta adequada.

Todos os campos serão processados, incluindo acesso público, protegido, padrão (pacote), privado e herdados.

Transferido por portabilidade de dalvik.runner.OptionParser

Confira também:

Resumo

Classes aninhadas

class OptionSetter.Handler<T>

 

class OptionSetter.MapHandler

Um Handler para processar valores de campos de mapa. 

class OptionSetter.OptionFieldsForName

Contêiner para a lista de campos de opção com o nome especificado. 

Constantes

char NAMESPACE_SEPARATOR

Construtores públicos

OptionSetter(Object... optionSources)

Cria um novo OptionParser para definir os campos @Option de "optionSources".

OptionSetter(Collection<Object> optionSources)

Cria um novo OptionParser para definir os campos @Option de "optionSources".

Métodos públicos

static Object getFieldValue(Field field, Object optionObject)

Retorna o valor do Field especificado, processando todas as exceções.

static OptionSetter.Handler<T> getHandler(Type type)
IKeyStoreClient getKeyStore()
static List<Field> getOptionFieldsForClass(Class<?> optionClass)

Recebe uma lista de todos os campos Option (declarados e herdados) de uma determinada classe.

String getTypeForOption(String name)

Retorna uma string que descreve o tipo do campo com o nome especificado.

boolean isBooleanOption(String name)
boolean isMapOption(String name)
static boolean setFieldValue(String optionName, Object optionSource, Field field, Object key, Object value, boolean checkOption)

Define o valor do campo Option especificado.

void setKeyStore(IKeyStoreClient keyStore)
List<OptionSetter.FieldDef> setOptionValue(String optionName, String valueText)

Define o valor de uma opção que não é de mapa.

List<OptionSetter.FieldDef> setOptionValue(String optionName, String keyText, String valueText)

Define o valor de uma opção.

final Set<File> validateRemoteFilePath(DynamicRemoteFileResolver resolver)

Executa todos os tipos de opção File e verifica se o caminho deles precisa ser resolvido.

Métodos protegidos

Collection<String> getUnsetMandatoryOptions()

Retorna os nomes de todos os Options marcados como mandatory, mas que permanecem não definidos.

Constantes

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

Valor da constante: 58 (0x0000003a)

Construtores públicos

OptionSetter

public OptionSetter (Object... optionSources)

Cria um novo OptionParser para definir os campos @Option de "optionSources".

Parâmetros
optionSources Object

Gera
com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Collection<Object> optionSources)

Cria um novo OptionParser para definir os campos @Option de "optionSources".

Parâmetros
optionSources Collection

Gera
com.android.tradefed.config.ConfigurationException
ConfigurationException

Métodos públicos

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

Retorna o valor do Field especificado, processando todas as exceções.

Parâmetros
field Field: o Field
optionObject Object: o Object de onde o valor do campo será extraído.
Retorna
Object o valor do campo como um Object ou null

getHandler

public static OptionSetter.Handler<T> getHandler (Type type)

Parâmetros
type Type

Retorna
OptionSetter.Handler<T>

Gera
ConfigurationException

getKeyStore

public IKeyStoreClient getKeyStore ()

Retorna
IKeyStoreClient

getOptionFieldsForClass

public static List<Field> getOptionFieldsForClass (Class<?> optionClass)

Recebe uma lista de todos os campos Option (declarados e herdados) de uma determinada classe.

Parâmetros
optionClass Class: o Class a ser pesquisado
Retorna
List<Field> um Collection de campos anotados com Option

getTypeForOption

public String getTypeForOption (String name)

Retorna uma string que descreve o tipo do campo com o nome especificado.

Parâmetros
name String: o nome do campo Option
Retorna
String um String que descreve o tipo do campo
Gera
ConfigurationException se o campo não for encontrado

isBooleanOption

public boolean isBooleanOption (String name)

Parâmetros
name String

Retorna
boolean

Gera
ConfigurationException

isMapOption

public boolean isMapOption (String name)

Parâmetros
name String

Retorna
boolean

Gera
ConfigurationException

setFieldValue

public static boolean setFieldValue (String optionName, 
                Object optionSource, 
                Field field, 
                Object key, 
                Object value, 
                boolean checkOption)

Define o valor do campo Option especificado.

Parâmetros
optionName String: o nome especificado em Option
optionSource Object: o Object a ser definido
field Field: o Field
key Object: a chave de uma entrada em um campo Map ou MultiMap ou nulo.
value Object: o valor a ser definido
checkOption boolean

Retorna
boolean Se o campo foi definido.
Gera
com.android.tradefed.config.ConfigurationException
ConfigurationException

Confira também:

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

Parâmetros
keyStore IKeyStoreClient

setOptionValue

public List<OptionSetter.FieldDef> setOptionValue (String optionName, 
                String valueText)

Define o valor de uma opção que não é de mapa.

Parâmetros
optionName String: o nome da opção a ser definida
valueText String: o valor
Retorna
List<OptionSetter.FieldDef> Uma lista de ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef)s correspondentes a cada campo de objeto que foi modificado.
Gera
ConfigurationException se a opção não for encontrada ou se valueText for do tipo errado

setOptionValue

public List<OptionSetter.FieldDef> setOptionValue (String optionName, 
                String keyText, 
                String valueText)

Define o valor de uma opção.

Parâmetros
optionName String: o nome da opção a ser definida
keyText String: a chave para opções do mapa ou nula.
valueText String: o valor
Retorna
List<OptionSetter.FieldDef> Uma lista de ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef)s correspondentes a cada campo de objeto que foi modificado.
Gera
ConfigurationException se a opção não for encontrada ou se valueText for do tipo errado

validateRemoteFilePath

public final Set<File> validateRemoteFilePath (DynamicRemoteFileResolver resolver)

Executa todos os tipos de opção File e verifica se o caminho deles precisa ser resolvido.

Parâmetros
resolver DynamicRemoteFileResolver: o DynamicRemoteFileResolver a ser usado para resolver os arquivos.
Retorna
Set<File> A lista de File que foram resolvidas dessa forma.
Gera
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

Métodos protegidos

getUnsetMandatoryOptions

protected Collection<String> getUnsetMandatoryOptions ()

Retorna os nomes de todos os Options marcados como mandatory, mas que permanecem não definidos.

Retorna
Collection<String> Uma Collection de Strings que contém os nomes (não qualificados) de opções obrigatórias não definidas.
Gera
ConfigurationException se um campo a ser verificado está inacessível