org.springframework.test.context.support

Class TestPropertySourceUtils

java.lang.Object

org.springframework.test.context.support.TestPropertySourceUtils

public abstract class TestPropertySourceUtils
extends java.lang.Object

Utility methods for working with @TestPropertySource and adding test PropertySources to the Environment.

Primarily intended for use within the framework.

Since:

4.1

Author:

Sam Brannen

See Also:

TestPropertySource

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	INLINED_PROPERTIES_PROPERTY_SOURCE_NAME The name of the MapPropertySource created from inlined properties.

Constructor Summary

Constructors

Constructor and Description
TestPropertySourceUtils()

Method Summary

Modifier and Type	Method and Description
static void	addInlinedPropertiesToEnvironment(ConfigurableApplicationContext context, java.lang.String... inlinedProperties) Add the given inlined properties to the Environment of the supplied context.
static void	addInlinedPropertiesToEnvironment(ConfigurableEnvironment environment, java.lang.String... inlinedProperties) Add the given inlined properties (in the form of key-value pairs) to the supplied environment.
static void	addPropertiesFilesToEnvironment(ConfigurableApplicationContext context, java.lang.String... locations) Add the Properties files from the given resource locations to the Environment of the supplied context.
static void	addPropertiesFilesToEnvironment(ConfigurableEnvironment environment, ResourceLoader resourceLoader, java.lang.String... locations) Add the Properties files from the given resource locations to the supplied environment.
static java.util.Map<java.lang.String,java.lang.Object>	convertInlinedPropertiesToMap(java.lang.String... inlinedProperties) Convert the supplied inlined properties (in the form of key-value pairs) into a map keyed by property name, preserving the ordering of property names in the returned map.

Methods inherited from class java.lang.Object

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

Field Detail

INLINED_PROPERTIES_PROPERTY_SOURCE_NAME

public static final java.lang.String INLINED_PROPERTIES_PROPERTY_SOURCE_NAME

The name of the MapPropertySource created from inlined properties.

Since:

4.1.5

See Also:

addInlinedPropertiesToEnvironment(org.springframework.context.ConfigurableApplicationContext, java.lang.String...), Constant Field Values

Constructor Detail

TestPropertySourceUtils

public TestPropertySourceUtils()

Method Detail

addPropertiesFilesToEnvironment

public static void addPropertiesFilesToEnvironment(ConfigurableApplicationContext context,
                                                   java.lang.String... locations)

Add the Properties files from the given resource locations to the Environment of the supplied context.

This method simply delegates to addPropertiesFilesToEnvironment(ConfigurableEnvironment, ResourceLoader, String...).

Parameters:

context - the application context whose environment should be updated; never null

locations - the resource locations of Properties files to add to the environment; potentially empty but never null

Throws:

java.lang.IllegalStateException - if an error occurs while processing a properties file

Since:

4.1.5

See Also:

ResourcePropertySource, TestPropertySource.locations(), addPropertiesFilesToEnvironment(ConfigurableEnvironment, ResourceLoader, String...)

addPropertiesFilesToEnvironment

public static void addPropertiesFilesToEnvironment(ConfigurableEnvironment environment,
                                                   ResourceLoader resourceLoader,
                                                   java.lang.String... locations)

Add the Properties files from the given resource locations to the supplied environment.

Property placeholders in resource locations (i.e., ${...}) will be resolved against the Environment.

Each properties file will be converted to a ResourcePropertySource that will be added to the PropertySources of the environment with highest precedence.

Parameters:

environment - the environment to update; never null

resourceLoader - the ResourceLoader to use to load each resource; never null

locations - the resource locations of Properties files to add to the environment; potentially empty but never null

Throws:

java.lang.IllegalStateException - if an error occurs while processing a properties file

Since:

4.3

See Also:

ResourcePropertySource, TestPropertySource.locations(), addPropertiesFilesToEnvironment(ConfigurableApplicationContext, String...)

addInlinedPropertiesToEnvironment

public static void addInlinedPropertiesToEnvironment(ConfigurableApplicationContext context,
                                                     java.lang.String... inlinedProperties)

Add the given inlined properties to the Environment of the supplied context.

This method simply delegates to addInlinedPropertiesToEnvironment(ConfigurableEnvironment, String[]).

Parameters:

context - the application context whose environment should be updated; never null

inlinedProperties - the inlined properties to add to the environment; potentially empty but never null

Since:

4.1.5

See Also:

TestPropertySource.properties(), addInlinedPropertiesToEnvironment(ConfigurableEnvironment, String[])

addInlinedPropertiesToEnvironment

public static void addInlinedPropertiesToEnvironment(ConfigurableEnvironment environment,
                                                     java.lang.String... inlinedProperties)

Add the given inlined properties (in the form of key-value pairs) to the supplied environment.

All key-value pairs will be added to the Environment as a single MapPropertySource with the highest precedence.

For details on the parsing of inlined properties, consult the Javadoc for convertInlinedPropertiesToMap(java.lang.String...).

Parameters:

environment - the environment to update; never null

inlinedProperties - the inlined properties to add to the environment; potentially empty but never null

Since:

4.1.5

See Also:

MapPropertySource, INLINED_PROPERTIES_PROPERTY_SOURCE_NAME, TestPropertySource.properties(), convertInlinedPropertiesToMap(java.lang.String...)

convertInlinedPropertiesToMap

public static java.util.Map<java.lang.String,java.lang.Object> convertInlinedPropertiesToMap(java.lang.String... inlinedProperties)

Convert the supplied inlined properties (in the form of key-value pairs) into a map keyed by property name, preserving the ordering of property names in the returned map.

Parsing of the key-value pairs is achieved by converting all pairs into virtual properties files in memory and delegating to Properties.load(java.io.Reader) to parse each virtual file.

For a full discussion of inlined properties, consult the Javadoc for TestPropertySource.properties().

Parameters:

inlinedProperties - the inlined properties to convert; potentially empty but never null

Returns:

a new, ordered map containing the converted properties

Throws:

java.lang.IllegalStateException - if a given key-value pair cannot be parsed, or if a given inlined property contains multiple key-value pairs

Since:

4.1.5

See Also:

addInlinedPropertiesToEnvironment(ConfigurableEnvironment, String[])