Maven Profile 与 SpringBoot Profile 多环境打包指派指定环境

目录

1、使用场景

2、Spring Boot Profile

3、Maven Profile设置

4、Spring profile与Maven Profile 融合二者，取长补短 实现 多环境打包

5、成果展现

6、总结

7、参考文章

---

1、使用场景

        因为实际项目之中，经常使用到针对不同环境进行相关的打包。于是趁最近一段时间比较闲。研究了一下如何是现在在多环境下打包问题。本片文章实现了基于*.properties文件及 *.yml文件的多环境打包。本片文章使用的是基于Maven的Profile，同时使用Maven的过滤器(filtering)。

      一般开发团队会有多个部署环境，如 dev 环境用于开发自测，Test环境让测试团队测试， Production 环境作为线上环境。通常不同环境的配置不同，我们希望打包时的人力消耗最少。

需要注意下：本文里面虽然都实现了*.properties和.yml文件的多环境下指定某个环境进行打包。但是有一个问题比较糟心就是基于*.properties文件类型的多环境打包时候，在application.properties文件之中中文被转换为了 Unicode码。希望其他看到此文的人能够提供好的解决方案。虽然功能可以实现指定环境直接替换，这是唯一的缺陷。

其他的.yml文件的替换很正常的。

2、Spring Boot Profile

     Spring Boot Profile 有许多的功能，这里只说管理配置的内容。Spring 加载配置的顺序如下:

1. Jar 包外的 application-{profile}.properties
2. Jar 包内的 application-{profile}.properties
3. Jar 包外的 application.properties
4. Jar 包内的 application.properties

   例如，如果我们在 application.properties 中指

spring.profiles.active = prod

则 SpringBoot 会使用 application-prod.properties 文件中的配置来覆盖 application.properties 文件中的相应配置。

3、Maven Profile设置

Maven 也提供了 Profile 支持，它允许我们在 pom.xml 中定义多个 Profile ，

每个 profile 可以指定自己的一些配置、依赖、触发条件等。例如：

	
		dev
		
			dev
		
	
	
		test
		
			test
		
	
	
		prod_test
		
			prod_test
		
	
	
		prod
		
			prod
		
		
			true
		
	

上面指定了四个 profile: dev、test、prod_test、prod，其中 prod是默认启用的，当profile 被启用时，它定义的的属性、依赖等内容就会起效。这里我们定义了spring.profiles.active 属性(可以自己命名为其他的只要对应上关系即可)，之后会用到。

在编译时指定 mvn clean install -Pprod 就能切换成 prod profile。

4、Spring profile与Maven Profile 融合二者，取长补短 实现 多环境打包

Maven 与 Spring Profile 的功能是有重合的，只使用一种其实就能实现多环境多配置。但它们各有千秋：

• Spring profile 除了指定配置，还有一些其它作用（如为不同的 profile 生成不同的 bean），但每次打包前都需要手工指定启用哪个 profile
• Maven Profile 可以通过命令行指定使用的 profile，但缺少了 spring profile 的一 些特定功能。

在 pom.xml 中定义 Profile

这里跟上面介绍的一样，定义两个/多个 profile 并为各个 profile 指定自己的属性：

	
		dev
		
			dev
		
	
	
		test
		
			test
		
	
	
		prod_test
		
			prod_test
		
	
	
		prod
		
			prod
		
		
			true
		
	

在 pom.xml 中定义资源过滤

目的是为了让 maven 在构建时用 profile 中指定的属性来替换 application.properties 中的内容。

	
		src/main/resources
		
		
			application*.properties
			
		
	
	
		src/main/resources
		
		true
							
			application.properties
			application-${spring.profiles.active}.properties
			
		
	

1位置中，我们通过 excludes 来将所有的 application*.properties(application*.yml) 排除在外，这样 maven 在打包时就不会复制这些文件。毕竟我们不希望把 application-dev.properties 也包含在 prod 的 jar 包里。

2位置中，通过开启 filtering，maven 会将文件中的 #XX# 替换 profile 中定义的 XX 变量/属性。另外，我们还通过 includes 来告诉 maven 根据profile 来复制对应的 propertie(yml)文件。

用 Maven 变量指定 Spring Profile

在 application.properties 文件中加入下面这行：

# 多环境配置文件激活属性
spring.profiles.active=#active.target.profile#

这里 active.target.profile 是在 maven profile 中的 properties 定义的，而 #XX# 的语法则是上节提到的 maven filtering 替换变量的语法。

构建不同的包

mvn clean package -P

5、成果展现

   此你可以在你的Ide开发环境之中运行，及可以看见很方便的切换当前启动的环境。为了显示当前运行环境，写了一个controller方法返回当前运行环境

@RestController
public class HelloController {

    @Autowired
    private Environment env;

    @RequestMapping("/hello")
    public String index() {
        return "Hello World";
    }

    @RequestMapping("/getCurrentEnv")
    public String getCurrentEnv(){
        String[] actProfile = env.getActiveProfiles();
        String curProfile = actProfile[0];
        return curProfile;
    }

}

IDE之中运行后如下图所示：

使用打包工具打包后启动一下试一试(本次选择test环境了)：

此时此目录下只有两个所需的.propertie文件啦

再看看打包后的jar文件之中

访问一下当前的页面

到此已经实现指定切换多环境下打包对应的环境，同时也不用在运行微服务时候指定环境啦。

示例源码所在地址：https://github.com/jianxia612/StudySampleJava/tree/master/Chapter-Muti-Profiles

6、总结

Maven profile 与 Spring profile 有自的优点，结合起来的步骤如下：

1. 在 pom.xml 中定义多个 profile 及自己的属性
2. 在 pom.xml 中定义 resource filtering，一方面控制 jar 中包含的资源文件， 一方面允许 @XX@ 的变量替换
3. 在 application.properties 中指定 spring.profiles.active，值为 maven profile 中定义的属性。
4. 构建时使用 mvn clean package -P 来指定 profile。
5. 如果你不想使用@服务作为过滤器符号，你可以自定义一个 需要在pom里面配置即可如下

	
	
	UTF-8
	UTF-8
	1.8

注意：问此还实现了基于yaml文件的过滤，示例工程之中放开对应的yaml文件，然后注释掉properties 文件即可。另外需要把yaml文件目录之中文件复制到resources下即可。

7、参考文章

Maven Profile 与 Spring Profile 管理多环境打包

Spring-Boot application.yml 文件拆分，实现 maven 多环境动态启用 Profiles

spring boot通过maven filter替换properties属性（多环境配置）