「Swagger」 給Swagger加個時間戳

Swagger方便大家生成API文檔的同時，有時候也不知道我們用的文檔是不是最新的，那可以通過Maven的全局屬性生成build number，或者 timestamp。

Maven 自帶生成時間戳的功能

在yaml文件中直接使用

@maven.build.timestamp@

但是自 3.2.2 + 之後，不支持GTM + 8 ，只支持 UTC 時間。作為中國人，使用起來還是彆扭。

好在還有其他的替代Maven Plugin，那就是 build-helper-maven-plugin

* SpringBoot項目下 pom文件配置如下：

<build>
 <plugins>
 <plugin>
 <groupid>org.springframework.boot/<groupid>
 <artifactid>spring-boot-maven-plugin/<artifactid>
 /<plugin>
 <plugin>
 <groupid>org.codehaus.mojo/<groupid>
 <artifactid>build-helper-maven-plugin/<artifactid>
 <version>3.0.0/<version>
 <executions>
 <execution>
 timestamp-property
 <goals>
 <goal>timestamp-property/<goal>
 /<goals>
 <configuration>
 <name>build.time/<name>
 <pattern>yyyy-MM-dd HH:mm:ss/<pattern>
 <timezone>GMT+8/<timezone>
 /<configuration>
 /<execution>
 /<executions>
 /<plugin>
 /<plugins>
/<build>

application.yml 配置如下

maven:
 project:
 version: @project.version@
 description: @project.description@
 build:
 time: @build.time@

如果是在Idea中使用，你會遇到一個奇怪的問題，build.time 沒有起作用。也就是使用idea運行SpringBoot項目時，插件的goal不會執行，需要在idea中進行設置