程序包 cn.taketoday.test.context.support

类 TestPropertySourceUtils

java.lang.Object

cn.taketoday.test.context.support.TestPropertySourceUtils

public abstract class TestPropertySourceUtils
extends Object

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

Primarily intended for use within the framework.

从以下版本开始:

4.0

作者:

Sam Brannen, Anatoliy Korovin, Phillip Webb, Harry Yang

另请参阅:

• TestPropertySource

嵌套类概要

嵌套类

修饰符和类型	类	说明
private static class	TestPropertySourceUtils.SequencedProperties	Extension of Properties that mimics a SequencedMap by tracking all added properties with a String key in a LinkedHashMap.

字段概要

字段

修饰符和类型	字段	说明
private static final cn.taketoday.core.io.PropertySourceFactory	defaultPropertySourceFactory
static final String	INLINED_PROPERTIES_PROPERTY_SOURCE_NAME	The name of the MapPropertySource created from inlined properties.
private static final cn.taketoday.logging.Logger	logger
private static Comparator<cn.taketoday.core.annotation.MergedAnnotation<? extends Annotation>>	reversedMetaDistance

构造器概要

构造器

构造器	说明
TestPropertySourceUtils()

方法概要

修饰符和类型	方法	说明
static void	addInlinedPropertiesToEnvironment(cn.taketoday.context.ConfigurableApplicationContext context, String... inlinedProperties)	Add the given inlined properties to the Environment of the supplied context.
static void	addInlinedPropertiesToEnvironment(cn.taketoday.core.env.ConfigurableEnvironment environment, String... inlinedProperties)	Add the given inlined properties (in the form of key-value pairs) to the supplied environment.
static void	addPropertiesFilesToEnvironment(cn.taketoday.context.ConfigurableApplicationContext context, String... locations)	Add the Properties files from the given resource locations to the Environment of the supplied context.
static void	addPropertiesFilesToEnvironment(cn.taketoday.core.env.ConfigurableEnvironment environment, cn.taketoday.core.io.ResourceLoader resourceLoader, String... locations)	Add the Properties files from the given resource locations to the supplied environment.
static void	addPropertySourcesToEnvironment(cn.taketoday.context.ConfigurableApplicationContext context, List<cn.taketoday.core.io.PropertySourceDescriptor> descriptors)	Add property sources for the given descriptors to the Environment of the supplied context.
static void	addPropertySourcesToEnvironment(cn.taketoday.core.env.ConfigurableEnvironment environment, cn.taketoday.core.io.ResourceLoader resourceLoader, List<cn.taketoday.core.io.PropertySourceDescriptor> descriptors)	Add property sources for the given descriptors to the supplied environment.
(专用程序包) static MergedTestPropertySources	buildMergedTestPropertySources(Class<?> testClass)
static Map<String,Object>	convertInlinedPropertiesToMap(String... inlinedProperties)	Convert the supplied inlined properties (in the form of key-value pairs) into a map keyed by property name.
private static boolean	duplicationDetected(TestPropertySourceAttributes currentAttributes, TestPropertySourceAttributes previousAttributes)
private static <T extends Annotation> List<List<cn.taketoday.core.annotation.MergedAnnotation<T>>>	findRepeatableAnnotations(Class<?> clazz, Class<T> annotationType)
private static <T extends Annotation> void	findRepeatableAnnotations(Class<?> clazz, Class<T> annotationType, List<List<cn.taketoday.core.annotation.MergedAnnotation<T>>> listOfLists, int[] aggregateIndex)
private static List<cn.taketoday.core.io.PropertySourceDescriptor>	mergeLocations(List<TestPropertySourceAttributes> attributesList)
private static String[]	mergeProperties(List<TestPropertySourceAttributes> attributesList)
private static TestPropertySourceAttributes	mergeTestPropertySourceAttributes(List<TestPropertySourceAttributes> aggregatedAttributesList)

从类继承的方法 java.lang.Object

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

字段详细资料

INLINED_PROPERTIES_PROPERTY_SOURCE_NAME

public static final String INLINED_PROPERTIES_PROPERTY_SOURCE_NAME

The name of the MapPropertySource created from inlined properties.

另请参阅:

• addInlinedPropertiesToEnvironment(cn.taketoday.context.ConfigurableApplicationContext, java.lang.String...)
• 常量字段值

defaultPropertySourceFactory

private static final cn.taketoday.core.io.PropertySourceFactory defaultPropertySourceFactory

reversedMetaDistance

private static Comparator<cn.taketoday.core.annotation.MergedAnnotation<? extends Annotation>> reversedMetaDistance

logger

private static final cn.taketoday.logging.Logger logger

构造器详细资料

TestPropertySourceUtils

public TestPropertySourceUtils()

方法详细资料

buildMergedTestPropertySources

static MergedTestPropertySources buildMergedTestPropertySources(Class<?> testClass)

mergeTestPropertySourceAttributes

@Nullable
private static TestPropertySourceAttributes mergeTestPropertySourceAttributes(List<TestPropertySourceAttributes> aggregatedAttributesList)

duplicationDetected

private static boolean duplicationDetected(TestPropertySourceAttributes currentAttributes,
 @Nullable
 TestPropertySourceAttributes previousAttributes)

mergeLocations

private static List<cn.taketoday.core.io.PropertySourceDescriptor> mergeLocations(List<TestPropertySourceAttributes> attributesList)

mergeProperties

private static String[] mergeProperties(List<TestPropertySourceAttributes> attributesList)

addPropertiesFilesToEnvironment

public static void addPropertiesFilesToEnvironment(cn.taketoday.context.ConfigurableApplicationContext context,
 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...).

参数:

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

抛出:

IllegalStateException - if an error occurs while processing a properties file

另请参阅:

• ResourcePropertySource
• TestPropertySource.locations()
• addPropertiesFilesToEnvironment(ConfigurableEnvironment, ResourceLoader, String...)
• addPropertySourcesToEnvironment(ConfigurableApplicationContext, List)

addPropertiesFilesToEnvironment

public static void addPropertiesFilesToEnvironment(cn.taketoday.core.env.ConfigurableEnvironment environment,
 cn.taketoday.core.io.ResourceLoader resourceLoader,
 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 the highest precedence.

参数:

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

抛出:

IllegalStateException - if an error occurs while processing a properties file

另请参阅:

• ResourcePropertySource
• TestPropertySource.locations()
• addPropertiesFilesToEnvironment(ConfigurableApplicationContext, String...)
• addPropertySourcesToEnvironment(ConfigurableApplicationContext, List)

addPropertySourcesToEnvironment

public static void addPropertySourcesToEnvironment(cn.taketoday.context.ConfigurableApplicationContext context,
 List<cn.taketoday.core.io.PropertySourceDescriptor> descriptors)

Add property sources for the given descriptors to the Environment of the supplied context.

This method delegates to addPropertySourcesToEnvironment(ConfigurableEnvironment, ResourceLoader, List).

参数:

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

descriptors - the property source descriptors to process; potentially empty but never null

抛出:

IllegalStateException - if an error occurs while processing the descriptors and registering property sources

另请参阅:

• TestPropertySource.locations()
• TestPropertySource.encoding()
• TestPropertySource.factory()
• PropertySourceFactory
• addPropertySourcesToEnvironment(ConfigurableEnvironment, ResourceLoader, List)

addPropertySourcesToEnvironment

public static void addPropertySourcesToEnvironment(cn.taketoday.core.env.ConfigurableEnvironment environment,
 cn.taketoday.core.io.ResourceLoader resourceLoader,
 List<cn.taketoday.core.io.PropertySourceDescriptor> descriptors)

Add property sources for the given descriptors to the supplied environment.

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

A PatternResourceLoader will be used to resolve resource location patterns into multiple resource locations.

Each PropertySource will be created via the configured PropertySourceFactory (or the DefaultPropertySourceFactory if no factory is configured) and added to the PropertySources of the environment with the highest precedence.

参数:

environment - the environment to update; never null

resourceLoader - the ResourceLoader to use to load resources; never null

descriptors - the property source descriptors to process; potentially empty but never null

抛出:

IllegalStateException - if an error occurs while processing the descriptors and registering property sources

另请参阅:

• TestPropertySource.locations()
• TestPropertySource.encoding()
• TestPropertySource.factory()
• PropertySourceFactory

addInlinedPropertiesToEnvironment

public static void addInlinedPropertiesToEnvironment(cn.taketoday.context.ConfigurableApplicationContext context,
 String... inlinedProperties)

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

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

参数:

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

另请参阅:

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

addInlinedPropertiesToEnvironment

public static void addInlinedPropertiesToEnvironment(cn.taketoday.core.env.ConfigurableEnvironment environment,
 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...).

参数:

environment - the environment to update; never null

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

另请参阅:

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

convertInlinedPropertiesToMap

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

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

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

The ordering of property names will be preserved in the returned map, analogous to the order in which the key-value pairs are supplied to this method. This also applies if a single string contains multiple key-value pairs separated by newlines — for example, when supplied by a user via a text block.

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

参数:

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

返回:

a new, ordered map containing the converted properties

抛出:

IllegalStateException - if a given key-value pair cannot be parsed

另请参阅:

• addInlinedPropertiesToEnvironment(ConfigurableEnvironment, String[])

findRepeatableAnnotations

private static <T extends Annotation>
List<List<cn.taketoday.core.annotation.MergedAnnotation<T>>> findRepeatableAnnotations(Class<?> clazz,
 Class<T> annotationType)

findRepeatableAnnotations

private static <T extends Annotation> void findRepeatableAnnotations(Class<?> clazz,
 Class<T> annotationType,
 List<List<cn.taketoday.core.annotation.MergedAnnotation<T>>> listOfLists,
 int[] aggregateIndex)