一、环境准备
java环境, jdk 1.5 以上
MyEclipse集成工具,我装的是8.5 版本
二、快速安装及配置
下载apache-maven-3.*.*-bin.zip
解压后, 配置环境变量%MAVEN_HOME%\bin 即可完成安装,(MAVEN_HOME为解压包位置)
测试maven3是否已经安装,在dos上运行mvn -version,出现如下类似结果表示安装完成
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
三、创建maven项目例子
1、新建项目, 点击File->Other 选择Java Maven Project
图1:new Maven Project
图2:ProjectName\ Group Id\Artifact Id
2、新建项目后, maven项目结构如下图
说明:
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
代码如下:
使用Maven进行编译, 在项目根目录下运行命令: mvn clean compile
说明:
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编写测试类
编写完毕后, 调用Maven执行测试,运行 mvn clean test
说明:
1)执行成功后, 在..\maventest2\target\test-classes的 \com\jennifer\test下生成了HelloMavenTest.class 文件
并且, target下面生成 surefire-reports,显示运行结果报告
2)若构建执行compiler:testCompile任务的时候失败了,Maven输出提示需要使用 -source5或更高版本以启动注释
修改配置文件, 使maven-compiler-plugin支持java5,如下:
5、打包
执行打包命令:mvn clean package
说明:
1)执行打包命令,jar插件的jar目标将项目主代码打包成一个名为hello-0.0.1-SNAPSHOT.jar,该文件位于target/ 输出目录中
默认命令规则:artifact-version.jar
2)将该 .jar文件拷贝下来, 导入到其他项目中, 就可以调用里面的类和提供的方法
3)直接在其他Maven引用的话, 执行安装步骤:mvn clean install, 就会安装到本地仓库中, 同样在repository仓库文件夹里,生成该项目的.pom .jar文件(类似前面下载的junit)
6、运行
前面默认打包生成的jar不能够直接运行, 因为带有main方法的类信息不回添加到mainfest中,需要再配置插件
再重新执行 mvn clean install
回再生成一份新的带有Main-Class信息的.jar文件,前面生成的被重命名为original-hello-0.0.1-SNAPSHOT.jar
在项目根目录中执行该jar文件
四、maven与其他常用插件结合使用
上述中, 就有提到maven里面配置junit插件, 用来完成单元测试, 实际上,maven项目很容易跟其他插件结合起来使用
比如javadoc, 代码覆盖测量工具Cobertura等
1、javadoc配置如下:
配置javadoc后, 执行 mvn javadoc:javadoc 命令, 就会在..\target\site\apidocs目录下生成 apidocs信息
2、Cobertura配置如下:
配置Cobertura后, 执行 mvn cobertura:cobertura 命令, 就会在..\target\site\cobertura目录下,生成测试代码覆盖主代码情况信息。