OptionSetter

public class OptionSetter
extends Object

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


Option フィールドに入力します。

byte、short、int、long、float、double などの数値フィールドの設定がサポートされています。これには、ボックス化されたバージョンとボックス化されていないバージョンの両方が含まれます(例: int と Integer)。引数を目的の型に設定する際に問題が発生すると、ConfigurationException がスローされます。

ファイル オプション フィールドは、ファイルが存在するかどうかをテストせずに、文字列引数を File オブジェクトでラップするだけでサポートされます。

パラメータの型がオプション セッターでサポートされている限り、List<File> や Set<String> などのパラメータ化されたコレクション フィールドがサポートされます。コレクション フィールドは、適切なコレクション インスタンスで初期化する必要があります。

パブリック、プロテクト、デフォルト(パッケージ)アクセス、プライベート、継承フィールドなど、すべてのフィールドが処理されます。

dalvik.runner.OptionParser から移植

関連項目:

概要

ネストされたクラス

class OptionSetter.Handler<T>

 

class OptionSetter.MapHandler

マップ フィールドの値を処理する Handler。 

class OptionSetter.OptionFieldsForName

指定された名前のオプション フィールドのリストのコンテナ。 

定数

char NAMESPACE_SEPARATOR

パブリック コンストラクタ

OptionSetter(Object... optionSources)

「optionSources」の @Option フィールドを設定するための新しい OptionParser を構築します。

OptionSetter(Collection<Object> optionSources)

「optionSources」の @Option フィールドを設定するための新しい OptionParser を構築します。

パブリック メソッド

static Object getFieldValue(Field field, Object optionObject)

指定された Field の値を返し、例外を処理します。

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

指定されたクラスのすべての Option フィールド(宣言されたフィールドと継承されたフィールドの両方)のリストを取得します。

String getTypeForOption(String name)

指定された名前のフィールドの型を表す文字列を返します。

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

指定された Option フィールドの値を設定します。

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

マップ以外のオプションの値を設定します。

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

オプションの値を設定します。

final Set<File> validateRemoteFilePath(DynamicRemoteFileResolver resolver)

すべての File オプション タイプを調べて、パスを解決する必要があるかどうかを確認します。

保護されたメソッド

Collection<String> getUnsetMandatoryOptions()

mandatory としてマークされているが、設定されていないすべての Option の名前を返します。

定数

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

定数値: 58 (0x0000003a)

パブリック コンストラクタ

OptionSetter

public OptionSetter (Object... optionSources)

「optionSources」の @Option フィールドを設定するための新しい OptionParser を構築します。

パラメータ
optionSources Object

例外
com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Collection<Object> optionSources)

「optionSources」の @Option フィールドを設定するための新しい OptionParser を構築します。

パラメータ
optionSources Collection

例外
com.android.tradefed.config.ConfigurationException
ConfigurationException

パブリック メソッド

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

指定された Field の値を返し、例外を処理します。

パラメータ
field Field: Field

optionObject Object: フィールドの値を取得する Object

戻り値
Object フィールドの値を Object または null として取得します。

getHandler

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

パラメータ
type Type

戻り値
OptionSetter.Handler<T>

例外
ConfigurationException

getKeyStore

public IKeyStoreClient getKeyStore ()

戻り値
IKeyStoreClient

getOptionFieldsForClass

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

指定されたクラスのすべての Option フィールド(宣言されたフィールドと継承されたフィールドの両方)のリストを取得します。

パラメータ
optionClass Class: 検索する Class

戻り値
List<Field> Option アノテーションが付いたフィールドの Collection

getTypeForOption

public String getTypeForOption (String name)

指定された名前のフィールドの型を表す文字列を返します。

パラメータ
name String: Option フィールド名

戻り値
String フィールドの型を記述する String

例外
ConfigurationException フィールドが見つからなかった場合

isBooleanOption

public boolean isBooleanOption (String name)

パラメータ
name String

戻り値
boolean

例外
ConfigurationException

isMapOption

public boolean isMapOption (String name)

パラメータ
name String

戻り値
boolean

例外
ConfigurationException

setFieldValue

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

指定された Option フィールドの値を設定します。

パラメータ
optionName String: Option で指定された名前

optionSource Object: 設定する Object

field Field: Field

key Object: Map フィールドまたは MultiMap フィールドのエントリのキー、または null。

value Object: 設定する値

checkOption boolean

戻り値
boolean フィールドが設定されたかどうか。

例外
com.android.tradefed.config.ConfigurationException
ConfigurationException

関連項目:

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

パラメータ
keyStore IKeyStoreClient

setOptionValue

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

マップ以外のオプションの値を設定します。

パラメータ
optionName String: 設定するオプションの名前

valueText String: 値

戻り値
List<OptionSetter.FieldDef> 変更された各オブジェクト フィールドに対応する ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) のリスト。

例外
ConfigurationException Option が見つからない場合、または valueText の型が間違っている場合

setOptionValue

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

オプションの値を設定します。

パラメータ
optionName String: 設定するオプションの名前

keyText String: 地図オプションのキー(null の場合もあります)。

valueText String: 値

戻り値
List<OptionSetter.FieldDef> 変更された各オブジェクト フィールドに対応する ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) のリスト。

例外
ConfigurationException Option が見つからない場合、または valueText の型が間違っている場合

validateRemoteFilePath

public final Set<File> validateRemoteFilePath (DynamicRemoteFileResolver resolver)

すべての File オプション タイプを調べて、パスを解決する必要があるかどうかを確認します。

パラメータ
resolver DynamicRemoteFileResolver: ファイルの解決に使用する DynamicRemoteFileResolver

戻り値
Set<File> そのように解決された File のリスト。

例外
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

保護されたメソッド

getUnsetMandatoryOptions

protected Collection<String> getUnsetMandatoryOptions ()

mandatory としてマークされているが、設定されていないすべての Option の名前を返します。

戻り値
Collection<String> 設定されていない必須オプションの(修飾されていない)名前を含む StringCollection

例外
ConfigurationException チェックするフィールドにアクセス不能な場合