IConfigurationFactory

public interface IConfigurationFactory

com.android.tradefed.config.IConfigurationFactory

الفئات الفرعية غير المباشرة المعروفة ConfigurationFactory وGCSConfigurationFactory وRetryConfigurationFactory وSandboxConfigurationFactory ConfigurationFactory المصنع لإنشاء IConfiguration  GCSConfigurationFactory يحمّل ConfigurationFactory الإعدادات من Google Cloud Storage.  إعادة المحاولة_في_الإعداد مصنع يعالج إعادة محاولة تنفيذ أمر.  SandboxConfigurationFactory مصنع الإعدادات الخاص لمعالجة إنشاء الإعدادات لأغراض وضع الحماية.

---

مصنع لإنشاء IConfiguration

ملخّص

الطرق العامة
abstract IConfiguration	createConfigurationFromArgs(String[] args, unconsumedArgs) أنشئ IConfiguration من وسيطات سطر الأوامر.
abstract IConfiguration	createConfigurationFromArgs(String[] args) طريقة مساعدة تستدعي ERROR(/#createConfigurationFromArgs(String[],List)) باستخدام وسيطة ثانية null.
abstract IConfiguration	createConfigurationFromArgs(String[] args, unconsumedArgs, IKeyStoreClient keyStoreClient) أنشئ IConfiguration من مَعلمات سطر الأوامر باستخدام متجر مفاتيح.
abstract IGlobalConfiguration	createGlobalConfigurationFromArgs(String[] args, nonGlobalArgs) أنشئ IGlobalConfiguration من وسيطات سطر الأوامر.
abstract IConfiguration	createPartialConfigurationFromArgs(String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) أنشئ إعدادات تحتوي فقط على مجموعة من العناصر المحدّدة.
abstract void	dumpConfig(String configName, PrintStream out) تفريغ محتوى الإعدادات في ERROR(/PrintStream) المحدّد
abstract	getConfigList() عرض قائمة بأسماء جميع الإعدادات المتوفّرة في حِزم JAR على مسار الطباعة
abstract	getConfigList(String subPath, boolean loadFromEnv) يشير هذا الاختلاف إلى getConfigList() حيث يمكننا تحديد ما إذا كنا نريد أيضًا تحميل الإعدادات من البيئة أم لا.
abstract void	printHelp(PrintStream out) تساعد الصور المطبوعة في زيادة الإنتاج في هذا المصنع.
abstract void	printHelpForConfig(String[] args, boolean importantOnly, PrintStream out) طباعة المساعدة في إخراج IConfiguration المحدّد في وسيطات سطر الأوامر إذا كانت "args" تشير إلى إعداد معروف، سيتم إنشاء عنصر IConfiguration من ملف XML، وسيتم عرض مساعدة حول هذا IConfiguration.

الطرق العامة

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                 unconsumedArgs)

يمكنك إنشاء IConfiguration من وسيطات سطر الأوامر.

التنسيق المتوقّع هو "CONFIG [options]"، حيث يكون CONFIG هو اسم الإعدادات المضمّنة أو مسار ملف لملف XML للإعدادات.

المعلمات
args	String: وسيطات سطر الأوامر
unconsumedArgs	: قائمة ستتم تعبئتها بالوسيطات التي لم يتم استخدامها من قِبل العناصر المرتبطة بالإعداد المحدّد. إذا كانت هذه القيمة null، ستعرض عملية التنفيذ ConfigurationException في حال بقاء أي وسيطات لم تتم معالجتها.

المرتجعات
IConfiguration	IConfiguration المحمَّلة. تمت تعبئة حقول العنصر المفوَّض Option بالقيم الواردة في args.

عمليات الرمي
ConfigurationException	في حال تعذّر تحميل الإعدادات

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args)

طريقة مساعدة تستدعي ERROR(/#createConfigurationFromArgs(String[],List)) باستخدام وسيطة ثانية null. وبالتالي، سيتم طرح ConfigurationException إذا بقيت أي وسيطات غير مستخدَمة.

المعلمات
args	String

المرتجعات
IConfiguration

الرميات
ConfigurationException

راجِع أيضًا:

• ERROR(/#createConfigurationFromArgs(String[], List))

createConfigurationFromArgs

public abstract IConfiguration createConfigurationFromArgs (String[] args, 
                 unconsumedArgs, 
                IKeyStoreClient keyStoreClient)

يمكنك إنشاء IConfiguration من وسيطات سطر الأوامر باستخدام ملف تخزين مفاتيح.

التنسيق المتوقّع هو "CONFIG [options]"، حيث يشير CONFIG إلى اسم الإعدادات المُدمَجة أو مسار ملف إلى ملف XML للإعدادات.

المعلمات
args	String: وسيطات سطر الأوامر
unconsumedArgs	: قائمة ستتم تعبئتها بالوسيطات التي لم يتم استخدامها من قِبل العناصر المرتبطة بالإعداد المحدّد. إذا كانت هذه القيمة null، ستعرض عملية التنفيذ ConfigurationException في حال بقاء أي وسيطات لم تتم معالجتها.
keyStoreClient	IKeyStoreClient: IKeyStoreClient يُستخدَم للحصول على معلومات حسّاسة في الوسيطات

المرتجعات
IConfiguration	IConfiguration المحمَّل. تمت تعبئة حقول العنصر المفوَّض Option بالقيم الواردة في args.

عمليات الرمي
ConfigurationException	في حال تعذّر تحميل الإعدادات

createGlobalConfigurationFromArgs

public abstract IGlobalConfiguration createGlobalConfigurationFromArgs (String[] args, 
                 nonGlobalArgs)

يمكنك إنشاء IGlobalConfiguration من وسيطات سطر الأوامر.

التنسيق المتوقّع هو "CONFIG [options]"، حيث يكون CONFIG هو اسم الإعدادات المضمّنة أو مسار ملف لملف إعدادات XML.

المعلمات
args	String: وسيطات سطر الأوامر
nonGlobalArgs	: قائمة سيتم تعبئتها بالوسيطات التي لم تتم معالجتها كوسيطات عامة

المرتجعات
IGlobalConfiguration	IGlobalConfiguration المحمَّل. تمّت تعبئة حقول العنصر المفوَّض Option بالقيم الواردة في args.

عمليات الرمي
ConfigurationException	في حال تعذّر تحميل الإعدادات

createPartialConfigurationFromArgs

public abstract IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, 
                IKeyStoreClient keyStoreClient, 
                 allowedObjects, 
                TradefedDelegator delegator)

أنشئ إعدادات تحتوي فقط على مجموعة من العناصر المحدّدة.

المعلمات
arrayArgs	String: وسيطات سطر الأوامر
keyStoreClient	IKeyStoreClient: IKeyStoreClient يُستخدَم للحصول على معلومات حساسة في الوسيطات.
allowedObjects	: مجموعة العناصر المسموح بإنشاءها
delegator	TradefedDelegator

المرتجعات
IConfiguration	تم تحميل IConfiguration.

عمليات الرمي
ConfigurationException	في حال تعذّر تحميل الإعدادات

dumpConfig

public abstract void dumpConfig (String configName, 
                PrintStream out)

تفريغ محتوى الإعدادات في ERROR(/PrintStream) المحدَّد

المعلمات
configName	String: اسم الإعداد
out	PrintStream: ERROR(/PrintStream) لتفريغ الإخراج

أمر getConfigList

public abstract  getConfigList ()

عرض قائمة بأسماء جميع الإعدادات المتوفّرة في حِزم JAR على مسار تحميل الحِزم لا تحاول تحميل أي من الإعدادات، لذا من الممكن أن تتضمّن هذه القائمة إعدادات غير صالحة.

المرتجعات

getConfigList

public abstract  getConfigList (String subPath, 
                boolean loadFromEnv)

هي صيغة getConfigList() حيث يمكن تحديد ما إذا كنا نرغب أيضًا في تحميل الإعدادات من البيئة أم لا.

المعلمات
subPath	String: اسم الأدلة الفرعية التي يجب البحث فيها عن الإعدادات إذا كان العنصر فارغًا، سيكون له السلوك نفسه مثل getConfigList().
loadFromEnv	boolean: صحيح إذا كان علينا تحميل الإعدادات في متغيّر البيئة.

المرتجعات

مساعدة الطباعة

public abstract void printHelp (PrintStream out)

تساعد الصور المطبوعة في زيادة الإنتاج في هذا المصنع.

تطبع معلومات مساعدة عامة وتسرد جميع الإعدادات المتاحة.

المعلمات
out	PrintStream: ERROR(/PrintStream) لتفريغ الإخراج

printHelpForConfig

public abstract void printHelpForConfig (String[] args, 
                boolean importantOnly, 
                PrintStream out)

طباعة المساعدة في إخراج IConfiguration المحدّد في وسيطات سطر الأوامر

إذا كانت "args" تشير إلى إعداد معروف، سيتم إنشاء عنصر IConfiguration من ملف XML، وسيتم عرض مساعدة حول هذا IConfiguration. يُرجى العِلم أنّه سيتم تجاهل جميع قيم "args" الأخرى (أي أنّ نص المساعدة سيصف القيم الحالية لـ Options كما تم تحميلها من XML، ولن يعكس قيم الخيارات التي تم ضبطها من خلال وسيطات سطر الأوامر.

إذا لم تشير "args" إلى IConfiguration معروف، سيتم عرض المساعدة العامة printHelp(PrintStream).

المعلمات
args	String: وسيطات سطر الأوامر
importantOnly	boolean: إذا كان الخيار true، اطبع مساعدة مختصرة تسرد التفاصيل المهمة فقط.
out	PrintStream: ERROR(/PrintStream) لتفريغ الإخراج