Java编写的用于构建系统的自动化工具。
见官方网站;
The 5 minute test,官方简易入门文档;Getting Started Tutorial,官方入门文档;Build Cookbook,官方的cookbook;POM Reference,POM文件的设置参考Settings Reference ,settings文件的设置参考Maven正在逐渐取代Ant,很多java开源软件(spring、Struts2 ……)已经使用maven。
不需要写复杂的处理脚本;声明式的类库依赖管理。Maven的基本使用介绍通过命令行编写简单的java和web项目。
通过maven在命令行下创建普通java项目,也就是main方法执行的项目或者jar文件的类库。
在交互界面中:
Choose a number: 回车即可,也就是选择15Define value for groupId: 输入组织id,比如easymorse.comDefine value for artifactId:输入项目名称,比如helloworldDefine value for version: 输入版本号,可以直接回车,默认是1.0-SNAPSHOTDefine value for package: java的包名,比如com.easymorse 然后回车表示确认上述输入即可。观察helloworld目录(Define value for artifactId输入的项目名称)下生成的文件和目录:
项目构建文件: pom.xml 代码框架: src\main\java\com\easymorse\App.java 测试代码: src\test\java\com\easymorse\AppTest.java命令行进入helloworld目录Define value for artifactId输入的项目名称)。
项目打包
mvn package检查命令生成了什么?
target目录 编译了代码 编译了测试代码 使用junit测试并生成的报告 生成代码的jar文件运行打包的jar文件:
java -cp target\helloworld-1.0-SNAPSHOT.jar com.easymorse.App编译源程序
mvn compile编译并测试
mvn test清空生成的文件
mvn clean将maven项目转化为eclipse项目
mvn eclipse:eclipse如果要清除有关eclipse项目的配置信息
mvn -Dwtpversion=1.0 eclipse:clean联合使用
mvn eclipse:clean clean在命令行输入,这一步和创建java项目类似:
mvn archetype:generate交互步骤说明:
Choose a number: 回车即可,也就是选择18,这里和java普通项目不一样Define value for groupId: 输入组织id,比如easymorse.comDefine value for artifactId:输入项目名称,比如helloworldDefine value for version: 输入版本号,可以直接回车,默认是1.0-SNAPSHOTDefine value for package: java的包名,比如com.easymorse 然后回车表示确认上述输入即可。需要在pom.xml文件中增加servlet容器的插件:
<build> <plugins> <plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>tomcat-maven-plugin</artifactId> </plugin> <plugin> <groupId>org.mortbay.jetty</groupId> <artifactId>maven-jetty-plugin</artifactId> <version>6.1.6</version> </plugin> <plugin> <artifactId>maven-compiler-plugin</artifactId> <configuration> <source>1.6</source> <target>1.6</target> <encoding>UTF-8</encoding> </configuration> </plugin> </plugins> </build> tomcat插件jetty插件编译插件的配置repository目录的作用
repository的位置,在用户目录的.m2目录下。 repository目录的作用,对依赖类库的缓存。
项目打包
mvn package启动tomcat
mvn tomcat:run启动jetty
mvn jetty:run转化为eclipse项目
mvn -Dwtpversion=1.5 eclipse:eclipse另外,需要在eclipse里创建一个classpath变量,名称为:M2_REPO,值为系统用户下.m2/repository目录。
Project Object Model,项目对象模型。
通过xml格式保存的pom.xml文件。
作用类似ant的build.xml文件,功能更强大。
该文件用于管理:
源代码、配置文件、开发者的信息和角色、问题追踪系统、组织信息、项目授权、项目的url、项目的依赖关系等等。一个完整的pom.xml文件,放置在项目的根目录下。
<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-v4_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>依赖关系列表(dependency list)是POM的重要部分。
<dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>4.0</version> <scope>test</scope> </dependency> ... </dependencies>groupId , artifactId , version : scope : compile(default),provided,runtime,test,system exclusions
如何查到依赖的类库? 一般可以通过这个网站:http://www.mvnrepository.com
继承其他pom.xml配置的内容。 maven提供了一个类似java.lang.Object的顶级父pom.xml文件。 可以通过下面命令查看当前pom.xml受到超pom.xml文件的影响:
mvn help:effective-pom创建一个各种项目可复用的pom.xml文件:http://easymorse.googlecode.com/svn/trunk/pom/pom.xml 部署要复用的pom.xml文件:
mvn install在自己的pom文件中继承上述pom:
<parent> <groupId>com.easymorse</groupId> <artifactId>pom</artifactId> <version>0.1</version> </parent>用于将多个maven项目聚合为一个大的项目。 比如目录结构如下:
. |– pom.xml |– module-a -- pom.xml |-- module-b – pom.xml |– module-c -- pom.xml |-- foo-all – pom.xml
那么总的pom.xml文件类似:
... <modules> <module>module-a</module> <module>module-b</module> <module>module-c</module> <module>foo-all</module> </modules> </project>maven的属性,是值的占位符,类似EL,类似ant的属性,比如${X},可用于pom文件任何赋值的位置。 有以下分类:
env.X:操作系统环境变量,比如${env.PATH}project.x:pom文件中的属性,比如: <project> <version>1.0</version> </project>引用方式:${project.version}
settings.x:settings.xml文件中的属性,比如: <settings> <offline>false</offline> </settings>引用方式:${settings.offline}
Java System Properties:java.lang.System.getProperties()中的属性,比如java.home,引用方式:${java.home}
自定义:在pom文件中可以:
<properties> <installDir>c:/apps/cargo-installs</installDir></properties>引用方式:${installDir}
在.m2目录下创建settings.xml文件(如果没有的话)
<settings 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/settings-1.0.0.xsd"> <offline>true</offline> </settings>经常有第三方包,因为一些原因,在网上repository上没有,需要自己动手安装。 比如sun某些版本的jar文件,比如Oracle的驱动。 已oracle驱动程序为例,比如驱动路径为c:/driver/ojdbc14.jar,是10.2.0.3.0版本 在该网址能够查到:http://www.mvnrepository.com/artifact/com.oracle/ojdbc14 artifactId和groupId。
mvn install:install-file -DgroupId=com.oracle -DartifactId=ojdbc14 -Dversion=10.2.0.3.0 -Dpackaging=jar -Dfile=c:/driver/ojdbc14.jar这样就可以在pom中依赖引用了:
<dependency> <groupId>com.oracle</groupId> <artifactId>ojdbc14</artifactId> <version>10.2.0.3.0</version> </dependency>tomcat配置有管理权限的用户:conf\tomcat-users.xml
<?xml version='1.0' encoding='utf-8'?> <tomcat-users> <role rolename="manager"/> <user username="marshal" password="password" roles="manager"/> </tomcat-users>在pom文件的tomcat插件中添加:
<plugin> <groupId>org.codehaus.mojo</groupId> <artifactId>tomcat-maven-plugin</artifactId> <configuration> <url>http://localhost:8080/manager</url> <server>myserver</server> <path>/mycontext</path> </configuration> </plugin>在.m2/settings.xml文件中增加:
<settings 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/settings-1.0.0.xsd"> <servers> <server> <id>myserver</id> <username>marshal</username> <password>password</password> </server> </servers> </settings>运行打包部署,在maven项目目录下:
mvn tomcat:deploy然后访问:http://localhost:8080/mycontext/ 即可。
撤销部署:
mvn tomcat:undeploy启动web应用:
mvn tomcat:start停止web应用:
mvn tomcat:stop重新部署:
mvn tomcat:redeploy部署展开的war文件:
mvn war:exploded tomcat:exploded