README

/**
 * 配置接口，大多数 {@link PropertyResolver} 类型都应实现此接口。
 * 提供访问和自定义在属性值类型转换时使用的 {@link org.springframework.core.convert.ConversionService ConversionService} 的功能。
 *
 * @author Chris Beams
 * @since 3.1
 */
public interface ConfigurablePropertyResolver extends PropertyResolver {

    /**
     * 返回用于执行属性类型转换时的 {@link ConfigurableConversionService}。
     * 可配置的转换服务允许方便地添加和移除单个 {@code Converter} 实例。
     * 
     * @return 当前使用的转换服务
     */
    ConfigurableConversionService getConversionService();

    /**
     * 设置在执行属性类型转换时使用的 {@link ConfigurableConversionService}。
     * 注意：作为完全替换 ConversionService 的替代方案，考虑通过 getConversionService() 添加或移除单个 {@code Converter} 实例。
     */
    void setConversionService(ConfigurableConversionService conversionService);

    /**
     * 设置该解析器替换的占位符的前缀。
     */
    void setPlaceholderPrefix(String placeholderPrefix);

    /**
     * 设置该解析器替换的占位符的后缀。
     */
    void setPlaceholderSuffix(String placeholderSuffix);

    /**
     * 指定分隔该解析器替换的占位符及其关联默认值的字符。
     * 如果不处理特殊字符作为值分隔符，则为 {@code null}。
     */
    void setValueSeparator(@Nullable String valueSeparator);

    /**
     * 设置当遇到无法解析的嵌套占位符时是否抛出异常。
     * {@code false} 表示严格解析，即会抛出异常。
     * {@code true} 表示未解析的嵌套占位符应以其未解析的 ${...} 形式通过。
     */
    void setIgnoreUnresolvableNestedPlaceholders(boolean ignoreUnresolvableNestedPlaceholders);

    /**
     * 指定必须存在的属性，通过 {@link #validateRequiredProperties()} 方法进行验证。
     */
    void setRequiredProperties(String... requiredProperties);

    /**
     * 验证通过 {@link #setRequiredProperties} 设置的每个属性是否存在并解析为非 {@code null} 值。
     * 如果任何必需的属性无法解析，则抛出 MissingRequiredPropertiesException 异常。
     */
    void validateRequiredProperties() throws MissingRequiredPropertiesException;

}

public class ConfigurablePropertyResolverDemo {

    public static void main(String[] args) {
        // 创建属性源
        Map<String, Object> properties = new HashMap<>();
        properties.put("app.name", "Spring-Reading");
        properties.put("app.version", "1.0.0");

        MapPropertySource propertySource = new MapPropertySource("myPropertySource", properties);
        MutablePropertySources propertySources = new MutablePropertySources();
        propertySources.addLast(propertySource);

        // 创建 ConfigurablePropertyResolver
        PropertySourcesPropertyResolver propertyResolver = new PropertySourcesPropertyResolver(propertySources);

        // 设置和获取转换服务
        ConfigurableConversionService conversionService = new DefaultConversionService();
        propertyResolver.setConversionService(conversionService);

        // 设置占位符前后缀
        propertyResolver.setPlaceholderPrefix("${");
        propertyResolver.setPlaceholderSuffix("}");

        // 设置默认值分隔符
        propertyResolver.setValueSeparator(":");

        // 设置未解析占位符的处理方式
        propertyResolver.setIgnoreUnresolvableNestedPlaceholders(true);

        // 设置并验证必需的属性
        propertyResolver.setRequiredProperties("app.name", "app.version");
        propertyResolver.validateRequiredProperties();

        // 读取属性
        String appName = propertyResolver.getProperty("app.name");
        String appVersion = propertyResolver.getProperty("app.version", String.class, "Unknown Version");
        System.out.println("获取属性 app.name: " + appName);
        System.out.println("获取属性 app.version: " + appVersion);
    }
}

获取属性 app.name: Spring-Reading
获取属性 app.version: 1.0.0