OptionSetter

public class OptionSetter
extends Object

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

Propaga los campos de Option.

Se admite la configuración de campos numéricos, como byte, short, int, long, float y double. Esto incluye las versiones con y sin conversión boxing (p. ej., int vs. Integer). Si hay un problema para configurar el argumento de modo que coincida con el tipo deseado, se arroja un ConfigurationException.

Los campos de opciones de archivos se admiten simplemente encapsulando el argumento de cadena en un objeto File sin probar la existencia del archivo.

Los campos de colección parametrizados, como List<File> y Set<String>, se admiten siempre y cuando el tipo de parámetro sea compatible con el configurador de opciones. El campo de la colección se debe inicializar con una instancia de colección adecuada.

Se procesarán todos los campos, incluidos los campos públicos, protegidos, predeterminados (paquete), privados y heredados.

Se portó desde dalvik.runner.OptionParser

También:

Resumen

Clases anidadas

class OptionSetter.Handler<T>

 

class OptionSetter.MapHandler

Un Handler para controlar los valores de los campos de mapa. 

class OptionSetter.OptionFieldsForName

Es un contenedor para la lista de campos de opciones con el nombre determinado. 

Constantes

char NAMESPACE_SEPARATOR

Constructores públicos

OptionSetter(Object... optionSources)

Construye un nuevo OptionParser para configurar los campos @Option de "optionSources".

OptionSetter(Collection<Object> optionSources)

Construye un nuevo OptionParser para configurar los campos @Option de "optionSources".

Métodos públicos

static Object getFieldValue(Field field, Object optionObject)

Devuelve el valor del Field proporcionado y controla las excepciones.

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

Obtiene una lista de todos los campos Option (declarados y heredados) para la clase determinada.

String getTypeForOption(String name)

Devuelve una cadena que describe el tipo del campo con el nombre determinado.

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

Establece el valor del campo Option determinado.

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

Establece el valor para una opción que no es de mapa.

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

Establece el valor de una opción.

final Set<File> validateRemoteFilePath(DynamicRemoteFileResolver resolver)

Ejecuta todos los tipos de opción File y verifica si se debe resolver su ruta de acceso.

Métodos protegidos

Collection<String> getUnsetMandatoryOptions()

Devuelve los nombres de todos los Option que están marcados como mandatory, pero que permanecen sin configurar.

Constantes

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

Valor constante: 58 (0x0000003a)

Constructores públicos

OptionSetter

public OptionSetter (Object... optionSources)

Construye un nuevo OptionParser para configurar los campos @Option de "optionSources".

Parámetros
optionSources Object

Arroja
com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Collection<Object> optionSources)

Construye un nuevo OptionParser para configurar los campos @Option de "optionSources".

Parámetros
optionSources Collection

Arroja
com.android.tradefed.config.ConfigurationException
ConfigurationException

Métodos públicos

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

Devuelve el valor del Field proporcionado y controla las excepciones.

Parámetros
field Field: El Field
optionObject Object: Es el Object del que se obtendrá el valor del campo.
Muestra
Object El valor del campo como Object o null

getHandler

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

Parámetros
type Type

Muestra
OptionSetter.Handler<T>

Arroja
ConfigurationException

getKeyStore

public IKeyStoreClient getKeyStore ()

Muestra
IKeyStoreClient

getOptionFieldsForClass

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

Obtiene una lista de todos los campos Option (declarados y heredados) para la clase determinada.

Parámetros
optionClass Class: Es el Class que se buscará.
Muestra
List<Field> Un Collection de campos anotados con Option

getTypeForOption

public String getTypeForOption (String name)

Devuelve una cadena que describe el tipo del campo con el nombre determinado.

Parámetros
name String: El nombre del campo Option
Muestra
String Un String que describe el tipo del campo
Arroja
ConfigurationException Si no se pudo encontrar el campo

isBooleanOption

public boolean isBooleanOption (String name)

Parámetros
name String

Muestra
boolean

Arroja
ConfigurationException

isMapOption

public boolean isMapOption (String name)

Parámetros
name String

Muestra
boolean

Arroja
ConfigurationException

setFieldValue

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

Establece el valor del campo Option determinado.

Parámetros
optionName String: Es el nombre especificado en Option.
optionSource Object: Es el Object que se configurará.
field Field: El Field
key Object: Es la clave de una entrada en un campo Map o MultiMap, o bien un valor nulo.
value Object: El valor que se establecerá
checkOption boolean

Muestra
boolean Indica si se configuró el campo.
Arroja
com.android.tradefed.config.ConfigurationException
ConfigurationException

También:

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

Parámetros
keyStore IKeyStoreClient

setOptionValue

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

Establece el valor para una opción que no es de mapa.

Parámetros
optionName String: Es el nombre de la opción que se configurará.
valueText String: el valor
Muestra
List<OptionSetter.FieldDef> Es una lista de ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef)s que corresponden a cada campo del objeto que se modificó.
Arroja
ConfigurationException Si no se encuentra la opción o si valueText es del tipo incorrecto

setOptionValue

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

Establece el valor de una opción.

Parámetros
optionName String: Es el nombre de la opción que se configurará.
keyText String: Es la clave de las opciones del mapa o un valor nulo.
valueText String: el valor
Muestra
List<OptionSetter.FieldDef> Es una lista de ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef)s que corresponden a cada campo del objeto que se modificó.
Arroja
ConfigurationException Si no se encuentra la opción o si valueText es del tipo incorrecto

validateRemoteFilePath

public final Set<File> validateRemoteFilePath (DynamicRemoteFileResolver resolver)

Ejecuta todos los tipos de opción File y verifica si se debe resolver su ruta de acceso.

Parámetros
resolver DynamicRemoteFileResolver: Es el DynamicRemoteFileResolver que se usará para resolver los archivos.
Muestra
Set<File> Es la lista de File que se resolvió de esa manera.
Arroja
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

Métodos protegidos

getUnsetMandatoryOptions

protected Collection<String> getUnsetMandatoryOptions ()

Devuelve los nombres de todos los Option que están marcados como mandatory, pero que permanecen sin configurar.

Muestra
Collection<String> Es un Collection de Strings que contiene los nombres (sin calificar) de las opciones obligatorias no establecidas.
Arroja
ConfigurationException Si no se puede acceder a un campo que se debe verificar