oracle帮助文档_Spring Boot Config文档，使用IntelliJ IDEA的两种方法

一个Spring Boot文档，两种方式。

在优锐课的java沙龙分享中，在现代软件开发中，应用程序由配置驱动。如果可配置属性的数量很大，则很难记住每个属性的用途，结构或类型。因此，有必要对这些属性的文档进行投资。

本文探讨了IDE集成选项，以帮助编写基于Spring Boot YAML的配置。

弹簧配置处理器¹

Spring Boot为配置文档提供了一种即用的机制：包括一个名为spring-boot-configuration-processor的jar和触发器构建。

annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'

怎么运行的

1. 你触发构建

2. 扫描@ConfigurationProperties并构造一个描述整体属性的JSON文件。

{"groups": [{"name": "db","type": "mighty.config.Database","sourceType": "mighty.config.Database"}],"properties": [{"name": "db.hostname","type": "java.lang.String","sourceType": "mighty.config.Database"},{"name": "db.password","type": "java.lang.Character[]","sourceType": "mighty.config.Database"},{"name": "db.port","type": "java.lang.Integer","sourceType": "mighty.config.Database","defaultValue": 0},{"name": "db.username","type": "java.lang.String","sourceType": "mighty.config.Database"}],"hints": []
}

3.你的IDE会拦截生成的文件，并帮助你编写配置。

IntelliJ IDEA –最终版在类路径上检测Spring元处理器，并根据生成的元数据文件提供提示。

但是，不支持IntelliJ IDEA社区版本，Spring Tools 4（带有Spring工具的Eclipse）和Visual Code（带有Spring工具的）。

YAML模式

YAML模式是一个更新，仍在发展且功能强大的选项。实际上，“ YAML模式是以JSON格式编写的”²（奇怪！）。

在撰写本文时，＃8或2019-09草案已经发布，其中包括诸如Visual Studio Code（Red Hat具有YAML扩展名），IntelliJ IDEA 2019.x等工具支持Draft＃7。

怎么运行的

1. 你可以手动编写模式。

2. 你创建模式映射：针对模式管理的文件映射。 IntelliJ IDEA社区版

3. IDE根据提供的架构提供提示，以帮助你有效地编写架构。

Spring 配置元数据与YAML模式

现在我们已经看到了两种方式，现在让我们进行比较。

情况1：静态属性

考虑一种配置，该配置接受一些与数据库连接有关的固定属性。

db:hostname:port:username:password:

这是两种方法的IDE性能：

在YAML模式的情况下，建议中未显示属性的类型，但在验证属性时会建议类型。使用Spring Boot配置元数据，Java异常消息显示在“类型不匹配”上。

情况2：动态属性

让我们扩展先前的案例配置。考虑下面显示的配置扩展。

根据类型，可以更改其他属性。考虑支持的两种数据库类型：Oracle和MySQL。

如果类型为oracle，则为Oracle特定的属性;如果类型为mysql，则为MySQL的特定属性。

UML类图可能的解决方案：

在Spring配置元数据的情况下，IDE无法将Oracle属性与MySQL属性区分开。生成的Spring元数据JSON文件未描述或命令属性的条件性质。而且，Spring Configuration元数据规范未指定任何条件构造。

在YAML架构的情况下，IDE可以拦截条件属性。

使用YAML架构使用

总结

当涉及到静态可配置属性时，Spring Configuration元数据程序员与YAML Schema相当。而且，它是自动生成的；但是，这由IntelliJ IDEA的付费版本提供支持。

YAML提供了出色的条件模式支持，使其功能强大；但是，编写这样一个复杂的架构并非易事

那么，哪个更好？

Spring开发人员应该包括条件属性构造，或者他们可以采用YAML / JSON模式，这将成为未来的标准，并且将被广大读者理解（即使使用不同的语言背景！）。而且，它将简化IDE的实现。

> 喜欢这篇文章的可以点个赞，欢迎大家留言评论，记得关注我，每天持续更新技术干货、职场趣事、海量面试资料等等
> 如果你对java技术很感兴趣也可以交流学习，共同学习进步。
> 不要再用"没有时间“来掩饰自己思想上的懒惰！趁年轻，使劲拼，给未来的自己一个交代
文章写道这里，欢迎完善交流。最后奉上近期整理出来的一套完整的java架构思维导图，分享给大家对照知识点参考学习。有更多JVM、Mysql、Tomcat、Spring Boot、Spring Cloud、Zookeeper、Kafka、RabbitMQ、RockerMQ、Redis、ELK、Git等Java干货