OptionSetter

public class OptionSetter
extends Object

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

填入 Option 欄位。

支援設定位元組、短、整數、長、浮點數和雙精度浮點數欄位等。這包括未包裝和已包裝的版本 (例如 int 和 Integer)。如果設定引數以符合所需類型時發生問題，系統會擲回 ConfigurationException。

只要將字串引數包裝在 File 物件中，即可支援檔案選項欄位，而無需測試檔案是否存在。

只要是 setter 選項支援的參數類型，系統支援參數化的集合欄位 (例如 List<File> 和 Set<String>)。集合欄位應使用適當的集合例項初始化。

系統會處理所有欄位，包括公開、受保護、預設 (套件) 存取權、私人和繼承欄位。

從 Dalvik.runner.OptionParser 移植

另請參閱：

摘要

巢狀類別

class OptionSetter.OptionFieldsForName

具有指定名稱的選項欄位清單容器。 

常數

char NAMESPACE_SEPARATOR

公用建構函式

OptionSetter( optionSources)

建構新的 OptionParser，用於設定 'optionSources' 的 @Option 欄位。
OptionSetter(Object... optionSources)

建構新的 OptionParser，用於設定「optionSources」的 @Option 欄位。

公用方法

static Object getFieldValue(Field field, Object optionObject)

傳回指定 ERROR(/Field) 的值，處理所有例外狀況。
IKeyStoreClient getKeyStore()
static getOptionFieldsForClass(Class<?> optionClass)

取得指定類別的所有 Option 欄位 (已宣告和繼承的欄位) 清單。
String getTypeForOption(String name)

傳回字串，說明指定名稱的欄位類型。
boolean isBooleanOption(String name)
boolean isMapOption(String name)
void setKeyStore(IKeyStoreClient keyStore)
setOptionValue(String optionName, String valueText)

設定非對應選項的值。

setOptionValue(String optionName, String keyText, String valueText)

設定選項的值。

final validateRemoteFilePath(DynamicRemoteFileResolver resolver)

逐一執行所有 ERROR(/File) 選項類型，並檢查是否應解析其路徑。

保護方法

getUnsetMandatoryOptions()

傳回所有標示為 mandatory 但仍未設定的 Option 名稱。

常數

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

常數值：58 (0x0000003a)

公用建構函式

OptionSetter

public OptionSetter ( optionSources)

建構新的 OptionParser 以設定「optionSources」的 @Option 欄位。

參數
optionSources

擲回
com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Object... optionSources)

建構新的 OptionParser 以設定「optionSources」的 @Option 欄位。

參數
optionSources Object

擲回
com.android.tradefed.config.ConfigurationException
ConfigurationException

公用方法

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

傳回指定 ERROR(/Field) 的值，處理所有例外狀況。

參數
field Field：ERROR(/Field)
optionObject Object：用於取得欄位值的 Object。
傳回
Object 欄位值為 Object 或 null

getKeyStore

public IKeyStoreClient getKeyStore ()

傳回
IKeyStoreClient

getOptionFieldsForClass

public static  getOptionFieldsForClass (Class<?> optionClass)

取得指定類別的所有 Option 欄位 (已宣告和已繼承的欄位) 清單。

參數
optionClass Class：要搜尋的 Class
傳回
使用 Option 註解的 ERROR(/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

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

參數
keyStore IKeyStoreClient

setOptionValue

public  setOptionValue (String optionName, 
                String valueText)

設定非地圖選項的值。

參數
optionName String：要設定的選項名稱
valueText String：值
傳回
與每個已修改的物件欄位相對應的 ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) 清單。
擲回
ConfigurationException 如果找不到選項或 valueText 的類型有誤

setOptionValue

public  setOptionValue (String optionName, 
                String keyText, 
                String valueText)

設定選項的值。

參數
optionName String：要設定的選項名稱
keyText String：地圖選項的鍵，或空值。
valueText String：值
傳回
與每個已修改的物件欄位相對應的 ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) 清單。
擲回
ConfigurationException 如果找不到選項或 valueText 的類型有誤

validateRemoteFilePath

public final  validateRemoteFilePath (DynamicRemoteFileResolver resolver)

逐一執行所有 ERROR(/File) 選項類型，並檢查是否應解析其路徑。

參數
resolver DynamicRemoteFileResolver：用來解析檔案的 DynamicRemoteFileResolver。
傳回
以這種方式解決的 ERROR(/File) 清單。
擲回
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

保護方法

getUnsetMandatoryOptions

protected  getUnsetMandatoryOptions ()

傳回所有標示為 mandatory 但仍未設定的 Option 名稱。

傳回
String 的 ERROR(/Collection)，其中包含未設定的必要選項 (不限定) 名稱。
擲回
ConfigurationException 如果要檢查的欄位無法存取