تنظیم‌کننده گزینه

public class OptionSetter
extends Object

شیء جاوا
↳ com.android.tradefed.config.OptionSetter

فیلدهای Option را پر می‌کند.

تنظیم فیلدهای عددی مانند فیلدهای byte، short، int، long، float و double پشتیبانی می‌شود. این شامل نسخه‌های unboxed و boxed (مثلاً int در مقابل Integer) می‌شود. اگر مشکلی در تنظیم آرگومان برای مطابقت با نوع مورد نظر وجود داشته باشد، خطای ConfigurationException رخ می‌دهد.

فیلدهای گزینه فایل با قرار دادن آرگومان رشته‌ای در یک شیء فایل، بدون بررسی وجود فایل، پشتیبانی می‌شوند.

فیلدهای مجموعه پارامتری مانند List<File> و Set<String> تا زمانی که نوع پارامتر توسط تنظیم‌کننده گزینه پشتیبانی شود، پشتیبانی می‌شوند. فیلد مجموعه باید با یک نمونه مجموعه مناسب مقداردهی اولیه شود.

همه فیلدها، از جمله فیلدهای عمومی، محافظت‌شده، دسترسی پیش‌فرض (بسته)، خصوصی و ارث‌بری، پردازش خواهند شد.

از dalvik.runner.OptionParser منتقل شده است

همچنین ببینید:

خلاصه

کلاس‌های تو در تو

class OptionSetter.Handler <T>

class OptionSetter.MapHandler

یک Handler برای مدیریت مقادیر فیلدهای Map.

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 علامت‌گذاری شده‌اند اما تنظیم نشده‌اند، برمی‌گرداند.

ثابت‌ها

جداکننده نام 

public static final char NAMESPACE_SEPARATOR

مقدار ثابت: ۵۸ (۰x۰۰۰۰۰۰۳a)

سازندگان عمومی

تنظیم‌کننده گزینه 

public OptionSetter (Object... optionSources)

یک OptionParser جدید برای تنظیم فیلدهای @Option از 'optionSources' می‌سازد.

پارامترها
optionSources Object

پرتاب‌ها
com.android.tradefed.config.ConfigurationException
ConfigurationException

تنظیم‌کننده گزینه 

public OptionSetter (Collection<Object> optionSources)

یک OptionParser جدید برای تنظیم فیلدهای @Option از 'optionSources' می‌سازد.

پارامترها
optionSources Collection

پرتاب‌ها
com.android.tradefed.config.ConfigurationException
ConfigurationException

روش‌های عمومی

دریافت مقدار فیلد 

public static Object getFieldValue (Field field, 
                Object optionObject)

مقدار Field داده شده را برمی‌گرداند و هرگونه استثنا را مدیریت می‌کند.

پارامترها
field Field : Field

optionObject Object : Object که قرار است مقدار فیلد از آن دریافت شود.

بازگشت‌ها
Object مقدار فیلد به عنوان یک Object یا null

دریافت‌کننده 

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

پارامترها
type Type

بازگشت‌ها
OptionSetter.Handler <T>

پرتاب‌ها
ConfigurationException

دریافت کلید فروشگاه 

public IKeyStoreClient getKeyStore ()

بازگشت‌ها
IKeyStoreClient

دریافت فیلدهای اختیاری برای کلاس 

public static List<Field> getOptionFieldsForClass (Class<?> optionClass)

لیستی از تمام فیلدهای Option (اعم از تعریف‌شده و ارث‌بری‌شده) برای کلاس داده‌شده را دریافت می‌کند.

پارامترها
optionClass Class : Class که باید جستجو شود

بازگشت‌ها
List<Field> Collection از فیلدها که با Option حاشیه‌نویسی شده‌اند

نوع‌گزینه را دریافت کنید 

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

مقدار فیلد را تنظیم کنید 

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

همچنین ببینید:

فروشگاه کلید تنظیم‌شده 

public void setKeyStore (IKeyStoreClient keyStore)

پارامترها
keyStore IKeyStoreClient

مقدار گزینه را تنظیم کنید 

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 نوع نادرستی دارد

مقدار گزینه را تنظیم کنید 

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 نوع نادرستی دارد

اعتبارسنجی مسیر فایل راه دور 

public final Set<File> validateRemoteFilePath (DynamicRemoteFileResolver resolver)

تمام انواع گزینه‌های File را بررسی می‌کند و بررسی می‌کند که آیا مسیر آنها باید مشخص شود یا خیر.

پارامترها
resolver DynamicRemoteFileResolver : DynamicRemoteFileResolver برای حل مشکل فایل‌ها استفاده می‌شود.

بازگشت‌ها
Set<File> لیست File که به این روش حل شده‌اند.

پرتاب‌ها
خطای بازیابی ساخت در com.android.tradefed.build.Build
BuildRetrievalError

روش‌های محافظت‌شده

گزینه‌های اجباری دریافت نشده 

protected Collection<String> getUnsetMandatoryOptions ()

نام تمام Option را که به عنوان mandatory علامت‌گذاری شده‌اند اما تنظیم نشده‌اند، برمی‌گرداند.

بازگشت‌ها
Collection<String> Collection از String که شامل نام‌های (نامشخص) گزینه‌های اجباری تنظیم نشده هستند.

پرتاب‌ها
ConfigurationException اگر فیلدی که باید تیک زده شود غیرقابل دسترسی باشد