实现PropertyResolver

Last updated: ... / Reads: 125009 Edit

Spring的注入分为@Autowired@Value两种。对于@Autowired,涉及到Bean的依赖,而对于@Value,则仅仅是将对应的配置注入,不涉及Bean的依赖,相对比较简单。为了注入配置,我们用PropertyResolver保存所有配置项,对外提供查询功能。

本节我们来实现PropertyResolver,它支持3种查询方式:

  1. 按配置的key查询,例如:getProperty("app.title");

  2. ${abc.xyz}形式的查询,例如,getProperty("${app.title}"),常用于@Value("${app.title}")注入;

  3. 带默认值的,以${abc.xyz:defaultValue}形式的查询,例如,getProperty("${app.title:Summer}"),常用于@Value("${app.title:Summer}")注入。

Java本身提供了按key-value查询的Properties,我们先传入Properties,内部按key-value存储:

public class PropertyResolver {

    Map<String, String> properties = new HashMap<>();

    public PropertyResolver(Properties props) {
        // 存入环境变量:
        this.properties.putAll(System.getenv());
        // 存入Properties:
        Set<String> names = props.stringPropertyNames();
        for (String name : names) {
            this.properties.put(name, props.getProperty(name));
        }
    }
}

这样,我们在PropertyResolver内部,通过一个Map<String, String>存储了所有的配置项,包括环境变量。对于按key查询的功能,我们可以简单实现如下:

@Nullable
public String getProperty(String key) {
    return this.properties.get(key);
}

下一步,我们准备解析${abc.xyz:defaultValue}这样的key,先定义一个PropertyExpr,把解析后的key和defaultValue存储起来:

record PropertyExpr(String key, String defaultValue) {
}

然后按${...}解析:

PropertyExpr parsePropertyExpr(String key) {
    if (key.startsWith("${") && key.endsWith("}")) {
        // 是否存在defaultValue?
        int n = key.indexOf(':');
        if (n == (-1)) {
            // 没有defaultValue: ${key}
            String k = key.substring(2, key.length() - 1);
            return new PropertyExpr(k, null);
        } else {
            // 有defaultValue: ${key:default}
            String k = key.substring(2, n);
            return new PropertyExpr(k, key.substring(n + 1, key.length() - 1));
        }
    }
    return null;
}

我们把getProperty()改造一下,即可实现查询${abc.xyz:defaultValue}

@Nullable
public String getProperty(String key) {
    // 解析${abc.xyz:defaultValue}:
    PropertyExpr keyExpr = parsePropertyExpr(key);
    if (keyExpr != null) {
        if (keyExpr.defaultValue() != null) {
            // 带默认值查询:
            return getProperty(keyExpr.key(), keyExpr.defaultValue());
        } else {
            // 不带默认值查询:
            return getRequiredProperty(keyExpr.key());
        }
    }
    // 普通key查询:
    String value = this.properties.get(key);
    if (value != null) {
        return parseValue(value);
    }
    return value;
}

每次查询到value后,我们递归调用parseValue(),这样就可以支持嵌套的key,例如:

${app.title:${APP_NAME:Summer}}

这样可以先查询app.title,没有找到就再查询APP_NAME,还没有找到就返回默认值Summer

注意到Spring的${...}表达式实际上可以做到组合,例如:

jdbc.url=jdbc:mysql//${DB_HOST:localhost}:${DB_PORT:3306}/${DB_NAME}

而我们实现的${...}表达式只能嵌套,不能组合,因为要实现Spring的表达式,需要编写一个完整的能解析表达式的复杂功能,而不能仅仅依靠判断${开头、}结尾。由于解析表达式的功能过于复杂,因此我们决定不予支持。

Spring还支持更复杂的#{...}表达式,它可以引用Bean、调用方法、计算等:

#{appBean.version() + 1}

为此Spring专门提供了一个spring-expression库来支持这种更复杂的功能。按照一切从简的原则,我们不支持#{...}表达式。

实现类型转换

除了String类型外,@Value注入时,还允许booleanintLong等基本类型和包装类型。此外,Spring还支持DateDuration等类型的注入。我们既要实现类型转换,又不能写死,否则,将来支持新的类型时就要改代码。

我们先写类型转换的入口查询:

@Nullable
public <T> T getProperty(String key, Class<T> targetType) {
    String value = getProperty(key);
    if (value == null) {
        return null;
    }
    // 转换为指定类型:
    return convert(targetType, value);
}

再考虑如何实现convert()方法。对于类型转换,实际上是从String转换为指定类型,因此,用函数式接口Function<String, Object>就很合适:

public class PropertyResolver {
    // 存储Class -> Function:
    Map<Class<?>, Function<String, Object>> converters = new HashMap<>();

    // 转换到指定Class类型:
    <T> T convert(Class<?> clazz, String value) {
        Function<String, Object> fn = this.converters.get(clazz);
        if (fn == null) {
            throw new IllegalArgumentException("Unsupported value type: " + clazz.getName());
        }
        return (T) fn.apply(value);
    }
}

这样我们就已经实现了类型转换,下一步是把各种要转换的类型放到Map里。在构造方法中,我们放入常用的基本类型转换器:

public PropertyResolver(Properties props) {
    ...
    // String类型:
    converters.put(String.class, s -> s);
    // boolean类型:
    converters.put(boolean.class, s -> Boolean.parseBoolean(s));
    converters.put(Boolean.class, s -> Boolean.valueOf(s));
    // int类型:
    converters.put(int.class, s -> Integer.parseInt(s));
    converters.put(Integer.class, s -> Integer.valueOf(s));
    // 其他基本类型...
    // Date/Time类型:
    converters.put(LocalDate.class, s -> LocalDate.parse(s));
    converters.put(LocalTime.class, s -> LocalTime.parse(s));
    converters.put(LocalDateTime.class, s -> LocalDateTime.parse(s));
    converters.put(ZonedDateTime.class, s -> ZonedDateTime.parse(s));
    converters.put(Duration.class, s -> Duration.parse(s));
    converters.put(ZoneId.class, s -> ZoneId.of(s));
}

如果再加一个registerConverter()接口,我们就可以对外提供扩展,让用户自己编写自己定制的Converter,这样一来,我们的PropertyResolver就准备就绪,读取配置的初始化代码如下:

// Java标准库读取properties文件:
Properties props = new Properties();
props.load(fileInput); // 文件输入流
// 构造PropertyResolver:
PropertyResolver pr = new PropertyResolver(props);
// 后续代码调用...
// pr.getProperty("${app.version:1}", int.class)

使用YAML配置

Spring Framework并不支持YAML配置,但Spring Boot支持。因为YAML配置比.properties要方便,所以我们把对YAML的支持也集成进来。

首先引入依赖org.yaml:snakeyaml:2.0,然后我们写一个YamlUtils,通过loadYamlAsPlainMap()方法读取一个YAML文件,并返回Map

public class YamlUtils {
    public static Map<String, Object> loadYamlAsPlainMap(String path) {
        return ...
    }
}

我们把YAML格式:

app:
  title: Summer Framework
  version: ${VER:1.0}

读取为Map,其中,每个key都是完整路径,相当于把它变为.properties格式:

app.title=Summer Framework
app.version=${VER:1.0}

这样我们无需改动PropertyResolver的代码,使用YAML时,可以按如下方式读取配置:

Map<String, Object> configs = YamlUtils.loadYamlAsPlainMap("/application.yml");
Properties props = new Properties();
props.putAll(config);
PropertyResolver pr = new PropertyResolver(props);

读取YAML的代码比较简单,注意要点如下:

  1. SnakeYaml默认读出的结构是树形结构,需要“拍平”成abc.xyz格式的key;
  2. SnakeYaml默认会自动转换intboolean等value,需要禁用自动转换,把所有value均按String类型返回。

参考源码

可以从GitHubGitee下载源码。

GitHub


Comments

Make a comment