ConfigurationFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

पहचाने गए डायरेक्ट सबक्लास GCSConfigurationFactory, RetryConfigurationFactory, SandboxConfigurationFactory GCSConfigurationFactory ConfigurationFactory, Google Cloud Storage से कॉन्फ़िगरेशन लोड करता है.  RetryConfigurationFactory फ़ैक्ट्री, जो किसी निर्देश को फिर से चलाने की प्रोसेस को मैनेज करती है.  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) यह एक आसान तरीका है, जो null दूसरे आर्ग्युमेंट के साथ ERROR(/#createConfigurationFromArgs(String[],List)) को कॉल करता है.
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 के लिए, सहायता आउटपुट प्रिंट करता है, अगर 'args' किसी ऐसे कॉन्फ़िगरेशन का रेफ़रंस देता है जिसकी जानकारी पहले से है, तो एक्सएमएल से एक IConfiguration ऑब्जेक्ट बनाया जाएगा और उस IConfiguration के लिए मदद आउटपुट की जाएगी.

सुरक्षित तरीके
InputStream	getBundledConfigStream(String name)
String	getConfigPrefix() क्लासपाथ पर कॉन्फ़िगरेशन एक्सएमएल फ़ाइलों का पाथ प्रीफ़िक्स दिखाता है यूनिट टेस्ट के लिए, इसे एक्सपोज़ किया गया है.
BufferedInputStream	getConfigStream(String name) दिए गए कॉन्फ़िगरेशन के नाम के लिए InputStream लोड करता है
ConfigurationDef	getConfigurationDef(String name, boolean isGlobal, templateMap) दिए गए नाम के लिए ConfigurationDef फ़ंक्शन का इस्तेमाल करना
	getMapConfig() टेस्टिंग के लिए एक्सपोज़ किया गया.
boolean	isDirectConfiguration(String configName)
String[]	reorderArgs(String[] args) 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, पहले से मौजूद कॉन्फ़िगरेशन का नाम या कॉन्फ़िगरेशन एक्सएमएल फ़ाइल का फ़ाइल पाथ होता है.

पैरामीटर
arrayArgs	String: कमांड लाइन के आर्ग्युमेंट
unconsumedArgs	: एक सूची, जिसमें उन आर्ग्युमेंट की जानकारी होगी जिन्हें तय किए गए कॉन्फ़िगरेशन से जुड़े ऑब्जेक्ट ने इस्तेमाल नहीं किया था. अगर यह वैल्यू null है, तो लागू करने पर, अगर कोई ऐसा आर्ग्युमेंट बचता है जिसे प्रोसेस नहीं किया गया है, तो ConfigurationException को दिखाया जाएगा.

रिटर्न
IConfiguration	लोड किया गया IConfiguration. डिलीगेट ऑब्जेक्ट Option के फ़ील्ड में, वैल्यू को args में डाला गया है.

थ्रो
ConfigurationException

createConfigurationFromArgs

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

पासकोड स्टोर की मदद से, कमांड लाइन के आर्ग्युमेंट से IConfiguration बनाएं.

सही फ़ॉर्मैट "CONFIG [options]" है. इसमें CONFIG, पहले से मौजूद कॉन्फ़िगरेशन का नाम या कॉन्फ़िगरेशन एक्सएमएल फ़ाइल का फ़ाइल पाथ होता है.

पैरामीटर
arrayArgs	String: कमांड लाइन के आर्ग्युमेंट
unconsumedArgs	: एक सूची, जिसमें उन आर्ग्युमेंट की जानकारी होगी जिन्हें तय किए गए कॉन्फ़िगरेशन से जुड़े ऑब्जेक्ट ने इस्तेमाल नहीं किया था. अगर यह वैल्यू null है, तो लागू करने पर, अगर कोई ऐसा आर्ग्युमेंट बचता है जिसे प्रोसेस नहीं किया गया है, तो ConfigurationException को दिखाया जाएगा.
keyStoreClient	IKeyStoreClient: एक IKeyStoreClient, जिसका इस्तेमाल आर्ग्युमेंट में संवेदनशील जानकारी पाने के लिए किया जाता है.

रिटर्न
IConfiguration	लोड किया गया IConfiguration. डिलीगेट ऑब्जेक्ट Option के फ़ील्ड में, वैल्यू को args में डाला गया है.

थ्रो
ConfigurationException

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs)

यह एक आसान तरीका है, जो null दूसरे आर्ग्युमेंट के साथ ERROR(/#createConfigurationFromArgs(String[],List)) को कॉल करता है. इसलिए, अगर कोई ऐसा आर्ग्युमेंट बचता है जिसका इस्तेमाल नहीं किया गया है, तो यह ConfigurationException दिखाएगा.

पैरामीटर
arrayArgs	String

रिटर्न
IConfiguration

थ्रो
ConfigurationException

createGlobalConfigurationFromArgs

public IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, 
                 remainingArgs)

कमांड लाइन आर्ग्युमेंट से IGlobalConfiguration बनाएं.

सही फ़ॉर्मैट "CONFIG [options]" है. इसमें CONFIG, पहले से मौजूद कॉन्फ़िगरेशन का नाम या कॉन्फ़िगरेशन एक्सएमएल फ़ाइल का फ़ाइल पाथ होता है.

पैरामीटर
arrayArgs	String: कमांड लाइन के आर्ग्युमेंट
remainingArgs	: एक सूची, जिसमें उन आर्ग्युमेंट की जानकारी होगी जिन्हें ग्लोबल आर्ग्युमेंट के तौर पर प्रोसेस नहीं किया गया था

रिटर्न
IGlobalConfiguration	लोड किया गया IGlobalConfiguration. डिलीगेट ऑब्जेक्ट Option के फ़ील्ड में, args में दी गई वैल्यू अपने-आप भर गई हैं.

थ्रो
ConfigurationException

createPartialConfigurationFromArgs

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

ऐसा कॉन्फ़िगरेशन बनाएं जिसमें सिर्फ़ चुने गए ऑब्जेक्ट का सेट शामिल हो.

पैरामीटर
arrayArgs	String: कमांड लाइन के आर्ग्युमेंट
keyStoreClient	IKeyStoreClient: एक IKeyStoreClient, जिसका इस्तेमाल आर्ग्युमेंट में संवेदनशील जानकारी पाने के लिए किया जाता है.
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 फ़ाइलों में मिले सभी कॉन्फ़िगरेशन के नामों की सूची दिखाता है. यह किसी भी कॉन्फ़िगरेशन को लोड करने की कोशिश नहीं करता. इसलिए, इस सूची में काम न करने वाला कॉन्फ़िगरेशन हो सकता है.

रिटर्न

getInstance

public static IConfigurationFactory getInstance ()

सिंगलटन IConfigurationFactory इंस्टेंस पाएं.

रिटर्न
IConfigurationFactory

loadAllConfigs

public void loadAllConfigs (boolean discardExceptions)

क्लासपाथ और टेस्ट केस डायरेक्ट्री में मिले सभी कॉन्फ़िगरेशन लोड करता है.

पैरामीटर
discardExceptions	boolean: अगर किसी ConfigurationException को अनदेखा करना है, तो इसे true पर सेट करें.

थ्रो
	com.android.tradefed.config.ConfigurationException
ConfigurationException

loadAndPrintAllConfigs

public void loadAndPrintAllConfigs ()

यह एक यूटिलिटी तरीका है, जो यह जांच करता है कि सभी कॉन्फ़िगरेशन लोड किए जा सकते हैं, पार्स किए जा सकते हैं, और सभी विकल्प की वैल्यू सेट की जा सकती हैं. सिर्फ़ इसलिए दिखाया जाता है, ताकि डिपेंडेंट प्रोजेक्ट अपने कॉन्फ़िगरेशन की पुष्टि कर सके. इसे कंसोल में नहीं दिखाया जाना चाहिए.

थ्रो
ConfigurationException	अगर एक या उससे ज़्यादा कॉन्फ़िगरेशन लोड नहीं हो पाते हैं

printHelp

public void printHelp (PrintStream out)

इस फ़ैक्ट्री के लिए सहायता आउटपुट प्रिंट करता है.

सामान्य सहायता जानकारी को प्रिंट करता है और सभी उपलब्ध कॉन्फ़िगरेशन की सूची दिखाता है.

पैरामीटर
out	PrintStream: आउटपुट को डंप करने के लिए ERROR(/PrintStream)

printHelpForConfig

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

कमांड लाइन के आर्ग्युमेंट में बताए गए IConfiguration के लिए, सहायता आउटपुट प्रिंट करता है,

अगर 'args' किसी ऐसे कॉन्फ़िगरेशन का रेफ़रंस देता है जिसकी जानकारी पहले से है, तो एक्सएमएल से एक IConfiguration ऑब्जेक्ट बनाया जाएगा और उस IConfiguration के लिए मदद आउटपुट की जाएगी. ध्यान दें कि अन्य सभी 'args' वैल्यू को अनदेखा कर दिया जाएगा. इसका मतलब है कि सहायता टेक्स्ट में, एक्सएमएल से लोड की गई Options की मौजूदा वैल्यू के बारे में बताया जाएगा. साथ ही, इसमें कमांड लाइन के आर्ग्युमेंट से सेट की गई वैल्यू नहीं दिखेंगी.

अगर 'args' में किसी 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 ()

क्लासपाथ पर कॉन्फ़िगरेशन एक्सएमएल फ़ाइलों का पाथ प्रीफ़िक्स दिखाता है

यूनिट टेस्ट के लिए, इसे एक्सपोज़ किया गया है.

रिटर्न
String	String पाथ, जिसके आखिर में / है

getConfigStream

protected BufferedInputStream getConfigStream (String name)

दिए गए कॉन्फ़िगरेशन के नाम के लिए InputStream लोड करता है

पैरामीटर
name	String: लोड करने के लिए कॉन्फ़िगरेशन का नाम

रिटर्न
BufferedInputStream	कॉन्फ़िगरेशन कॉन्टेंट पढ़ने के लिए ERROR(/BufferedInputStream)

थ्रो
ConfigurationException	if config could not be found

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)

args को फिर से क्रम में लगाएं, ताकि template:map के सभी आर्ग्युमेंट सबसे आगे आ जाएं.

पैरामीटर
args	String

रिटर्न
String[]

resolveRemoteFile

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

पैरामीटर
configURI	URI
destDir	URI

रिटर्न
IRemoteFileResolver.ResolvedFile

थ्रो
BuildRetrievalError