maven (profiles)装载不同环境所需的配置文件

Posted 易连山

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了maven (profiles)装载不同环境所需的配置文件相关的知识,希望对你有一定的参考价值。

引子:

  maven与java的联系在今天的项目已经是不可分割的 ,但是不同的项目有各具特色的项目结构,不同的项目结构使用了不同的maven插件,想要了解一个项目的项目结构,或者自己构建一个具有成熟结构体系的项目,那么,了解到熟悉的使用maven插件那么就是势在必行的了。

maven装载不同环境所需的配置文件

  场景:

  企业及应用,摆脱不了三个环境,研发环境,测试环境,生产环境,或者灰度环境,甚至更多。不同的环境 有不同的配置,那么如何在项目发布打包时将所需的配置正确的装载呢。

正常情况下,这些不同环境的配置放在了相似的配置文件,或者类似的包结构下。

  我们会使用以下命令,来装载不同的配置文件:

mvn clean package -P uat

  以上的配置代表了我们将选择prod下包括的相关配置文件,这依赖于pom的相关profile配置 ,实际上profile文件是由maven conf/setting.xml而来的,但这里配置的是全局变量,对于一个开发者我们往往在具体的项目里配置相关的profile,以方便在打包时选择。

示例配置如下:


    <profiles>
        <profile>
            <id>dev</id>    <!-- a. _P后的参数-->
            <activation>
                <activeByDefault>true</activeByDefault>   <!-- b.    表示是否默认激活  mvn clean package 加载的就是此配置下的文件-->
            </activation>
            <properties>
                <finalName.suffix>dev</finalName.suffix><!-- c.  最终项目包后缀-->
                <sysconfig.properties.file>sysconfig-dev.properties</sysconfig.properties.file> <!-- d. 选择加载的配置,注意这并不代表打包时就使用这个配置文件了,而是声明sysconfig.properties.file这个变量留待其他地方调用-->
                <ucmp.log.home>d:/app/applogs/ucmp</ucmp.log.home>  <!-- 同样是声明变量,而不是指定文件-->
            </properties>
        </profile>
        <profile>
            <id>uat</id>
            <properties>
                <finalName.suffix>uat</finalName.suffix>
                <sysconfig.properties.file>sysconfig-uat.properties</sysconfig.properties.file>
                <ucmp.log.home>/app/applogs/ucmp</ucmp.log.home>
            </properties>
        </profile>

  需要留意的是,properties 下的文件都是变量的声明,而不是变量的使用都是需要其他地方调用的 ,正如 properties 代表的是属性。

  关于我们声明的这三个属性我们分别在这三个地方指定加载,

 

<build>
        <finalName>${project.artifactId}-${finalName.suffix}-${project.version}</finalName>

 

<!-- 环境配置和war包分离 以外部配置为准 -->
<context:property-placeholder order="1"
   ignore-resource-not-found="true" ignore-unresolvable="true"
   location="file:${CONF_PATH}/${sysconfig.properties.file}" />
   
<context:property-placeholder 
   order="2" 
   ignore-resource-not-found="true" 
   ignore-unresolvable="false"
   location="classpath*:/${sysconfig.properties.file}" />  
    <property name="instance_name" value="${jboss.server.name:-default}" />
    <property name="log_home" value="${ucmp.log.home}/${instance_name}" />
    <property name="logfile_maxsize" value="100MB" />

 最终打包后的结果如下

uat替换${finalName.suffix}  ,sysconfig-uat.properties替换${sysconfig.properties.file}

 那是否这样就代表万事大吉了,答案是否定的 ,这样的我们会发现在打包时上述声明的几个配置文件都有打入jar包只是在spring配置阶段加载了我们声明的 ,这样的包是不够简洁的。

同时在复杂的环境中我们将所有的配置变量都放入一个配置文件也是行不通的,这样会大大降低代码的可读性。

关于如何与assembly结合,构建更好的包结构信息,请参考我的下篇博客:http://www.cnblogs.com/lianshan/p/7348093.html

 

以上是关于maven (profiles)装载不同环境所需的配置文件的主要内容,如果未能解决你的问题,请参考以下文章

idea pom profiles 配置的使用

Spring 环境与profile——超简用例

idea 中的 profiles 详解

Spring IOC官方文档学习笔记(十三)之环境概要

SpringBoot项目的创建:手动创建一个Maven工程,然后引入SpringBoot所需的dependency来完成 (不需联网,但复杂)

maven属性资源过滤profile不同环境构建项目