إعدادات المصنع

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

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

---

المصنع لإنشاء IConfiguration

ملخّص

الصفوف المتداخلة
class	ConfigurationFactory.ConfigLoader تنفيذ IConfigDefLoader الذي يتتبّع الإعدادات المضمّنة من أحد الإعدادات الأساسية ويُلقي استثناءً على عمليات التضمين الدائرية
class	ConfigurationFactory.ExceptionLoader

منصات إنشاء محمية
ConfigurationFactory()

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

الطرق المحمية
InputStream	getBundledConfigStream(String name)
String	getConfigPrefix() عرض بادئة المسار لملفات "config xml" في classpath تمّ عرضها لكي تتمكّن اختبارات الوحدة من محاكاة البيانات.
BufferedInputStream	getConfigStream(String name) تحميل مصدر الإدخال لاسم الإعداد المحدّد
ConfigurationDef	getConfigurationDef(String name, boolean isGlobal, templateMap) استرداد ConfigurationDef للاسم المحدَّد
	getMapConfig() معرض للاختبار.
boolean	isDirectConfiguration(String configName)
String[]	reorderArgs(String[] args) غيِّر ترتيب الوسائط بحيث يتم نقل جميع وسيطات template:map إلى المقدمة.
IRemoteFileResolver.ResolvedFile	resolveRemoteFile(URI configURI, URI destDir)

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

ConfigurationFactory

protected ConfigurationFactory ()

الطرق العامة

clearMapConfig

public void clearMapConfig ()

في بعض الحالات، نحتاج إلى محو المحتوى من الخريطة.

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

أنشئ IConfiguration من وسيطات سطر الأوامر.

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

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

المرتجعات
IConfiguration	IConfiguration المحمَّل. تحتوي حقول عنصر التفويض Option على تم ملؤها بقيم في الوسيطات.

الرميات
ConfigurationException

createConfigurationFromArgs

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

أنشئ IConfiguration من مَعلمات سطر الأوامر باستخدام متجر مفاتيح.

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

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

المرتجعات
IConfiguration	IConfiguration المحمَّل. تحتوي حقول عنصر التفويض Option على تم ملؤها بقيم في الوسيطات.

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

إنشاء_تكوينمنArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

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

المعلمات
arrayArgs	String

المرتجعات
IConfiguration

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

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

أنشئ IGlobalConfiguration من وسيطات سطر الأوامر.

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

المعلمات
arrayArgs	String: وسيطات سطر الأوامر
remainingArgs	: قائمة سيتم تعبئتها بالوسيطات التي لم يتم إدخالها تمت معالجتها كوسيطات عمومية.

المرتجعات
IGlobalConfiguration	IGlobalConfiguration المحمَّل. حقول عنصر التفويض Option تمت تعبئتها بقيم في الوسيطات.

الرميات
ConfigurationException

createPartialConfigurationFromArgs

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

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

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

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

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

إعداد dumpConfig

public void dumpConfig (String configName, 
                PrintStream out)

ينقل محتوى الإعدادات إلى ERROR(/PrintStream) المحدّد

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

أمر getConfigList

public  getConfigList (String subPath, 
                boolean loadFromEnv)

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

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

المرتجعات

أمر getConfigList

public  getConfigList ()

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

المرتجعات

الحصول على مثيل

public static IConfigurationFactory getInstance ()

احصل على مثيل IConfigurationFactory في نمط "العنصر الفردي".

المرتجعات
IConfigurationFactory

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

تحمِّل جميع الإعدادات الواردة في أدلة classpath وحالات الاختبار.

المعلمات
discardExceptions	boolean: صحيح إذا كان يجب تجاهل أي استثناء.

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

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

طريقة الأداة التي تتحقّق من إمكانية تحميل جميع الإعدادات وتحليلها مجموعة قيم جميع الخيارات. الكشف فقط بحيث يمكن للمشروع التحقق من صحة الإعدادات. يجب ألا يتم عرضها في وحدة التحكّم.

الرميات
ConfigurationException	في حال تعذّر تحميل إعداد واحد أو أكثر

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

public void printHelp (PrintStream out)

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

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

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

printHelpForConfig

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

تساعد الطباعة في الحصول على نتائج IConfiguration المحدّدة في وسيطات سطر الأوامر،

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

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

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

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

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

المعلمات
name	String

المرتجعات
InputStream

getConfigPrefix

protected String getConfigPrefix ()

عرض بادئة المسار لملفات "config xml" في classpath

تمّ عرضها لكي تتمكّن اختبارات الوحدة من محاكاة البيانات.

المرتجعات
String	مسار String مع لاحقة /

getConfigStream

protected BufferedInputStream getConfigStream (String name)

تحميل مصدر الإدخال لاسم الإعداد المحدّد

المعلمات
name	String: اسم الإعدادات المطلوب تحميله

المرتجعات
BufferedInputStream	ERROR(/BufferedInputStream) لقراءة محتوى الإعدادات

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

أمر getConfigurationDef

protected ConfigurationDef getConfigurationDef (String name, 
                boolean isGlobal, 
                 templateMap)

استرداد ConfigurationDef للاسم المحدَّد

المعلمات
name	String: اسم الإعدادات المضمنة للتحميل أو مسار ملف إلى ملف الإعداد للتحميل
isGlobal	boolean
templateMap

المرتجعات
ConfigurationDef	ConfigurationDef

عمليات الرمي
ConfigurationException	في حال حدوث خطأ أثناء تحميل الإعدادات

getMapConfig

protected  getMapConfig ()

تمّ عرضها للاختبار. إرجاع نسخة من الخريطة

المرتجعات

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

المعلمات
configName	String

المرتجعات
boolean

reorderArgs

protected String[] reorderArgs (String[] args)

غيِّر ترتيب الوسيطات لكي يتم نقل جميع وسيطات template:map إلى المقدمة.

المعلمات
args	String

المرتجعات
String[]

resolveRemoteFile

protected IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, 
                URI destDir)

المعلمات
configURI	URI
destDir	URI

المرتجعات
IRemoteFileResolver.ResolvedFile

الرميات
BuildRetrievalError