首页 > 代码库 > Maven进阶宝典
Maven进阶宝典
前言：
团队在开发过程中用的是maven项目，由于对maven的一些打包流程以及相关参数配置不是太了解，因此应大家的需求做一下maven的讲解，为了不误导大家，看了很多相关资料，自己也实验了一下，就把自己觉得对大家有用的东西列出来，做了一些简单的介绍，起到抛砖引玉的作用，希望能对大家能有帮助。
一、什么是maven
Maven是一个Java语言编写的开源项目管理工具，是Apache软件基金会的顶级项目。主要用于项目构建，依赖管理，项目信息管理。
二、Maven诞生的背景
Maven这个单词来自于意第绪语（犹太语），意为知识的积累，最初在Jakata Turbine项目中用来简化构建过程。当时有一些项目（有各自Ant build文件），仅有细微的差别，而JAR文件都由CVS来维护。于是希望有一种标准化的方式构建项目，一个清晰的方式定义项目的组成，一个容易的方式发布项目的信息，以及一种简单的方式在多个项目中共享JARs。
三、Maven特点
1. maven不仅是构建工具，它还是依赖管理工具和项目管理工具，提供了中央仓库，能够帮我们自动下载构件。
2.为了解决的依赖的增多，版本不一致，版本冲突，依赖臃肿等问题，它通过一个坐标系统来精确地定位每一个构件（artifact）。
3.还能帮助我们分散在各个角落的项目信息，包括项目描述，开发者列表，版本控制系统，许可证，缺陷管理系统地址。
4.maven还为全世界的java开发者提供了一个免费的中央仓库，在其中几乎可以找到任何的流行开源软件。通过衍生工具(Nexus),我们还能对其进行快速搜索
5.maven对于目录结构有要求，约定优于配置，用户在项目间切换就省去了学习成本。
6.跨平台，是声明式的，没有依赖管理。
四、Maven私服的搭建
一、为什么搭建Maven私服
有些公司都不提供外网给项目组人员，因此就不能使用maven访问远程的仓库地址，所以很有必要在局域网里找一台有外网权限的机器，搭建nexus私服，然后开发人员连到这台私服上，这样的话就可以通过这台搭建了nexus私服的电脑访问maven的远程仓库。
二、Maven仓库
Maven库：
http://repo2.maven.org/maven2/
Maven依赖查询：
http://mvnrepository.com/
maven的仓库只有两大类：1.本地仓库 2.远程仓库，在远程仓库中又分成了3种：2.1 中央仓库 2.2 私服 2.3 其它公共库；如图：
1.本地仓库
Maven在本地存储构件的地方。
2. 远程仓库
2.1 中央仓库
中央仓库是默认的远程仓库，maven在安装的时候，自带的就是中央仓库的配置。
2.2 私服
Maven私服的 个特性：
1.节省自己的外网带宽：减少重复请求造成的外网带宽消耗
2.加速Maven构件：如果项目配置了很多外部远程仓库的时候，构建速度就会大大降低
3.部署第三方构件：有些构件无法从外部仓库获得的时候，我们可以把这些构件部署到内部仓库(私服)中，供内部maven项目使用
4.提高稳定性，增强控制：Internet不稳定的时候，maven构建也会变的不稳定，一些私服软件还提供了其他的功能
5.降低中央仓库的负荷：maven中央仓库被请求的数量是巨大的，配置私服也可以大大降低中央仓库的压力
当前主流的maven私服：
1.Apache的Archiva
2.JFrog的Artifactory
3.Sonatype的Nexus
三、搭建Maven私服
详细介绍地址：http://www.cnblogs.com/quanyongan/archive/2013/04/24/3037589.html
http://blog.csdn.net/clj198606061111/article/details/52200928
在安装安装nexus如果出现这种情况：
以管理员身份运行cmd.exe即可。
五、Maven安装
安装教程：http://jingyan.baidu.com/article/4f7d5712a1306c1a21192746.html
六、settings.xml配置
详细介绍地址：http://blog.csdn.net/u014527058/article/details/50906343
View Code
七、Maven工程的创建
省略，这些在网上一搜一大堆，这里就不再啰嗦了。
知识驿站（具体了解地址：http://blog.csdn.net/cnhk1225/article/details/51189467）：
maven中的仓库分为两种，snapshot快照仓库和release发布仓库。snapshot快照仓库用于保存开发过程中的不稳定版本，release正式仓库则是用来保存稳定的发行版本。定义一个组件/模块为快照版本，只需要在pom文件中在该模块的版本号后加上-SNAPSHOT即可(注意这里必须是大写)
八、pom.xml的配置
一、插件配置详解地址：
http://www.cnblogs.com/dennyzhangdd/p/5831112.html
View Code
二、Jetty插件运行Maven Web工程
详细介绍地址：https://my.oschina.net/cokolin/blog/409164
1 <?xml version="1.0"?>
2 <plugin>
3 <groupId>org.mortbay.jetty</groupId>
4 <artifactId>jetty-maven-plugin</artifactId>
5 <version>8.1.16.v20140903</version>
6 <configuration>
7 <scanIntervalSeconds>5</scanIntervalSeconds>
8 <webApp>
9 <contextPath>/ucf-company</contextPath>
10 </webApp>
11 <connectors>
12 <connector implementation="org.eclipse.jetty.server.nio.SelectChannelConnector">
13 <port>9080</port>
14 </connector>
15 <connector implementation="org.eclipse.jetty.server.ssl.SslSelectChannelConnector">
16 <port>9443</port>
17 <password>changeit</password>
18 </connector>
19 <!-- 这两个connector的配置要改为： -->
20 <connector implementation="org.eclipse.jetty.server.bio.SocketConnector">
21 <port>8080</port>
22 </connector>
23 <connector implementation="org.eclipse.jetty.server.ssl.SslSocketConnector">
24 <port>8443</port>
25 <password>changeit</password>
26 </connector>
27 </connectors>
28 </configuration>
29 </plugin>
三、Maven混淆代码
Maven的proguard插件只能混淆jar包。如果要混淆Web项目则将Web混淆的工程jar的classes替换打的war包的classes文件夹即可。
View Code
研究过程出现的问题：
如果没有<injar></injar>会报如下错误信息：
1 [ERROR] Failed to execute goal com.github.wvengen:proguard-maven-plugin:2.0.7:proguard (default) on project ucf-company: Obfuscation failed (result=1) -> [Help 1]
2 [ERROR]
3 [ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
4 [ERROR] Re-run Maven using the -X switch to enable full debug logging.
5 [ERROR]
6 [ERROR] For more information about the errors and possible solutions, please read the following articles:
7 [ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
具体实现参照地址：
http://www.cnblogs.com/yanduanduan/p/5340060.html
http://blog.csdn.net/wltj920/article/details/48970869
四、Maven打包时动态替换properties资源文件中的配置值：
1 <profiles>
2 <!-- 开发/测试环境，默认激活 -->
3 <profile>
4 <id>dev</id>
5 <properties>
6 <env>dev</env>
7 </properties>
8 <activation>
9 <activeByDefault>true</activeByDefault>
10 <!--默认启用的是dev环境配置-->
11 </activation>
12 </profile>
13 <!-- 生产环境 -->
14 <profile>
15 <id>prod</id>
16 <properties>
17 <env>prod</env>
18 </properties>
19 </profile>
20 <!-- qa环境 -->
21 <profile>
22 <id>qa</id>
23 <properties>
24 <env>qa</env>
25 </properties>
26 </profile>
27 </profiles>
28 <build>
29 <filters>
30 <!-- 指定使用的 filter -->
31 <filter>src/main/resources/filter/${env}.properties</filter>
32 </filters>
33 <resources>
34 <resource>
35 <!-- 配置需要被替换的资源文件路径, db.properties 应该在 src/main/resource 目录下 -->
36 <directory>src/main/resources</directory>
37 <filtering>true</filtering>
38 <!-- 是否使用过滤器 -->
39 </resource>
40 </resources>
41 </build>
九、Maven配置多模块项目
用项目层次的划分替代包层次的划分能给我们带来如下好处：
- 方便重用，如果你有一个新的swing项目需要用到app-dao和app-service，添加对它们的依赖即可，你不再需要去依赖一个WAR。而有些模块，如app-util，完全可以渐渐进化成公司的一份基础工具类库，供所有项目使用。这是模块化最重要的一个目的。
- 由于你现在划分了模块，每个模块的配置都在各自的pom.xml里，不用再到一个混乱的纷繁复杂的总的POM中寻找自己的配置。
- 如果你只是在app-dao上工作，你不再需要build整个项目，只要在app-dao目录运行mvn命令进行build即可，这样可以节省时间，尤其是当项目越来越复杂，build越来越耗时后。
- 某些模块，如app-util被所有人依赖，但你不想给所有人修改，现在你完全可以从这个项目结构出来，做成另外一个项目，svn只给特定的人访问，但仍提供jar给别人使用。
- 多模块的Maven项目结构支持一些Maven的更有趣的特性（如DepencencyManagement），这留作以后讨论。
一个简单的Maven模块结构是这样的：
---- app-parent
|-- pom.xml (pom)
|
|-- app-util
| |-- pom.xml (jar)
|
|-- app-dao
| |-- pom.xml (jar)
|
|-- app-service
| |-- pom.xml (jar)
|
|-- app-web
|-- pom.xml (war)
创建Maven多模块项目参照地址：http://www.cnblogs.com/huboking/p/4351921.html
十、Maven常用命令
mvn help:system 自动在本用户下创建 ~/.m2/repository
mvn clean compile 清理编译
mvn clean test 清理测试
mvn clean package 清理打包
mvn clean install 清理将打包好的jar存入 本地仓库 注意是本地仓库
mvn archetype:generate 使用Archetype生成项目骨架
mvn clean deploy 根据pom中的配置信息将项目发布到远程仓库中
十一、Maven常见错误排查
一.Maven工程出现红差解决方法：
进行maven clean、update，然后进行工程clean、tomcat clean，如果还没有去掉则说明是工程代码有问题，不属于工程环境的问题。
二.Maven工程出现感叹号解决方法：
产生原因：
因为一些maven管理的jar没能正确下载。
先查看buildpath，找问题的jar包，之后再一个个解决
对这些有问题的jar，是因为当前的maven仓库无法找到，所以可以通过如下方法添加能找到相应jar的maven仓库：
1.在google中直接搜索相应jar，比如：jmxri-1.2.1.jar
2.在搜索结果中找到有这个jar的maven仓库，并加入到setting.xml中。
3.重新对项目进行 右键 - maven - update dependencies。
十二、cargo远程部署项目到tomcat
tomcat-users.xml,至少要添加manager,manager-gui,manager-script,manager-jmx,manager-status,添加权限
<tomcat-users> <role rolename="tomcat"/> <role rolename="role1"/> <role rolename="manager"/> <role rolename="admin"/> <role rolename="manager-gui"/> <role rolename="manager-script"/> <role rolename="manager-jmx"/> <role rolename="manager-status"/> <!--admin角色没有的要注意添上--> <user username="tomcat" password="tomcat" roles="tomcat"/> <user username="admin" password="admin" roles="admin,manager,tomcat,manager-gui,manager-script,manager-jmx,manager-status"/> <!--你用哪个用户做管理员，则需要分配相应的角色，我给admin用户分配了admin和manager连个角色--> </tomcat-users>
注意：当解压的项目已存在时，会部署不成功，需要在context.xml中再Context标签中加入antiResourceLocking="true" 就可以了。
新版无需修改maven的settings.xml文件，网上很多误导别人的
mvn cargo:redeploy
<!-- 远程部署 ,tomcat必须启动-->
<plugin>
<groupId>org.codehaus.cargo</groupId>
<artifactId>cargo-maven2-plugin</artifactId>
<version>1.4.9</version>
<configuration>
<container>
<containerId>tomcat7x</containerId>
<type>remote</type>
</container>
<configuration>
<type>runtime</type>
<properties>
<cargo.remote.uri>http://${tomcat.host}:${tomcat.port}/manager/text</cargo.remote.uri>
<cargo.remote.username>${tomcat.username}</cargo.remote.username>
<cargo.remote.password>${tomcat.password}</cargo.remote.password>
</properties>
</configuration>
</configuration>
</plugin>
Maven进阶宝典