maven

总结分为6个部分

• maven概述
• maven安装
• maven项目结构和创建方法
• maven配置文件settings.xml
• 项目对象文件pom.xml解析
• eclipse插件安装

一、maven概述

要用java实现一个后台系统，可能需要涉及很多模块。

web应用服务器、文件服务器、db 等等。 我们要开发这些模块，需要先把他们各自需要依赖的jar包或者项目下载打包好，然后配置到项目的classpath中。

这些应用在运行单元测试pr编译or部署的时候，需要依赖本地的一些配置，比如jdk、web容器等，这样我们将项目分享出去的时候，别人要使用就有一定的配置门槛。

maven可以帮我们完成上述所有的工作，不用我们再手工去完成。、

maven将项目看做一个对象。

maven建立了一个仓库体系，来管理这些项目对象。

maven的仓库分为本地仓库和远程仓库(maven提供的中央仓库)。

我们可以通过maven的命令把自己的项目a放到本地仓库中，如果其他项目b需要依赖项目a，则可以直接在本地仓库中找到。

如果我们的项目依赖一些别人的项目，比如jdbc、mybatis，maven会先根据我们的项目属性在本地仓库中去找，若找不到就去中央仓库中去找。

如下图，箭头表示依赖关系。

maven项目对象的部分基础属性：

① 项目坐标

    项目坐标用来定位一个项目在仓库中的位置。当项目b依赖项目a或者jdbc时，maven会根据项目坐标属性去从仓库体系中寻找项目，并自动配置到项目依赖中。

② 打包方式。

    这个属性决定我们执行maven的package方法后，项目会被打包成什么文件。

③ 项目依赖列表。

　这个属性的值是一个数组，里边有一些其他项目的坐标。

④ 构建插件列表。

    这个属性是一个数组，定义项目需要的一些插件，比如源码打包工具、web容器

还有一些属性在后边介绍。

 

maven项目对象的部分方法：

①mvn compile  编译项目

②mvn package 打包项目

③mvn clean 清除之前编译和打包产生的文件

④mvn install  将项目安装到本地仓库

⑤mvn test 运行测试代码

 

二、maven的安装

① 访问http://maven.apache.org/download.html 下载最新版本

② 解压到maven工作目录，比如d盘根目录

③ 配置maven环境变量

 MAVEN_HOME : D:\apache-maven-3.0.2 
  MAVEN : %MAVEN_HOME%\bin 
  在path 前面 加上 %MAVEN%; 

④ 打开cmd敲 mvn -version， 回车。

    如看到下面信息表示安装成功： 
   

 

三、maven项目结构和项目创建方法

　项目结构：

 

一级目录src为源码目录

　　二级目录main/java为项目主要代码目录

　　　　三级目录就是项目的source目录了

　　二级目录test/java为项目测试代码目录

　　　　三级目录   测试代码source目录

一级目录 编译、打包产生的文件的存放目录

pom.xml文件——项目对象描述文件，前边讲的项目对象的属性和方法配置就在这个文件里边

 　　maven项目创建方法

  ① 打开cmd，切换到工作目录，运行

　　

　　首次运行这个命令maven会下载一大堆依赖的文件，这个不用管。

 ②  填写quickstart参数

　　

　　按回车，这样就成功的创建了一个maven项目。

　　我们填写的几个参数：

　　groupId是帮助项目对象在仓库中定位的

　　artifactId决定了生成的项目文件夹目录的名称

　　version是项目版本号

　　package 是项目source文件下最顶层的包名

③ 项目创建成功

　

 

④ 也可以把命令一次敲完 

 

 

四、maven配置文件settings.xml

　　在使用maven的时候和仓库相关的一些配置用到了这个文件，所以在这里想讲一讲这个文件。位置：maven\conf\settings.xml。

 

　　① 修改本地仓库位置

　　maven默认本地仓库的位置是  用户\.m2  目录 。这个目录在C盘下，和我们的工作区是分开的，不方便管理。另外，如果系统出现啥问题，C盘格式化了，我们的文件就找不回来了。

　　<localRepository>D:/java/maven_repo</localRepository>

　　修改这个属性，即可修改本地仓库的位置。

 　  修改了settings.xml后最好在本地仓库里边复制一份，避免maven重装后配置文件丢失

 

　　② 配置maven中央仓库位置

　　由于祖国很墙，有时候访问中央仓库网速会特别慢或者干脆不可用，所有我们要配置一个maven中央仓库在国内的镜像服务器。

　　我使用的是oschina提供的镜像服务器，项目比较全速度也挺快。

<mirrors>    <mirror>        <id>nexus-osc</id>        <mirrorOf>central</mirrorOf>        <name>Nexus osc</name>        <url>http://maven.oschina.net/content/groups/public/</url>    </mirror></mirrors>    

 

五、maven项目对象配置文件  pom.xml 解析

  pom.xml是maven项目比较核心的一个文件，所以这部分的内容可以算是重头了。我还是按照描述一个对象的方式来描述这个文件吧。

　①  pom.xml 对象

<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/xsd/maven-4.0.0.xsd">    <!-- 指定了当前POM的版本 -->    <modelVersion>4.0.0</modelVersion></project>

 

　　这个是pom.xml的壳子，我姑且把它叫做pom对象吧

  ② 坐标属性

　　如果我们认为maven仓库是一个空间，那么坐标属性就是项目在这个空间内的 x、y、z 坐标(刚好决定坐标的标签有三个，这么比喻很合适啊:) )。

<groupId>com.sogou.hi</groupId><!-- 反写的公司网址+项目名 --><artifactId>hi</artifactId><!-- 一般是项目名+模块名  如 mcloud.db --><version>0.0.1-SNAPSHOT</version><!-- 大版本号.分支版本号.小版本号  snapshot 快照  alpha内测  beta公测  release稳定版  GA正式发布版本 -->

　　任何时候要找到一个项目，只需要有这三个属性就可以了

 

 ③ 项目依赖列表属性

　　概述中说过，这个属性是一个数组，那么在xml文件中的表现形式就是下面这样的：

  <dependencies>    <dependency>      <groupId>junit</groupId>      <artifactId>junit</artifactId>      <version>3.8.1</version>    </dependency>     <dependency>      <groupId>com.sogou.ml</groupId>      <artifactId>ml-b</artifactId>      <version>0.0.1-SNAPSHOT</version>    </dependency>  </dependencies>

　这个依赖列表属性表明，该项目依赖了两个项目 junit和ml-b 。项目依赖还有一些其他的属性，真正用的时候是下面这样的：  

  <dependencies>    <dependency>      <groupId>junit</groupId>      <artifactId>junit</artifactId>      <version>3.8.1</version>      <scope>test</scope><!-- scope 属性决定该依赖项目在什么阶段，test表示该项目只在测试代码中依赖 具体见  http://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Dependency_Scope -->    </dependency>     <dependency>      <groupId>com.sogou.ml</groupId>      <artifactId>ml-b</artifactId>      <version>0.0.1-SNAPSHOT</version>      <exclusions> <!-- 排除传递关系的依赖。 例如 ml-c 依赖 ml-b，ml-b依赖 ml-a ，那么我们会发现maven让ml-c同时依赖了a和b，通过这个属性可以排除c对a的依赖 -->          <exclusion>              <groupId>com.sogou.ml</groupId>              <artifactId>ml-a</artifactId>          </exclusion>      </exclusions>    </dependency>  </dependencies>

④ 构建过程中使用插件的属性

　这个配置会让我们的项目在运行 mvn package打包的同时将源码也打包，原本target目录下只会出现 xxx.jar ，现在还会出现一个 xxx-source.jar

    <!-- 为项目构建行为提供相应支持 -->    <build>        <!-- 插件列表 -->        <plugins>            <!-- 打包源码插件 -->            <plugin>                <!-- 插件项目坐标 -->                <groupId>org.apache.maven.plugins</groupId>                <artifactId>maven-source-plugin</artifactId>                <version>2.4</version>                <!-- 在什么阶段执行 -->                <executions>                    <execution>                        <phase>package</phase>                        <goals>                            <goal>jar-no-fork</goal>                        </goals>                    </execution>                </executions>            </plugin>        </plugins>    </build>

下面这个配置可以让项目打包完成后开始运行web容器，若是web项目就可以在浏览器中访问站点了。

 

<plugins>        <plugin>               <!-- <groupId>org.mortbay.jetty</groupId>               <artifactId>jetty-maven-plugin</artifactId>               <version>8.1.15.v20140411</version>-->               <groupId>org.apache.tomcat.maven</groupId>              <artifactId>tomcat7-maven-plugin</artifactId>              <version>2.2</version>               <executions>                   <!-- 打包成功后即开始运行web容器 -->                   <execution>                       <phase>package</phase>                       <goals>                           <goal>                               run                           </goal>                       </goals>                   </execution>               </executions>        </plugin>    </plugins>

 

 ⑤ 项目聚合属性

　　假如我们有好几个项目，需要一起编译打包，挨个打包很麻烦，这个时候我们就可以用聚合属性。

<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/xsd/maven-4.0.0.xsd">  <modelVersion>4.0.0</modelVersion>  <groupId>com.sogou.ml</groupId>  <artifactId>ml-all</artifactId>  <version>0.0.1-SNAPSHOT</version>  <packaging>pom</packaging>  <name>ml-all</name>  <url>http://maven.apache.org</url>  <modules>      <module>          ../ml-a      </module>      <module>          ../ml-b      </module>      <module>          ../ml-c      </module>  </modules>  <properties>    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>  </properties></project>

　　新建一个pom文件，将packaging打包方式修改为pom。

　　添加modules属性，这个属性也是一个数组，里边有一些项目文件夹的路径，编译打包这个pom项目的时候，会将modules里边的项目都编译打包。

⑥ 父子项目属性

　　新建一个新的maven项目，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/xsd/maven-4.0.0.xsd">  <modelVersion>4.0.0</modelVersion>  <groupId>com.sogou.ml</groupId>  <artifactId>ml-parent</artifactId>  <version>0.0.1-SNAPSHOT</version>  <packaging>pom</packaging>  <name>ml-parent</name>  <url>http://maven.apache.org</url>  <properties>    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>    <junit.version>3.8.1</junit.version>  </properties><dependencyManagement> <dependencies>    <dependency>      <groupId>junit</groupId>      <artifactId>junit</artifactId>      <version>${junit.version}</version>      <scope>test</scope>    </dependency>  </dependencies></dependencyManagement> </project>

 

　　打包方式同样的修改为pom。添加<dependencyManagement>节点，这个节点下是项目依赖属性。

　　在此节点下的依赖项目并不会在本项目中生效，但是可以在子项目的依赖中指定依赖，子项目配置如下：

  <parent>      <groupId>com.sogou.ml</groupId>    <artifactId>ml-parent</artifactId>    <version>0.0.1-SNAPSHOT</version>  </parent>  <dependencies>    <dependency>      <groupId>junit</groupId>      <artifactId>junit</artifactId>    </dependency>  </dependencies>

　　这样就可以让子项目依赖在父项目中配置的项目了

六、为eclipse安装maven插件

　若我们使用的eclipse中米有maven插件，可以自己下载安装一个。

　   http://download.csdn.net/detail/cnclenovo/5181671

　　下载后解压到  eclipse\dropins 目录下即可。

　　打开Windows-preference 看到maven说明安装成功。

　　

　　 现在我们创建maven项目、编译打包等操作，都可以用eclipse插件来完成了。