程序包 cn.taketoday.core.env

接口 ConfigurablePropertyResolver

所有超级接口:

PropertyResolver

所有已知子接口:

ConfigurableEnvironment

所有已知实现类:

AbstractEnvironment, AbstractPropertyResolver, MapPropertyResolver, PropertiesPropertyResolver, PropertySourcesPropertyResolver, StandardEnvironment, TypedPropertyResolver

public interface ConfigurablePropertyResolver
extends PropertyResolver

Configuration interface to be implemented by most if not all PropertyResolver types. Provides facilities for accessing and customizing the ConversionService used when converting property values from one type to another.

从以下版本开始:

4.0

作者:

Chris Beams, Harry Yang

方法概要

修饰符和类型	方法	说明
void	addRequiredProperties(String... requiredProperties)	Specify which properties must be present, to be verified by validateRequiredProperties().
ConfigurableConversionService	getConversionService()	Return the ConfigurableConversionService used when performing type conversions on properties.
void	setConversionService(ConfigurableConversionService conversionService)	Set the ConfigurableConversionService to be used when performing type conversions on properties.
void	setEscapeCharacter(Character escapeCharacter)	Specify the escape character to use to ignore placeholder prefix or value separator, or null if no escaping should take place.
void	setIgnoreUnresolvableNestedPlaceholders(boolean ignoreUnresolvableNestedPlaceholders)	Set whether to throw an exception when encountering an unresolvable placeholder nested within the value of a given property.
void	setPlaceholderPrefix(String placeholderPrefix)	Set the prefix that placeholders replaced by this resolver must begin with.
void	setPlaceholderSuffix(String placeholderSuffix)	Set the suffix that placeholders replaced by this resolver must end with.
void	setRequiredProperties(String... requiredProperties)	Specify which properties must be present, to be verified by validateRequiredProperties().
void	setValueSeparator(String valueSeparator)	Specify the separating character between the placeholders replaced by this resolver and their associated default value, or null if no such special character should be processed as a value separator.
void	validateRequiredProperties()	Validate that each of the properties specified by setRequiredProperties(java.lang.String...) is present and resolves to a non-null value.

从接口继承的方法 cn.taketoday.core.env.PropertyResolver

containsProperty, getFlag, getFlag, getProperty, getProperty, getProperty, getProperty, getRequiredProperty, getRequiredProperty, resolvePlaceholders, resolveRequiredPlaceholders

方法详细资料

getConversionService

ConfigurableConversionService getConversionService()

Return the ConfigurableConversionService used when performing type conversions on properties.

The configurable nature of the returned conversion service allows for the convenient addition and removal of individual Converter instances:

 ConfigurableConversionService cs = env.getConversionService();
 cs.addConverter(new FooConverter());
 

另请参阅:

• PropertyResolver.getProperty(String, Class)
• ConverterRegistry.addConverter(cn.taketoday.core.conversion.Converter<?, ?>)

setConversionService

void setConversionService(ConfigurableConversionService conversionService)

Set the ConfigurableConversionService to be used when performing type conversions on properties.

Note: as an alternative to fully replacing the ConversionService, consider adding or removing individual Converter instances by drilling into getConversionService() and calling methods such as #addConverter.

另请参阅:

• PropertyResolver.getProperty(String, Class)
• getConversionService()
• ConverterRegistry.addConverter(cn.taketoday.core.conversion.Converter<?, ?>)

setPlaceholderPrefix

void setPlaceholderPrefix(String placeholderPrefix)

Set the prefix that placeholders replaced by this resolver must begin with.

setPlaceholderSuffix

void setPlaceholderSuffix(String placeholderSuffix)

Set the suffix that placeholders replaced by this resolver must end with.

setValueSeparator

void setValueSeparator(@Nullable
 String valueSeparator)

Specify the separating character between the placeholders replaced by this resolver and their associated default value, or null if no such special character should be processed as a value separator.

setEscapeCharacter

void setEscapeCharacter(@Nullable
 Character escapeCharacter)

Specify the escape character to use to ignore placeholder prefix or value separator, or null if no escaping should take place.

setIgnoreUnresolvableNestedPlaceholders

void setIgnoreUnresolvableNestedPlaceholders(boolean ignoreUnresolvableNestedPlaceholders)

Set whether to throw an exception when encountering an unresolvable placeholder nested within the value of a given property. A false value indicates strict resolution, i.e. that an exception will be thrown. A true value indicates that unresolvable nested placeholders should be passed through in their unresolved ${...} form.

Implementations of PropertyResolver.getProperty(String) and its variants must inspect the value set here to determine correct behavior when property values contain unresolvable placeholders.

setRequiredProperties

void setRequiredProperties(String... requiredProperties)

Specify which properties must be present, to be verified by validateRequiredProperties().

addRequiredProperties

void addRequiredProperties(String... requiredProperties)

Specify which properties must be present, to be verified by validateRequiredProperties().

validateRequiredProperties

void validateRequiredProperties()
                         throws MissingRequiredPropertiesException

Validate that each of the properties specified by setRequiredProperties(java.lang.String...) is present and resolves to a non-null value.

抛出:

MissingRequiredPropertiesException - if any of the required properties are not resolvable.