0E.配置话题

trydofor原创神翼话题大约 5 分钟

0E.配置话题

工程配置，如maven，properties，spring等设置项。

0E.01.有哪些开关属性

## 找到所有开关配置
find . -name 'wings-enabled*.properties' \
| egrep -v -E 'target/|example/|-test/'

## 找到所有开关Java
find . -name '*EnabledProp.java' \
| egrep -v -E 'example/'

## 找到所有限定属性
find . -name 'additional-spring-configuration-metadata.json' \
| egrep -v -E 'target/|example/'

0E.02.调整springboot版本和依赖

wings仅在SpringBoot标准生命周期中，对配置文件的加载，进行了处理，不依赖于任何特定版本。对于不想跟随wings一同升级spring及其依赖的，只把wings做dependency，而不parent和import即可。

wings随时跟进升级SpringBoot的次一级稳定版，目的是为了测试sharding-jdbc和jooq的兼容性。而在二进制兼容方面，wings210版本的编译的目标是java=11，kotlin=1.6

对于maven继承依赖有parent和import两种，其重要区别在于property覆盖。

parent - you can also override individual dependencies by overriding a property in your own project
import - does not let you override individual dependencies by using properties, as explained above. To achieve the same result, you need to add entries in the dependencyManagement section of your project before the spring-boot-dependencies entry.
https://docs.spring.io/spring-boot/docs/3.0.3/maven-plugin/reference/htmlsingle/#using.parent-pom
https://docs.spring.io/spring-boot/docs/3.0.3/maven-plugin/reference/htmlsingle/#using-import

对于低于wings的spring-boot版本，一般来讲指定一下jooq版本就可以完全正常。

0E.03.lib工程和boot工程的区别

SpringBoot打包的executable是boot.jar 不是普通的lib.jar

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <executable>true</executable>
    </configuration>
</plugin>

lib工程的配置，跳过repackage，参考example之外的工程

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <executions>
        <execution>
            <id>repackage</id>
            <goals>
                <goal>repackage</goal>
            </goals>
            <configuration>
                <skip>true</skip>
            </configuration>
        </execution>
    </executions>
</plugin>

wings推荐的工程结构是，parent的pom.xml的project/build/plugins项，对以下plugin的configuration进行默认设置，

spring-boot-maven-plugin - executable=true
maven-deploy-plugin - skip=true
maven-install-plugin - skip=true

这样，所有子模块，以boot工程提供默认的build（boot打包，不deploy，不install）。在lib子模块中跳过boot打包，即repackage中skip=true

0E.04.缺少mirana和meepo依赖lib

因是非吃货的大翅项目（曾用名），一些SNAPSHOT依赖，需要自行编译并本地安装。偶尔可以在sonatype上找到，需要自行添加repository，如~/.m2/settings.xml

<repository>
    <id>ossrh-snapshots</id>
    <url>https://oss.sonatype.org/content/repositories/snapshots</url>
    <snapshots><enabled>true</enabled></snapshots>
    <releases><enabled>false</enabled></releases>
</repository>

0E.05.配置和注入时的占位符

硬编码中，@Autowired
- PropertyResolver - 以key获取或解析value字符串
- StringValueResolver - 解析value字符串
properties配置中${VAR}
@Value和@RequestMapping中${VAR}

0E.06.移除Tomcat或hazelcast

使用wings为parent时通过dependencyManagement，继承wings默认不需要修改。但若是没有继承wings依赖，以下2项视情况需要自行调整。

spring-boot-starter-web/spring-boot-starter-tomcat，因默认使用undertow
spring-session-hazelcast/hazelcast，使用最新版本

0E.07.Java和Kotlin版本

通过pom设置java和kotlin的编译版本，若IDE中出现编译失败，很可能是编译版本不对。从210起，wings全面适配java 11，kotlin自动更新为1.6，但未做java8证兼性测试。

0E.08.如何配置logger和log groups

SpringBoot内置以下Log Groups

org.springframework.core.codec
org.springframework.http
org.springframework.web
org.springframework.boot.actuate.endpoint.web
org.springframework.boot.web.servlet.ServletContextInitializerBeans
org.springframework.jdbc.core
org.jooq.tools.LoggerListener

Spring Boot uses Commons Logging for all internal logging but leaves the underlying log implementation open

Wings遵循这一实践，@Configuration等spring功能为CommonsLogging，而业务代码中使用lombok的@Slf4j配置为static log

0E.09.mvn resources filtering

注：在210版后，以spring变量取代了mvn变量，不再需要filter。

因为在swagger的配置中使用了变量@project.version@，所以会配置 build/resources/resource/filtering=true，以便mvn自动替换。

但是开启filter会引起错误替换，比如二进制文件等，wings默认忽略一些二进制文件

0E.10.SPA及反向代理的缓存设置

默认情况下springboot自动增加以下Response Header，使得反向代理无需设置 Cache-Control=no-cache,no-store,max-age=0,must-revalidate

但对于SPA页面，需要进行手动设置，如nginx配置。

location / {
    #add_header 'Access-Control-Allow-Origin' '*'; #允许跨域
    root /data/static/demo-admin-spa/;
    if ($request_filename ~* \.(html|htm)$){
        add_header Cache-Control no-cache,no-store,max-age=0,must-revalidate;
    }
}