在工作中,我们经常遇到多环境需要不同的配置文件,例如不同环境下连接的数据库不一致。
在spring boot
项目中可以较为方便的集成,那么在传统的spring web
项目中应该如何解决这个问题呢,下面我们尝试使用maven的filter进行处理不同环境的变量值。
配置pom文件
- 为pom文件添加profile的配置
<profiles>
<profile>
<id>local</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<env>local</env>
</properties>
</profile>
<profile>
<id>development</id>
<properties>
<env>development</env>
</properties>
</profile>
<profile>
<id>test</id>
<properties>
<env>test</env>
</properties>
</profile>
<profile>
<id>production</id>
<properties>
<env>production</env>
</properties>
</profile>
</profiles>
在本段代码中,我们将local设置为默认的环境变量,那么在我们打包的过程中如果不置顶环境变量,maven将按照默认的local形式进行打包。我们为每个profile设置了一个env
的变量值,该值可以让我们在其他部分配置直接引用。
- 配置filter
<filters>
<filter>src/main/resource/${env}/application.properties</filter>
</filters>
通过filter,我们可以将不同环境目录下的application.properties文件中的参数值加载到maven中,如果我们有多个properties可以在添加一个filter即可。
- 配置resources
<resources>
<resource>
<directory>src/main/resources</directory>
<filtering>true</filtering>
<excludes>
<exclude>local/*</exclude>
<exclude>development/*</exclude>
<exclude>test/*</exclude>
<exclude>production/*</exclude>
</excludes>
</resource>
</resources>
通过指定filtering
表示该目录下的文件都将通过maven的过滤进行变量值的替换,并且我们将源代码中的多环境目录进行排除,在maven编译生成的目录将不会带目录文件。
配置application.properties文件
在src/main/resources/目录下新建一个application.properties,并添加内容
test.properties=@test.properties@
此处的@test.properties@为通过fileter筛选各自环境下的加入到maven的变量值。
例如src/main/resources/production/applicaiton.properties
文件内容为:
test.properties=production
maven在编译的过程中会替换 @test.properties@为production,最终生成的application.properties文件内容应该为:
test.properties=production
通过上面的讲解和代码配置,我们完成了maven多环境变量的配置工作,接下来我们来使用maven编译试试?
- 通过命令进行打包
mvn clean compile -Pproduction
- 查看目录文件生成情况
常见问题
maven在替换变量的时候,默认${]和@@表达式均可替换,如果我们在spring 的xml配置文件中使用${} 也会被maven替换掉,为了避免该问题,我们可以参考spring boot
的parent中的xml进行配置
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<version>2.6</version>
<configuration>
<delimiters>
<delimiter>@</delimiter>
</delimiters>
<useDefaultDelimiters>false</useDefaultDelimiters>
</configuration>
</plugin>
重点是delimiter的配置,该配置主要配置变量的分隔符,我们配置为@,那么它就不会对${}产生作用了,具体说明可以参考maven的官方文档 maven delimiters
结束
通过上面的展示,想必我们都已经学会使用maven的多环境配置了,本段的demo我也传到github上,大家可以自行查看具体源代码。github源代码