当前位置:首页 > 开发 > 研发管理 > 正文

maven 简单实用教程

发表于: 2013-04-30   作者:AdyZhang   来源:转载   浏览:
摘要: 1. Maven介绍  1.1. 简介 java编写的用于构建系统的自动化工具。目前版本是2.0.9,注意maven2和maven1有很大区别,阅读第三方文档时需要区分版本。 1.2. Maven资源 见官方网站;The 5 minute test,官方简易入门文档;Getting Started Tutorial,官方入门文档;Build Coo

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>

  <!-- 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>
 
 
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.0
http://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.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
 
 
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 简单实用教程

  • 0

    开心

    开心

  • 0

    板砖

    板砖

  • 0

    感动

    感动

  • 0

    有用

    有用

  • 0

    疑问

    疑问

  • 0

    难过

    难过

  • 0

    无聊

    无聊

  • 0

    震惊

    震惊

编辑推荐
BTrace本身也是可以独立运行的程序,作用是在不停止目标程序运行的前提下,通过HotSpot虚拟机的HotS
BTrace本身也是可以独立运行的程序,作用是在不停止目标程序运行的前提下,通过HotSpot虚拟机的HotS
BTrace本身也是可以独立运行的程序,作用是在不停止目标程序运行的前提下,通过HotSpot虚拟机的HotS
BTrace本身也是可以独立运行的程序,作用是在不停止目标程序运行的前提下,通过HotSpot虚拟机的HotS
BTrace本身也是可以独立运行的程序,作用是在不停止目标程序运行的前提下,通过HotSpot虚拟机的HotS
BTrace本身也是可以独立运行的程序,作用是在不停止目标程序运行的前提下,通过HotSpot虚拟机的HotS
eclipse maven plugin 插件 安装 和 配置 环境准备: eclipse(Helios) 3.6 maven 3.0.4 maven3 安
----------------准备工作------------- Jdk 1.5以上java开发环境。 Eclipse IDE 一个。 Maven 3.0.
先去下一个IDE,我用的eclipse,那我们就先去下一个,我是在 spring官网下去下载的一个集成了spring
项目结构如下: pom.xml 内容: <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi
版权所有 IT知识库 CopyRight © 2009-2015 IT知识库 IT610.com , All Rights Reserved. 京ICP备09083238号