maven使用心得

转自 http://www.iteye.com/topic/1130715

1.配置环境变量：

MAVEN_HOME 
以及添加到path：%MAVEN_HOME%/bin 

2.maven安装目录：
bin：运行的脚本
Boot：maven3.0包含一个文件plexus-classworlds-2.2.3.jar ,是一个类加载器框架，maven使用这个作为自己的类加载器
conf：settings.xml
lib：依赖包

3.检查是否可以连接到maven的软件仓库：
ping repo1.maven.org

如果连接不到仓库，可以设置代理，检查代理以及指定的端口是否可以访问：
telnet 222.222.222.22 8080
telent ip地址 端口

然后配置：$MAVEN_HOME$/conf/settings.xml中添加代理。

4.maven的核心配置：POM.xml  project object model>项目对象模型 
用于描述项目如何构建，声明项目依赖等等。

POM文件主体结构：
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> 
        <groupId>com.renjie120</groupId>         <!-- 项目组 -->
        <artifactId>helloworld</artifactId>        <!-- 组里面的一个唯一信息 -->
        <version>1.0</version>         <!-- 版本 -->
        <name>lsq test</name>      <!-- 别名 -->
         
        <packing>jar</packing>    <!-- 打包生成的文件格式，例如jar，war等  -->
</project>

最重要的：groupId，artifactId，version

groupId：一般是公司名+项目名
artifactId：一般是项目名作为前缀，例如：spring-context,maven会生成以artifactId为前缀的jar包。

5.MAVEN的约定，把java代码都放在src/main/java目录下面。然后再里面才创建java程序包。

对代码进行编译：在代码根目录下面执行：mvn clean compile，就可以自动生成target目录了
实际是执行了这样三个插件任务：clean:clean,resources:resources,compile:compile

6.编写单元测试：
首先必须在POM中添加对junit的依赖：
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>   <!-- 这里的测试的包从网络地址可以访问：http://repo1.maven.org/maven2/ -->
      <vesion>4.7</version>  
      <scope>test</scope>    <!-- 这里的scope是指定为test，默认是compile -->
    </dependency>
  </dependencies>

然后在java同目录下面添加关于test的目录，以及test的代码：
package com.renjie120;

import static org.junit.Assert.assertEquals;
import org.junit.Test;

public class HelloWorldTest{
  @Test
  public void testT(){
    HelloWorld h = new HelloWorld();
    String r = h.t();
    assertEquals("hello world",r);
  }
}

最后，在test目录下面执行：mvn clean test即可，发现实际是执行了这几个任务：
clean:clean,resources:resources,compiler:compile,resources:testResources,compiler:testCompile

结果：执行了项目主资源处理，主代码编译，测试资源处理，测试代码编译这样的工作。是maven的生命周期。
在target目录下面生成了二进制文件，以及使用了surefire：test任务进行测试，surefire是maven的负责执行测试的插件，自动运行HelloWorldTest，输出测试报告结果到surefire-reports文件夹，里面显示进行多少个测试，出错多少，跳过多少，失败多少，等等。

7.打包和运行：
mvn install -DskipTests   //跳过测试进行打包。。

mvn clean package
会在打包执行执行编译，测试等操作。
jar:jar负责打包  生成结果在target/目录下面。

将我们的包放到maven仓库中，使用命令mvn clean install，这样其他的maven工程就可以引用我们的自定义包了!!
结果，发现我们的代码保存到了maven仓库下面去了！！

如何打包生成可以执行的jar？？
需要添加插件maven-shage-plugin：




8.根据一个骨架文件，在选择了目的文件夹之后，就可以进行新的一个工程的创建了： 
mvn archetype:generate  -B -DarchetypeGroupId=workflow -DarchetypeArtifactId=snda.archetype.sample -DgroupId=lishuiqing.test -DartifactId=lishuiqing.test.wf -Dpackage=com.renjie120.test -Dversion=1.0

-DgroupId= 是生成的mvn工程名   -DartifactId=文件夹名称   -Dpackage=代码的名字空间
-DarchetypeArtifactId：是参考的mvn工程名


mvn archetype:generate  -B -DarchetypeGroupId=workflow -DarchetypeArtifactId=snda.archetype.sample -DgroupId=hurray.contract -DartifactId=hurray.contract.discharge -Dpackage=hurray.contract.discharge -Dversion=1.0


9.下面是将一个jar包添加到仓库中！！结果是生成了一个com.lsq文件夹下面的lsq.ojdbc-1.0.jar的jar包！
mvn install:install-file -DgroupId=com.lsq -DartifactId=lsq.ojdbc -Dversion=1.0 -Dpackaging=jar -Dfile=E:\hvming\maven_test\ojdbc14.jar


mvn install:install-file -DgroupId=com.lsq -DartifactId=pingyin -Dversion=1.0 -Dpackaging=jar -Dfile=E:\hvming\workspace\mainOpec\classLoader\pinyin4j-2.5.0.jar

10.为了使用axis2的jar包来生成web service的客户端，使用maven的话，需要使用下面的依赖：
        <dependency>
                        <groupId>org.apache.axis2</groupId>
                        <artifactId>axis2</artifactId>
                        <version>1.5</version>
                </dependency>
                <dependency>
                        <groupId>org.apache.ws.commons.axiom</groupId>
                        <artifactId>axiom-dom</artifactId>
                        <version>1.2.11</version>
                </dependency>
                <dependency>
                        <groupId>org.apache.ws.commons.axiom</groupId>
                        <artifactId>axiom-api</artifactId>
                        <version>1.2.11</version>
                </dependency>
                <dependency>
                        <groupId>org.apache.ws.commons.axiom</groupId>
                        <artifactId>axiom-impl</artifactId>
                        <version>1.2.11</version>
                </dependency>
                <dependency>
                        <groupId>org.apache.xmlbeans</groupId>
                        <artifactId>xmlbeans</artifactId>
                        <version>2.3.0</version>
                </dependency> 
                <dependency>
                        <groupId>org.apache.axis2</groupId>
                        <artifactId>axis2-transport-local</artifactId>
                        <version>1.5</version>
                </dependency> 
                <dependency>
                        <groupId>org.apache.axis2</groupId>
                        <artifactId>axis2-transport-http</artifactId>
                        <version>1.5</version>
                </dependency>

 11.下载mvn jar包的时候，同时下载源码：
maven2在执行eclipse:eclipse，install等命令时，默认不下载sources包。
有两个方法可以获得所依赖包的源码包：
 
1、使用命令 mvn dependency:sources
2、增加参数 mvn eclipse:eclipse -DdownloadSources=true

12.将一个工程所依赖的jar包全部导出来，使用插件：
<build>
        <plugins>
                <plugin>
                        <artifactId>maven-assembly-plugin</artifactId>
                        <version>2.2-beta-5</version>
                        
                        <configuration>
                                <descriptorRefs>
                                        <descriptorRef>jar-with-dependencies</descriptorRef>
                                </descriptorRefs>
                        </configuration>
                </plugin>
        </plugins>
</build>

然后使用命令：“
mvn assembly:assembly -DskipTests

结果是在target文件夹下面生成一个新的jar包，包含了全部的依赖的jar包。

但是，上面会有一个问题，使用的jar包全部包含在了一个新的jar包-------这个jar包会很大，而且很杂。

区分开来各个软件的办法：
新建一个文件src\main\assembly\src.xml
内容如下：
<assembly
        xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.0http://maven.apache.org/xsd/assembly-1.1.0.xsd">
        <id>jar-with-dependencies</id>
        <formats>
                <format>jar</format>
        </formats>
        <includeBaseDirectory>false</includeBaseDirectory>
        <dependencySets>
                <dependencySet>
                        <unpack>false</unpack>
                        <scope>runtime</scope>
                </dependencySet>
        </dependencySets>
        <fileSets>
                <fileSet>
                        <directory>${project.build.outputDirectory}</directory>
                </fileSet>
        </fileSets>
</assembly>

并修改pom.xml中的插件部分为：
<build>
  <plugins>
    <plugin>
      <artifactId>maven-assembly-plugin</artifactId>
      <version>2.2-beta-5</version>

      <configuration>
        <descriptors>
          <descriptor>src/main/assembly/src.xml</descriptor>
        </descriptors>
      </configuration>
    </plugin>
  </plugins>
</build>

执行命令即可：mvn assembly:assembly -DskipTests