集成maven和Spring boot的profile功能

    由于项目的需要, 今天给spirng boot项目添加了profile功能。再网上搜索了一圈,也没有找到满意的参考资料,其实配置并不难,就是没有一个one stop(一站式)讲解的地方,所以有了写这篇博客的想法。由于本人水平有限,文中任何错误和纰漏欢迎大家反馈。希望本文可以给你带来帮助。

    本文实现的目标:

           1 使用了maven的profile功能

           2 使用了spring Boot的profile功能

           3 集成了1和2的功能

           4 在eclipse中运行mvn工程,使用开发环境的profile。

           5 通过mvn在命令行中打包时,可以指定相应的profile。

 

什么是profile,解决什么问题呢?举个例子。一般在开发项目的时候要有多个环境,如开发环境、测试环境、生产环境,他们的配置文件一般不同。当我们要向各个环境发布程序时,需要人工处理这些配置文件,这显然麻烦且易错。有了profile,一切问题就简单了。只要在maven打包时使用下面命令即可。

 

[plain] view plain copy
 
  1. mvn clean package -Dmaven.test.skip=true -P prod  

            解释一下, -P prod 就是告诉maven要使用名字为prod的profile来打包,即所有的配置文件都使用生产环境(prod是自己定义的,在这里自定义为生产环境)。

 

实现思路简述:

    maven支持profile功能,当使用maven profile打包时,可以打包指定目录和指定文件,且可以修改文件中的变量。spring boot也支持profile功能,只要在application.properties文件中指定spring.profiles.active=xxx 即可,其中xxx是一个变量,当maven打包时,修改这个变量即可。

 

具体实现:

 

A段,介绍coolpro工程的配置。

    这个工程只需要修改pom.xml文件即可,需要定义具体maven的profile。定义完毕之后,当我们使用mvn clean package -P dev 时,maven就知道了profileActive=dev这个属性生效了。其中profileActive可以自己定义,就是一个maven的自定义属性。

    pom.xml文件如下:

 

B段,介绍coolpro-api工程的配置

    这个工程是一个web工程,主要是想根据指定的profile配置相应的spring boot运行环境。如:如果profile是dev,配置web服务器的监听端口为8010;profile为test,则端口为8020;profile为prod,则端口为8030。 

    工程中有4个文件:

              application.properties, 包含通用配置的文件。文件中有spring.profiles.active=@profileActive@的属性。spring boot的profile是通过spring.profiles.active属性来配置的,这里的profileActive和上面coolpro工程中配置的profileActive属性名要一致。这样,在运行mvn命令时,maven就会帮我们将@profileActive@替换成指定的profile。

              application-dev.properties, 当mvn -P dev时, 需要打包这个文件。

              application-test.properties, 当mvn -P test时, 需要打包这个文件。

              application-prod.properties, 当mvn -P prod时, 需要打包这个文件。

    pom.xml配置:

    application.properties文件:

     其他3个文件见截图:

    

C段,介绍coolpro-core工程的配置

 

配置完成了。看效果。

1 在Eclipse环境中,直接运行项目。

2 使用maven命令,打包这个应用。

     1)以开发环境打包:mvn clean package -Dmaven.test.skip=true -P dev -e 

           结果如下:

       查看api工程:

      

     查看core工程:

 

以此类推, 可以运行

       mvn clean package -Dmaven.test.skip=true -P test -e 

       mvn clean package -Dmaven.test.skip=true -P prod -e 

 

注意两点:

       1 在属性文件中替换变量时,使用@符合。 

       

        最开始,使用$符号,就是不能替换,在网上搜索一下,原来是maven的maven-resources-plugin可以定义这个替换的符号。通过eclipse提供的Maven Pom editor编辑器打开pom.xml文件,在“Effective POM”选项卡中,可以看到定义的是@这个符号。

      2 怎么在启动spring boot应用时,打印正在使用的profile,避免配置错误呢?可以参考如下代码。

[java] view plain copy
 
  1. public static void main(String[] args) {  
  2.     ApplicationContext ctx = SpringApplication.run(RestApiApplication.class, args);  
  3.     String[] activeProfiles = ctx.getEnvironment().getActiveProfiles();  
  4.     for (String profile : activeProfiles) {  
  5.         logger.warn("Spring Boot 使用profile为:{}" , profile);  
  6.     }  
  7. }  



 

 

参考:http://docs.spring.io/spring-boot/docs/current/reference/html/

            http://www.tuicool.com/articles/NjqAF3

            http://blog.csdn.NET/jbgtwang/article/details/8642979

            http://zilongsky-gmail-com.iteye.com/blog/2032001

            http://www.huangyunkun.com/2015/01/01/run-code-after-spring-boot-started/

posted @ 2017-07-11 00:40  牧之丨  阅读(734)  评论(0编辑  收藏  举报