一、环境准备

java环境, jdk 1.5 以上

MyEclipse集成工具,我装的是8.5 版本

二、快速安装及配置

下载apache-maven-3.*.*-bin.zip

解压后, 配置环境变量%MAVEN_HOME%\bin 即可完成安装,(MAVEN_HOME为解压包位置)

测试maven3是否已经安装,在dos上运行mvn -version,出现如下类似结果表示安装完成

java 构建maven项目 java中的maven项目_java maven 项目结构

2、修改仓库位置

2.1 win7系统默认的仓库路径是:C:\Users\用户名\.m2\repository 修改为:D:\Program Files\Maven\Repositories

2.2 修改\apache-maven-3.1.0\conf 下的setting.xml文件, 找到D:\Program Files\Maven\Repositories这一行,进行修改

2.3 打开命令提示符, 输入:mvn help:system, 该命令会打印出所有的java系统属性和环境变量

3、修改myeclipse内嵌maven为自己安装的版本

打开myEclipse,点击Window->Preferences

java 构建maven项目 java中的maven项目_jar_02

三、创建maven项目例子

1、新建项目, 点击File->Other 选择Java Maven Project

java 构建maven项目 java中的maven项目_java maven 项目结构_03

图1:new Maven Project

java 构建maven项目 java中的maven项目_jar_04

图2:ProjectName\ Group Id\Artifact Id

2、新建项目后, maven项目结构如下图

java 构建maven项目 java中的maven项目_java_05

说明:

1)pom.xml在项目的根目录下,打开pom.xml

2)pom.xml中, groupId artifactId和version,这3个元素定义了项目基本的坐标,

一般groupId跟创建的包关联(名称相同),如图所示; artifactId定义了当前Maven项目在组中唯一的ID

3)pom.xml自动添加了依赖,有了这个声明, Maven能够自动下载相应版本的junit.jar包,

如图,已经下载到了本地仓库C:\Users\${用户名}\.m2\repository\junit\junit\versionxx,打开该路径,可以看到junit-version.pom 和junit-version.jar

4)添加依赖中,元素定义依赖范围,当为test时候, 表示: import JUnit只能测试类中, 在主代码中引入, 会编译错误。

不声明依赖范围,默认值是compile,表示该依赖对主代码和测试代码都有效。

3、编写主代码(src/main/java下)并编译

比如,在com.jennifer.test下建HelloMaven.java

代码如下:

java 构建maven项目 java中的maven项目_java_06

使用Maven进行编译, 在项目根目录下运行命令: mvn clean compile

java 构建maven项目 java中的maven项目_java 构建maven项目_07

说明:

1)clean,告诉Maven清理输出目录 target/

2)compile告诉Maven编译项目主代码,编译后,在..\maventest2\target\classes的 \com\jennifer\test下生成了HelloMaven.class 文件

4、编写测试代码(src/test/java下)

如上2(3)所述, 已经添加了junit依赖,(默认创建项目后依赖的junit版本较低,改成4.8.1,此时,依赖的关联包会自动更新),

下面用junit编写测试类

java 构建maven项目 java中的maven项目_java maven 项目结构_08

编写完毕后, 调用Maven执行测试,运行 mvn clean test

java 构建maven项目 java中的maven项目_java_09

说明:

1)执行成功后, 在..\maventest2\target\test-classes的 \com\jennifer\test下生成了HelloMavenTest.class 文件

并且, target下面生成 surefire-reports,显示运行结果报告

2)若构建执行compiler:testCompile任务的时候失败了,Maven输出提示需要使用 -source5或更高版本以启动注释

修改配置文件, 使maven-compiler-plugin支持java5,如下:

java 构建maven项目 java中的maven项目_maven_10

5、打包

执行打包命令:mvn clean package

java 构建maven项目 java中的maven项目_maven_11

说明:

1)执行打包命令,jar插件的jar目标将项目主代码打包成一个名为hello-0.0.1-SNAPSHOT.jar,该文件位于target/  输出目录中

默认命令规则:artifact-version.jar

2)将该 .jar文件拷贝下来, 导入到其他项目中, 就可以调用里面的类和提供的方法

3)直接在其他Maven引用的话, 执行安装步骤:mvn clean install, 就会安装到本地仓库中, 同样在repository仓库文件夹里,生成该项目的.pom .jar文件(类似前面下载的junit)

java 构建maven项目 java中的maven项目_jar_12

6、运行

前面默认打包生成的jar不能够直接运行, 因为带有main方法的类信息不回添加到mainfest中,需要再配置插件

java 构建maven项目 java中的maven项目_java maven 项目结构_13

再重新执行 mvn clean install

回再生成一份新的带有Main-Class信息的.jar文件,前面生成的被重命名为original-hello-0.0.1-SNAPSHOT.jar

在项目根目录中执行该jar文件

java 构建maven项目 java中的maven项目_java 构建maven项目_14

四、maven与其他常用插件结合使用

上述中, 就有提到maven里面配置junit插件, 用来完成单元测试, 实际上,maven项目很容易跟其他插件结合起来使用

比如javadoc, 代码覆盖测量工具Cobertura等

1、javadoc配置如下:

java 构建maven项目 java中的maven项目_jar_15

配置javadoc后, 执行 mvn javadoc:javadoc 命令, 就会在..\target\site\apidocs目录下生成 apidocs信息

2、Cobertura配置如下:

java 构建maven项目 java中的maven项目_jar_16

配置Cobertura后, 执行 mvn cobertura:cobertura 命令, 就会在..\target\site\cobertura目录下,生成测试代码覆盖主代码情况信息。