使用 maven profile
一个项目可以部署在不同的环境当中,maven 的 profile 针对不同的环境指定各自的编译方法。在 pom.xml 的 profile 中,可以根据不同的环境定制以下内容:
- <repositories>
- <pluginRepositories>
- <dependencies>
- <plugins>
- <properties>
- <dependencyManagement>
- <distributionManagement>
- <build>
- <defaultGoal>
- <resources>
- <testResources>
- <finalName>
可以设置默认激活的 profile
<profiles>
<profile>
<id>profile-1</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
...
</profile>
</profiles>
build 配置项
build 配置项可以在两处出现:
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
...
<!-- 项目级别的构建,基础配置 -->
<build>...</build> <profiles>
<profile>
<!-- 特殊的构建 -->
<build>...</build>
</profile>
</profiles>
</project>
以下是 build 的详细配置
<build>
<defaultGoal>install</defaultGoal>
<directory>${basedir}/target</directory>
<finalName>${artifactId}-${version}</finalName>
<filters> <!-- 过滤器,用于过滤resource中的各个文件 -->
<filter>filters/filter1.properties</filter>
</filters>
<resources>
<resource>
<targetPath>META-INF/plexus</targetPath>
<filtering>false</filtering> <!-- 是否使用过滤器 -->
<directory>${basedir}/src/main/plexus</directory>
<includes>
<include>configuration.xml</include>
</includes>
<excludes>
<exclude>**/*.properties</exclude>
</excludes>
</resource>
</resources>
<testResources>
...
</testResources>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>2.0</version>
<extensions>false</extensions> <!-- 是否使用扩展 -->
<inherited>true</inherited> <!-- 是否可继承 -->
<configuration> <!-- 当前插件的配置 -->
<classifier>test</classifier>
</configuration>
<dependencies>...</dependencies>
<executions> <!-- 配置插件在哪个阶段使用 -->
<execution>
<id>echodir</id>
<goals>
<goal>run</goal>
</goals>
<phase>verify</phase>
<inherited>false</inherited>
<configuration>
<tasks>
<echo>Build Dir: ${project.build.directory}</echo>
</tasks>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
<sourceDirectory>${basedir}/src/main/java</sourceDirectory>
<scriptSourceDirectory>${basedir}/src/main/scripts</scriptSourceDirectory>
<testSourceDirectory>${basedir}/src/test/java</testSourceDirectory>
<outputDirectory>${basedir}/target/classes</outputDirectory>
<testOutputDirectory>${basedir}/target/test-classes</testOutputDirectory>
<extensions> <!-- 通过扩展来修改插件的行为 -->
<extension>
<groupId>org.apache.maven.wagon</groupId>
<artifactId>wagon-ftp</artifactId>
<version>1.0-alpha-3</version>
</extension>
</extensions>
</build>
filter 规则
maven 通过过滤器来修改部署时的不同配置。部署时的所有资源的配置,如果根据环境不同,有不同的配置,则需要在资源中加上以下形式的标记:
${tag.subtag}
如,在 spring.xml 中要配置上传文件的路径:
<beans>
<bean id="uploadService" class="com.oist.project.service.UploadServiceImpl">
<property name="uploadDir" value="${spring.uploadDir}"/>
</bean>
</beans>
在 pom.xml 中进行以下配置:
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
...
<build>
<filters> <!-- 指定 filter -->
<filter>src/main/filters/${deploy.env}.properties</filter>
</filters>
<resources>
<resource> <!-- spring.xml 应该在 src/main/resource 目录下 -->
<filtering>true</filtering> <!-- 是否使用过滤器 -->
</resource>
</resources>
</build> <profiles>
<profile>
<id>development</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<propertys>
<deploy.env>develop</deploy.env>
</propertys>
</profile> <profile>
<id>test</id>
<propertys>
<deploy.env>test</deploy.env>
</propertys>
</profile> <profile>
<id>production</id>
<propertys>
<deploy.env>production</deploy.env>
</propertys>
</profile> </profiles>
</project>
然后就可以针对不同的环境设置不同的目录了:
src/main/filters/develop.properties 文件
# 上传路径:
spring.uploadDir=c:/uploadDir
src/main/filters/test.properties 文件
# 上传路径:
spring.uploadDir=/tmp/upload_dir
src/main/filters/production.properties 文件
# 上传路径:
spring.uploadDir=/app/project/upload_dir
如果配置了多个 filter,并且两个 filter 中有相同的 key,则后面的 value 为最终取值。
<build>
<filters>
<filter>src/main/filters/production.properties</filter>
<filter>src/main/filters/test.properties</filter>
</filters>
</build>
如以上的配置,因为 test.properties 在最后,因而 spring.uploadDir 为 test.properties 的取值 /tmp/upload_dir
maven 的 properties 加载顺序
- <build><filters> 中的配置
- pom.xml 中的 <properties>
- mvn -Dproperty=value 中定义的 property
相同 key 的 property,以最后一个文件中的配置为最终配置。
利用这一规则,可以在打升级 war 包的时候,不将 lib/*.jar 打进 war 包。
<project>
...
<properties>
<lib.exclude>abc.jar</lib.exclude>
</properties>
...
<build>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>2.3</version>
<configuration>
<packagingExcludes>WEB-INF/lib/${lib.exclude}.jar</packagingExcludes>
</configuration>
</plugin>
</build>
</project>
打第一个 war 包的时候,可以使用以下命令:
mvn clean compile war:war -Pproduction
今后要升级,不用再把 lib 打进 war 包(这样可以使得 war 包体积减少很多),可以使用以下的命令:
mvn clean compile war:war -Pproduction -Dlib.execlude=*