使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

配置工厂

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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


用于创建IConfiguration的工厂。

概括

嵌套类

class ConfigurationFactory.ConfigLoader

IConfigDefLoader的实现,它从一个根配置跟踪包含的配置,并在循环包含时引发异常。

class ConfigurationFactory.ExceptionLoader

受保护的构造函数

ConfigurationFactory ()

公共方法

void clearMapConfig ()

在某些特殊情况下,我们需要清除地图。

IConfiguration createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs) createConfigurationFromArgs (String[] arrayArgs, unconsumedArgs)

从命令行参数创建IConfiguration

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

使用密钥库从命令行参数创建IConfiguration

IConfiguration createConfigurationFromArgs (String[] arrayArgs)

一种方便的方法,它调用带有null第二个参数的ERROR(/#createConfigurationFromArgs(String[],List))

IGlobalConfiguration createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs) createGlobalConfigurationFromArgs (String[] arrayArgs, remainingArgs)

从命令行参数创建IGlobalConfiguration

IConfiguration createPartialConfigurationFromArgs (String[] arrayArgs, IKeyStoreClient keyStoreClient, allowedObjects, TradefedDelegator delegator) 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”指的是已知配置,则将从 XML 创建一个IConfiguration对象,并输出该IConfiguration的帮助。

受保护的方法

InputStream getBundledConfigStream (String name)
String getConfigPrefix ()

返回类路径上配置 xml 文件的路径前缀

暴露所以单元测试可以模拟。

BufferedInputStream getConfigStream (String name)

为给定的配置名称加载 InputStream

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

检索给定名称的ConfigurationDef

getMapConfig ()

暴露用于测试。

boolean isDirectConfiguration (String configName)
String[] reorderArgs (String[] args)

重新排序 args 以便 template:map args 全部移到前面。

IRemoteFileResolver.ResolvedFile resolveRemoteFile (URI configURI, URI destDir)

受保护的构造函数

配置工厂

protected ConfigurationFactory ()

公共方法

清除地图配置

public void clearMapConfig ()

在某些特殊情况下,我们需要清除地图。

createConfigurationFromArgs

public IConfiguration createConfigurationFromArgs (String[] arrayArgs, 
                 unconsumedArgs)

从命令行参数创建IConfiguration

预期格式为“CONFIG [options]”,其中 CONFIG 是内置配置名称或配置 xml 文件的文件路径。

参数
arrayArgs String : 命令行参数

unconsumedArgs :一个列表,它将填充与指定配置关联的对象未使用的参数。如果这是null ,那么如果任何未处理的参数仍然存在,则实现将抛出ConfigurationException

退货
IConfiguration加载的IConfiguration 。委托对象Option字段已填充 args 中的值。

投掷
ConfigurationException

createConfigurationFromArgs

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

使用密钥库从命令行参数创建IConfiguration

预期格式为“CONFIG [options]”,其中 CONFIG 是内置配置名称或配置 xml 文件的文件路径。

参数
arrayArgs String : 命令行参数

unconsumedArgs :一个列表,它将填充与指定配置关联的对象未使用的参数。如果这是null ,那么如果任何未处理的参数仍然存在,则实现将抛出ConfigurationException

keyStoreClient IKeyStoreClient :一个IKeyStoreClient用于获取 args 中的敏感信息。

退货
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 是内置配置名称或配置 xml 文件的文件路径。

参数
arrayArgs String : 命令行参数

remainingArgs : 一个列表,将填充未作为全局参数处理的参数

退货
IGlobalConfiguration加载的IGlobalConfiguration 。委托对象Option字段已填充 args 中的值。

投掷
ConfigurationException

createPartialConfigurationFromArgs

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

创建仅包含一组选定对象的配置。

参数
arrayArgs String : 命令行参数

keyStoreClient IKeyStoreClient :一个IKeyStoreClient用于获取 args 中的敏感信息。

allowedObjects : 允许创建的对象集

delegator TradefedDelegator

退货
IConfiguration加载的IConfiguration

投掷
ConfigurationException

转储配置

public void dumpConfig (String configName, 
                PrintStream out)

将配置的内容转储到给定的ERROR(/PrintStream)

参数
configName String : 配置名称

out PrintStream : 将输出转储到的ERROR(/PrintStream)

获取配置列表

public  getConfigList (String subPath, 
                boolean loadFromEnv)

getConfigList()的变体可以指定我们是否也想从环境中加载配置。

参数
subPath String : 要查找配置的子目录的名称。如果为 null,则具有与getConfigList()相同的行为。

loadFromEnv boolean :如果我们应该在环境变量中加载配置,则为真。

退货

获取配置列表

public  getConfigList ()

返回在类路径的 JAR 中找到的所有配置的名称列表。不尝试加载任何配置,因此此列表中可能有非工作配置。

退货

获取实例

public static IConfigurationFactory getInstance ()

获取单例IConfigurationFactory实例。

退货
IConfigurationFactory

加载所有配置

public void loadAllConfigs (boolean discardExceptions)

加载在类路径和测试用例目录中找到的所有配置。

参数
discardExceptions boolean : 如果任何 ConfigurationException 应该被忽略,则为 true。

投掷
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”指的是已知配置,则将从 XML 创建一个IConfiguration对象,并输出该IConfiguration的帮助。请注意,所有其他 'args' 值都将被忽略(即帮助文本将描述从 XML 加载的Option的当前值,并且不会反映由命令行 args 设置的选项值。

如果 'args' 没有引用已知的IConfiguration ,则将显示通用printHelp(PrintStream)帮助。

参数
args String : 命令行参数

importantOnly boolean : 如果为true ,则打印一个仅列出重要细节的简短帮助

out PrintStream : 将输出转储到的ERROR(/PrintStream)

受保护的方法

getBundledConfigStream

protected InputStream getBundledConfigStream (String name)

参数
name String

退货
InputStream

获取配置前缀

protected String getConfigPrefix ()

返回类路径上配置 xml 文件的路径前缀

暴露所以单元测试可以模拟。

退货
String带有尾随 / 的String路径

获取配置流

protected BufferedInputStream getConfigStream (String name)

为给定的配置名称加载 InputStream

参数
name String : 要加载的配置名称

退货
BufferedInputStream用于读取配置内容的ERROR(/BufferedInputStream)

投掷
ConfigurationException如果找不到配置

获取配置定义

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

检索给定名称的ConfigurationDef

参数
name String : 要加载的内置配置的名称或要加载的配置文件的文件路径

isGlobal boolean

templateMap

退货
ConfigurationDef ConfigurationDef

投掷
ConfigurationException如果加载配置时发生错误

获取地图配置

protected  getMapConfig ()

暴露用于测试。返回地图的副本。

退货

isDirectConfiguration

protected boolean isDirectConfiguration (String configName)

参数
configName String

退货
boolean

重新排序参数

protected String[] reorderArgs (String[] args)

重新排序 args 以便 template:map args 全部移到前面。

参数
args String

退货
String[]

解决远程文件

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

参数
configURI URI

destDir URI

退货
IRemoteFileResolver.ResolvedFile

投掷
BuildRetrievalError