OptionSetter

public class OptionSetter
extends Object

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

מילוי השדות Option.

יש תמיכה בהגדרה של שדות מספריים כמו שדות byte,‏ short,‏ int,‏ long,‏ float ו-double. החישוב כולל גם גרסה של הקופסה וגם גרסה של הקופסה (למשל Integer לעומת מספר שלם). אם יש בעיה בהגדרת הארגומנט כך שיתאים לסוג הרצוי, מתרחשת הטלת ConfigurationException.

כדי לתמוך בשדות של אפשרויות קובץ, פשוט עוטפים את ארגומנט המחרוזת באובייקט File בלי לבדוק אם הקובץ קיים.

יש תמיכה בשדות של אוספים עם פרמטרים, כמו List<File> ו-Set<String>, כל עוד סוג הפרמטר נתמך בדרך אחרת על ידי ה-setter של האפשרות. צריך לאתחל את שדה האוסף באמצעות מופע אוסף מתאים.

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

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

מאמרים קשורים:

סיכום

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

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) הנתון, בטיפול במקרים חריגים.

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()

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

קבועים

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

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

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

OptionSetter

public OptionSetter ( optionSources)

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

פרמטרים
optionSources

זריקות
com.android.tradefed.config.Configuration וכל החריגות
ConfigurationException

OptionSetter

public OptionSetter (Object... optionSources)

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

פרמטרים
optionSources Object

זריקות
com.android.tradefed.config.Configuration וכל החריגות
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 לחיפוש
החזרות
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

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 אם לא ניתן למצוא את האפשרות או שהערך של valueText שגוי

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) שתואמים לכל שדה אובייקט שעבר שינוי.
זריקות
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 אם שדה לבדיקה אינו נגיש