maven profile自动切换环境参数的2种方法详解
前言
痛点：
在java开发的过程中，我们经常要面对各种各样的环境，比如开发环境，测试环境，正式环境，而这些环境对项目的需求也不相同。
在此之前，我们往往需要手动去修改相对应的配置文件然后打成war，才能部署到相应的环境上。
但是这样很容易出现问题，因为很容易出现少改或者漏改，造成不必要的麻烦
幻想：
要是有一种东西，能让我们打war的时候指定一个参数，就能自动把项目编译成对应环境的war，那该有多幸福啊！！！
结果：这样的东西还真有，那就是maven-profile
在开发过程中，我们经常会根据不同的环境配置不同的参数，如数据源的ip，username，password、url、秘钥等都会不同，传统方式是在一个配置文件中通过修改properties文件中的参数值或者通过注释解注释来达到目的，这样不仅容易出错，还浪费不必要的时间，更重要的是把代码发布到测试环境或者生产环境还容易忘记改。为解决这种问题，maven提供了一种解决方案，就是profile。
下图为传统方式，需要来回的注释和解注释
profile定义的位置
- 针对于特定项目的profile配置我们可以定义在该项目的pom.xml中。
- 针对于特定用户的profile配置，我们可以在用户的settings.xml文件中定义profile。该文件在用户家目录下的“.m2”目录下。
- 全局的profile配置。全局的profile是定义在Maven安装目录下的“conf/settings.xml”文件中的。
filter方式实现
第一步：分别定义application-dev.properties、application-test.properties、application-pro.properties三个文件
application-dev.properties
env.jdbc.username=dev env.jdbc.password=123456
application-test.properties
env.jdbc.username=test env.jdbc.password=888888
application-pro.properties
env.jdbc.username=root env.jdbc.password=666666
第二步：定义总的属性文件application.properties，该文件中的值去引用application-<env>.properties中的key
application.properties
// 引用application-<env>中的key
jdbc.username=${env.jdbc.username}
jdbc.password=${env.jdbc.password}
# 公共配置
salt=123456789
第三步：配置profile
<profiles> <profile> <!-- 开发环境 --> <id>dev</id> <properties> <env>dev</env> </properties> <activation> <!-- 设置默认激活这个配置 --> <activeByDefault>true</activeByDefault> </activation> </profile> <profile> <!-- 测试环境 --> <id>test</id> <properties> <env>test</env> </properties> </profile> <profile> <!-- 发布环境 --> <id>pro</id> <properties> <env>pro</env> </properties> </profile> </profiles>
第四步：配置filter和resource
${env}就是在mvn package -P <env>的名字，这样就告诉application.properties中应用的key是那个属性文件的key了
<build>
<finalName>profile-app</finalName>
<!-- 定义了变量配置文件的地址 -->
<filters>
<filter>src/main/resources/config/application/application-${env}.properties</filter>
</filters>
<resources>
<resource>
<directory>src/main/resources</directory>
<filtering>true</filtering>
</resource>
</resources>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
</plugin>
</plugins>
</build>
打包运行
// 如果不指定环境，默认是activeByDefault=true的环境，当前是指开发环境 mvn package // 打包指定的环境通过-P 参数，注意p是大写的 mvn package -P <env>
从mvn packege -P test运行的结果中可以看到生成的target目录下classes/application.perperties中的jdbc.username和jdbc.password 就是application-test.properties中配置的env.jdbc.username和env.jdbc.password的值。
在spring中如果要使用属性配置文件，直接引入这个总的配置文件即可，其他的环境配置文件的使命已经结束了。
<context:property-placeholder location="classpath:application.properties"/>
实现原理：
在pom.xml中为每个不同的环境定义不同的profile，每个profile都有一个环境名称，然后为不同环境定义不同的配置文件(如application-<env>.properties), 再定义一个总的属性文件(如application.properties), 然后让application.properties的value去引用application-<env>.properties中对应的key，在打包时指定要打包的环境的名称即可，这样application.properties中的key的值就是相对应环境application-<env>.properties对应的值了。
多resource实现方式
步骤
第一步：在src/main/resource创建一个env目录，再创建各个环境的子目录，再再各个环境子目录下创建名为config.properties的文件，每个键相同，值不同。
env/dev/config.properties
jdbc.username=dev jdbc.password=123456
env/test/config.properties
jdbc.username=test jdbc.password=888888
env/pro/config.properties
jdbc.username=root jdbc.password=666666
第二步：创建一个与环境无关的application.properties
application.properties
# 公共配置 salt=123456789
第三步：配置profiles
<profiles> <profile> <!-- 开发环境 --> <id>dev</id> <properties> <env>dev</env> </properties> <activation> <!-- 设置默认激活这个配置 --> <activeByDefault>true</activeByDefault> </activation> </profile> <profile> <!-- 测试环境 --> <id>test</id> <properties> <env>test</env> </properties> </profile> <profile> <!-- 发布环境 --> <id>pro</id> <properties> <env>pro</env> </properties> </profile> </profiles>
第四步：配置resource
<build>
<finalName>profile-app</finalName>
<!-- 定义了变量配置文件的地址 -->
<resources>
<resource>
<directory>src/main/resources</directory>
<excludes>
<exclude>env/dev/*</exclude>
<exclude>env/test/*</exclude>
<exclude>env/pro/*</exclude>
</excludes>
<filtering>true</filtering>
</resource>
<resource>
<directory>src/main/resources/env/${env}</directory>
<includes>
<include>*.*</include>
<include>**/*.xml</include>
<include>**/*.properties</include>
</includes>
<filtering>true</filtering>
</resource>
</resources>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
</plugin>
</plugins>
</build>
第五步：运行 mvn package -P test
如果经常使用mvn package -P <env>可以在idea中配置一些maven, 步骤为：Edit Configurations… —– + —- Maven —- 分别为每个环境添加maven 命令，以后双击Run Configureations中的任意一个就是相当于运行mvn package -P <env>命令了
两种方式比较
filter方式会把所有的application-dev.properties、application-test.properties、application-pro.properties文件都会打包进去，而且此种方式只能针对属性文件，如果有其他文件(如.xml)也根据不同的环境有不同的配置，这种方式是不好处理。
多resource方式在打包时只打包指定环境的配置文件，可以将各种文件放到各自的环境文件夹中，在打包的时候会将整个文件夹都打包进去。推荐此种方式
总结
以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对脚本之家的支持。
相关文章
这篇文章主要介绍了SpringCloud Zuul实现负载均衡和熔断机制方式，具有很好的参考价值，希望对大家有所帮助。2021-07-07
页面重定向即页面从当前请求的页面,有条件或者定时跳转到其他页面,下面这篇文章主要给大家介绍了关于JAVA中五个重定向的方式,文中通过实例代码介绍的非常详细,需要的朋友可以参考下2022-12-12
Spring AOP提供了五种通知类型：@Before、@After、@AfterReturning、@AfterThrowing和@Around,每种通知类型都有其特定的使用场景和实现方式,通过合理使用这些通知类型,可以实现各种横切关注点的模块化和解耦,感兴趣的朋友跟随小编一起看看吧2024-11-11
这篇文章主要介绍了在 Spring Boot 中使用注解集成 Redis 缓存的步骤,包括添加依赖、创建相关配置类、需要缓存数据的类（TestService）以及测试方法（如在 Controller 中的 redisTest 和 redisCache 方法）,还对一些关键代码和配置进行了详细说明2025-01-01
解决springboot 部署到 weblogic 中 jar 包冲突的问题
这篇文章主要介绍了springboot 部署到 weblogic 中 jar 包冲突,weblogic 也有是解决方案的，可以通过新增并配置 weblogic.xml 文件来定义哪些类需要优先从项目工程包的 jar 包中加载，本文给大家分享解决方法，需要的朋友可以参考下2022-08-08
Spring应用中使用acutator/refresh刷新属性不生效的问题分析及解决
在Spring应用收到/actuator/refresh的POST请求后,标注了@RefreshScope以及@ConfiguratioinProperties的bean会被Spring容器重新加载,但是,在实际应用中,并没有按照预期被Spring容器加载,本文将讨论导致这种未按预期刷新的一种原因,感兴趣的朋友可以参考下2024-01-01
这篇文章主要给大家介绍了关于VSCode新手教程之配置Java环境的详细教程,工欲善其事必先利其器,想要工作顺利我们先搭建好JAVA的开发环境,需要的朋友可以参考下2023-10-10
这篇文章主要介绍了Java多文件生成并压缩下载,本文给大家分享两种思路通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2022-02-02
Java程序员的10道常见的XML面试问答题（XML术语详解）
包括web开发人员的Java面试在内的各种面试中，XML面试题在各种编程工作的面试中很常见。XML是一种成熟的技术，经常作为从一个平台到其他平台传输数据的标准2014-04-04
这篇文章主要介绍了idea热部署且开启自动编译的实现方法,本文通过图文并茂的形式给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下2020-12-12
最新评论