Java的项目构建工具Maven的配置和使用教程
一、maven是什么
maven是一个用java开发的项目构建工具, 它能使项目构建过程中的编译、测试、发布、文档自动化, 大大减轻了程序员部署负担。
二、安装maven
安装maven非常简单,访问maven官方页下载即可:http://maven.apache.org/download.cgi
下载完后配置m2_home环境变量, 然后终端运行mvn --version, 看到正确的输出提示,maven就安装完成了。
三、maven基本概念
maven的核心思想是pom, 即project object model(项目对象模型)。pom文件是以xml文件的形式描述一个maven项目所用到的资源(源码、依赖、测试等)。下图描述了pom文件的结构, 以及maven是如何调用pom文件的。
当执行一条maven命令时, 会传入一个pom文件, maven会在该pom里面的描述的资源上执行
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> <!-- the basics --> <groupid>...</groupid> <artifactid>...</artifactid> <version>...</version> <packaging>...</packaging> <dependencies>...</dependencies> <parent>...</parent> <dependencymanagement>...</dependencymanagement> <modules>...</modules> <properties>...</properties> <!-- build settings --> <build>...</build> <reporting>...</reporting> <!-- more project information --> <name>...</name> <description>...</description> <url>...</url> <inceptionyear>...</inceptionyear> <licenses>...</licenses> <organization>...</organization> <developers>...</developers> <contributors>...</contributors> <!-- environment settings --> <issuemanagement>...</issuemanagement> <cimanagement>...</cimanagement> <mailinglists>...</mailinglists> <scm>...</scm> <prerequisites>...</prerequisites> <repositories>...</repositories> <pluginrepositories>...</pluginrepositories> <distributionmanagement>...</distributionmanagement> <profiles>...</profiles> </project>
modelversion是pom模型版本, 4.0.0支持maven2和3
maven coordinates(maven坐标)
(1)groupid: 它是一个组织或者项目的唯一id, 大多数情况下会使用项目的java包的根名作为groupid, 例如com.pastqing
(2)artifactid:它是正在构建的项目名称, 例如一个支付系统artifactid是web-pay。artifactid 是maven仓库中groupid目录下的子目录名
(3)version:顾名思义项目发行的版本号
以上三项都是构建结果名称的一部分, 在项目构建后会生成一个jar包,位于maven仓库的路径就是maven_repo/com/pastqing/web-pay/1.0/web-pay-1.0.jar
四、一个用maven构建的hello world java项目
利用maven插件archetype构建一个项目:
在终端中打开工作目录
运行命令:
mvn archetype:generate
, 第一次运行时比较慢,原因是第一次需要从maven*仓库中下载相关项目原型。下载完毕后,会选择项目模型,以及输入groupid, artifactid,version等,构建完毕后会有成功提示。
打包项目:切换到项目根目录,运行mvn package。打包成功之后,项目会生成一个target文件夹,里面有生成好的jar文件和class文件。
运行jar文件:
java -cp target/helloworld-1.0-snapshot.jar com.pastqing.app
至此一个最简单maven构建的java项目就完成了。
五、一个用maven构建的java-web项目
生成一个web项目与生成java项目基本类似,只是用的模型不同而已。这里不再阐述。下面我们具体说说如何使用tomcat或者jetty插件运行web项目。这里我们以tomcat举例。
maven tomcat插件安装: http://tomcat.apache.org/maven-plugin-2.2/
我们将如下插件信息加入到web项目中的pom文件中
<plugin> <groupid>org.apache.tomcat.maven</groupid> <artifactid>tomcat6-maven-plugin</artifactid> <version>2.2</version> </plugin> <plugin> <groupid>org.apache.tomcat.maven</groupid> <artifactid>tomcat7-maven-plugin</artifactid> <version>2.2</version> </plugin>
这样我们集成了这个tomcat的maven插件, 只需要一个命令就可以部署、启动服务了。命令如下:
mvn tomcat:run
(tomcat6)
mvn tomcat7:run
(tomcat7)
使用tomcat maven插件自动部署到外部tomcat
以上自动部署,会使用maven内嵌的tomcat, 下面我们修改pom文件, 让项目部署到外部的tomcat中。
修改项目pom文件,添加服务器配置信息
<plugin> <groupid>org.apache.tomcat.maven</groupid> <artifactid>tomcat7-maven-plugin</artifactid> <version>2.2</version> <configuration> <url>http://localhost:8080/manager/text</url> <server>tomcat7</server> <username>admin</username> <password>admin</password> </configuration> </plugin>
其中server, username, password的值与%maven_home中的setting.xml中的server, username, password一一对应。
启动外部tomcat, 运行命令mvn tomcat7:redeploy
六、如何用maven构建多模块项目
1.父pom
所有的maven pom文件都继承自一个父pom, 如果没有指定父pom, 则该pom文件继承自根pom。pom文件的集成关系如下图所示:
可以让一个pom文件显式地继承另一个pom文件。这样,可以通过修改公共父pom文件的设置来修改所有子pom文件的设置。这里我们使用parent标签来定义父pom。下面我们具体搭建一个多模块mavne项目
2.构建项目目录结构
我们创建一个maven-web项目, 名字叫educationcloud, 接下来我们在项目目录下创建几个文件夹用来划分我们的模块。它们分别是education-parent(父模块), education-core(业务), education-entity(实体), education-web(web服务)
目录的划分可以根据需要进行, 我的划分如上
3.修改pom文件
我们用module标签来进行划分模块。打开根目录下的pom文件, 添加moudle标签。
<?xml version="1.0" encoding="utf-8"?> <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.educationcloud</groupid> <artifactid>educationcloud</artifactid> <version>1.0-snapshot</version> <packaging>pom</packaging> <modules> <module>education-parent</module> <module>education-core</module> <module>education-entity</module> <module>education-web</module> </modules> <name>educationcloud</name> </project>
这里我们说下packaging标签:最常见的就是打包为jar, war了。任何一个maven项目都需要定义pom文件中的packaging元素, 如果不声明该元素, 则默认打包为jar, 如果定义值为war那么就打包为war包。如果值为pom,那么什么包都不生成(通常用于父模块)。
给各个模块添加parent标签:
parent标签用来定义父pom的坐标位置的, 定义如下:
<parent> <groupid>com.educationcloud</groupid> <artifactid>educationcloud-parent</artifactid> <version>1.0-snapshot</version> <relativepath></relativepath> </parent>
groupid, aritfactid, version是常规表示父pom位置信息的元素, relativepath是表示父pom位置的相对路径, 默认为../pom.xml, 这里需要注意的是groupid, aritfactid, version必须与父pom文件中的对应起来
使用dependencymanagement管理项目所有依赖
为了统一管理依赖,我们在父项目模块的pom文件中使用dependencymanagement来声明项目的所有依赖, 这样在其他的子项目中引用依赖时就可以省略版本号的编写, 修改起来也很容易。
编写**父项目模块**educationcloud-parent的pom文件, 添加如下:
使用pluginmanagement管理项目中的maven插件
为了统一管理项目中的maven插件, 如maven编译插件, 打包插件等及其配置信息, 在父项目 pom文件中添加pluginmanagement来管理, 这样在所有子模块中引用的插件都会统一处理, 添加如下:
<pluginmanagement> <plugins> <!-- complile插件的配置 --> <plugin> <groupid>org.apache.maven.plugins</groupid> <artifactid>maven-complier-plugin</artifactid> <version>3.3</version> <configuration> <source>1.7</source> <target>1.7</target> <encoding>utf-8</encoding> </configuration> <plugin> </plugins> </pluginmanagement>
上面我们添加了maven编译插件的配置,用jdk1.7编译, 保存后我们可以在各个子模块的effective pom中看到相应的修改。
使用properties标签定义常量:
我们将各个依赖的版本号定义为不同的常量,这样方便以后的修改:
<properties> <jdkversion>1.7</jdkversion> <servletversion>3.1.0</servletversion> <mysqlversion>5.1.34</mysqlversion> <junitversion>4.12</junitversion> <defaultencoding>utf-8</defaultencoding> </properties>
引用时用${jdkversion}的形式引用即可。
注,以上操作均可在ide中操作, 更加方便简单。