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>, כל עוד סוג הפרמטר נתמך בדרך אחרת על ידי ה-setter של האפשרות. צריך לאתחל את שדה האוסף באמצעות מופע אוסף מתאים.

כל השדות יעברו עיבוד, כולל שדות ציבוריים, מוגנים, ברירת מחדל (חבילת) גישה, פרטיים וירושים.

הועבר מ-dalvik.runner.OptionParser

מידע נוסף:

סיכום

כיתות בתצוגת עץ

class OptionSetter.Handler<T>

 

class OptionSetter.MapHandler

Handler לטיפול בערכים של שדות מפה. 

class OptionSetter.OptionFieldsForName

מאגר לרשימת שדות האפשרויות עם השם הנתון. 

קבועים

char NAMESPACE_SEPARATOR

יוצרים ציבוריים

OptionSetter( optionSources)

יצירת אובייקט OptionParser חדש להגדרת השדות של @Option ב-'optionSources'.

OptionSetter(Object... optionSources)

יצירת אובייקט OptionParser חדש להגדרת השדות של @Option ב-'optionSources'.

שיטות ציבוריות

static Object getFieldValue(Field field, Object optionObject)

הפונקציה מחזירה את הערך של ERROR(/Field), ומטפלת בחריגות.

static OptionSetter.Handler<T> getHandler(Type type)
IKeyStoreClient getKeyStore()
static 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)
setOptionValue(String optionName, String valueText)

הגדרת הערך לאפשרות שאינה מפה.

setOptionValue(String optionName, String keyText, String valueText)

הגדרת הערך של אפשרות.

final validateRemoteFilePath(DynamicRemoteFileResolver resolver)

הפונקציה בודקת את כל סוגי האפשרויות של ERROR(/File) ובודקת אם צריך לפתור את הנתיב שלהן.

שיטות מוגנות

getUnsetMandatoryOptions()

הפונקציה מחזירה את השמות של כל הערכים של Option שסומנו כ-mandatory אבל לא הוגדרו.

קבועים

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

ערך קבוע: 58 (0x0000003a)

יוצרים ציבוריים

OptionSetter

public OptionSetter ( optionSources)

יצירת אובייקט OptionParser חדש להגדרת השדות של @Option ב-'optionSources'.

פרמטרים
optionSources

זריקות
com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Object... optionSources)

יצירת אובייקט OptionParser חדש להגדרת השדות של @Option ב-'optionSources'.

פרמטרים
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

getHandler

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

פרמטרים
type Type

החזרות
OptionSetter.Handler<T>

זריקות
ConfigurationException

getKeyStore

public IKeyStoreClient getKeyStore ()

החזרות
IKeyStoreClient

getOptionFieldsForClass

public static  getOptionFieldsForClass (Class<?> optionClass)

הפונקציה מקבלת רשימה של כל שדות Option (גם שהוגדרו וגם שעברו בירושה) של הכיתה הנתונה.

פרמטרים
optionClass Class: ה-Class לחיפוש
החזרות
ERROR(/Collection) של שדות עם הערות Option

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: ERROR(/Field)
key Object: המפתח של רשומה בשדה ERROR(/Map) או MultiMap, או null.
value Object: הערך שרוצים להגדיר
checkOption boolean

החזרות
boolean האם השדה הוגדר.
זריקות
com.android.tradefed.config.ConfigurationException
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)s שתואם לכל שדה אובייקט ששונה.
זריקות
ConfigurationException if Option cannot be found or valueText is wrong type

setOptionValue

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

הגדרת הערך של אפשרות.

פרמטרים
optionName String: השם של האפשרות שרוצים להגדיר
keyText String: המפתח של אפשרויות המפה, או null.
valueText String: הערך
החזרות
רשימה של ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef)s שתואם לכל שדה אובייקט ששונה.
זריקות
ConfigurationException if Option cannot be found or valueText is wrong type

validateRemoteFilePath

public final  validateRemoteFilePath (DynamicRemoteFileResolver resolver)

הפונקציה בודקת את כל סוגי האפשרויות של ERROR(/File) ובודקת אם צריך לפתור את הנתיב שלהן.

פרמטרים
resolver DynamicRemoteFileResolver: ה-DynamicRemoteFileResolver שישמש לפתרון הקובצים.
החזרות
רשימת ERROR(/File) שהבעיה שלהם נפתרה בדרך הזו.
זריקות
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

שיטות מוגנות

getUnsetMandatoryOptions

protected  getUnsetMandatoryOptions ()

הפונקציה מחזירה את השמות של כל הערכים של Option שסומנו כ-mandatory אבל לא הוגדרו.

החזרות
ERROR(/Collection) של String שמכיל את השמות (ללא הסיווג) של האפשרויות החובה שלא הוגדרו.
זריקות
ConfigurationException אם אין גישה לשדה שרוצים לבדוק