maven篇2：手动创建maven工程

程序三两行

已于 2022-07-29 11:25:50 修改

阅读量2.9k

点赞数 1

分类专栏： # Idea maven、git/svn 文章标签： maven

于 2022-03-10 17:12:17 首次发布

本文为博主原创文章，未经博主允许不得转载。

本文链接：https://blog.csdn.net/qq_34491508/article/details/123397941

版权

Idea maven、git/svn 专栏收录该内容

16 篇文章 3 订阅

订阅专栏

一、Maven中的坐标

使用三个『向量』在『Maven的仓库』中唯一的定位到一个『jar』包。

groupId：公司或组织域名的倒序，通常也会加上项目名称如：com.csslh.test

artifactId：一个项目或者是项目中的一个模块的 id,模块的名称，将来作为 Maven 工程的工程名如pro1-test

version：模块的版本号，根据自己的需要设定
例如：1.0-SNAPSHOT
SNAPSHOT 表示快照版本，正在迭代过程中，不稳定的版本
RELEASE 表示正式版本

二、坐标和仓库中 jar 包的存储路径之间的对应关系

<groupId>javax.servlet</groupId>
  <artifactId>servlet-api</artifactId>
  <version>2.5</version>

上面坐标对应的 jar 包在 Maven 本地仓库中的位置

Maven本地仓库根目录\javax\servlet\servlet-api\2.5\servlet-api-2.5.jar

三、创建maven工程

1、maven工程说明

使用Maven管理项目的话，那么项目的结构目录务必要按照Maven约定的目录结构来创建项目，我们在官方文档中可以看到Maven提供的目录结构图：
在这里插入图片描述
图中的pom.xml配置文件，它是Maven的核心配置文件，我们的项目版本，jar包依赖等都以标签的形式保存在了这个配置文件中

约定目录结构的意义
Maven 为了让构建过程能够尽可能自动化完成，所以必须约定目录结构的作用。例如：Maven 执行编译操作，必须先去 Java 源程序目录读取 Java 源代码，然后执行编译，最后把编译结果存放在 target 目录。

约定大于配置
Maven 对于目录结构这个问题，没有采用配置的方式，而是基于约定。这样会让我们在开发过程中非常方便。如果每次创建 Maven 工程后，还需要针对各个目录的位置进行详细的配置，那肯定非常麻烦。

目前开发领域的技术发展趋势就是：约定大于配置，配置大于编码。

2、手动创建maven项目

我们知道了maven项目所要遵循的结构格式，先不使用eclipse和idea创建项目，手动创建一个maven项目，不过在此之前我们需要一个包含文件头的pom.xml的模板文件，在哪找呢？很简单，现在许多开源项目都是通过maven去打包的，比如mybatis，我们找到mybatis的jar包，解压后可以在目录中看到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/maven-v4_0_0.xsd">

</project>

然后创建项目，依据Maven约定的目录结构创建文件夹以及pom.xml文件，如下图所示，首先在src/main/java目录下创建我们的java类源文件：

 package com.wl.maven01.model;
 
 public class HelloWorld{
 
          public String sayHello(){
 
                 return "Hello World!";
 
          }
 
    }

接下来在src/test/java目录下创建用于测试的测试类java源文件：

主要用于测试HelloWorld类的sayHello方法的返回值与断言是否一致，代码如下：

package com.wl.maven01.model;
 
import org.junit.*;
 
import org.junit.Assert.*;
 
public class HelloWorldTest{
 
     @Test
 
     public void testHello(){
 
        Assert.assertEquals("Hello World!",new HelloWorld().sayHello());
 
     }  
 
    }

这里引入了junit的jar包，Maven的一大特点就是通过pom.xml去管理jar包，我们只需要在配置文件中写入依赖的相关配置，那么Maven就会自动从Maven中央仓库中将我们的jar包下载到本地仓库，关于依赖和仓库的概念后面再细说，这里我们只需要知道我们的Maven项目不必再手动将jar包add到项目的classpath中，而是在pom.xml中声明即可，Maven会自动下载到本地。下面看看我们的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/maven-v4_0_0.xsd">
 
      <modelVersion>4.0.0</modelVersion>
 
      <groupId>com.wl.maven01</groupId>
 
      <artifactId>maven-test</artifactId>
 
      <version>0.0.1-SNAPSHOT</version>
 
     
 
      <dependencies>
 
        <dependency>
 
          <groupId>junit</groupId>
 
          <artifactId>junit</artifactId>
 
          <version>4.11</version>
 
        </dependency>
 
      </dependencies>
 
    </project>

modelVersion ——描述这个pom.xml文件是遵从哪个版本的项目描述符，maven3应当设置成4.0.0

groupId ——指明了创建项目的组织的唯一标识符，一般就是包名了

artifactId ——指的是项目中的主要的模块名（primary artifact），默认命名方式是“项目名-模块名”

version ——指的是项目模块的版本，通常使用的是Maven的快照版本（例如：0.0.1-SNAPSHOT）

配置文件和java文件都写好之后，我们就可以通过Maven去编译、测试以及打包我们项目了。

这里总结一下maven常用的命令

mvn Clean清理编译的文件
 
mvn compile编译主目录文件
 
mvn test 编译并运行test里的代码
 
mvn package打包
 
mvn install 将项目发布到本地仓库

首先是编译项目，我们在命令行下切换到我们Maven项目的根路径下：

test>mvn compile

可以看到Compiling 1 source file to xxx BUILD SUCCESS字样，即编译了一个源文件到D盘的Maven01/target/classes目录下，下面我们再观察一下之前的Maven项目目录，会多出一个target目录
通过mvn test命令来对运行我们Maven项目的单元测试：
Running com.wl.maven01.model.HelloWorldTest BUILD SUCCESS字样，显而易见的已经成功运行了我们的测试类。在target文件夹下又多出了2个文件夹

surfire-reports目录用于存放生成的测试报告，而test-classes同理肯定是用于存放测试类编译后的字节码文件了。

打包命令——mvn package：
打包成功，打好的jar包在D:/test/target根目录下，我们可以在指定的jar
Clean命令

可以看到当我们执行了clean命令之后，显示了Deleting e:/Maven01/target，即删除了target文件夹，最后显示了BUILD SUCCESS字样即执行成功。

然后执行install命令，执行之后显示Installing F:/MavenTest02/pom.xml to E:/apache-maven-3.3.3/repo…

不难发现我们的test2已经成功打包并作为一个普通的构件安装到了我们本地的Maven仓库中。这样当我们在其他的Maven项目如果需要用到test中的类时，就可以将它作为普通的依赖导入到pom.xml中即可，例如这样：

3、自动构建项目&项目骨架

上面是手动的去创建目录文件夹，在实际开发中显然是不可取的，实际开发肯定是通过IDE去创建项目，而IDE也无法自动创建，而是间接的调用了Maven的项目构建命令，那么接下来就学习一下构建命令的提供者——Archetypes插件，首先看一下官网的介绍：
在这里插入图片描述
可以在官网的这段简介中看到，使用archetype插件可以创建Maven项目，而且一个archetype会提供许多项目模板（骨架），上图中的代码也给出了archetype插件的使用命令和参数名。通常情况下我们使用mvn archetype:generate命令即可，如官方文档中Introdution to Archetypes中介绍的一样，
————————————————
在这里插入图片描述

下面我们在命令行实际操作一下试试看，切换到F:/test3（空目录）后，输入mvn archetype:generate，

Choose a number or apply filter (format: [groupId:]artifactId, case sensitive contains): 7:【直接回车，使用默认值】

Define value for property 'groupId': com.atguigu.maven

Define value for property 'artifactId': pro01-maven-java

Define value for property 'version' 1.0-SNAPSHOT: :【直接回车，使用默认值】

Define value for property 'package' com.atguigu.maven: :【直接回车，使用默认值】

Confirm properties configuration: groupId: com.atguigu.maven artifactId: pro01-maven-java version: 1.0-SNAPSHOT package: com.atguigu.maven Y: :【直接回车，表示确认。如果前面有输入错误，想要重新输入，则输入 N 再回车。】

完成项目创建，直接安装并运行一下这个项目，通过mvn install将我们这个项目编译打包并安装到本地仓库，并通过java命令去运行jar包

我们还可以通过指定参数名的方式去创建指定的某种骨架的项目，在上面的“How do I make my first Maven Project”的截图中我们可以看到官方提供的几个参数，分别是-DarchetypeGroupId、-DgroupId、-DartifactId。比如依旧创建上面的那个默认项目的话，我们可以直接运行这个命令：

mvn archetype:generate -DgroupId=com.wl.maven04 -DartifactId=maven04-model -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

这样就避免了我们去选择，而直接创建默认的骨架——maven-archetype-quickstart的项目了。我们在之前运行mvn archetype:generate命令时也看到了这个插件为我们提供的骨架有1393之多，即使我们使用了filter也很难选择，不过没关系，官方给我们提供了几个最常用的骨架以供选择：
在这里插入图片描述
如上图所示，可以看到有web project的骨架，simple maven project的骨架等等，我们根据需要自行选择即可，再补充一个很常用的骨架：maven-archetype-webapp，我们在创建web项目的时候更多的应该会选择这个骨架。下面我们就用这个骨架创建一个web项目并在浏览器Hello World！首先创建一个新的目录MavenWebTest，在命令行中切换到该目录并输入命令

在这里插入图片描述

可以看到我们输入了命令并指定参数之后，成功在我们的F:/MavenWebTest目录下创建了mavenweb-model这个web项目，创建完成后我们把这个项目导入到MyEclipse中看一下目录结构（注意MyEclipse的话需要通过maven插件提供的导入来导入maven项目

可以发现src/main下多了一个webapp目录，而这个目录其实就和我们普通web项目的webroot或webcontent是一样的了，我们的web相关文件（js、jsp、css）等都应该放在这个目录下了，下面再看一下这个自动生成的maven web项目的pom文件吧：注意一下packaging元素，它的值是war，也就说明我们执行mvn package打包项目的时候会在target目录下生成一个war包，直接发布这个war包即可！