maven(一)初步搭建,项目结构

时间:2022-05-22 09:22:57

一、环境准备

java环境, jdk 1.5 以上

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

二、快速安装及配置

1、下载maven: http://maven.apache.org/docs/3.1.1/release-notes.html

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

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

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

maven(一)初步搭建,项目结构

2、修改仓库位置

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

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

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

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

打开myEclipse,点击Window->Preferences

maven(一)初步搭建,项目结构

三、创建maven项目例子

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

maven(一)初步搭建,项目结构

图1:new Maven Project

maven(一)初步搭建,项目结构

图2:ProjectName\ Group Id\Artifact Id

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

maven(一)初步搭建,项目结构

说明:

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

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

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

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

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

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

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

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

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

代码如下:

maven(一)初步搭建,项目结构

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

maven(一)初步搭建,项目结构

说明:

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(一)初步搭建,项目结构

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

maven(一)初步搭建,项目结构

说明:

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

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

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

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

maven(一)初步搭建,项目结构

5、打包

执行打包命令:mvn clean package

maven(一)初步搭建,项目结构

说明:

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

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

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

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

maven(一)初步搭建,项目结构

6、运行

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

maven(一)初步搭建,项目结构

再重新执行 mvn clean install

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

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

maven(一)初步搭建,项目结构

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

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

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

1、javadoc配置如下:

maven(一)初步搭建,项目结构

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

2、Cobertura配置如下:

maven(一)初步搭建,项目结构

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