OptionSetter

public class OptionSetter
extends Object

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

تعبئة حقول Option

يمكن ضبط الحقول الرقمية، مثل حقول البايت والقصيرة والصحيحة والطويلة والعائمة والمضاعفة. ويشمل ذلك كلاً من الإصدارات غير المُعبَّأة والمُعبَّأة (مثل int مقابل Integer). إذا حدثت مشكلة عند ضبط الوسيطة لمطابقة النوع المطلوب، يتم طرح ConfigurationException.

يمكن استخدام حقول خيارات الملفات من خلال لفّ الوسيطة السلسلة في عنصر File بدون اختبار توفّر الملف.

تتوفّر حقول المجموعات المُعرَّفة بالمَعلمات، مثل List<File> وSet<String>، ما دام نوع المَعلمة متوافقًا مع أداة ضبط الخيارات. يجب بدء حقل المجموعة باستخدام مثيل مجموعة مناسب.

ستتم معالجة جميع الحقول، بما في ذلك الحقول العامة والمحمية والحقول التلقائية (الحزمة) والحقول الخاصة والحقول المُكتسَبة.

تم نقله من dalvik.runner.OptionParser

راجِع أيضًا:

ملخّص

الفئات المُدمجة

class OptionSetter.OptionFieldsForName

حاوية لقائمة حقول الخيارات التي تحمل اسمًا معيّنًا 

الثابتات

char NAMESPACE_SEPARATOR

وظائف الإنشاء العامة

OptionSetter(Object... optionSources)

ينشئ OptionParser جديدًا لضبط حقول @Option في optionSources.

OptionSetter( 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 (Object... optionSources)

ينشئ OptionParser جديدًا لضبط حقول @Option في optionSources.

المعلمات
optionSources Object

عمليات الرمي
ConfigurationException

OptionSetter

public OptionSetter ( optionSources)

ينشئ OptionParser جديدًا لضبط حقول @Option في optionSources.

المعلمات
optionSources

عمليات الرمي
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 if field could not be found

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: القيمة
المرتجعات
قائمة بقيم FieldDef التي تتوافق مع كل حقل كائن تم تعديله
عمليات الرمي
ConfigurationException إذا تعذّر العثور على الخيار أو إذا كان نوع valueText غير صحيح

setOptionValue

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

لضبط قيمة خيار

المعلمات
optionName String: اسم الخيار المطلوب ضبطه
keyText ‫String: مفتاح خيارات الخريطة، أو قيمة فارغة
valueText String: القيمة
المرتجعات
قائمة بقيم FieldDef التي تتوافق مع كل حقل كائن تم تعديله
عمليات الرمي
ConfigurationException إذا تعذّر العثور على الخيار أو إذا كان valueText من النوع غير الصحيح

validateRemoteFilePath

public final  validateRemoteFilePath (DynamicRemoteFileResolver resolver)

يُجري هذا الإجراء فحصًا لجميع أنواع الخيارات ERROR(/File) للتحقّق مما إذا كان يجب حلّ مسارها.

المعلمات
resolver DynamicRemoteFileResolver

المرتجعات
قائمة ERROR(/File) التي تم حلّها بهذه الطريقة
عمليات الرمي
BuildRetrievalError

الطرق المحمية

getUnsetMandatoryOptions

protected  getUnsetMandatoryOptions ()

عرض أسماء جميع Option التي تم وضع علامة عليها على أنّها mandatory ولكن لا تزال غير محدّدة

المرتجعات
ERROR(/Collection) من String تحتوي على أسماء (غير مؤهَّلة) للخيارات الإلزامية التي لم يتم ضبط قيمها

عمليات الرمي
ConfigurationException إذا تعذّر الوصول إلى حقل يجب التحقّق منه