ConfigurationFactory

public class ConfigurationFactory
extends Object implements IConfigurationFactory

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

IConfiguration を作成するためのファクトリ。

概要

ネストされたクラス

class ConfigurationFactory.ConfigLoader

含まれる構成を 1 つから追跡する 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 のヘルプ出力を出力します。

'args' の場合既知の構成を参照すると、IConfiguration オブジェクトが作成されます。 その IConfiguration のヘルプが出力されます。

保護されたメソッド

InputStream getBundledConfigStream(String name)
String getConfigPrefix()

クラスパス上の構成 XML ファイルのパス接頭辞を返す

単体テストがモックできるように公開されています。

BufferedInputStream getConfigStream(String name)

指定された構成名の InputStream を読み込みます

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 フィールドには、 args の値が入力されています。
例外
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 フィールドには、 args の値が入力されています。
例外
ConfigurationException

createConfigurationFromArgs

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 フィールド 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: 構成を検索するサブディレクトリの名前。null の場合、 getConfigList() と同じ動作をします。
loadFromEnv boolean: 環境変数に構成を読み込む場合は true。
戻り値

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 1 つ以上の設定の読み込みに失敗した場合

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」に注意 の値は無視されます（つまり、ヘルプテキストには Option の現在の値が説明されます） XML からロードされたものとして解釈され、コマンドライン引数で設定されたオプションの値は反映されません。

'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 ()

クラスパス上の構成 XML ファイルのパス接頭辞を返す

単体テストがモックできるように公開されています。

戻り値
String 末尾に / が付いた String パス

getConfigStream

protected BufferedInputStream getConfigStream (String name)

指定された構成名の InputStream を読み込みます

パラメータ
name String: 読み込む構成名
戻り値
BufferedInputStream 構成の内容を読み取るための ERROR(/BufferedInputStream)
例外
ConfigurationException config が見つからなかった場合

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