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

تنشئ هذه الدالة برنامج OptionParser جديدًا لضبط حقول @Option الخاصة بـ "optionSources".

OptionSetter(Collection<Object> optionSources)

تنشئ هذه الدالة برنامج OptionParser جديدًا لضبط حقول @Option الخاصة بـ "optionSources".

الإجراءات العامة

static Object getFieldValue(Field field, Object optionObject)

لعرض قيمة Field المحدّدة، مع معالجة أي استثناءات

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

تضبط هذه السمة قيمة خيار غير خريطة.

List<OptionSetter.FieldDef> setOptionValue(String optionName, String keyText, String valueText)

تضبط هذه السمة قيمة أحد الخيارات.

final Set<File> validateRemoteFilePath(DynamicRemoteFileResolver resolver)

يتم تنفيذ جميع أنواع الخيارات File والتحقّق مما إذا كان يجب حلّ مسارها.

طُرق محمية

Collection<String> getUnsetMandatoryOptions()

تعرِض هذه السمة أسماء جميع Option التي تم وضع علامة mandatory عليها ولكنها تظل غير مضبوطة.

الثوابت

NAMESPACE_SEPARATOR

public static final char NAMESPACE_SEPARATOR

Constant Value: 58 (0x0000003a)

طُرق وضع التصميم العامة

OptionSetter

public OptionSetter (Object... optionSources)

تنشئ هذه الدالة برنامج OptionParser جديدًا لضبط حقول @Option الخاصة بـ "optionSources".

المعلَمات
optionSources Object

عمليات الطرح
com.android.tradefed.config.ConfigurationException
ConfigurationException

OptionSetter

public OptionSetter (Collection<Object> optionSources)

تنشئ هذه الدالة برنامج OptionParser جديدًا لضبط حقول @Option الخاصة بـ "optionSources".

المعلَمات
optionSources Collection

عمليات الطرح
com.android.tradefed.config.ConfigurationException
ConfigurationException

الإجراءات العامة

getFieldValue

public static Object getFieldValue (Field field, 
                Object optionObject)

لعرض قيمة Field المحدّدة، مع معالجة أي استثناءات

المعلَمات
field Field: 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 List<Field> getOptionFieldsForClass (Class<?> optionClass)

تعرض هذه الطريقة قائمة بجميع حقول Option (المحدّدة والموروثة) لفئة معيّنة.

المعلَمات
optionClass Class: Class للبحث
المرتجعات
List<Field> 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: Field
key ‫Object: مفتاح لإدخال في حقل Map أو MultiMap أو قيمة فارغة
value Object: القيمة المطلوب ضبطها
checkOption boolean

المرتجعات
boolean ما إذا تم ضبط الحقل.
عمليات الطرح
com.android.tradefed.config.ConfigurationException
ConfigurationException

يُرجى الاطّلاع أيضًا على:

setKeyStore

public void setKeyStore (IKeyStoreClient keyStore)

المعلَمات
keyStore IKeyStoreClient

setOptionValue

public List<OptionSetter.FieldDef> setOptionValue (String optionName, 
                String valueText)

تضبط هذه السمة قيمة خيار غير خريطة.

المعلَمات
optionName ‫String: اسم الخيار المطلوب ضبطه
valueText String: القيمة
المرتجعات
List<OptionSetter.FieldDef> قائمة ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) تتوافق مع كل حقل من حقول الكائن تم تعديله.
عمليات الطرح
ConfigurationException إذا لم يتم العثور على الخيار أو كان نوع valueText غير صحيح

setOptionValue

public List<OptionSetter.FieldDef> setOptionValue (String optionName, 
                String keyText, 
                String valueText)

تضبط هذه السمة قيمة أحد الخيارات.

المعلَمات
optionName ‫String: اسم الخيار المطلوب ضبطه
keyText ‫String: مفتاح خيارات الخريطة أو قيمة فارغة
valueText String: القيمة
المرتجعات
List<OptionSetter.FieldDef> قائمة ERROR(FieldDef/com.android.tradefed.config.OptionSetter.FieldDef FieldDef) تتوافق مع كل حقل من حقول الكائن تم تعديله.
عمليات الطرح
ConfigurationException إذا لم يتم العثور على الخيار أو كان نوع valueText غير صحيح

validateRemoteFilePath

public final Set<File> validateRemoteFilePath (DynamicRemoteFileResolver resolver)

يتم تنفيذ جميع أنواع الخيارات File والتحقّق مما إذا كان يجب حلّ مسارها.

المعلَمات
resolver DynamicRemoteFileResolver: DynamicRemoteFileResolver المطلوب استخدامه لتحديد الملفات.
المرتجعات
Set<File> قائمة File التي تم حلّها بهذه الطريقة
عمليات الطرح
com.android.tradefed.build.BuildRetrievalError
BuildRetrievalError

طُرق محمية

getUnsetMandatoryOptions

protected Collection<String> getUnsetMandatoryOptions ()

تعرِض هذه السمة أسماء جميع Option التي تم وضع علامة mandatory عليها ولكنها تظل غير مضبوطة.

المرتجعات
Collection<String> قائمة Collection من Strings تحتوي على أسماء (غير مؤهَّلة) للخيارات الإلزامية غير المضبوطة.
عمليات الطرح
ConfigurationException إذا كان الحقل المطلوب التحقّق منه تعذّر الوصول إليه