`

maven 教程二 深入

 
阅读更多

一:编写POM 

引用
<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/xsd/maven-4.0.0.xsd"> 

  <modelVersion>4.0.0</modelVersion> 
  <groupId>com.mycompany.app</groupId> 
  <artifactId>my-app</artifactId> 
  <version>1.0-SNAPSHOT</version> 
  <packaging>jar</packaging> 

  <name>my-app</name> 
  <url>http://maven.apache.org</url> 

  <properties> 
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> 
  </properties> 

  <dependencies> 
    <dependency> 
      <groupId>junit</groupId> 
      <artifactId>junit</artifactId> 
      <version>4.7</version> 
      <scope>test</scope> 
    </dependency> 
  </dependencies> 
</project> 


1:project是所有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/xsd/maven-4.0.0.xsd"> 


</project> 


它还声明了一些POM相关的命名空间及xsd元素,虽然这些属性不是必须的,但使用这些属性能够让第三方工具(如IDE中的XML编辑器)帮助我们快速编辑POM。 

2:<modelVersion>4.0.0</modelVersion> 
根元素下的第一个子元素modelVersion指定了当前POM模型的版本,对于Maven2及Maven 3来说,它只能是4.0.0。 

3:groupId,artifactId和version三行 
pom.xml中最重要的是groupId,artifactId和version三行。这三个元素定义了一个项目基本的坐标,在Maven的世界,任何的jar、pom或者war都是以基于这些基本的坐标进行区分的。 

3.1:groupId 
定义了项目属于哪个组,这个组往往和项目所在的组织或公司存在关联,譬如你的公司是mycom,有一个项目为myapp,那么groupId就应该是com.mycom.myapp。 

3.2:artifactId 
定义了当前Maven项目在组中唯一的ID,在前面的groupId为com.mycompany.app的例子中,你可能会为不同的子项目(模块)分配artifactId,如:myapp-util、myapp-domain、myapp-web等等。本例中artifactId 为 my-app 

3.3:version 
顾名思义,version指定了项目当前的版本。 

引用
<version>1.0-SNAPSHOT</version>


SNAPSHOT意为快照,说明该项目还处于开发中,是不稳定的版本。随着项目的发展,version会不断更新,如升级为1.1-SNAPSHOT、1.0、1.1、2.0等等。本书的6.5小节会详细介绍SNAPSHOT,第13章介绍如何使用Maven管理项目版本的升级发布。 

4:name元素 
声明了一个对于用户更为友好的项目名称,虽然这不是必须的,但我还是推荐为每个POM声明name,以方便信息交流。 


没有任何实际的Java代码,我们就能够定义一个Maven项目的POM,这体现了Maven的一大优点,它能让项目对象模型最大程度地与实际代码相独立,我们可以称之为解耦,或者正交性,这在很大程度上避免了Java代码和POM代码的相互影响。比如当项目需要升级版本时,只需要修改POM,而不需要更改Java代码;而在POM稳定之后,日常的Java代码开发工作基本不涉及POM的修改。 

二:编写主代码 

1:主代码的位置: 
项目主代码和测试代码不同,项目的主代码会被打包到最终的构件中(比如jar),而测试代码只在运行测试时用到,不会被打包。默认情况下,Maven假设项目主代码位于src/main/java目录。我们遵循Maven的约定,创建该目录,然后在该目录下创建文件com/mycompany/app/App.java 

引用
package com.mycompany.app; 

/** 
* Hello world! 
* 
*/ 
public class App 
{ 
    public static void main( String[] args ) 
    { 
        System.out.println( "Hello World!" ); 
    } 
}



2:注意事项: 
关于该Java代码有两点需要注意。首先,在95%以上的情况下,我们应该把项目主代码放到src/main/java/目录下(遵循Maven的约定),而无须额外的配置,Maven会自动搜寻该目录找到项目主代码。其次,该Java类的包名是com.mycompany.app 或者 com.mycompany.app.my-app,这与我们之前在POM中定义的groupId和artifactId相吻合。一般来说,项目中Java类的包都应该基于项目的groupId和artifactId,这样更加清晰,更加符合逻辑,也方便搜索构件或者Java类。 

3:编译主代码: 
代码编写完毕后,我们使用Maven进行编译,在项目根目录下运行命令 mvn clean compile ,我们会得到如下输出: 

 

clean告诉Maven清理输出目录target/,compile告诉Maven编译项目主代码,从输出中我们看到Maven: 

引用
首先执行了clean:clean任务,删除target/目录,默认情况下Maven构建的所有输出都在target/目录中; 
接着执行resources:resources任务(未定义项目资源,暂且略过); 
最后执行compiler:compile任务,将项目主代码编译至target/classes目录


    上文提到的clean:clean、resources:resources,以及compiler:compile对应了一些Maven插件及插件目标,比如clean:clean是clean插件的clean目标,compiler:compile是compiler插件的compile目标,后文会详细讲述Maven插件及其编写方法。 

    至此,Maven在没有任何额外的配置的情况下就执行了项目的清理和编译任务,接下来,我们编写一些单元测试代码并让Maven执行自动化测试。 

三:编写测试代码 

1:在pom.xml中增加junit依赖 
Maven项目中默认的测试代码目录是src/test/java,在Java世界中,由Kent Beck和Erich Gamma建立的JUnit是事实上的单元测试标准。要使用JUnit,pom.xml中要有下列代码: 

引用
  <dependencies> 
    <dependency> 
      <groupId>junit</groupId> 
      <artifactId>junit</artifactId> 
      <version>4.7</version> 
      <scope>test</scope> 
    </dependency> 
  </dependencies>


dependencies元素下可以包含多个dependency元素以声明项目的依赖,这里我们有一个依赖groupId是junit,artifactId是junit,version是4.7。前面我们提到groupId、artifactId和version是任何一个Maven项目最基本的坐标,JUnit也不例外,有了这段声明,Maven就能够自动下载junit-4.7.jar。也许你会问,Maven从哪里下载这个jar呢?在Maven之前,我们可以去JUnit的官网下载分发包。而现在有了Maven,它会自动访问中央仓库(http://repo1.maven.org/maven2/),下载需要的文件。读者也可以自己访问该仓库,打开路径junit/junit/4.7/,就能看到junit-4.7.pom和junit-4.7.jar。本书第6章会详细介绍Maven仓库及中央仓库。 

上述POM代码中还有一个值为test的元素scope,scope为依赖范围,若依赖范围为test则表示该依赖只对测试有效,换句话说,测试代码中的import JUnit代码是没有问题的,但是如果我们在主代码中用import JUnit代码,就会造成编译错误。如果不声明依赖范围,那么默认值就是compile,表示该依赖对主代码和测试代码都有效。 

2:编写测试代码 

 

3:调用Maven执行测试 
运行 mvn clean test : 

 

四:打包和运行 

将项目进行编译、测试之后,下一个重要步骤就是打包(package)。POM中没有指定打包类型,使用默认打包类型jar,我们可以简单地执行命令 mvn clean package 进行打包。类似地,Maven会在打包之前执行编译、测试等操作。这里我们看到jar:jar任务负责打包,实际上就是jar插件的jar目标将项目主代码打包成一个名为hello-world-1.0-SNAPSHOT.jar的文件,该文件也位于target/输出目录中,它是根据artifact-version.jar规则进行命名的,如有需要,我们还可以使用finalName来自定义该文件的名称,这里暂且不展开。

分享到:
评论

相关推荐

    maven教程-maven教程-maven教程

    通过本文的介绍,我们可以了解到Maven的基本概念、安装配置、基本使用和深入应用详解。 Maven的基本概念包括POM(Project Object Model,项目对象模型)、标准集合(archetype)、项目生命周期和依赖管理系统。POM...

    Maven 教程:基础篇-尚硅谷学习笔记 2022年

    **Maven教程:基础篇——尚硅谷学习笔记 2022年** Maven是一个强大的Java项目管理和构建工具,由Apache软件基金会开发。它通过提供一个标准的项目对象模型(Project Object Model,POM)来简化项目的构建过程,并...

    Maven教程.docx

    ### Maven教程知识点详解 #### 一、Maven概述 **Maven** 是一款项目管理和集成工具,主要用于简化软件项目的构建过程。它通过提供一个统一的标准生命周期框架,使得开发者能够自动完成项目的基础设施搭建工作。...

    Maven教程资料.pdf

    本篇教程将带你深入理解Maven的核心概念和基本操作。 首先,Maven是一个基于项目对象模型(Project Object Model,简称POM)的项目管理工具。POM是Maven的核心,它是一个XML文件,包含了项目的基本信息、构建指令、...

    maven 详细教程 实战 例子 电子书

    通过阅读"Maven2详细教程.doc"、"Maven+in+action.pdf"、"Maven2+Eclipse开发J2EE.pdf"和"maven入门时写的博客.pdf"这些资料,你可以深入理解Maven的各个方面,从基础到高级,从理论到实践,掌握这个强大的项目管理...

    Maven精品教程视频源码

    本教程将全面深入地探讨Maven的核心概念、配置、生命周期、插件以及实际项目中的应用,旨在帮助开发者高效地管理和构建Java项目。 **一、Maven基本概念** 1. **项目对象模型(Project Object Model, POM)**:...

    maven教程,项目教程+源代码,全教程

    ** Maven教程全攻略:项目构建与管理利器 ** Maven是一个强大的Java项目管理和构建工具,它简化了构建过程,统一了构建方式,并通过依赖管理帮助开发者解决类库版本冲突问题。本教程旨在全面讲解Maven的使用,包括...

    maven与maven教程

    通过阅读这本书,你可以深入理解Maven的工作原理,并学习如何在实际项目中有效利用Maven提高开发效率。 总的来说,Maven提供了一种标准化的方式来管理Java项目,通过其强大的依赖管理和自动化构建能力,极大地简化...

    maven精品视频教程

    "Maven 精品视频教程"是一套针对Java开发人员设计的教育资源,旨在深入解析Maven这一强大的构建工具。通过视频教学的方式,该教程不仅详细介绍了Maven的基本概念和核心功能,还结合实际项目进行实践讲解,帮助学习者...

    maven学习教程分享

    本教程将深入探讨Maven的核心概念和使用技巧,帮助你快速掌握这个强大的工具。 1. Maven基本概念: - 项目对象模型(Project Object Model,POM):Maven的配置文件,包含了项目的基本信息、依赖、构建目标等。 -...

    Maven精品教程视频01

    【 Maven 精品教程视频01 】:这是一份关于 Maven 的详细教学资源,旨在帮助初学者和有经验的开发者深入理解并熟练掌握 Maven 这一强大的Java项目管理和构建工具。Maven 提供了一个统一的方式来管理项目的构建、报告...

    maven教程-v1.0

    ### Maven教程知识点详解 #### Maven概述 - **Maven定义**:Maven是一款由Apache基金会提供的项目管理和构建工具。它的核心理念是通过一种简洁、统一的方式管理项目的构建、依赖关系和文档,以此来提高开发效率并...

    maven最全教程.doc

    本教程将详细介绍Maven的主要功能、原理以及如何安装和使用。 **1. 为什么使用Maven** 1. **模块化管理**:当项目变得庞大时,Maven允许我们将项目拆分为多个独立的模块,每个模块对应一个工程,便于团队成员分工...

    maven 简单使用教程

    - Better Builds with Maven:一本免费电子书,提供更深入的Maven使用指南。 2. Maven与Ant的区别: - Maven采用声明式配置,避免了Ant中的复杂脚本编写。 - Maven提供了一种标准的构建生命周期,包括清理、编译...

    maven安装教程

    Maven安装教程: Maven是目前广泛使用的一款项目管理和构建自动化工具,它依赖于项目对象模型(POM)文件来描述项目和管理项目的...随着对Maven的深入了解和应用,开发者可以更好地掌握Java项目的自动化构建和依赖管理。

    maven详细教程

    完成这个教程后,你将深入理解Maven 2的设计理念,并具备使用Maven构建和管理项目的基本技能。这对于参与到Apache和Codehaus社区的大型项目至关重要。不过,这个教程假设你对Java开发有一定的了解,熟悉构建工具,...

    Maven教程.rar

    本教程将带你深入理解Maven的基本概念和核心功能,助你高效地进行Java项目开发。 1. Maven的基本概念: Maven是一个基于项目对象模型(POM)的概念,它定义了项目的结构和构建过程。POM文件是Maven的核心,包含了...

    尚硅谷Maven课程笔记代码资源

    二、Maven仓库 Maven依赖管理的关键在于它的中央仓库,存储了大量的开源库,开发者无需手动下载即可直接引用。此外,还可以设置本地仓库和私有远程仓库,以满足特定项目的需求。Maven通过解析POM文件中的依赖声明,...

    java-springmvc-maven基础教程

    本教程将深入讲解如何使用Java、SpringMVC和Maven构建一个基础的Web应用程序。SpringMVC是Spring框架的一部分,用于构建强大的、灵活的Web应用,而Maven则是一个项目管理和综合工具,能够帮助开发者管理依赖、构建...

Global site tag (gtag.js) - Google Analytics