Maven进阶宝典

时间:2023-03-10 06:47:52
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 其它公共库;如图:

Maven进阶宝典

       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.****.net/clj198606061111/article/details/52200928

在安装安装nexus如果出现这种情况:  

Maven进阶宝典

以管理员身份运行cmd.exe即可。

五、Maven安装

  安装教程:http://jingyan.baidu.com/article/4f7d5712a1306c1a21192746.html

六、settings.xml配置

   详细介绍地址:http://blog.****.net/u014527058/article/details/50906343

 <?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <proxies> </proxies> <servers> <!--用来实现热部署 -->
<server>
<id>tomcat7x</id>
<username>admin</username>
<password>admin</password>
</server>
<!--用来发布项目到nexus的相对应的发布目录下 ,这里的id要和eclipse中配置的一样-->
<server>
<id>user-release</id>
<username>deployment</username>
<password>deployment123</password>
</server>
<!--用来发布项目到nexus的相对应的快照目录下 ,这里的id要和eclipse中配置的一样-->
<server>
<id>user-snapshots</id>
<username>deployment</username>
<password>deployment123</password>
</server>
</servers> <mirrors> <mirror>
<id>public</id>
<mirrorOf>*</mirrorOf>
<name>Human Readable Name for this Mirror.</name>
<!--<url>http://repo.maven.apache.org/maven2/</url>-->
<url>http://maven私服ip地址:8081/nexus/content/groups/public/</url>
</mirror> </mirrors> <profiles> <profile>
<id>nexus</id>
<repositories>
<repository>
<id>central</id>
<url>http://central</url>
<releases><enabled>true</enabled></releases>
<snapshots><enabled>true</enabled><updatePolicy>always</updatePolicy></snapshots>
</repository>
</repositories>
<pluginRepositories>
<pluginRepository>
<id>central</id>
<url>http://central</url>
<releases><enabled>true</enabled></releases>
<snapshots><enabled>true</enabled></snapshots>
</pluginRepository>
</pluginRepositories>
</profile> <profile>
<id>jdk-1.7</id>
<activation>
<activeByDefault>true</activeByDefault>
<jdk>1.7</jdk>
</activation>
<properties>
<maven.compiler.source>1.7</maven.compiler.source>
<maven.compiler.target>1.7</maven.compiler.target>
<maven.compiler.compilerVersion>1.7</maven.compiler.compilerVersion>
</properties>
</profile> </profiles> <activeProfiles>
<activeProfile>nexus</activeProfile>
</activeProfiles>
</settings>

七、Maven工程的创建

   省略,这些在网上一搜一大堆,这里就不再啰嗦了。

   知识驿站(具体了解地址:http://blog.****.net/cnhk1225/article/details/51189467):

      maven中的仓库分为两种,snapshot快照仓库和release发布仓库。snapshot快照仓库用于保存开发过程中的不稳定版本,release正式仓库则是用来保存稳定的发行版本。定义一个组件/模块为快照版本,只需要在pom文件中在该模块的版本号后加上-SNAPSHOT即可(注意这里必须是大写)

八、pom.xml的配置

  一、插件配置详解地址:

      http://www.cnblogs.com/dennyzhangdd/p/5831112.html

  

 <?xml version="1.0"?>
<project
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>组织名</groupId>
<artifactId>父工程名</artifactId>
<version>版本号</version>
</parent>
<artifactId>子工程名</artifactId>
<packaging>war</packaging>
<dependencies> </dependencies>
<profiles>
<!-- 开发/测试环境,默认激活 -->
<profile>
<id>dev</id>
<properties>
<env>dev</env>
<tomcat.host>远程tomcat的地址</tomcat.host>
<tomcat.port>${tomcatPort}</tomcat.port>
<tomcat.username>admin</tomcat.username>
<tomcat.password>admin</tomcat.password>
</properties>
<activation>
<activeByDefault>true</activeByDefault><!--默认启用的是dev环境配置-->
</activation>
</profile>
<!-- 生产环境 -->
<profile>
<id>prod</id>
<properties>
<env>prod</env>
<tomcat.host>远程服务器ip地址</tomcat.host>
<tomcat.port>${tomcatPort}</tomcat.port>
<tomcat.username>admin</tomcat.username>
<tomcat.password>admin</tomcat.password>
</properties>
</profile>
<profile>
<id>qa</id>
<properties>
<env>qa</env>
<tomcat.host>远程服务器ip地址</tomcat.host>
<tomcat.port>${tomcatPort}</tomcat.port>
<tomcat.username>admin</tomcat.username>
<tomcat.password>admin</tomcat.password>
</properties>
</profile>
</profiles> <build>
<finalName>ucf-personal</finalName>
<plugins>
<!-- 用来支持maven自带的命令 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.1</version>
<configuration>
<source>1.7</source>
<target>1.7</target>
</configuration>
</plugin>
<!-- 用cargo插件来实现项目自动远程热部署 -->
<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>
</plugins>
<!-- 根据构建环境的改变(生产或测试)来获得相应的值 -->
<filters> <!-- 指定使用的 filter -->
<filter>src/main/resources/filter/${env}.properties</filter>
</filters>
<resources>
<resource> <!-- 配置需要被替换的资源文件路径, db.properties 应该在 src/main/resource 目录下 -->
<directory>src/main/resources</directory>
<filtering>true</filtering> <!-- 是否使用过滤器 -->
</resource>
</resources>
</build>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<distributionManagement>
<repository>
<id>releases</id>
<name>releases</name>
<url>http://远程服务器ip地址:8081/nexus/content/repositories/releases/</url>
</repository>
<snapshotRepository>
<id>snapshots</id>
<name>snapshots</name>
<url>http://远程服务器ip地址:8081/nexus/content/repositories/snapshots/</url>
</snapshotRepository>
</distributionManagement>
</project>

web.xml动态给变量赋值

1.在<profile><properties>标签中添加与web.xml中相对应的${cas.serverLoginUrl}的key作为标签,

 在里面赋值,如:<cas.serverLoginUrl>http://10.1.1.1</cas.serverLoginUrl>

 <profiles>
<profile>
<id>development</id>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
<properties>
<profiles.active>dev</profiles.active>
<mybatis.log>ERROR</mybatis.log>
<log.path>/opt/dev/</log.path>
<cas.serverLoginUrl>http://10.1.1.1</cas.serverLoginUrl>
<cas.serverName>http://10.1.1.1</cas.serverName>
<cas.serverUrlPrefix>http://10.1.1.1</cas.serverUrlPrefix>
</properties>
</profile>
</profiles>

2.在工程的pom.xml中,新增过滤web资源配置

 <plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>2.1.1</version>
<configuration>
<webResources>
<resource>
<directory>src/main/webapp</directory>
<filtering>true</filtering>
</resource>
</webResources>
</configuration>
</plugin>

3.在web.xml中用占位符替换

 <filter>
<filter-name>CASFilter</filter-name>
<filter-class>com.ezubo.global.om.web.filter.LoginFilter</filter-class>
<init-param>
<param-name>casServerLoginUrl</param-name>
<param-value>${cas.serverLoginUrl}</param-value>
</init-param>
<init-param>
<param-name>serverName</param-name>
<param-value>${cas.serverName}</param-value>
</init-param>
<init-param>
<param-name>noFilterUrl</param-name>
<param-value>*.js</param-value>
</init-param>
</filter>

 二、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文件夹即可。

 
   <build>
<plugins>
<plugin>
<groupId>com.github.wvengen</groupId>
<artifactId>proguard-maven-plugin</artifactId>
<version>2.0.7</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>proguard</goal>
</goals>
</execution>
</executions>
<configuration>
<attach>true</attach>
<attachArtifactClassifier>pg</attachArtifactClassifier>
<!-- attach 的作用是在 install 与 deploy 时将生成的 pg 文件也安装与部署 -->
<options> <!-- 详细配置方式参考 ProGuard 官方文档 -->
<!--<option>-dontobfuscate</option>-->
<option>-ignorewarnings</option> <!--忽略所有告警-->
<option>-dontshrink</option> <!--不做 shrink -->
<option>-dontoptimize</option> <!--不做 optimize -->
<option>-dontskipnonpubliclibraryclasses</option>
<option>-dontskipnonpubliclibraryclassmembers</option> <option>-repackageclasses com.ucfgroup.framework.web.app.pg</option>
<!--平行包结构(重构包层次),所有混淆的类放在 pg 包下--> <!-- 以下为 Keep,哪些内容保持不变,因为有一些内容混淆后(a,b,c)导致反射或按类名字符串相关的操作失效 --> <option>-keep class **.package-info</option>
<!--保持包注解类--> <option>-keepattributes Signature</option>
<!--JAXB NEED,具体原因不明,不加会导致 JAXB 出异常,如果不使用 JAXB 根据需要修改-->
<!-- Jaxb requires generics to be available to perform xml parsing and without this option ProGuard was not retaining that information after obfuscation. That was causing the exception above. --> <option>-keepattributes SourceFile,LineNumberTable,*Annotation*</option>
<!--保持源码名与行号(异常时有明确的栈信息),注解(默认会过滤掉所有注解,会影响框架的注解)--> <option>-keep class SSRuntimeEasyJava.** { *;}</option>
<!--保持 Bean 类,(由于很多框架会对 Bean 中的内容做反射处理,请根据自己的业务调整) --> </options>
<outjar>${project.build.finalName}-pg</outjar>
<libs>
<lib>${java.home}/lib/rt.jar</lib>
</libs> </configuration>
</plugin>
</plugins>
</build>


      研究过程出现的问题:

          如果没有<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.****.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配置多模块项目

    用项目层次的划分替代包层次的划分能给我们带来如下好处:

    1. 方便重用,如果你有一个新的swing项目需要用到app-dao和app-service,添加对它们的依赖即可,你不再需要去依赖一个WAR。而有些模块,如app-util,完全可以渐渐进化成公司的一份基础工具类库,供所有项目使用。这是模块化最重要的一个目的。
    2. 由于你现在划分了模块,每个模块的配置都在各自的pom.xml里,不用再到一个混乱的纷繁复杂的总的POM中寻找自己的配置。
    3. 如果你只是在app-dao上工作,你不再需要build整个项目,只要在app-dao目录运行mvn命令进行build即可,这样可以节省时间,尤其是当项目越来越复杂,build越来越耗时后。
    4. 某些模块,如app-util被所有人依赖,但你不想给所有人修改,现在你完全可以从这个项目结构出来,做成另外一个项目,svn只给特定的人访问,但仍提供jar给别人使用。
    5. 多模块的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>

遇到的错误:

cargo-maven2-plugin:1.4.9:redeploy failed: Failed to undeploy

原因:

是antiResourceLocking属性引起的,参考如下:http://*.com/questions/14873219/cannot-undeploy-a-web-app-completely-in-tomcat-7
修改context.xml文件<Context antiResourceLocking="true">

十三、Maven打包时通过命令向pom.xml中传多参数

Maven进阶宝典

如上图所说即可实现maven打包时传多个参数的需求