maven 简单实用教程html
java编写的用于构建系统的自动化工具。 java
目前版本是2.0.9，注意maven2和maven1有很大区别，阅读第三方文档时须要区分版本。 react
· 见官方网站； web
· The 5 minute test，官方简易入门文档； apache
· Getting Started Tutorial，官方入门文档； windows
· Build Cookbook，官方的cookbook； 缓存
· POM Reference，POM文件的设置参考 tomcat
· Settings Reference ，settings文件的设置参考 服务器
· Better Builds with Maven，免费的电子书，下载须要注册。 oracle
Maven正在逐渐取代Ant，不少java开源软件（Spring、Struts2 ……）已经使用maven。
· 不须要写复杂的处理脚本；
· 声明式的类库依赖管理。
· 构建：好比生成class、jar、war或者ear文件
· 生成文档：好比生成javadoc、网站文档
· 生成报告：好比junit测试报告
· 生成依赖类库：生成文档，说明项目多其余软件的依赖
· 有关SCM：SCM（Software Configuration Management），软件配置管理，好比版本控制，好比bug管理等等
· 发布：生成供发布的分发包，好比生成Struts2的分发包，供提交给用户使用
· 部署：好比，web应用程序，自动部署到指定的服务器上
经过我写的商品管理的小例子，演示结合maven和svn的功能。
· 从官方网站下载最新的Maven分发包http://maven.apache.org/download.html，当前为2.0.9；
· 解压缩到本地；
· 配置maven, 将maven/bin目录设置到windows环境变量Path中
· 检查maven是否安装成功, 在命令行中执行
· mvn -version
Maven的基本使用介绍经过命令行编写简单的java和web项目。
经过maven在命令行下建立普通java项目，也就是main方法执行的项目或者jar文件的类库。
执行：
mvn archetype:generate
在交互界面中：
· Choose a number: 回车便可，也就是选择15
· Define value for groupId: 输入组织id，好比easymorse.com
· Define value for artifactId：输入项目名称，好比helloworld
· Define value for version: 输入版本号，能够直接回车，默认是1.0-SNAPSHOT
· Define 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，菜单选择：file>import>general>existing projects into workspace，在对话框中选中目录，导入便可。
若是要清除有关eclipse项目的配置信息：
mvn -Dwtpversion=1.0 eclipse:clean
联合使用
mvn eclipse:clean clean
经过maven在命令行下建立java web项目。
在命令行输入，这一步和建立java项目相似：
mvn archetype:generate
交互步骤说明：
· Choose a number: 回车便可，也就是选择18，这里和java普通项目不同
· Define value for groupId: 输入组织id，好比easymorse.com
· Define value for artifactId：输入项目名称，好比helloworld
· Define value for version: 输入版本号，能够直接回车，默认是1.0-SNAPSHOT
· Define 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
这样生成wtp插件的web项目。
打开eclipse，菜单选择：file>import>general>existing projects into workspace，在对话框中选中目录，导入便可。
另外，须要在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>
<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> <groupId>org.codehaus.mojo</groupId> <artifactId>my-project</artifactId> <version>1.0</version> <packaging>war</packaging> </project>
· groupId : 组织标识，例如：org.codehaus.mojo，在M2_REPO目录下，将是: org/codehaus/mojo目录。
· artifactId : 项目名称，例如：my-project，在M2_REPO目录下，将是：org/codehaus/mojo/my-project目录。
· version : 版本号，例如：1.0，在M2_REPO目录下，将是：org/codehaus/mojo/my-project/1.0目录。
· packaging : 打包的格式，能够为：pom , jar , maven-plugin , ejb , war , ear , rar , par
依赖关系列表（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
好比查询hibernate，能够找到结果列表中的hibernate类库条目。
点击：http://www.mvnrepository.com/artifact/org.hibernate/hibernate，
选择版本，好比3.2.6ga，即：http://www.mvnrepository.com/art ... /hibernate/3.2.6.ga
复制文章中的：
<dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate</artifactId> <version>3.2.6.ga</version> </dependency>
到pom.xml文件中便可。
是否还须要找到hibernate依赖的pom？
不须要，hibernate也会有pom，maven会经过它的pom自动找到它依赖的类库。
继承其余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>
参考文档：http://maven.apache.org/plugins/maven-eclipse-plugin/reactor.html
原文示例有误，见：modules.rar
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
· settings.xml的配置
· pom.xml的详细配置
· 自定义插件的方法：http://maven.apache.org/plugins/maven-archetype-plugin/examples/archetype.html
· 自定义goal的执行：<preGoal><postGoal>
· 插件的查询和使用
· 搭建镜像repository
· 在maven中调用ant