OptionSetter

public class OptionSetter
extends Object

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

Subclasses diretas conhecidas ArgsOptionParser ArgsOptionParser Preenche campos Option com base em argumentos de linha de comando analisados.

---

Preenche os campos Option.

Há suporte para a configuração de campos numéricos, como byte, short, int, long, float e double. Isso inclui versões desempacotadas e empacotadas (por exemplo, int vs. 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 com o simples agrupamento do 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 aceitos desde que o tipo de parâmetro seja aceito pelo definidor de opções. O campo de coleção precisa ser inicializado com uma instância de coleção adequada.

Todos os campos serão processados, incluindo campos públicos, protegidos, de acesso padrão (pacote), privados e herdados.

Portado de dalvik.runner.OptionParser

Confira também:

• ArgsOptionParser

Resumo

Classes aninhadas
class	OptionSetter.Handler<T>
class	OptionSetter.MapHandler Um Handler para processar valores de campos do mapa.
class	OptionSetter.OptionFieldsForName Contêiner para a lista de campos de opção com o nome fornecido.

Constantes
char	NAMESPACE_SEPARATOR

Construtores públicos
OptionSetter( optionSources) Cria um novo OptionParser para definir os campos @Option de "optionSources".
OptionSetter(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 ERROR(/Field) fornecido, processando todas as exceções.
static OptionSetter.Handler<T>	getHandler(Type type)
IKeyStoreClient	getKeyStore()
static	getOptionFieldsForClass(Class<?> optionClass) Recebe uma lista de todos os campos Option (declarados e herdados) para a classe especificada.
String	getTypeForOption(String name) Retorna uma string que descreve o tipo do campo com o nome fornecido.
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)
	setOptionValue(String optionName, String valueText) Define o valor de uma opção que não é de mapa.
	setOptionValue(String optionName, String keyText, String valueText) Define o valor de uma opção.
final	validateRemoteFilePath(DynamicRemoteFileResolver resolver) Processa todos os tipos de opção ERROR(/File) e verifica se o caminho deles precisa ser resolvido.

Métodos protegidos
	getUnsetMandatoryOptions() Retorna os nomes de todos os Options marcados como mandatory, mas que ainda não foram definidos.

Constantes

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

Valor da constante: 58 (0x0000003a)

Construtores públicos

OptionSetter

public OptionSetter ( optionSources)

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

Parâmetros
optionSources

Gera
	com.android.tradefed.config.ConfigurationException
ConfigurationException

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

Métodos públicos

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

Retorna o valor do ERROR(/Field) fornecido, processando todas as exceções.

Parâmetros
field	Field: o ERROR(/Field)
optionObject	Object: o Object para receber o valor do campo.

Retorna
Object	o valor do campo como 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  getOptionFieldsForClass (Class<?> optionClass)

Recebe uma lista de todos os campos Option (declarados e herdados) para a classe especificada.

Parâmetros
optionClass	Class: o Class a ser pesquisado

Retorna
	um ERROR(/Collection) de campos anotados com Option

getTypeForOption

public String getTypeForOption (String name)

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

Parâmetros
name	String: o nome do campo Option

Retorna
String	um String que descreve o tipo do campo

Gera
ConfigurationException	if field could not be found

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 ERROR(/Field)
key	Object: a chave de uma entrada em um campo ERROR(/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:

• OptionUpdateRule

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

Parâmetros
keyStore	IKeyStoreClient

setOptionValue

public  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
	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 o valor do texto for do tipo errado

setOptionValue

public  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 nulo.
valueText	String: o valor

Retorna
	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 o valor do texto for do tipo errado

validateRemoteFilePath

public final  validateRemoteFilePath (DynamicRemoteFileResolver resolver)

Processa todos os tipos de opção ERROR(/File) e verifica se o caminho deles precisa ser resolvido.

Parâmetros
resolver	DynamicRemoteFileResolver: o DynamicRemoteFileResolver a ser usado para resolver os arquivos.

Retorna
	A lista de ERROR(/File) que foi resolvida dessa forma.

Gera
	com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

Métodos protegidos

getUnsetMandatoryOptions

protected  getUnsetMandatoryOptions ()

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

Retorna
	Um ERROR(/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 estiver inacessível