如何使用Guice从Properties文件注入字符串列表类型配置

核心实现思路是利用Guice原生的TypeConverter扩展机制，全局注册字符串到集合的转换规则，仅需一次配置即可覆盖所有同类配置的注入，无需为每个集合字段单独编写绑定逻辑。

步骤1：实现字符串到List的转换器 #

import com.google.inject.TypeLiteral;
import com.google.inject.spi.TypeConverter;
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;

public class StringToListConverter implements TypeConverter {
    @Override
    public Object convert(String value, TypeLiteral<?> toType) {
        // 空值/空白字符串直接返回空集合
        if (value == null || value.isBlank()) {
            return List.of();
        }
        // 按逗号拆分并清除每个元素的前后空白
        return Arrays.stream(value.split(","))
                .map(String::trim)
                .filter(item -> !item.isBlank())
                .collect(Collectors.toList());
    }
}

步骤2：在Guice Module中注册转换器 #

修改你现有Module的configure方法，添加转换器注册逻辑即可：

@Override
protected void configure() {
    try {
        // 注册类型转换器，匹配所有List<String>类型的注入点
        binder().convertToTypes(
            TypeLiteral.get(List.class),
            new StringToListConverter()
        );

        Properties properties = getProperties();
        Names.bindProperties(binder(), properties);
        binder().bind(MyApi.class);
     } catch (Exception e) {
        log.error(e.getMessage());
        throw new RuntimeException(e);
    }
}

完成以上两步后，你原有业务代码中的注入逻辑无需任何修改，@Inject @Named("mail.to") public List<String> mailTo即可正常注入拆分后的集合。

可选：缩小转换器生效范围 #

如果担心全局转换器会和其他List类型的绑定冲突，可以调整匹配规则，仅让转换器作用于带@Named注解的注入点：

import static com.google.inject.matcher.Matchers.annotatedWith;
import static com.google.inject.matcher.Matchers.only;

// 注册时修改为
binder().convertToTypes(
    only(TypeLiteral.get(List.class)),
    annotatedWith(Named.class),
    new StringToListConverter()
);

如果需要支持Set<String>、List<Integer>等其他集合类型，只需扩展转换器的类型判断逻辑，根据toType的泛型参数做对应转换即可。

内容的提问来源于stack exchange，提问作者pbuchheit