maven profiles

定义Profiles
　　你可以把profiles定义在4个地方：
　　%M2_HOME%/conf/settings.xml，这是针对该部电脑的所有user的profiles，是global profiles，它会影响所有的maven project build
　　<your -home-directory>/.m2/settings.xml，这是针对per user的profiles，是user级的profiles，它会影响当前user的所有maven project build
　　定义在pom.xml文件里面，这是仅针对该project的profiles，是project级的profiles
　　profiles.xml，它和pom.xml在同一个目录下，也是project级的profiles，使用profiles.xml的目的是希望把profiles的设置从pom.xml里抽离出来设置。
　　定义在这4个地方的profiles中，涉及范围越窄的profiles会覆盖范围越宽的profiles。即：定义在pom.xml里profiles会覆盖profiles.xml的，profiles.xml的会覆盖<your -home-directory>/.m2/settings.xml的，<your -home-directory>/.m2/settings.xml的会覆盖%M2_HOME%/conf/settings.xml的。
　　不过请注意：设置在pom.xml里的profiles是最最推荐的，因为pom.xml会被deploy到repository里，所以pom.xml里的profiles才会available for subsequent builds originating from the repository or as transitive dependencies。而settings.xml和profiles.xml里定义的profiles不会被deploy到repository，则有诸多限制，因此，只有下面几个profiles能够在settings.xml和profiles.xml里定义：
　　repositories
　　pluginRepositories
　　properties
　　其他类型的profiles必须在pom.xml里定义（上面3个profiles也可以在pom.xml里定义）。
　　Pom.xml能够定义的profiles包括：
<repositories>
<pluginRepositories>
<dependencies>
<plugins>
<properties> (not actually available in the main POM, but used behind the scenes)
<modules>
<reporting>
<dependencyManagement>
<distributionManagement>
a subset of the <build> element, which consists of:
<defaultGoal>
<resources>
<testResources>
<finalName>
　　激活Profiles
　　激活profiles有下列几种方式：
Explicitly
Through Maven settings
Based on environment variables
OS settings
Present or missing files
　　1）通过mvn命令的-P参数来显示激活profiles，该参数值是profile id list（之间用逗号连接）。如：
　　mvn groupId:artifactId:goal -P profileId-1,profileId-2
　　2）　　　　　　　　　　　　通过在settings.xml里设置<activeProfiles> element来激活（当然<profiles>也必须在settings.xml里定义）
<settings>
...
　　　　　<profiles>
<profile>
　　<id>profile1</id>
　 ...
</profile>
　　　　　</profiles>
　　
<activeProfiles>
　　<activeProfile>profile-1</activeProfile>
</activeProfiles>
...
</settings>
　　列在<activeProfiles>里的profiles list会在每一个project执行时被激活
　　3）Profiles还可以基于detect到的build environment 的state来自动激活，而不需要象上面2种方式显式激活。这只需要在profile定义时使用<activation> element。如：
<profiles>
<profile>
　　<activation>
　　　<jdk>1.4</jdk>
　　</activation>
　　...
</profile>
</profiles>
　　上面的代码表示：如果JDK version start with 1.4 （eg. "1.4.0_08", "1.4.2_07", "1.4"），该profile会被激活
<profiles>
<profile>
　　<activation>
　　　<property>
　　　　<name>debug</name>
　　　</property>
　　</activation>
　　...
</profile>
</profiles>
　　上面的代码表示：如果存在system propertie “debug”，该profile会被激活。为了激活它，输入的命令类似于：
　　mvn groupId:artifactId:goal –Ddebug
<profiles>
<profile>
　　<activation>
　　　<property>
　　　　<name>environment</name>
　　　　<value>test</value>
　　　</property>
　　</activation>
　　...
</profile>
</profiles>
　　上面的代码表示：如果存在system propertie “environment”的值为test，该profile会被激活。为了激活它，输入的命令类似于：
mvn groupId:artifactId:goal -Denvironment=test
　　4）Profiles还可以基于OS setting来自动激活
<profiles>
<profile>
　　<activation>
　　　<os>
　　　<name>Windows XP</name>
　　　<family>Windows</family>
　　　<arch>x86</arch>
　　　<version>5.1.2600</version>
　　</os>
　　　　</activation>
...
</profile>
</profiles>
　　上面的代码表示：如果OS为windows xp，该profile会被激活
　　5）根据某个file不存在而激活profile。例如下面定义的profile是在target/generated-sources/axistools/wsdl2java/org/apache/maven不存在时激活
<profiles>
<profile>
　　<activation>
　　　<file>
　　　　<missing>target/generated-sources/axistools/wsdl2java/org/apache/maven</missing>
　　　</file>
　　</activation>
　　...
</profile>
</profiles>
　　使用Profiles时要注意的2个问题
　　第一、external properties
　　不是定义在pom.xml里的properties都称为external properties。举例说明最明了：
　　pom.xml：
<project>
...
<build>
　　<plugins>
　　　<plugin>
　　　　<groupId>org.myco.plugins</groupId>
　　　　<artifactId>spiffy-integrationTest-plugin</artifactId>
　　　　<version>1.0</version>
　　　　<configuration>
　　　　　<appserverHome>${appserver.home}</appserverHome>
　　　　</configuration>
　　　</plugin>
　　　...
　　</plugins>
</build>
...
</project>
　　
~/.m2/settings.xml
<settings>
...
<profiles>
　　<profile>
　　　<id>appserverConfig</id>
　　　<properties>
　　　　<appserver.home>/path/to/appserver</appserver.home>
　　　</properties>
　　</profile>
</profiles>
　　
<activeProfiles>
　　<activeProfile>appserverConfig</activeProfile>
</activeProfiles>
...
</settings>
　　当你执行该pom时，运行正常。但如果another user执行时，则运行失败，因为无法解析${appserver.home}（这是由于该properties是定义在user级别的settings.xml）。
　　解决方法就是把该profile放到pom.xml里定义，但这样做的缺点是所有使用该profile的pom.xml每个都要定义一次该profile。
　　最好的解决方法是：Since Maven provides good support for project inheritance, it's possible to stick this sort of configuration in the pluginManagement section of a team-level POM or similar, and simply inherit the paths
　　第二、pom.xml里定义的profiles不符合激活条件
　　依然是举个例子：
　　pom.xml：
<project>
...
<profiles>
　　<profile>
　　　<id>appserverConfig-dev</id>
　　　<activation>
　　　　<property>
　　　　　<name>env</name>
　　　　　<value>dev</value>
　　　　</property>
　　　</activation>
　　　<properties>
　　　　<appserver.home>/path/to/dev/appserver</appserver.home>
　　　</properties>
　　</profile>
　　
　　<profile>
　　　<id>appserverConfig-dev-2</id>
　　　<activation>
　　　　<property>
　　　　　<name>env</name>
　　　　　<value>dev-2</value>
　　　　</property>
　　　</activation>
　　　<properties>
　　　　<appserver.home>/path/to/dev/appserver2</appserver.home>
　　　</properties>
　　</profile>
</profiles>
　　
<build>
　　<plugins>
　　　<plugin>
　　　　<groupId>org.myco.plugins</groupId>
　　　　<artifactId>spiffy-integrationTest-plugin</artifactId>
　　　　<version>1.0</version>
　　　　<configuration>
　　　　　<appserverHome>${appserver.home}</appserverHome>
　　　　</configuration>
　　　</plugin>
　　　...
　　</plugins>
</build>
...
</project>