maven学习系列（五）- maven之setting.xml详解

2015/11/16


topic ：maven<基本命令,setting.xml,注意事项>


points: localResponsity,pluginGroups,server,mirror,profile,activeProfile


1 基本命令 
<1>mvn package,mvn install,mvn deploy的区别
mvn package 打包
mvn install 打包并安装到本地库
mvn deploy  打包并安装到远程库


常用
mvn compile 编译
mvn package Dmaven.test.skip=true 跳过测试编译


<2>例子
eg1 生成war包并部署到tomcat中
mvn -Pdev clean install -Dmaven.test.skip=true
cd beauty-api-web/target/
rm -rf beauty-api-web/*
unzip beauty-api-*.war -d beauty-api-web
rm -rf /data/local/beauty-api/webapps/ROOT/*
cp -r beauty-api-web/* /data/local/beauty-api/webapps/ROOT/


eg2 生成war包，并copy到相应目录
mvn clean install -Pdev -Dmaven.test.skip=true clean package
cd target
scp sogou-brandtask-*.jar root@*.*.*.*:/data/task/task_online/sogou-brandtask.jar


2 pom文件和setting.xml文件相关知识点
<1>localResponsity 本地仓库 
eg:<localRepository>E:/maven/repository</localRepository>


<2>pluginGroups 插件组，这个元素包含了一系列pluginGroup元素，每个又包含了一个groupId。
当一个plugin被使用，而它的groupId没有被提供的时候，pluginGroups列表将被搜索。
eg：<pluginGroups>
        <pluginGroup>org.mortbay.jetty</pluginGroup>
    </pluginGroups>
org.morbay.jetty:jetty-maven-plugin:run => mvn jetty:run

<3>mirrors 镜像
eg： <mirrors>
         <mirror>
             <id>planetmirror.com</id>
             <name>PlanetMirror Australia</name>
             <url>http://downloads.planetmirror.com/pub/maven2</url>
             <mirrorOf>central</mirrorOf>
         </mirror>
     </mirrors>


<4>server 服务器，仓库所在服务器的用户名，密码等相关信息


<5>distributionManagement 分发器，包含多种仓库，一般包含napShot和release仓库


<6>profiles,包括repositories，pluginRespositories,properties,activation
<<1 activation 激活，如果所有指定的条件都达到了，那么，activation就被触发，而且不需要一次性全部达到
  <profiles>
         <profile>
            <id>test</id>
            <activation>
                 <activeByDefault>false</activeByDefault>
                 <jdk>1.5</jdk>
                 <os>
                     <name>Windows XP</name>
                     <family>Windows</family>
                     <arch>x86</arch>
                     <version>5.1.2600</version>
                 </os>
                 <property>
                     <name>mavenVersion</name>
                     <value>2.0.3</value>
                 </property>
                 <file>
                     <exists>${basedir}/file2.properties</exists>
                     <missing>${basedir}/file1.properties</missing>
                 </file>
             </activation>
             ...
         </profile>
     </profiles>
当以上条件全部达到时，激活test


<<2 properties 属性
eg：<profiles>
         <profile>
             ...
             <properties>
                 <user.install>${user.home}/our-project</user.install>
             </properties>
             ...
         </profile>
     </profiles>
#如果这个profile被激活，那么属性${user.install}就可以被访问了，profiles中的profile
#需要激活才能使用，可以通过activation 或者 -p 显示的激活 
 
<<3 repositories 仓库是Maven用来构筑构建系统的本地仓库的远程项目集合。它来自于被Maven叫做插件和依赖的本地仓库。
不同的远程仓库包含不同的项目，当profile被激活，他们就会需找匹配的release或者snapshot构件。
eg：<profiles>
         <profile>
         ...
         <repositories>
             <repository>
                 <id>codehausSnapshots</id>
                 <name>Codehaus Snapshots</name>
                 <releases>
                     <enabled>false</enabled>
                     <updatePolicy>always</updatePolicy>
                     <checksumPolicy>warn</checksumPolicy>
                 </releases>
                 <snapshots>
                     <enabled>true</enabled>
                     <updatePolicy>never</updatePolicy>
                     <checksumPolicy>fail</checksumPolicy>
                 </snapshots>
                 <url>http://snapshots.maven.codehaus.org/maven2</url>
                 <layout>default</layout>
             </repository>
         </repositories>
         <pluginRepositories>
         ...
         </pluginRepositories>
         ...
         </profile>
     </profiles>
 
<<4 plugin repositorie插件仓库，仓库包含了两种重要类型的构件。第一种是用来做其他构件依赖的构件，这是在中央仓库中的大多数插件。
另外一种类型的构件就是插件pluginRepository元素指向一个可以找到新插件的远程地址。
<<5 Active Profiles被激活的profiles
eg:<activeProfiles>
       <activeProfile>env-test</activeProfile>
   </activeProfiles>


3 注意事项
<1>maven中snapShot和release的区别
<<1 maven中的仓库分为两种，snapshot快照仓库和release发布仓库。snapshot快照仓库用于保存开发过程中的不稳定版本，
release正式仓库则是用来保存稳定的发行版本。定义一个组件/模块为快照版本，只需要在pom文件中在该模块的版本号后加上-SNAPSHOT即可(必须大写)
<<2 快照版本mvn deploy时会自动发布到快照版本库中，在不更改版本号的情况下，直接编译打包时，
maven会自动从镜像服务器上下载最新的快照版本。如果是正式发布版本，那么在mvn deploy时会自动发布到正式版本库中，
而使用正式版本的模块，在不更改版本号的情况下，编译打包时如果本地已经存在该版本的模块则不会主动去镜像服务器上下载


<2>settings.xml存在于两个地方：
1.安装的地方：$M2_HOME/conf/settings.xml
2.用户的目录：${user.home}/.m2/settings.xml
前者又被叫做全局配置，后者被称为用户配置。如果两者都存在，它们的内容将被合并，并且用户范围的settings.xml优先


<3>当setting.xml中的profile被激活时，会覆盖pom中相同id的profile的配置信息


<4>maven2中snapshot快照库和release发布库的应用
pom.xml
<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>cc.mzone</groupId>
    <artifactId>myjar</artifactId>
    <version>${project.release.version}</version>
    <packaging>jar</packaging>
 
    <distributionManagement>
        <repository>
   <id>mzone-release</id>
   <url>http://192.168.1.88/nexus/content/repositories/mzone-release</url>
        </repository>
        <snapshotRepository>
   <id>mzone-snapshot</id>
   <url>http://192.168.1.88/nexus/content/repositories/mzone-snapshot</url>
        </snapshotRepository>
    </distributionManagement>
 
    <properties>
        <project.release.version>0.1-SNAPSHOT</project.release.version>
    </properties>
 
    <profiles>
        <profile>
            <id>product</id>
   <properties>
         <project.release.version>0.1</project.release.version>
   </properties>
        </profile>
    </profiles>
</project>
setting.xml
<servers>
    <server>
        <id>mzone-release</id>
        <username>deployment</username>
        <password>deployment</password>
    </server>
    <server>
        <id>mzone-snapshot</id>
        <username>deployment</username>
        <password>deployment</password>
    </server>
</servers>
1、如果在发布时使用mvn deploy -P product的命令，那么会自动使用0.1作为发布版本，那么根据maven处理snapshot和release的规则，
   由于版本号后不带-SNAPSHOT故当成是正式发布版本，会被发布到release仓库；
2、如果发布时使用mvn deploy命令，那么就会使用默认的版本号0.1-SNAPSHOT，此时maven会认为是快照版本，会自动发布到快照版本库。
3、在distributionManagement段中配置的是snapshot快照库和release发布库的地址，采用nexus作为镜像服务器,服务器的账号和密码存
   放在server中。
   
5 maven缓存问题。
有时候由于maven项目无法更新，可以删除.repository缓存文件