Starting March 27, 2025, we recommend using android-latest-release instead of aosp-main to build and contribute to AOSP. For more information, see Changes to AOSP.

ConfigurationFactory.ExceptionLoader

protected class ConfigurationFactory.ExceptionLoader
extends ConfigurationFactory.ConfigLoader

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

Summary

Public constructors
`ExceptionLoader(boolean isGlobal)`

Public methods
`ConfigurationDef`	`getConfigurationDef(String name, templateMap)`
`boolean`	`isBundledConfig(String name)` Returns true if it is a config file found inside the classpath.
`void`	`loadConfiguration(String name, ConfigurationDef def, String deviceTagObject, templateMap, templateSeen)`
`void`	`loadIncludedConfiguration(ConfigurationDef def, String parentName, String name, String deviceTagObject, templateMap, templateSeen)` Configs that are bundled inside the tradefed.jar can only include other configs also bundled inside tradefed.jar.

Protected methods
`String`	`findConfigName(String name, String parentName)` Find config's name based on its name and its parent name.
`boolean`	`isTrackableConfig(String name)` Should track the config's life cycle or not.
`void`	`trackConfig(String name, ConfigurationDef def)` Track config for dynamic loading.

Public constructors

ExceptionLoader

public ExceptionLoader (boolean isGlobal)

Parameters
`isGlobal`	`boolean`

Public methods

getConfigurationDef

public ConfigurationDef getConfigurationDef (String name, 
                 templateMap)

Parameters
`name`	`String`
`templateMap`

Returns
`ConfigurationDef`

Throws
`ConfigurationException`

isBundledConfig

public boolean isBundledConfig (String name)

Returns true if it is a config file found inside the classpath.

Parameters
`name`	`String`

Returns
`boolean`

loadConfiguration

public void loadConfiguration (String name, 
                ConfigurationDef def, 
                String deviceTagObject, 
                 templateMap, 
                 templateSeen)

Parameters
`name`	`String`
`def`	`ConfigurationDef`
`deviceTagObject`	`String`
`templateMap`
`templateSeen`

Throws
`ConfigurationException`

loadIncludedConfiguration

public void loadIncludedConfiguration (ConfigurationDef def, 
                String parentName, 
                String name, 
                String deviceTagObject, 
                 templateMap, 
                 templateSeen)

Configs that are bundled inside the tradefed.jar can only include other configs also bundled inside tradefed.jar. However, local (external) configs can include both local (external) and bundled configs.

Parameters
`def`	`ConfigurationDef`
`parentName`	`String`
`name`	`String`
`deviceTagObject`	`String`
`templateMap`
`templateSeen`

Throws
`ConfigurationException`

Protected methods

findConfigName

protected String findConfigName (String name, 
                String parentName)

Find config's name based on its name and its parent name. This is used to properly handle bundle configs and local configs.

Parameters
`name`	`String`: config's name
`parentName`	`String`: config's parent's name.

Returns
`String`	the config's full name.

isTrackableConfig

protected boolean isTrackableConfig (String name)

Should track the config's life cycle or not.

Parameters
`name`	`String`: config's name

Returns
`boolean`	`true` if the config is trackable, otherwise `false`.

trackConfig

protected void trackConfig (String name, 
                ConfigurationDef def)

Track config for dynamic loading. Right now only local files are supported.

Parameters
`name`	`String`: config's name
`def`	`ConfigurationDef`: config's def.