此页面由 Cloud Translation API 翻译。

IConfigurationFactory 类的构造函数

public interface IConfigurationFactory

com.android.tradefed.config.IConfigurationFactory

已知的间接子类

ConfigurationFactory、GCSConfigurationFactory、RetryConfigurationFactory、SandboxConfigurationFactory

ConfigurationFactory	用于创建 `IConfiguration` 的工厂。
GCSConfigurationFactory	`ConfigurationFactory` 会从 Google Cloud Storage 加载配置。
RetryConfigurationFactory	用于处理命令重试的工厂。
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` 对象并输出有关该 `IConfiguration` 的帮助。

公共方法

createConfigurationFromArgs

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

使用命令行参数创建 IConfiguration。

预期格式为“配置 [选项]”，其中 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 是内置配置名称或指向配置 XML 文件的文件路径。

参数
`args`	`String`：命令行参数
`unconsumedArgs`	：一个列表，用于填充与指定配置关联的对象所消耗的电量。如果为 `null`，则实现将抛出如果仍然存在任何未处理的参数，则返回 `ConfigurationException`。
`keyStoreClient`	`IKeyStoreClient`：一个 `IKeyStoreClient`，用于获取 Google Cloud 中的参数。

返回
`IConfiguration`	已加载的 `IConfiguration`。委托对象 `Option` 字段包含已填充了 args 中的值。

抛出
`ConfigurationException`	如果无法加载配置

createGlobalConfigurationFromArgs

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

通过命令行参数创建 IGlobalConfiguration。

预期格式为“配置 [选项]”，其中 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`：要查找其配置的子目录的名称。如果为 null，行为与 `getConfigList()` 相同。
`loadFromEnv`	`boolean`：如果我们应在环境变量中加载配置，则为 true。

返回

打印帮助

public abstract void printHelp (PrintStream out)

输出此工厂的帮助输出。

输出一般帮助信息，并列出所有可用配置。

参数
`out`	`PrintStream`：要将输出转储到的 `ERROR(/PrintStream)`

printHelpForConfig

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

输出命令行参数中指定的 IConfiguration 的帮助输出。

如果为“args”指向已知配置，系统会创建一个 IConfiguration 对象并输出有关该 IConfiguration 的帮助。请注意所有其他“args” 值将被忽略（即帮助文本将描述 Option 的当前值从 XML 加载，不会反映命令行参数设置的选项值。

如果为“args”未引用已知的 IConfiguration，即通用系统将显示printHelp(PrintStream)帮助。

参数
`args`	`String`：命令行参数
`importantOnly`	`boolean`：如果为 `true`，则输出简略帮助内容，其中仅列出重要细节
`out`	`PrintStream`：要将输出转储到的 `ERROR(/PrintStream)`