maven 简略实用

2012-12-19

maven 简单实用1. Maven介绍?1.1. 简介?java编写的用于构建系统的自动化工具。目前版本是2.0.9，注意maven2

maven 简单实用

1. Maven介绍?

1.1. 简介?
java编写的用于构建系统的自动化工具。
目前版本是2.0.9，注意maven2和maven1有很大区别，阅读第三方文档时需要区分版本。??

1.2. Maven资源?

见官方网站；
The 5 minute test，官方简易入门文档；
Getting Started Tutorial，官方入门文档；
Build Cookbook，官方的cookbook；
POM Reference，POM文件的设置参考
Settings Reference?，settings文件的设置参考
Better Builds with Maven，免费的电子书，下载需要注册。??
1.3. Maven和Ant的区别?
Maven正在逐渐取代Ant，很多java开源软件（Spring、Struts2 ……）已经使用maven。
- 不需要写复杂的处理脚本；
- 声明式的类库依赖管理。??
  1.4. Maven的基本功能?
  - 构建：比如生成class、jar、war或者ear文件
  - 生成文档：比如生成javadoc、网站文档
  - 生成报告：比如junit测试报告
  - 生成依赖类库：生成文档，说明项目多其他软件的依赖
  - 有关SCM：SCM（Software Configuration Management），软件配置管理，比如版本控制，比如bug管理等等
  - 发布：生成供发布的分发包，比如生成Struts2的分发包，供提交给用户使用
  - 部署：比如，web应用程序，自动部署到指定的服务器上
    通过我写的商品管理的小例子，演示结合maven和svn的功能。??
    2. Maven使用
    2.1. Maven的安装和配置?
    从官方网站下载最新的Maven分发包http://maven.apache.org/download.html，当前为2.0.9；
    解压缩到本地；
    配置maven, 将maven/bin目录设置到windows环境变量Path中
    检查maven是否安装成功, 在命令行中执行
    mvn -version?
    2.2. Maven的基本使用?
    Maven的基本使用介绍通过命令行编写简单的java和web项目。??
    2.2.1. 实现Java项目?
    通过maven在命令行下创建普通java项目，也就是main方法执行的项目或者jar文件的类库。??
    2.2.1.1. 创建Maven项目?
    执行：?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
    ?
    2.2.1.2. 运行Maven项目?
    命令行进入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?
    2.2.2. 实现Web项目?
    通过maven在命令行下创建java web项目。??
    2.2.2.1. 创建Maven项目?
    在命令行输入，这一步和创建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目录的作用，对依赖类库的缓存。
    ?
    2.2.2.2. 运行Maven项目?
    项目打包?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目录。??
    3. POM文件的基本配置?
    3.1. POM介绍?
    3.1.1. 什么是POM?
    Project Object Model，项目对象模型。
    通过xml格式保存的pom.xml文件。
    作用类似ant的build.xml文件，功能更强大。
    该文件用于管理：源代码、配置文件、开发者的信息和角色、问题追踪系统、组织信息、项目授权、项目的url、项目的依赖关系等等。??
    3.1.2. 快速浏览?
    一个完整的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>  <groupId>...</groupId> <artifactId>...</artifactId> <version>...</version> <packaging>...</packaging> <dependencies>...</dependencies> <parent>...</parent> <dependencyManagement>...</dependencyManagement> <modules>...</modules> <properties>...</properties>  <build>...</build> <reporting>...</reporting>  <name>...</name> <description>...</description> <url>...</url> <inceptionYear>...</inceptionYear> <licenses>...</licenses> <organization>...</organization> <developers>...</developers> <contributors>...</contributors>  <issueManagement>...</issueManagement> <ciManagement>...</ciManagement> <mailingLists>...</mailingLists> <scm>...</scm> <prerequisites>...</prerequisites> <repositories>...</repositories> <pluginRepositories>...</pluginRepositories> <distributionManagement>...</distributionManagement> <profiles>...</profiles></project>
    3.2. 基本设置?
    3.2.1. 协作关系
    <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
    ?
    3.2.2. POM间关系
    ?3.2.2.1. 依赖关系?
    依赖关系列表（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自动找到它依赖的类库。
    ?
    3.2.2.2. 继承关系?
    继承其他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>
    ?
    ?
    3.2.2.3. 聚合关系
    ?用于将多个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??
    3.2.3. 其他配置?
    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}??
    3.3. 其他?
    3.3.1. 设置离线?
    在.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.0http://maven.apache.org/xsd/settings-1.0.0.xsd"> <offline>true</offline></settings>
    3.3.2. 安装第三方包?
    经常有第三方包，因为一些原因，在网上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>
    3.3.3. 部署到tomcat
    ?
    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.0http://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
    ?
    ?
    3.3.4. 未讲到的内容?
    settings.xml的配置
    pom.xml的详细配置
    自定义插件的方法：http://maven.apache.org/plugins/maven-archetype-plugin/examples/archetype.html
    自定义goal的执行：<preGoal><postGoal>
    插件的查询和使用
    搭建镜像repository
    在maven中调用ant

热点排行

编程

maven 简略实用

1. Maven介绍?

1.1. 简介?
java编写的用于构建系统的自动化工具。
目前版本是2.0.9，注意maven2和maven1有很大区别，阅读第三方文档时需要区分版本。??

2. Maven使用

2.2. Maven的基本使用?
Maven的基本使用介绍通过命令行编写简单的java和web项目。??

2.2.1. 实现Java项目?
通过maven在命令行下创建普通java项目，也就是main方法执行的项目或者jar文件的类库。??

2.2.2. 实现Web项目?
通过maven在命令行下创建java web项目。??

3. POM文件的基本配置?

3.1. POM介绍?

3.2. 基本设置?

3.3. 其他?

3.3.4. 未讲到的内容?
settings.xml的配置
pom.xml的详细配置
自定义插件的方法：http://maven.apache.org/plugins/maven-archetype-plugin/examples/archetype.html
自定义goal的执行：<preGoal><postGoal>
插件的查询和使用
搭建镜像repository
在maven中调用ant

编程

maven 简略实用

1. Maven介绍?

1.1. 简介?java编写的用于构建系统的自动化工具。目前版本是2.0.9，注意maven2和maven1有很大区别，阅读第三方文档时需要区分版本。??

2. Maven使用

2.2. Maven的基本使用?Maven的基本使用介绍通过命令行编写简单的java和web项目。??

2.2.1. 实现Java项目?通过maven在命令行下创建普通java项目，也就是main方法执行的项目或者jar文件的类库。??

2.2.2. 实现Web项目?通过maven在命令行下创建java web项目。??

3. POM文件的基本配置?

3.1. POM介绍?

3.2. 基本设置?

3.3. 其他?

1.1. 简介?
java编写的用于构建系统的自动化工具。
目前版本是2.0.9，注意maven2和maven1有很大区别，阅读第三方文档时需要区分版本。??

2.2. Maven的基本使用?
Maven的基本使用介绍通过命令行编写简单的java和web项目。??

2.2.1. 实现Java项目?
通过maven在命令行下创建普通java项目，也就是main方法执行的项目或者jar文件的类库。??

2.2.2. 实现Web项目?
通过maven在命令行下创建java web项目。??