spring-configuration-metadata.json文件是做啥的?
在前几天分享的关于Spring Boot Starter中的spring.factories
文件不再推荐使用的视频下,看到有网友问了这样一个问题:
这个文件也是位于/META-INF/
目录下面:
里面的大概是这样的:
{
"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教程(https://blog.didispace.com/spring-boot-learning-2x/)中有具体讲过,这个内容是配置元数据。
它的主要作用就是,当我们在配置文件中尝试编写配置信息的时候,IDE可以根据这个配置元数据给出了相关的提示信息,比如:
所以,要做一个体验良好的Starter,这个文件还是非常重要的,对于使用你封装的开发者来说,写配置的时候就会方便很多。
如何自动生成?
既然spring.factories
可以自动生成,那么spring-configuration-metadata.json
文件可以自动生成吗?
答案是肯定的,不然维护这个json
文件都会累死人!
你只需要在你的pom.xml
中加入这个依赖:
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-configuration-processorartifactId>
<optional>trueoptional>
dependency>
一切就都搞定了,当你再次编译的时候,spring-configuration-metadata.json
文件就自动出现啦!不过,这里还有个前提,你在写配置属性类的时候,有好好写注释,那么自动提示就都会带上了,比如下面这样:
@Data
@ConfigurationProperties("swagger")
public class SwaggerProperties {
/**
* 标题
**/
private String title = "";
/**
* 描述
**/
private String description = "";
我们创建了一个高质量的技术交流群,与优秀的人在一起,自己也会优秀起来,赶紧点击加群,享受一起成长的快乐。另外,如果你最近想跳槽的话,年前我花了2周时间收集了一波大厂面经,节后准备跳槽的可以点击这里领取!
推荐阅读
你好,我是程序猿DD,10年开发老司机、阿里云MVP、腾讯云TVP、出过书创过业、国企4年互联网6年。从普通开发到架构师、再到合伙人。一路过来,给我最深的感受就是一定要不断学习并关注前沿。只要你能坚持下来,多思考、少抱怨、勤动手,就很容易实现弯道超车!所以,不要问我现在干什么是否来得及。如果你看好一个事情,一定是坚持了才能看到希望,而不是看到希望才去坚持。相信我,只要坚持下来,你一定比现在更好!如果你还没什么方向,可以先关注我,这里会经常分享一些前沿资讯,帮你积累弯道超车的资本。