注册 登录  
 加关注
   显示下一条  |  关闭
温馨提示!由于新浪微博认证机制调整,您的新浪微博帐号绑定已过期,请重新绑定!立即重新绑定新浪微博》  |  关闭

享受编码

    的乐趣

 
 
 

日志

 
 

maven 简单实用教程  

2011-05-27 10:14:05|  分类: Java |  标签: |举报 |字号 订阅

  下载LOFTER 我的照片书  |

关键字: maven 简单实用教程

本文转载自: http://eric-hou.javaeye.com/blog/424795

1. Maven介绍

1.1. 简介

java编写的用于构建系统的自动化工具。

目前版本是2.0.9,注意maven2和maven1有很大区别,阅读第三方文档时需要区分版本。

1.2. 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. 未讲到的内容

  评论这张
 
阅读(1053)| 评论(0)
推荐 转载

历史上的今天

评论

<#--最新日志,群博日志--> <#--推荐日志--> <#--引用记录--> <#--博主推荐--> <#--随机阅读--> <#--首页推荐--> <#--历史上的今天--> <#--被推荐日志--> <#--上一篇,下一篇--> <#-- 热度 --> <#-- 网易新闻广告 --> <#--右边模块结构--> <#--评论模块结构--> <#--引用模块结构--> <#--博主发起的投票-->
 
 
 
 
 
 
 
 
 
 
 
 
 
 

页脚

网易公司版权所有 ©1997-2017