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.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 أو قيمة فارغة
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) التي تتوافق مع كل حقل كائن تم تعديله
عمليات الرمي
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 ()

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

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

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