`
houzhaowei
  • 浏览: 499183 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

maven 简单实用教程

阅读更多

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

 

29
1
分享到:
评论
7 楼 nich002 2014-04-25  
zealot 写道

大家不要点这SB的链接, 直接跳到一个垃圾网站上去了.
6 楼 chengcheng222e 2013-08-19  
很详细不错
5 楼 zhengyutong 2012-04-27  
感谢楼主的总结~~~~
4 楼 mlzboy 2012-01-26  
博主,有QQ什么的不,请教问题
3 楼 zealot 2011-10-31  
2 楼 编程的石头 2011-10-19  
好多,还是让别人配好了,看着头痛
1 楼 ralf_realman 2011-08-13  
不错,很好

相关推荐

    maven简单实用教程

    【Maven简单实用教程】 Maven是一个基于Java的构建工具,专为管理项目的构建、报告和依赖关系而设计。它的核心理念是通过Project Object Model (POM)来描述项目,并利用中央仓库进行依赖管理和版本控制。 1. Maven...

    maven 简单实用教程 htm

    ** Maven 简单实用教程概述 ** Maven 是一个强大的项目管理工具,主要用于构建、管理和部署 Java 项目。它通过使用一个项目对象模型(Project Object Model,POM)来描述项目,并自动化项目的构建过程。Maven 的...

    maven eclipse 培训教程

    Maven in action.pdf Maven2+Eclipse开发J2EE.pdf ...Maven简单实用教程.docx OTNVD_WebLogicServerDevelopment_CN.pdf 《Maven实战》(国内首本Maven著作)(Maven的安装、配置及使用入门) 《Maven权威指南》.pdf.pdf

    Maven简易教程1

    【Maven简易教程1】 Maven是一款强大的自动化构建工具,主要服务于Java平台,它通过约定优于配置的原则,简化了项目的构建、管理和部署流程。在大数据和Java开发领域,Maven的作用尤为显著,能够帮助开发者有效地...

    maven 教程

    ### Maven 教程知识点详解 #### 一、Maven 概念 **Maven** 是由 Apache 软件基金会支持的一款开源项目管理和综合工具。它通过定义项目对象模型(Project Object Model,简称 POM)的方式,实现了项目的构建、报告...

    IDEA插件推荐之Maven-Helper的教程图解

    4. 安装和配置:Maven-Helper 插件的安装和配置非常简单。开发者只需要在 IDEA 插件市场中搜索 Maven Helper,然后安装并重启 IDEA 就可以开始使用。需要注意的是,在国内网络连接 JetBrains 服务器可能会比较慢,...

    EOVA框架整合WEBSERVICE ,eclipse maven环境 简单实用。内含说明.

    本教程将介绍如何在Eclipse IDE中,利用Maven构建工具,将EOVA框架与WebService进行整合,实现一个简单而实用的应用。 首先,我们需要了解EOVA框架的核心概念。EOVA强调业务对象的虚拟化,它通过动态代理技术实现了...

    maven2教程,适合所有人看的

    《Maven2教程,适合所有人看的》 Maven2,作为一个强大的Java项目管理工具,它的出现极大地简化了构建、管理和部署Java应用程序的过程。对于有志于提升开发效率和规范化的开发者来说,掌握Maven2是至关重要的。然而...

    一份关于maven的教程!!!!!!!!

    ### Maven 教程知识点详解 #### 一、简介 **1.1 什么是 Maven?** Maven 是 Apache 软件基金会支持的一款自动化构建工具,主要用于 Java 项目的构建、依赖管理和项目信息管理。 **1.2 Maven 的优势和作用** - *...

    Eclipse实用教程[郑阿奇资料

    《Eclipse实用教程[郑阿奇资料]》是一份针对Eclipse集成开发环境的详尽教程,主要面向研究生级别的学习者。这份资料包含了两大部分:Eclipse实用教程的电子教案和试验部分,旨在帮助用户深入理解和熟练应用Eclipse...

    使用Maven构建简单的邮件发送示例项目

    本教程将带你通过使用Maven构建一个简单的邮件发送示例项目,这非常适合初学者理解和学习。 首先,我们需要了解Maven的基本概念。Maven是基于项目对象模型(Project Object Model,POM)的,它通过POM文件来管理...

    Eclipse实用教程[郑阿奇][案例及素材]

    《Eclipse实用教程[郑阿奇][案例及素材]》是一部深入浅出的Eclipse使用指南,由知名Java开发者郑阿奇编著。本教程旨在帮助读者熟练掌握Eclipse这一强大的Java集成开发环境(IDE),并结合实际案例,提升开发效率。...

    Maven+ssm(spring+springmvc+mybatis)+mysql

    SSM(Spring、SpringMVC、MyBatis)是一个经典的Java web开发框架组合,由Spring框架作为基础,SpringMVC负责处理HTTP请求...对于初学者,这是一个全面而实用的入门教程,能够帮助他们快速建立起企业级应用开发的能力。

    推荐了多个详细资源讲解maven

    Maven使用一种标准的目录结构和一个XML格式的配置文件(pom.xml),使得项目构建、依赖管理和生命周期管理变得简单易行。 ### Maven的核心概念 1. **项目对象模型(Project Object Model, POM)** Maven的中心是...

    idea创建基于maven的web工程共6页.pdf.zi

    这份6页的PDF教程可能会进一步深入,包括更具体的配置细节、常见问题解决、自定义Maven目标以及更多实用技巧。对于初学者来说,这样的教程是非常有价值的资源,能够快速掌握使用IDEA和Maven创建Web项目的方法。

    Spring+SpringMVC+Mybatis+Maven+MySql项目框架 加分页详解适合新手学习

    本项目旨在为新手提供一个基础的SSM框架搭建教程,并且加入了Maven管理和MySql数据库支持,以及分页功能的详细讲解,帮助初学者快速上手。 首先,我们来详细了解一下SSM框架的核心组件: 1. **Spring**:Spring 是...

    java Web 应用开发技术实用教程源代码

    在Java Web应用开发技术实用教程中,初学者可以深入理解并掌握构建Web应用程序的基本概念和技术。本教程通过详细的例题,旨在帮助读者逐步熟悉并熟练使用Java语言进行Web开发。以下是一些关键知识点的概述: 1. **...

    Java2实用教程(第3版)教学课件共21页.pdf.zi

    【Java2实用教程(第3版)教学课件】是一份深入浅出的Java学习资源,针对初学者和有一定基础的开发者设计。本教程旨在帮助读者掌握Java编程语言的核心概念和实际应用,全面覆盖了Java 2平台的关键特性。这份教学课件...

    Maven+Spring MVC+Mybatis的分页例子

    总的来说,这个"Maven+Spring MVC+Mybatis的分页例子"是一个实用的教程,帮助开发者了解如何在Java Web环境中集成这三个框架,并实现分页功能。通过这个实例,你可以学习到Maven的依赖管理、Spring MVC的请求处理、...

Global site tag (gtag.js) - Google Analytics