如何在SpringBoot项目中的自定义配置添加IDE支持

发布时间:2021-02-23 16:33:30 作者:Leah
来源:亿速云 阅读:155

这篇文章将为大家详细讲解有关如何在SpringBoot项目中的自定义配置添加IDE支持,文章内容质量较高,因此小编分享给大家做个参考,希望大家阅读完这篇文章后对相关知识有一定的了解。

Application.java:

如何在SpringBoot项目中的自定义配置添加IDE支持

application.properties

如何在SpringBoot项目中的自定义配置添加IDE支持

或者是没有使用@Value而直接在XML中使用我们配置的属性值

application.xml

如何在SpringBoot项目中的自定义配置添加IDE支持

这样的代码和配置在Spring Boot项目中可以正常启动并读取配置,但是在我们的IDE中却不会为我们提示配置的类型和代码补全。当我们有新同事到来,或者是需要为配置文件添加新的环境的支持的时候,我们很容易会把配置文件的Key拼错,或者Value的值与我们的变量类型并不兼容(实际上真的发生过这样的问题导致项目启动失败)。

但是在我们使用Spring Boot提供的配置的时候,IDE总是能为我们自动补全,告诉我们这个配置的变量类型,甚至是给我们把这个配置的描述显示出来。

我们是否也可以为我们自己写的配置添加这样的IDE支持呢?

如何在SpringBoot项目中的自定义配置添加IDE支持

配置项元数据(Configuration Metadata)

Spring Boot的Jar文件包含元数据文件,这些文件提供了我们所需要的配置属性的详细信息。IDE通过读取这些元数据文件,然后在使用application.properties或application.yml的时候提供上下文信息和代码补全。 那么只要知道如何编写并存放配置项元数据信息文件,我们也可以让IDE知道如何为我们的自定义配置提供上下文信息。

元数据格式

Spring Boot项目的配置项元数据文件都放在META-INF/spring-configuration-metadata.json中。下图是当我们配置好Spring Boot项目后默认使用的Spring Boot自动配置的配置项元数据存放的位置

如何在SpringBoot项目中的自定义配置添加IDE支持

配置项元数据文件按照groups, properties和hints组织。properties下的每个property都是程序中需要使用的配置项的key值,比如server.port是服务启动后的端口号。而我们可以将一些property按照某些规则组合起来,这个组合就是group(通常我们并不需要为properties组织对应的group)。而hints是为我们的配置项提供额外的信息,比如时区time.zone支持Asia/Shanghai,我们可以为它提供"Asia/Shanghai"的hint。

properties的参数

名称类型描述
nameString属性的全名。名称是小写字母以句点分割。此属性是必须的
typeString属性的数据类型的完整签名(java.lang.String),如果是范型的话还应当包含完整的范型参数(java.util.List<java.lang.String>)。为了保证一致性,需要使用包装类型来替代基本类型。此属性不是必须的,但是无法得到类型诊断的支持。

hints的参数

名称类型描述
nameString该提示所引用的属性的全称,和properties的name参数相同。此属性是必须的
valuesValueHint[]ValueHint对象定义的有效值列表。每个条目都定义该值,并且可以具有描述

ValueHint的参数

名称类型描述
valueObjectproperty给定的类型的有效值,如果property的类型是数组,那么它也可以是值的数组。此属性是必须的。如果是Map类型的属性,可以使用.keys和.values来指定对应的有效值。
descriptionString和properties的description相同,提示给用户的简短描述。此属性不是必须的。

这里只展示了我们常用的参数,关于配置项元数据文件格式的详细信息可以看Spring Boot的官方文档 (https://docs.spring.io/spring-boot/docs/current/reference/html/appendix-configuration-metadata.html#configuration-metadata-format)

为自定义配置编写配置项元数据

接下来我们将对值、数组场景编写对应的配置项元数据,并为这些配置项添加提示(Talk is cheap,show me the code)

如何在SpringBoot项目中的自定义配置添加IDE支持

如何在SpringBoot项目中的自定义配置添加IDE支持

在IDE中实际使用的效果

如何在SpringBoot项目中的自定义配置添加IDE支持

如何在SpringBoot项目中的自定义配置添加IDE支持

如何在SpringBoot项目中的自定义配置添加IDE支持

不过这种方式虽然好,但是需要我们写很多的JSON配置来告诉IDE该如何进行代码补全和附加上下文信息,配置和代码还是处于分离的状态, 如果能通过写一个配置类,直接通过这个类和它的注释 就能为我们做到IDE支持就好了——Spring Boot开发者也是这么想的。

为代码自动生成配置项元数据

首先我们要改掉随处使用@Value的习惯,使用专门的数据类来存放我们的配置项

如何在SpringBoot项目中的自定义配置添加IDE支持

接下来我们创建一个Bean,让Spring Boot容器来接管这个类的实例

如何在SpringBoot项目中的自定义配置添加IDE支持

通过@ConfigurationProperties注解,Spring就会自动将配置注入到我们的配置Bean中,但是此时IDE还无法识别我们添加的自动配置,我们需要添加Spring Boot的注解处理器(annotation processor,从Java 1.6开始支持的特性)

如何在SpringBoot项目中的自定义配置添加IDE支持

添加注解处理器后重新编译,我们就会在target目录下看到自动生成的META-INF/spring-configuration-metadata.json

如何在SpringBoot项目中的自定义配置添加IDE支持

里面的内容基本就是我们之前自己手动输入的内容,只是受于Java代码表达信息的局限性,没有办法生成hints信息。其中sourceType和sourceMethod属性还可以帮助IDE跳转到我们声明这个配置的类和方法

如何在SpringBoot项目中的自定义配置添加IDE支持

如果我们想要让我们使用代码生成的配置类也能添加提示的话,可以在我们的META-INF目录下添加additional-spring-configuration-metadata.json文件,将hints写到这个文件里面

如何在SpringBoot项目中的自定义配置添加IDE支持

这样Spring Boot在编译的时候就会将我们的提示信息合并到配置信息元数据文件里面了

如何在SpringBoot项目中的自定义配置添加IDE支持

关于如何在SpringBoot项目中的自定义配置添加IDE支持就分享到这里了,希望以上内容可以对大家有一定的帮助,可以学到更多知识。如果觉得文章不错,可以把它分享出去让更多的人看到。

推荐阅读:
  1. 支持vim为python IDE
  2. SpringBoot入门十六,添加Thymeleaf模板支持

免责声明:本站发布的内容(图片、视频和文字)以原创、转载和分享为主,文章观点不代表本网站立场,如果涉及侵权请联系站长邮箱:is@yisu.com进行举报,并提供相关证据,一经查实,将立刻删除涉嫌侵权内容。

springboot ide

上一篇:@RequestParam、@PathParam、@PathVariable三者有什么区别

下一篇:如何在Android中实现一个动画效果的自定义下拉菜单功能

相关阅读

您好,登录后才能下订单哦!

密码登录
登录注册
其他方式登录
点击 登录注册 即表示同意《亿速云用户服务条款》