maven 入门

2022-08-10 08:22:37

Apache Maven 入门篇 ( 上 )

作者：George Ma

写这个 maven 的入门篇是因为之前在一个开发者会的动手实验中发现挺多人对于 maven 不是那么了解，所以就有了这个想法。
这个入门篇分上下两篇。本文着重动手，用 maven 来构建运行 hellow world 程序，体会一下不用任何 IDE ，只用 maven 是咋回事。然后下篇就讲解一下 maven 的核心概念。写这两篇文章特意回避了复杂的示例，也不使用 IDE ，目的是排除干扰，着重于 maven 本身。

本文的源代码可从这里下载。

Apache Maven 是做什么用的？

Maven 是一个项目管理和构建自动化工具。但是对于我们程序员来说，我们最关心的是它的项目构建功能。所以这里我们介绍的就是怎样用 maven 来满足我们项目的日常需要。
Maven 使用惯例优于配置的原则 。它要求在没有定制之前，所有的项目都有如下的结构：

目录

目的

${basedir}

存放 pom.xml和所有的子目录

${basedir}/src/main/java

项目的 java源代码

${basedir}/src/main/resources

项目的资源，比如说 property文件

${basedir}/src/test/java

项目的测试类，比如说 JUnit代码

${basedir}/src/test/resources

测试使用的资源

一个 maven 项目在默认情况下会产生 JAR 文件，另外 ，编译后 的 classes 会放在 ${basedir}/target/classes 下面， JAR 文件会放在 ${basedir}/target 下面。
这时有人会说了 ， Ant 就没有那么多要求 ，它允许你可以*的定义项目的结构。在这里不想引起口水战哈， 我个人觉得 maven 的这些默认定义很方便使用。 
好了 ，接下来我们来安装 maven 。

Maven 的安装

在安装 maven 前，先保证你安装了 JDK 。 JDK 6 可以从 Oracle 技术网上下载：
http://www.oracle.com/technetwork/cn/java/javase/downloads/index.html。
Maven 官网的下载链接是 : http://maven.apache.org/download.html 。
该页的最后给出了安装指南。

安装完成后，在命令行运行下面的命令：

$ mvn -v 
Apache Maven 3.0.3 (r1075438; 2011-03-01 01:31:09+0800)
Maven home: /home/limin/bin/maven3
Java version: 1.6.0_24, vendor: Sun Microsystems Inc.
Java home: /home/limin/bin/jdk1.6.0_24/jre
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "2.6.35-28-generic-pae", arch: "i386", family: "unix"

如果你看到类似上面的输出的话，就说明安装成功了。
接下来我们用 maven 来建立最著名的“Hello World!”程序 :)
注意：如果你是第一次运行 maven，你需要 Internet 连接，因为 maven 需要从网上下载需要的插件。
我们要做的第一步是建立一个 maven 项目。在 maven 中，我们是执行 maven 目标 (goal) 来做事情的。
maven 目标和 ant 的 target 差不多。在命令行中执行下面的命令来建立我们的 hello world 项目

~$mvn archetype:generate -DgroupId=com.mycompany.helloworld -DartifactId=helloworld -Dpackage=com.mycompany.helloworld -Dversion=1.0-SNAPSHOT -DarchetypeCatalog=internal

archetype:generate 目标会列出一系列的 archetype 让你选择。 Archetype 可以理解成项目的模型。 Maven 为我们提供了很多种的项目模型，包括从简单的 Swing 到复杂的 Web 应用。我们选择默认的 maven-archetype-quickstart ，是编号 #106 ，如下图所示：

maven 入门

连打两个回车，这时候让你确定项目属性的配置，

maven 入门

这些属性是我们在命令行中用 -D 选项指定的。该选项使用 -Dname=value 的格式。回车确认，就完成了项目的建立，如下图所示：

maven 入门

这时候我们看一下 maven 给我们建立的文件目录结构：

maven 入门

maven 的 archetype 插件建立了一个 helloworld 目录，这个名字来自 artifactId 。在这个目录下面，有一个 Project Object Model(POM) 文件 pom.xml 。这个文件用于描述项目，配置插件和管理依赖关系。
源代码和资源文件放在 src/main 下面，而测试代码和资源放在 src/test 下面。

Maven 已经为我们建立了一个 App.java 文件：

    package com.mycompany.helloworld;   

      

    /**  

     * Hello world!  

     *  

     */   

    public class App {   

      

        public static void main( String[] args ) {   

            System.out.println( "Hello World!" );   

        }   

    }  

正是我们需要的 Hello World 代码。所以我们可以构建和运行这个程序了。用下面简单的命令构建：

~$cd helloworld

~$mvn package

当你第一次运行 maven 的时候，它会从网上的 maven 库 (repository) 下载需要的程序，存放在你电脑的本地库 (local repository) 中，所以这个时候你需要有 Internet 连接。Maven 默认的本地库是 ~/.m2/repository/ ，在 Windows 下是 %USER_HOME%\.m2\repository\ 。

maven 入门

如果构建没有错误的话，就会得到类似下面的结果：

maven 入门

这个时候， maven 在 helloworld 下面建立了一个新的目录 target/ ，构建打包后的 jar 文件 helloworld-1.0-SNAPSHOT.jar 就存放在这个目录下。编译后的 class 文件放在 target/classes/ 目录下面，测试 class 文件放在 target/test-classes/ 目录下面。

为了验证我们的程序能运行，执行下面的命令：

~$java -cp target/helloworld-1.0-SNAPSHOT.jar com.mycompany.helloworld.App

maven 入门

运行成功！！

现在你可能会有不少的问题。所以下一篇文章会解释 maven 的核心概念，希望能回答你可能会有的一些疑问。

Apache Maven 入门篇(下)

作者：George Ma

第一篇文章大概的介绍了一下Apache Maven以及它的下载和安装，并且运行了一个简单的示例。那么在对maven有了一点接触后，接下去的一步是要了解maven的核心概念，这样才能在使用maven的时候游刃有余。

接下来我们介绍下面这几个核心概念：

  • POM (Project Object Model)
  • Maven 插件
  • Maven 生命周期
  • Maven 依赖管理
  • Maven 库

POM (Project Object Model)

一个项目所有的配置都放置在 POM 文件中：定义项目的类型、名字，管理依赖关系，定制插件的行为等等。比如说，你可以配置 compiler 插件让它使用 java 1.5 来编译。

现在看一下第一篇文章中示例的 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">
     <modelVersion>4.0.0</modelVersion>

<groupId>com.mycompany.helloworld</groupId> 
     <artifactId>helloworld</artifactId> 
     <version>1.0-SNAPSHOT</version> 
     <packaging>jar</packaging>

<name>helloworld</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>3.8.1</version> 
         <scope>test</scope> 
       </dependency> 
     </dependencies> 
    </project>

在 POM 中，groupId, artifactId, packaging, version 叫作 maven 坐标，它能唯一的确定一个项目。有了 maven 坐标，我们就可以用它来指定我们的项目所依赖的其他项目，插件，或者父项目。一般 maven 坐标写成如下的格式：

    	groupId:artifactId:packaging:version

像我们的例子就会写成：

    	com.mycompany.helloworld: helloworld: jar: 1.0-SNAPSHOT

我们的 helloworld 示例很简单，但是大项目一般会分成几个子项目。在这种情况下，每个子项目就会有自己的 POM 文件，然后它们会有一个共同的父项目。这样只要构建父项目就能够构建所有的子项目了。子项目的 POM 会继承父项目的 POM。另外，所有的 POM都继承了一个 Super-POM。Super-POM 设置了一些默认值，比如在第一篇文章中提到的默认的目录结构，默认的插件等等，它遵循了惯例优于配置的原则。所以尽管我们的这个 POM 很简单，但是这只是你看得见的一部分。运行时候的 POM 要复杂的多。 如果你想看到运行时候的 POM 的全部内容的话，可以运行下面的命令：

$mvn help:effective-pom

Maven 插件

在第一篇文章中，我们用了 mvn archetype:generate 命令来生成一个项目。那么这里的 archetype:generate 是什么意思呢？archetype 是一个插件的名字，generate是目标(goal)的名字。这个命令的意思是告诉 maven 执行 archetype 插件的 generate 目标。插件目标通常会写成pluginId:goalId

一个目标是一个工作单元，而插件则是一个或者多个目标的集合。比如说Jar插件，Compiler插件，Surefire插件等。从看名字就能知道，Jar 插件包含建立Jar文件的目标， Compiler 插件包含编译源代码和单元测试代码的目标。Surefire 插件的话，则是运行单元测试。

看到这里，估计你能明白了，mvn 本身不会做太多的事情，它不知道怎么样编译或者怎么样打包。它把构建的任务交给插件去做。插件定义了常用的构建逻辑，能够被重复利用。这样做的好处是，一旦插件有了更新，那么所有的 maven 用户都能得到更新。

Maven 生命周期

在上一篇文章中，我们用的第二个命令是：mvn package。这里的 package 是一个maven的生命周期阶段 (lifecycle phase )。生命周期指项目的构建过程，它包含了一系列的有序的阶段 (phase)，而一个阶段就是构建过程中的一个步骤。

那么生命周期阶段和上面说的插件目标之间是什么关系呢？插件目标可以绑定到生命周期阶段上。一个生命周期阶段可以绑定多个插件目标。当 maven 在构建过程中逐步的通过每个阶段时，会执行该阶段所有的插件目标。

maven 能支持不同的生命周期，但是最常用的是默认的Maven生命周期 (default Maven lifecycle )。如果你没有对它进行任何的插件配置或者定制的话，那么上面的命令 mvn package 会依次执行默认生命周期中直到包括 package 阶段前的所有阶段的插件目标：

  1. process-resources 阶段：resources:resources

  2. compile 阶段：compiler:compile

  3. process-classes 阶段：(默认无目标)

  4. process-test-resources 阶段：resources:testResources

  5. test-compile 阶段：compiler:testCompile

  6. test 阶段：surefire:test

  7. prepare-package 阶段：(默认无目标)

  8. package 阶段：jar:jar

Maven 依赖管理

之前我们说过，maven 坐标能够确定一个项目。换句话说，我们可以用它来解决依赖关系。在 POM 中，依赖关系是在 dependencies 部分中定义的。在上面的 POM 例子中，我们用 dependencies 定义了对于 junit 的依赖：

Xml 代码

  <dependencies>

    <dependency>

      <groupId>junit</groupId>

      <artifactId>junit</artifactId>

      <version>3.8.1</version>

      <scope>test</scope>

    </dependency>

  </dependencies>

那这个例子很简单，但是实际开发中我们会有复杂得多的依赖关系，因为被依赖的 jar 文件会有自己的依赖关系。那么我们是不是需要把那些间接依赖的 jar 文件也都定义在POM中呢？答案是不需要，因为 maven 提供了传递依赖的特性。

所谓传递依赖是指 maven 会检查被依赖的 jar 文件，把它的依赖关系纳入最终解决的依赖关系链中。针对上面的 junit 依赖关系，如果你看一下 maven 的本地库（我们马上会解释 maven 库）~/.m2/repository/junit/junit/3.8.1/ ，

maven 入门

你会发现 maven 不但下载了 junit-3.8.1.jar，还下载了它的 POM 文件。这样 maven 就能检查 junit 的依赖关系，把它所需要的依赖也包括进来。

在 POM 的 dependencies 部分中，scope 决定了依赖关系的适用范围。我们的例子中 junit 的 scope 是 test，那么它只会在执行 compiler:testCompile and surefire:test 目标的时候才会被加到 classpath 中，在执行 compiler:compile 目标时是拿不到 junit 的。

我们还可以指定 scope 为 provided，意思是 JDK 或者容器会提供所需的jar文件。比如说在做web应用开发的时候，我们在编译的时候需要 servlet API jar 文件，但是在打包的时候不需要把这个 jar 文件打在 WAR 中，因为servlet容器或者应用服务器会提供的。

scope 的默认值是 compile，即任何时候都会被包含在 classpath 中，在打包的时候也会被包括进去。

Maven 库

当第一次运行 maven 命令的时候，你需要 Internet 连接，因为它要从网上下载一些文件。那么它从哪里下载呢？它是从 maven 默认的远程库(http://repo1.maven.org/maven2) 下载的。这个远程库有 maven 的核心插件和可供下载的 jar 文件。

但是不是所有的 jar 文件都是可以从默认的远程库下载的，比如说我们自己开发的项目。这个时候，有两个选择：要么在公司内部设置定制库，要么手动下载和安装所需的jar文件到本地库。

本地库是指 maven 下载了插件或者 jar 文件后存放在本地机器上的拷贝。在 Linux 上，它的位置在 ~/.m2/repository，在 Windows XP 上，在 C:\Documents and Settings\username\.m2\repository ，在 Windows 7 上，在 C:\Users\username\.m2\repository。当 maven 查找需要的 jar 文件时，它会先在本地库中寻找，只有在找不到的情况下，才会去远程库中找。

运行下面的命令能把我们的 helloworld 项目安装到本地库：

$mvn install

一旦一个项目被安装到了本地库后，你别的项目就可以通过 maven 坐标和这个项目建立依赖关系。比如如果我现在有一个新项目需要用到 helloworld，那么在运行了上面的 mvn install 命令后，我就可以如下所示来建立依赖关系：

Xml 代码

    <dependency>

      <groupId>com.mycompany.helloworld</groupId>

      <artifactId>helloworld</artifactId>

      <version>1.0-SNAPSHOT</version>

    </dependency>

好了，maven 的核心概念就简单的介绍到这里。至于在 Eclipse 中如何使用 maven，这个网上很多了，google 一下就行。

发布仓库

将本地库发布到maven仓库，大家就都可以使用该项目了，命令如下：

mvn deploy

1、maven入门（maven笔记）

字数2034 阅读82 评论1 喜欢4

一、安装

首先maven的配置安装非常简单：将下载下来的压缩包解压之后将bin目录的路径加入到path环境变量下即可，使用mvn –version可以验证。

二、手工演示maven构建java项目

  • 这里我们先手工的创建maven工程
    我们先新建一个目录用来存放maven工程E:\javaWeb\maven\maven-pro。然后新建一个01目录，这个目录就是我们的工程目录，而相关的的java文件必须放在此工程下的src\main\java目录中。

  • 新建一个java文件Hello.java：

package cn.edu.zttc.hello;

 public class Hello{

     public String sayHello(String name){

         return "Hello:" + name;

     }

     public static void main(String[] args){

         System.out.println("Hello World");

     }

 }

注意：这里我们需要将此文件放在01\src\main\java\cn\edu\zttc\hello目录下（根据包名），当然不存在的目录需要我们手工新建出来。

  • 配置一个pom.xml的配置文件
<?xml version="1.0" encoding="UTF-8"?>

<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>cn.edu.zttc.maven.hello</groupId>

    <!--配置项目的一个模块-->

    <artifactId>hello-first</artifactId>

    <!--版本信息：这是一个快照版本-->

    <version>SNAPSHOT-0.0.1</version>

</project>

这样我们就配置好了一个java项目的基本信息。

  • 编译
    使用命令mvn compile进行编译，此时maven就会去*仓库下载所需要的文件（如jar包）。下载下来的文件默认会放在C:\Users\yj\.m2目录中，当然之后我们可能会给maven配置一个本地仓库，那样就不需要每次都进行下载。

  • 配置一个本地仓库
    下载的内容在C:\Users\yj\.m2中，但是为了精确控制maven下载下来的文件，我们在E:\maven中新建了一个文件夹maven\repository（完整路径是：E:\maven\maven\repository），专门用来存放maven下载的文件。而这里我们首先需要对maven安装目录中的conf文件夹中的settings.xml对本地路径进行配置：

    maven 入门
    1

    然后将此文件复制一份到E:\maven\maven中。这里我们的本地仓库中什么都没有，直接将之前下载在C:\Users\yj\.m2中的repository中的所有文件全部拷贝到本目录。这样maven会首先在本地仓库中进行寻找所需的依赖文件，如果本地没有才会去远程仓库中下载。

  • 测试
    编译之后在工程下会多出一个target的目录，这个目录中存放的就是编译好了的文件。现在我们编写一个测试文件TestHello.java（放在E:\javaWeb\maven\maven-pro\01\src\test\java\cn\edu\zttc\hello）：

package cn.edu.zttc.hello;

import org.junit.*;

import static junit.framework.Assert.*;

import cn.edu.zttc.hello.*;

public class TestHello{

    @Test

    public void testHello(){

        Hello h = new Hello();

        assertEquals( h.sayHello("tom"), "Hello:tom");

    }

}

注意：路径的后半部分是根据包名而定的。
同时，显然此测试类需要用到junit的相关包，所以我们需要在pom.xml文件中配置junit:

<?xml version="1.0" encoding="UTF-8"?>

<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>cn.edu.zttc.maven.hello</groupId>

    <!--配置项目的一个模块-->

    <artifactId>hello-first</artifactId>

    <!--版本信息：这是一个快照版本-->

    <version>SNAPSHOT-0.0.1</version>

    <dependencies>

        <dependency>

            <groupId>junit</groupId>

            <artifactId>junit</artifactId>

            <version>4.10</version>

            <scope>test</scope>

        </dependency>

    </dependencies>

</project>

说明：这里暂时不要管如何配置，我们先对maven有个直观的感受。
之后我们在工程01目录下运行命令：mvn test
此时我们会发现在target目录中多出了一些测试报告之类的文件，我们可以查看测试结果。当然我们如果使用命令:mvn clean可以将编译的文件全部删掉。

  • 打包
    我们使用命令：mvn clean package。这个命令就是先清除之前的编译文件然后再次编译。同时还会给我们将本工程的本模块打成一个jar包。
    然后我们再看命令：mvn clean install
    这个命令就是清理之前的文件，再次编译并将打好的包发到本地仓库中。这里注意：将打好的包发布到本地仓库中之后我们在其他项目中就可以使用此包了。

  • 现在在E:\javaWeb\maven\maven-pro中新建另一个工程02。目录结构和之前的一样，这里不再说明。然后我们编写一个java文件World.java：

    package cn.edu.zttc.world;
    
//这里我们是导入的之前的工程（01）
    
import cn.edu.zttc.hello.*;
    
public class World{
    
  public static void main(String[] args){
    
      Hello h = new Hello();
    
      h.sayHello("Jerry");
    
  }
    
}

  • 同时这里需要用到01工程的内容，所以我们需要在本工程的配置文件pom.xml中进行配置

<?xml version="1.0" encoding="UTF-8"?>

<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>cn.edu.zttc.maven.hello</groupId>

    <artifactId>hello-second</artifactId>

    <version>SNAPSHOT-0.0.1</version>

    <dependencies>

        <dependency>

            <groupId>junit</groupId>

            <artifactId>junit</artifactId>

            <version>4.10</version>

            <scope>test</scope>

        </dependency>

        <dependency>

            <groupId>cn.edu.zttc.maven.hello</groupId>

            <artifactId>hello-first</artifactId>

            <version>SNAPSHOT-0.0.1</version>

            <scope>complie</scope>

        </dependency>

    </dependencies>

</project>

  • 之后我们使用命令：mvn package这样就打好一个包了，这是如果我们的01工程中Hello.java文件中增加了一个方法：

    public String hello(){
    
  return “Hello”;
    
}

    这时我们只需要使用命令：mvn clean install重新清理、编译、打包、发布。在02工程中我们就可以直接使用此方法：h.hello();然后再使用命令：mvn clean package即可。

  • 但是很显然，使用这种方式新建一个项目太过于麻烦，那maven为我们提供了一个工具，比如我们现在新建一个项目03。进入03，然后使用命令：
    mvn archetype:generate帮我们新建项目的骨架。

    maven 入门
    2

    碰到这种情况我们直接回车即可。

    maven 入门
    3

    然后到这里也是直接回车。然后我们需要输入一些信息，如下：

    maven 入门
    4

    没有输入的地方表示直接回车。这样我们的项目骨架就搭建好了。

三、使用MyEclipse创建mavne工程

  • 在MyEclipse中配置本地maven
    首先在window-->preference-->Maven4MyEclipse-->Installations-->添加我们自己的maven：选择文件路径E:\maven\maven-3.3.9。

    maven 入门
    5

    然后我们还要设置自己的仓库window-->preference-->Maven4MyEclipse-->User Settings选择自己的仓库中的E:\maven\maven\ settings.xml然后apply-->ok。

    maven 入门
    6

  • 然后我们新建一个maven项目（工程user-core）：
    New-->Maven Project-->Next-->

    maven 入门
    7

    -->Next-->输入我们的模块名称，包名等等信息。这样我们就建立了一个maven项目。

    maven 入门
    8

    之后我们就可以进行相关的开发。

上一篇：Maven学习总结（1）——Maven入门


下一篇：#316 div.2