标签:
POM
就像Make的Makefile,Ant的build.xml一样,Maven项目的核心是pom.xml。POM(Project Object Model项目对象模型),定义了项目的基本信息,用于描述项目如何构建,声明项目依赖等等。
我们先来建立一个经典的Hello world Maven项目。
先建立一个helloworld文件夹,在文件夹中新建pom.xml文件,在文件中编写如下代码:
<?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/maven-4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.j1.hhl</groupId> <artifactId> hhl-helloworld</artifactId> <version>1.0.0-SNAPSHOT</version> <package>war</package> <name>MAVEN HELLO WORLD PROJECT</name> </project>
代码的第一行是XML头,指定了该xml文档的版本和编码方式。紧接着是project元素,project是所有pom.xml元素的根元素,它声明了一些POM相关的命名空间及xsd元素,虽然这些属性不是必须的,但使用这些属性能使第三方工具帮助我们快速编辑POM。
根元素下的第一个元素modelVersion指定了当前POM模型的版本,对于Maven2和Maven3,它只能是4.0.0。
这段代码中最重要的是groupId,artifactId,version,这三个元素定义了一个项目的坐标。
groupId定义了项目属于哪一个组,这个组往往和项目所在组织或者公司存在关联。譬如,j1公司有一个app项目叫hhl,则groupId为com.j1.hhl。
artifactId定义了当前Maven项目在组中唯一的ID,譬如,我们在hhl项目中把登录功能单独出来作为一个项目,那么登录项目artifactId即可为hhl-helloworld。一般情况下,artifactId的前缀为组groupId最后一个属性名,例如本例中的hhl。
version指明了当前Maven项目的版本号,分为发布版本和快照版本。
package项目打包类型,如果不声明,默认即为jar,也可以显式声明为war。
name 声明了对于用于一个更为友好的项目名称,方便信息交流。
没有任何实际的java代码,我们就可以定义一个Maven的POM。这体现了Maven能够将项目对象模型与java代码最大程度的相互独立,俗称解耦或者正交性。这在很大程度上避免了java代码和POM代码相互影响。
Maven主代码(编译 mvn clean complier)
主代码与测试代码不同,项目主代码会被打包到最终构建中,而测试代码不会。本着约定大于配置的原则,我们一般将主代码放在src/main/java中,这里有一点需要注意,我们在给类取名的时候,注意尽量保持与POM中groupId和artifactId一致,如上述POM,我们的主代码应该在com.j1. hhl.helloworld包下。
Maven测试代码(测试 mvn clean test)
测试代码一般放在src/main/test中,我们可以使用标准的单元测试,这里提前用到Maven项目依赖的功能:我们先在POM引入Junit jar包,代码如下
<?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/maven-4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.j1.hhl</groupId> <artifactId>hhl-helloworld</artifactId> <version>1.0.0-SNAPSHOT</version> <name>MAVEN HELLO WORLD PROJECT</name> <package>war</package> <dependences> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.8</version> <scope>test</scope> </dependency> </dependences> </project>
dependences声明项目依赖,可以有多个,dependency下有groupId,artifactId,version有了这三个属性的声明,Maven会自动下载junit-4.8.jar构建,以为项目所用。那么这个jar是从哪里来的呢?先从中央仓库下载到本地,再从本地引入到项目中。Scope声明依赖范围,test说明依赖只对测试有效,如果不显示声明依赖范围,则默认为complier,则测试和主代码都有效。具体测试类写法和一般单元测试类写法一样。项目在测试之前,会执行编译工作。
打包(mvn clean package)和安装(mvn clean install)
将项目进行编译测试之后,下一个重要步骤就是打包,helloword项目中,我们指定打包类型为war包,同样在打包之前,会执行编译和测试的工作,在本例中,打包之后默认会生成一个名为hhl-helloworld-1.0.0-SNAPSHOT.war文件(文件命名规则为artifactId+version+文件后缀),此文件位于Maven的输出目录target中,如果有必要,我们也可以在POM声明finalName来自定义的打包名称。如果想让打包的类被其他Maven项目所用,我们还需要做最后一步,即安装。在执行安装操作之前,先回运行编译、测试、打包三步操作,等安装完之后,会自动将打包完后的构建上传到本地Maven仓库中,这样只有其他Maven项目在POM中定义
<dependences> <dependency> <groupId>com.j1.hhl</groupId> <artifactId>hhl-helloworld</artifactId> <version>1.0.0-SNAPSHOT</version> </dependency> </dependences>
就可以使用war包中的类了。
以上从编译到测试,从测试到打包,再从打包到安装我们都走了一遍,值得一提的是,在执行当前步骤前,会将之前所有步骤重新再走一遍。需要注意的是,执行上面四个步骤,其实质是由四个插件来完成的,这一点对于理解Maven构建的生命周期有特别的意义。
使用Archetype快速创建项目结构
在上面helloworld项目中,我们有意约束大家项目的结构,比如我们将主代码放入src/main/java,我们将pom.xml放入根目录下等等,我们一步一步展示这些步骤,是为了勾勒出Maven项目的基本结构,当我们熟练使用此种方式创建Maven项目后,我们可以为了避免重复发明轮子,我们可以使用Archetype快速创建项目骨架,简单的运行Maven命令:mvn archetype:generate(实际上是在执行maven- archetype-plugin插件),在执行命令后,会让你输入groupId、artifactId、version等一些POM信息,当输入完之后,一个完整的Maven项目就快速勾勒出来了。
标签:
原文地址:http://www.cnblogs.com/tomcatx/p/4249114.html