Package org.robolectric.plugins

Class LazyApplicationConfigurer

java.lang.Object

org.robolectric.plugins.LazyApplicationConfigurer

All Implemented Interfaces:

Configurer<LazyApplication.LazyLoad>

@AutoService(Configurer.class)
public class LazyApplicationConfigurer
extends Object
implements Configurer<LazyApplication.LazyLoad>

A Configurer that reads the LazyApplication to dictate whether Robolectric should lazily instantiate the Application under test (as well as the test Instrumentation).

Constructor Summary

Constructors

Constructor	Description
LazyApplicationConfigurer()

Method Summary

Modifier and Type	Method	Description
LazyApplication.LazyLoad	defaultConfig()	Returns the default configuration for tests that do not specify a configuration of this type.
Class<LazyApplication.LazyLoad>	getConfigClass()	Retrieve the class type for this Configurer
LazyApplication.LazyLoad	getConfigFor(Class<?> testClass)	Returns the configuration for the given class.
LazyApplication.LazyLoad	getConfigFor(Method method)	Returns the configuration for the given method.
LazyApplication.LazyLoad	getConfigFor(String packageName)	Returns the configuration for a given package.
LazyApplication.LazyLoad	merge(LazyApplication.LazyLoad parentConfig, LazyApplication.LazyLoad childConfig)	"Merges" two configurations together.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

LazyApplicationConfigurer

public LazyApplicationConfigurer()

Method Details

getConfigClass

public Class<LazyApplication.LazyLoad> getConfigClass()

Description copied from interface: Configurer

Retrieve the class type for this Configurer

Specified by:

getConfigClass in interface Configurer<LazyApplication.LazyLoad>

defaultConfig

@Nonnull public LazyApplication.LazyLoad defaultConfig()

Description copied from interface: Configurer

Returns the default configuration for tests that do not specify a configuration of this type.

Specified by:

defaultConfig in interface Configurer<LazyApplication.LazyLoad>

getConfigFor

@Nonnull public LazyApplication.LazyLoad getConfigFor(@Nonnull String packageName)

Description copied from interface: Configurer

Returns the configuration for a given package.

This method will be called once for package in the hierarchy leading to the test class being configured. For example, for com.example.FooTest, this method will be called three times with "com.example", "@com", and "" (representing the top level package).

Specified by:

getConfigFor in interface Configurer<LazyApplication.LazyLoad>

Parameters:

packageName - the name of the package, or the empty string representing the top level unnamed package

Returns:

a configuration object, or null if the given properties has no relevant data for this configuration

getConfigFor

public LazyApplication.LazyLoad getConfigFor(@Nonnull Class<?> testClass)

Description copied from interface: Configurer

Returns the configuration for the given class.

This method will be called for each class in the test's class inheritance hierarchy.

Specified by:

getConfigFor in interface Configurer<LazyApplication.LazyLoad>

Returns:

a configuration object, or null if the given class has no relevant data for this configuration

getConfigFor

public LazyApplication.LazyLoad getConfigFor(@Nonnull Method method)

Description copied from interface: Configurer

Returns the configuration for the given method.

Specified by:

getConfigFor in interface Configurer<LazyApplication.LazyLoad>

Returns:

a configuration object, or null if the given method has no relevant data for this configuration

merge

@Nonnull public LazyApplication.LazyLoad merge(@Nonnull LazyApplication.LazyLoad parentConfig, @Nonnull LazyApplication.LazyLoad childConfig)

"Merges" two configurations together. Child configuration always overrides the parent

Specified by:

merge in interface Configurer<LazyApplication.LazyLoad>

Parameters:

parentConfig - a less specific configuration object

childConfig - a more specific configuration object

Returns:

the new configuration with merged parent and child data.