Maven使用小结

??（1）创建一个maven项目
??mvn archetype:create
??-DgroupId=org.sonatype.mavenbook.ch03
??-DartifactId=simple
??-DpackageName=org.sonatype.mavenbook

?

??相关解释说明
??mvn archetype:create? 通过archetype插件快速创建一个项目
??-Dname=value ?这样的对是将会被传到目标中的参数,java用来设置系统属性的方式
??artifactId ???????? 项目的基础目录(simple)
??simple项目下的pom.xml文件 描述了项目，配置了插件，声明了依赖
??src/main/java? ???????? java类文件
??src/main/resources??classpath资源文件
??src/test/java? ????????? 测试java类文件
??src/test/resources?? ?测试classpath资源文件

?

??（2）构建并打包项目（在包含pom.xml文件下运行）
??mvn install ????
??运行后在target目录下生成simple-1.0-SNAPSHOT.jar文件（名称根据pom.xml文件配置得来）,
??并安装到我们的本地maven仓库。

??(3）maven的pom.xml文件说明：

<groupId>org.sonatype.maven.test</groupId><artifactId>simple</artifactId><version>1.0-SNAPSHOT</version><packaging>jar</packaging>

??? 以上四个元素是maven的坐标，唯一标识了一个项目。

<name>simple</name><url>http://maven.apache.org</url>

?? 以上二个元素是pom提供的描述性元素，给人提供可阅读的名字。

<dependencies> <dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>3.8.1</version><scope>test</scope></dependency></dependencies>

???<dependencies>元素定义了项目的相关依赖，
??<scope>元素为test,说明只有在运行compiler:testCompile和surefire:test时才会被加到classpath中。
??<scope>元素如果为provided,则依赖在编译的时候需要，但是不应该被捆绑在构建的输出中。
? ?????????????? 在开发web应用时很有用。
??maven支持传递性依赖，会隐式地把相关依赖间接依赖的包也加到项目中。

?

（4）验证程序是否工作（java -cp 指定类运行所依赖其他类的路径,多个依赖包用;隔开)
???? ?java -cp target/simple-1.0-SNAPSHOT.jar org.sonatype.maven.App

?

（5）-查看有效的(effective)pom,即maven真正运行根据的pom
???? ?mvn help:effective-pom (在项目的基础目录下simple运行）

?

（6）maven项目打包
??mvn package 运行到打包为止的所有阶段，包含以下一系列插件目标
??mvn resources:resources
???????? compiler:compile
??????? resources:testResources
??????? compiler:testCompile
??????? surefire:test
?????? ?jar:jar
????
（7）浏览maven中央仓库??
?????? ?http://repo2.maven.org/maven2
??maven仓库的目录存储格式
????? <groupId> / <artifactId> / <version> / <artifactId>-<version>.<packaging>

?

（8）生成站点文档和报告
????? ?mvn site?（生成文档目录在target/site目录下）

?

（9）查看相关依赖的groupId和artifactId
???? ??http://mvnrepository.com/ （搜索依赖可查看pom.xml文件中的依赖元素）

?

（10）浏览项目的相关依赖(打印出已解决依赖的列表）
??1.mvn dependency:resolve（在项目目录下执行）
??2.mvn dependency:tree??? (浏览项目的整个依赖树，包含间接依赖)

（11）执行单元测试
??????? ?mvn test??????
??1.忽略单元测试失败，需要设置Surefire的testFailureIgnore的属性为true

<build> <plugins>  <plugin>   <groupId>org.apache.maven.plugins</groupId>   <artifactId>maven-surefire-plugin</artifactId>   <configuration>     <testFailureIgnore>true<testFailureIgnore>   </configuration>  <plugin> </plugins></build>

?2.跳过单元测试,需要设置Surefire的skip的属性为true

<build> <plugins>  <plugin>   <groupId>org.apache.maven.plugins</groupId>   <artifactId>maven-surefire-plugin</artifactId>   <configuration>    <skip>true</skip>   </configuration>  </plugin> </plugins></build>

?

(12）创建Maven的Web应用(需指定archetypeArtifactId为maven-archetype-webapp,打包成war)
????? ?mvn archetype:create
?????? -DgroupId=org.sonatype.mavenbook.ch05
????? ?-DartifactId=simple-webapp
?????? -DpackageName=org.sonatype.mavenbook
????? ?-DarchetypeArtifactId=maven-archetype-webapp

??打包的War文件默认名称为<artifactId>-<version>.war
??如果定义了finalName，则包名为<finalName>.war.
??如：<finalName>simple-webapp</finalName>

?

（13）配置Maven Jetty插件
??? 1.在pom.xml文件中配置

 <build>  <finalName>simple-webapp</finalName>  <plugins>   <plugin>    <groupId>org.mortbay.jetty</groupId>    <artifactId>maven-jetty-plugin</artifactId>   </plugin>  </plugins>  </build>

? 2.启动Web项目(调用Jetty插件的run目标）
???mvn jetty:run
??启动完后就可以通过(http://localhost:8080/simple-webapp/)访问。

?

（14）Pom相关
??1.asm包（字节码操作）依赖包如果版本不一致，则项目会出问题。

??2.所有的pom文件都从超级pom继承，超级pom存放于
??{M2_HOME}\lib\maven-2.2.1-uber.jar\org\apache\maven\project

??3.查看项目的有效POM,超级POM和项目POM的合并(打印出XML文档)
??mvn help:effective-pom

??4.版本号格式（例：1.3.5, 1.3-beta-01)
??<主版本>.<次版本>.<增量版本>-<限定版本>

??5.pom的属性引用(${})
??例：${project.groupId}-${project.artifactId}
??maven提供了三个隐式的变量
??1.env 例:${env.PATH},暴露了操作系统,访问系统的环境变量
??2.project 例:${project.groupId},暴露了POM,访问POM的信息。
??3.settings 例:${settings.offline},暴露了Maven Settings的信息，
??引用settings.xml文件中offline元素的值。

?

（15）项目依赖的依赖范围
??1.compile(编译范围)，默认的范围，在所有的classpath中可用，同时也会被打包。
??2.provided(已提供范围)，只有在容器提供该依赖后才可使用，在编译时可用，但不会被打包。（例：Servlet Api)
??3.runtime(运行时范围)，只有在运行和测试系统时需要，编译时不需要。（例：JDBC驱动）
??4.test(测试范围），只有在测试编译和测试运行阶段可用，编译和运行时不需要。
??5.system(系统范围），与provided类似，必须显示的提供一个对于本地系统中JAR文件的路径。不推荐使用。

?

??6.使用依赖的多个版本
??(,) 不包含量词
??[,] 包含量词
??例：<version>[3.8,4.0]</version> 依赖于3.8-4.0之间的版本
??<version>[,3.8.1]</version> 依赖于<=3.8.1的版本

??7排除传递性依赖（配置exclusions元素）

<dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.16</version> <exclusions>  <exclusion>   <groupId>javax.mail</groupId>   <artifactId>mail</artifactId>  </exclusion>  <exclusion>   <groupId>javax.jms</groupId>   <artifactId>jms</artifactId>  </exclusion> </exclusions></dependency>

?

??8.统一依赖版本号
?? ?在子项目中引用依赖而不用显示的列出版本号（dependencyManagement元素),
??版本升级时不用手工的一个个修改依赖的pom.xml文件。

<dependencyManagement>  <dependencies>    <dependency>      <groupId>mysql</groupId>      <artifactId>mysql-connector-java</artifactId>      <version>5.1.2</version>    </dependency>  </dependencies></dependencyManagement>

??在子项目中引用依赖，不用指定版本号

<dependencies>  <dependency>   <groupId>mysql</groupId>   <artifactId>mysql-connector-java</artifactId>  </dependency></dependencies>

??如果子项目中指定了版本，将覆盖顶层POM的dependencyManagement元素的版本号。

?

??9.多模块项目管理
??将很多项目归类在一起，成为一个构建，打包类型总是POM.

<modules>  <module>sub-gooup-a</module>  <module>sub-gooup-b</module></modules>

?10.项目继承（当一个项目声明一个parent的时候，它从父项目的POM中继承信息）

<parent>  <groupId>com.training.killerapp</groupId>  <artifactId>a-parent</artifactId>  <version>1.0-SNAPSHOT</version></parent>

?

?(16).maven生命周期
??(1)清理生命周期(删除整个构建目录，target目录）
??mvn clean
??(2)默认生命周期阶段
??1.validate 验证项目是否正确
??2.generate-sources 生成所有需要包含在编译过程中的源代码
??3.process-sources 处理源代码，比如过滤一些值。
??4.generate-resources 生成所有需要包含在打包过程中的资源文件
??5.process-resources? 复制并处理资源文件至目标目录，准备打包
??6.compile 编译项目的源代码
??7.process-classes 后处理编译生成的文件，例如对Java类进行字节码增强
??8.generate-test-sources 生成所有包含在测试编译过程中的测试源码
??9.process-test-sources 处理测试源码，比如过滤一些值
??10.generate-test-resources 生成测试需要的资源文件
??11.process-test-resources 复制并处理测试资源文件至测试目标目录
??12.test-compile 编译测试源码至目标目录
??13.test 使用合适的单元测试框架运行测试。这些测试应该不需要代码被打包或发布
??14.prepare-package 在真正的打包之前，执行一些准备打包必要的操作。
???这通常会产生一个包的展开的处理过的版本
??15.package 将编译好的代码打包成可分发的格式 ，如JAR,WAR,或者EAR
??16.pre-integration-test 执行一些在集成测试运行之前需要的动作。如建立集成测试需要的环境
??17.integration-test 如果有必要的话，处理包并发布至集成测试可以运行的环境
??18.post-integration-test 执行一些在集成测试运行之后需要的动作。如清理集成测试环境
??19.verify 执行所有检查，验证包是有效的，符合质量规范
??20.install 安装包至本地仓库，以备本地的其它项目作为依赖使用
??21.deploy 复制最终的包至远程仓库，共享给其它开发人员和项目（通常和一次正式的发布相关）

?

(17).过滤资源，替换属性
??默认的Maven行为会跳过过滤，只是将资源复制到输出目录。需显示地配置资源过滤

<build><filters><filter>src/main/filters/default.properties</filter></filters><rosources><directory>src/main/resources</directory><filtering>true</filtering></resources></build>

?

?

(18).使用Maven Profile覆盖Compiler插件配置

<profiles><profile><id>production</id><build><plugins>  <plugin>    <inherited>true</inherited>    <groupId>org.apache.maven.plugins</groupId>    <artifactId>maven-compiler-plugin</artifactId>    <configuration>    <debug>false</debug>    <optimize>true</optimize>    </configuration>  </plugin>         </plugins></build></profile></profiles>

?? 1.profiles通常是pom.xml中最后一个元素
?? 2.每个profile必须要有一个id元素，通过传给Maven一个-P<profile_id>参数来调用profile.
?? 3.一个profile元素可以包含很多其它元素，只要这些元素可以出现在pom.xml文件的project元素下。
?? 4.mvn clean install -Pproduction -X (-X为开启调试输出）
????
(19).使用profile激活动态包含子模块

<profiles><profile>  <id>jdk16</id>  <activation>  <jdk>1.6</jdk>  </activation>  <modules>  <module>simple-script</module>  </modules></profile></profiles>

? 1.如果在jdk1.6下运行，则会构建simple-script项目，否则不会构建。
??2.activation元素列出了所有激活profile需要的条件。
??其它方式：通过属性缺失激活(!表示否定，当没有设置${environment.type}属性时被激活.

<activation><property><name>!environment.type</name></property></activation>

?3.如果大量使用Maven Profile，可将profile从POM文件中分离，
??使用一个单独文件，名字为profiles.xml,放到项目目录下（同pom.xml),格式为

<profiles><profile>...</profile></profiles>

?4.setting profile可以应用到所有使用到Maven构建的项目，可以在两个地方定义
??(1).~/.m2/settings.xml(特定用户)
??(2).${M2_HOME}/conf/settings.xml(全局)

??5.列出活动的profile
??mvn help:active-profiles

?

?(20).创建私服
??下载nexus(http://nexus.sonatype.org/downloads/)
??解压后运行目录下\bin\jsw\windows-x86-32\Nexus.bat,
??访问http://127.0.0.1:8081/nexus（默认admin,admin123)
??1.配置maven settings

<mirrors>    <mirror>  <id>Nexus</id>  <mirrorOf>central</mirrorOf>  <name>Nexus Public Mirror</name>  <url>http://localhost:8081/nexus/content/groups/public</url></mirror>     </mirrors>

?

2.或者

<profiles><profile><id>artifactory</id><repositories><repository><id>nexus</id><name>local nexus</name><url>http://localhost:8081/nexus/content/groups/public</url><layout>default</layout></repository></repositories><pluginRepositories><pluginRepository><id>nexus</id><name>local nexus</name><url>http://localhost:8081/nexus/content/groups/public</url><layout>default</layout></pluginRepository></pluginRepositories></profile></profiles><activeProfiles><activeProfile>artifactory</activeProfile></activeProfiles>

?3. 或者在项目pom.xml中加入

 <repositories><repository><id>nexus</id><name>local nexus</name><url>http://localhost:8081/nexus/content/groups/public</url></repository></repositories><pluginRepositories><pluginRepository><id>nexus</id><name>local nexus</name><url>http://localhost:8081/nexus/content/groups/public</url></pluginRepository></pluginRepositories>

? 配置后maven会从本地的nexus安装查阅（可在Public Repositories和Maven Central仓库中查到）
???
?（21）部署第三方构件到nexus?
???在nexus项目管理中
?? 找到Repositories，这里选择其中一个，例如3rd party，
?? 可以在下面看到一个Artifact Upload选项卡。
?? 打开在GAV Definition中选择GAV Parameters，在接下来的Group中选输入组织名，
?? Artifact项输入artifactId ,Packaging:这里选择jar，
?? 之后上传一个自定义的jar文件，
?? 点击Add Artifact,Upload Artifact(s),上传成功后，
?? 在上边的3rd party上单击右键——ReIndex,然后刷新下这个列表，
?? 就可以看到下边多了.index文件夹和我们刚才上传相关的文件夹。?