spring-configuration-metadata.json文件是做啥的？

2022-05-28

翟永超

Spring Boot

DD的博客全面升级，阅读体验更佳（尤其是系列教程），后续不再通过这里发布新文章，而是改到 www.didispace.com 发布啦，奔走相告！点击直达～

在前几天分享的关于Spring Boot Starter中的spring.factories文件不再推荐使用的视频下，看到有网友问了这样一个问题：

图 1

这个文件也是位于/META-INF/目录下面：

图 2

里面的大概是这样的：

{
  "groups": [
    {
      "name": "swagger",
      "type": "com.spring4all.swagger.SwaggerProperties",
      "sourceType": "com.spring4all.swagger.SwaggerProperties"
    },
    {
      "name": "swagger.authorization",
      "type": "com.spring4all.swagger.SwaggerAuthorizationProperties",
      "sourceType": "com.spring4all.swagger.SwaggerAuthorizationProperties"
    },
    {
      "name": "swagger.contact",
      "type": "com.spring4all.swagger.SwaggerProperties$Contact",
      "sourceType": "com.spring4all.swagger.SwaggerProperties"
    },
    ...
    "properties": [
    {
      "name": "swagger.apply-default-response-messages",
      "type": "java.lang.Boolean",
      "description": "是否使用默认预定义的响应消息 ，默认 true",
      "sourceType": "com.spring4all.swagger.SwaggerProperties",
      "defaultValue": true
    },
    {
      "name": "swagger.authorization.auth-regex",
      "type": "java.lang.String",
      "description": "需要开启鉴权URL的正则",
      "sourceType": "com.spring4all.swagger.SwaggerAuthorizationProperties",
      "defaultValue": "^.*$"
    },
    ...

spring.factories的作用是让Spring Boot知道要加载这个Starter的哪些配置类，而这个文件又有啥用呢？

其实，之前我在Spring Boot教程中有具体讲过，这个内容是配置元数据。它的主要作用就是，当我们在配置文件中尝试编写配置信息的时候，IDE可以根据这个配置元数据给出了相关的提示信息，比如：

图 3

所以，要做一个体验良好的Starter，这个文件还是非常重要的，对于使用你封装的开发者来说，写配置的时候就会方便很多。

如何自动生成？

既然spring.factories可以自动生成，那么spring-configuration-metadata.json文件可以自动生成吗？

答案是肯定的，不然维护这个json文件都会累死人！

你只需要在你的pom.xml中加入这个依赖：

<dependency>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-configuration-processor</artifactId>
  <optional>true</optional>
</dependency>

一切就都搞定了，当你再次编译的时候，spring-configuration-metadata.json文件就自动出现啦！不过，这里还有个前提，你在写配置属性类的时候，有好好写注释，那么自动提示就都会带上了，比如下面这样：

@Data
@ConfigurationProperties("swagger")
public class SwaggerProperties {

    /**
     * 标题
     **/
    private String title = "";
    /**
     * 描述
     **/
    private String description = "";

本期视频已发布：https://www.bilibili.com/video/BV1L54y1o7rC/，欢迎关注我的B站！

好了，今天的分享就到这里！如果您学习过程中如遇困难？可以加入我们超高质量的Spring技术交流群，参与交流与讨论，更好的学习与进步！更多Spring Boot教程可以点击直达！，欢迎收藏与转发支持！

本文由程序猿DD 创作
版权声明：自由转载-非商用-非衍生-保持署名 (CC BY-NC-ND 3.0)
原创不易，转载请注明出处，感谢支持！如果本文对您有用，欢迎转发分享！