Maven的基本配置与使用

什么是Maven

Maven是基于项目对象模型(POM)，可以通过一小段描述信息来管理项目的构建，报告和文档的软件项目管理工具。
发文时，绝大多数开发人员都把 Ant 当作 Java 编程项目的标准构建工具。遗憾的是，Ant 的项目管理工具（作为 make的替代工具）不能满足绝大多数开发人员的需要。通过检查 Ant 构建文件，很难发现项目的相关性信息和其它信息（如开发人员/拥有者、版本或站点主页）。
Maven 除了以程序构建能力为特色之外，还提供 Ant 所缺少的高级项目管理工具。由于 Maven 的缺省构建规则有较高的可重用性，所以常常用两三行 Maven 构建脚本就可以构建简单的项目，而使用 Ant 则需要十几行。事实上，由于 Maven 的面向项目的方法，许多 Apache Jakarta 项目发文时使用 Maven，而且公司项目采用 Maven 的比例在持续增长。
Maven这个单词来自于意第绪语，意为知识的积累，最早在 Jakata Turbine项目中它开始被用来试图简化构建过程。当时有很多项目，它们的Ant build文件仅有细微的差别，而JAR文件都由CVS来维护。于是Maven创始者开始了Maven这个项目，该项目的清晰定义包括，一种很方便的发布项目信息的方式，以及一种在多个项目中共享JAR的方式。(摘录百度百科)
http://baike.baidu.com/view/336103.htm

安装Maven

Window
#检查JDK
echo %JAVA_HOME%
C:\Program Files\Java\jdk1.8.0_05
java -version
java version "1.8.0_05"
Java(TM) SE Runtime Environment (build 1.8.0_05-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.5-b02, mixed mode)
#环境变量
M2_HOME  E:\Java\apache-maven-3.2.1
Path %M2_HOME%\bin
#检查配置
mvn -v
Apache Maven 3.2.1 (ea8b2b07643dbb1b84b6d16e1f08391b666bc1e9; 2014-02-15T01:37:5
2+08:00)
Maven home: E:\Java\apache-maven-3.2.1
Java version: 1.8.0_05, vendor: Oracle Corporation
Java home: C:\Program Files\Java\jdk1.8.0_05\jre
Default locale: zh_CN, platform encoding: GBK
OS name: "windows 7", version: "6.1", arch: "amd64", family: "dos"

Liunx
#导入环境变量
$ export M2_HOME=/opt/apache-maven
$ export PATH=$PATH:$M2_HOME/bin
#检查配置
mvn -v
#修改仓库位置
conf\目录下的setting.xml文件，设置成自己创建的仓库路径

<!-- localRepository | The path to the local repository maven will use to store artifacts. | Default: ${user.home}/.m2/repository <localRepository>/path/to/local/repo</localRepository> -->

#配置http代理
如果网络有特殊限制。通过http代理连接，在conf\目录下的setting.xml文件配置proxy

Maven坐标

Maven坐标为各种构件引入了秩序，任务一个构件都必须明确定义自己的坐标，而一组Maven坐标是通过一些元素
   定义的，他们是 groupId,artifactId,version,packaging,classifier

<groupId>org.springframework</groupId>

<artifactId>spring-core</artifactId>

<packaging>jar</packaging>

<version>3.0.6.RELEASE</version>

groupId: 定义当前Maven项目隶属的实际项目。
        1：Maven项目和实际项目不一定是一对一的关系，比如SpringFramework这一实际项目，这是
             由于Maven中模块的概念，因为一个实际项目往往被划分成很多模块
        2：groupId不应该对应项目隶属的组织或公司。原因很简单，一个组织下会有很多实际项目
        3：groupId的表示方式与Java包名的表示方式类似，通常与域名反向一一对应
artifactId
        定义实际项目中的一个Maven项目（模块），推荐的做法是使用实际项目名称作为artifactId的前缀。
        这样做的好处是方便寻找实际构件，在默认情况下，Maven生成的构件，其文件名会以artifactId作为
        开头。如spring-core-3.0.6.RELEASE.jar 
version
        定义Maven项目当前所处的版本，如3.0.6.RELEASE
packaging  定义Maven项目的打包方式。
             1：打包方式通常与所生成构件的文件扩展名对应，如上例中的packaging为jar,最终的文件名为spring-core-3.0.6.RELEASE.jar
                而使用war打包方式的Maven项目，最终生成的构件会有一个.war文件，不过这不是绝对的。
             2：打包方式会影响构建的生命周期，比如jar打包和war打包使用不同的命令
             3：当不定义packaging的时候，Maven会使用默认值jar
classifier
            用来帮助定义构建输出的一些附属构件。附属构件与主构件对应，
            如上例中的主构件是spring-core-3.0.6.RELEASE.jar，该项目可能还会通过使用一些插件生成如
            spring-core-3.0.6.RELEASE-sources.jar，spring-core-3.0.6.RELEASE-doc.jar这样的附件构件,
            其中包含了Java源代码和文档，这时候，javadoc和sources就是这两个附属构件的classifier.
            这样附属也就拥有了自己唯一的坐标

上述5个元素中，groupId,artifactId,version是必须定义的，packaging是可可选的（默认为jar），而classifier是不能直接定义的。同时，项目构件的文件名是与坐标相对应的，一般的规则为artifactId-version[-classifier].packaging[-classifier]表示可选

创建Maven项目

#创建一个简单Maven项目
mvn archetype:generate
    -DgroupId=com.mycompany.app
    -DartifactId=my-app-simple
    -DarchetypeArtifactId=maven-archetype-quickstart
    -Dversion=1.0
#创建Maven的Web项目   
mvn archetype:create
    -DgroupId=packageName
    -DartifactId=webappName
    -DarchetypeArtifactId=maven-archetype-webapp
    -Dversion=1.0

#创建项目(命令行中构建的选择不能换行)
mvn archetype:create -DgroupId=com.homeinns.web -DartifactId=homeinns-web -DarchetypeArtifactId=maven-archetype-webapp -Dversion=1.0

#构建成eclipse项目
cd homeinns-web
mvn eclipse:eclipse

mvn archetype：create 创建Maven项目
mvn compile 编译源代码
mvn deploy 发布项目
mvn test-compile 编译测试源代码
mvn test 运行应用程序中的单元测试
mvn site 生成项目相关信息的网站
mvn dependency:tree 查看maven的依赖树结构
mvn clean 清除项目目录中的生成结果
mvn package 根据项目生成的jar
mvn install 在本地Repository中安装jar
mvn eclipse:eclipse 构建成eclipse工程
mvn eclipse:clean  清除eclipse结构
mvnjetty:run  启动jetty服务
mvntomcat:run 启动tomcat服务
mvn clean package -Dmaven.test.skip=true:清除以前的包后重新打包，跳过测试类
mvn dependency:copy-dependencies  导出项目依赖的jar包
mvn dependency:copy-dependencies -DoutputDirectory=lib 导出依赖的jar包到lib文件夹

导入eclipse工程

An internal error occurred during: "Updating Maven Project". Unsupported IClasspathEntry kind=4
http://stackoverflow.com/questions/10564684/how-to-fix-error-updating-maven-project-unsupported-iclasspathentry-kind-4
如果没有/src/main/java目录配置一下工程JDK目录

如果提示如下错误，设置下java的编译版本
Java compiler level does not match the version of the installed Java project facet.xxx Unknown Faceted Project Problem (Java Version Mismatch)

Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin: 2.3.2 :compile ( default -compile) on project oecp: Compilation failure

因为eclipse默认是运行在JRE上面的，maven的一些功能要求使用JDK,所以要在eclipse中的配置文件eclipse.ini中加入

-vm C:/Program Files/Java/jdk1.8.0_05/bin/javaw.exe

或者指定自己JDK

目录结构

src/main/java : java源文件存放位置
src/main/resource : resource资源位置
src/test/java : 测试代码源位置

对象模型(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">

  <modelVersion>4.0.0</modelVersion>

  <groupId>com.homeinns.web</groupId>

  <artifactId>homeinns-web</artifactId>

  <packaging>war</packaging>

  <version>1.0-SNAPSHOT</version>

  <name>homeinns-web Maven Webapp</name>

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

  <dependencies>

      <!--junit-->

      <dependency>

          <groupId>junit</groupId>

          <artifactId>junit</artifactId>

          <version>4.11</version>

          <scope>test</scope>

      </dependency>

  </dependencies>

  <build>

    <finalName>homeinns-web</finalName>

  </build>

</project>

junit依赖范围

<dependencies> 

        <dependency> 

                <groupId>junit</groupId> 

                 <artifactId>junit</artifactId> 

                  <version>3.8.1</version> 

                   <scope>test</scope> 

        </dependency> 

</dependencies>

注意：当依赖范围是test的时候，该依赖只会被加入到测试代码的classpath中，也就是说，对于项目主代码，
该依赖是没有任何作用的。JUnit是单元测试框架，只有在测试的时候才需要，因此使用该依赖范围

使用Jetty容器热部署

<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">

    <modelVersion>4.0.0</modelVersion>

    <groupId>com.homeinns.web</groupId>

    <artifactId>homeinns-web</artifactId>

    <packaging>war</packaging>

    <version>1.0</version>

    <name>homeinns-web Maven Webapp</name>

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

    <dependencies>

        <dependency>

            <groupId>junit</groupId>

            <artifactId>junit</artifactId>

            <version>3.8.1</version>

            <scope>test</scope>

        </dependency>



        <dependency>

            <groupId>org.mortbay.jetty</groupId>

            <artifactId>jsp-api-2.0</artifactId>

            <version>6.1.14</version>



        </dependency>

        <dependency>

            <groupId>tomcat</groupId>

            <artifactId>jasper-compiler-jdt</artifactId>

            <version>5.5.15</version>

        </dependency>

        <dependency>

            <groupId>tomcat</groupId>

            <artifactId>jasper-compiler</artifactId>

            <version>5.5.15</version>

        </dependency>

        <dependency>

            <groupId>tomcat</groupId>

            <artifactId>jasper-runtime</artifactId>

            <version>5.5.15</version>

        </dependency>

        <dependency>

            <groupId>org.mortbay.jetty</groupId>

            <artifactId>jsp-2.1</artifactId>

            <version>6.1.14</version>

            <scope>test</scope>

            <exclusions>

                <exclusion>

                    <groupId>org.mortbay.jetty</groupId>

                    <artifactId>jsp-api-2.1</artifactId>

                </exclusion>

                <exclusion>

                    <groupId>org.mortbay.jetty</groupId>

                    <artifactId>start</artifactId>

                </exclusion>

                <exclusion>

                    <groupId>org.mortbay.jetty</groupId>

                    <artifactId>jetty-annotations</artifactId>

                </exclusion>

            </exclusions>

        </dependency>

    </dependencies>

    <build>

        <finalName>homeinns-web</finalName>

        <plugins>

            <!-- jetty插件 -->

            <plugin>

                <groupId>org.mortbay.jetty</groupId>

                <artifactId>maven-jetty-plugin</artifactId>

                <version>6.1.10</version>

                <configuration>

                    <scanIntervalSeconds>10</scanIntervalSeconds>

                    <stopKey>foo</stopKey>

                    <stopPort>9999</stopPort>

                </configuration>

                <executions>

                    <execution>

                        <id>start-jetty</id>

                        <phase>pre-integration-test</phase>

                        <goals>

                            <goal>run</goal>

                        </goals>

                        <configuration>

                            <scanIntervalSeconds>0</scanIntervalSeconds>

                            <daemon>true</daemon>

                        </configuration>

                    </execution>

                    <execution>

                        <id>stop-jetty</id>

                        <phase>post-integration-test</phase>

                        <goals>

                            <goal>stop</goal>

                        </goals>

                    </execution>

                </executions>

            </plugin>

        </plugins>

    </build>

</project>

#启动Jetty
mvn jetty:run
#停止服务
CTRL+C

http://docs.codehaus.org/display/JETTY/Maven+Jetty+Plugin

Maven 中央仓库

http://search.maven.org/
http://mvnrepository.com/

Refer：
http://maven.apache.org/
http://www.yiibai.com/maven/
http://tangyanbo.iteye.com/blog/1503782
Building Java Projects with Maven
http://spring.io/guides/gs/maven