超级详细的Maven教程(二)创建第一个Maven项目hellomaven

简介: 之前讲过Maven介绍及环境搭建,介绍了maven的作用和如何搭建maven环境。接下来就以一个helloworld的例子来说一说如何创建Maven项目以及Maven的项目结构,最后讲Maven如何编译运行项目。

之前讲过Maven介绍及环境搭建,介绍了maven的作用和如何搭建maven环境。接下来就以一个helloworld的例子来说一说如何创建Maven项目以及Maven的项目结构,最后讲Maven如何编译运行项目。

 

一、创建Maven项目

其实所谓创建Maven项目,说白了就是创建一个符合Maven约定的项目骨架,也就是项目目录。这些项目的目录可以手动创建,也可以用maven插件。


这里我就介绍使用archetype插件自动建立目录

首先,创建项目存放的目录(例如d:\maven_project),然后打开终端或者命令行并切换到d:\maven_project目录下,执行以下Maven命令:

mvn archetype:generate -DgroupId=com.weiz.hellomaven -DartifactId=hello-maven-test -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

参数说明

groupId : 标识package命名空间

artifactId: 创建的项目名称


命令行输出如下结果说明项目创建成功。

Picked up _JAVA_OPTIONS: -Dfile.encoding=UTF-8 -Dgroovy.source.encoding=UTF-8
[INFO] Scanning for projects...
.
.省略输出
.
[INFO] Parameter: basedir, Value: D:\maven_project
[INFO] Parameter: package, Value: com.weiz.hellomaven
[INFO] Parameter: groupId, Value: com.weiz.hellomaven
[INFO] Parameter: artifactId, Value: hello-maven-test
[INFO] Parameter: packageName, Value: com.weiz.hellomaven
[INFO] Parameter: version, Value: 1.0-SNAPSHOT
[INFO] project created from Old (1.x) Archetype in dir: D:\maven_project\hello-m
aven-test
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  4.039 s
[INFO] Finished at: 2020-05-23T16:40:59+08:00
[INFO] ------------------------------------------------------------------------

注意:如果是刚安装的Maven,第一次创建项目时可能需要一段时间,因为Maven需要从网上下载大部分最近的artifacts (plugin jars and other files)到你的本地仓库。如果失败了,再执行一次该命令即可。


输出了“BUILD SUCCESS”时表示项目创建成功了,创建一个hello-maven-test的项目。在目录下,可以看到刚创建成功的maven项目。

image.png

 

二、Maven项目结构

Maven工程与以往的java工程目录结构类似,不同的地方在于:以往的java工程目录目录一般只有一个src用于存放包及java文件。具体Maven项目结构如下: 

$ MavenProject
|-- pom.xml
|-- src
|   |-- main
|   |   `-- java
|   |   `-- resources
|   `-- test
|   |   `-- java
|   |   `-- resources

上面我们看到maven创建的项目结构,与普通的Java项目结构差不多。一般将java的功能代码,放在main/java下面,而测试代码放在test/java下,这样在运行时,maven才可以识别目录并进行编译。

  • src/main/java - 存放项目.java文件;
  • src/main/resources - 存放项目资源文件;
  • src/test/java - 存放测试类.java文件;
  • src/test/resources - 存放测试资源文件;
  • target - 项目输出目录;
  • pom.xml - Maven核心文件(Project Object Model)

 

三、POM文件详解

1.什么是pom文件

POM代表工程对象模型(Project Object Model)它是使用Maven工作的基本组件,pom.xml位于工程根目录,它是Maven项目中非常重要的文件。下面就是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>
  <groupId>com.weiz.hellomaven</groupId>
  <artifactId>hello-maven-test</artifactId>
  <packaging>jar</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>hello-maven-test</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

 

2.Maven的坐标

maven 的所有构件均通过坐标进行组织和管理。maven 的坐标通过 5 个元素进行定义,其中 groupId、artifactId、version 是必须的,packaging 是可选的(默认为jar),classifier 是不能直接定义的。

  • groupId 这是工程组的标示,它在一个组织或项目中通常是唯一的,例如,上述项目中com.weiz.hellomaven拥有所有当前组织的项目。
  • artifactId 当前工程标识。通常是工程的名称,如上述中的hello-maven-test。groupId和artifactId一起定位了当前项目的仓库中的位置信息
  • version 工程版本号,如:com.weiz.hellomaven:hello-maven-test:1.0-SNAPSHOT

如果要在项目中引用其他第三方的Jar包,只需要在pom.xml中添加该Jar包的Maven坐标即可:

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.15</version>
        </dependency>


四、编译、运行

上面讲了项目的目录结构,已经如何创建项目,那么怎么项目怎么编译、运行呢?

1、编译

打开控制台,进入到新创建的工程的目录下,执行命令:mvn compile

[INFO] Scanning for projects...
[INFO]
[INFO] ----------------< com.weiz.hellomaven:hello-maven-test >----------------
[INFO] Building hello-maven-test 1.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------.
.省略输出
.
[INFO] Nothing to compile - all classes are up to date
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  1.923 s
[INFO] Finished at: 2020-05-23T17:41:56+08:00
[INFO] ------------------------------------------------------------------------

输出了“BUILD SUCCESS”时表示项目编译成功。项目编译成功后会在项目下生成一个target文件夹,里面存放编译后的文件。

 

2、运行测试类

编译成功后执行mvn test命令,运行测试类:mvn test

[INFO] Scanning for projects...
.
省略输出
.
.
-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running com.weiz.hellomaven.AppTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.012 sec
Picked up _JAVA_OPTIONS: -Dfile.encoding=UTF-8 -Dgroovy.source.encoding=UTF-8
Results :
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  3.131 s
[INFO] Finished at: 2020-05-23T17:53:57+08:00
[INFO] ------------------------------------------------------------------------

输出信息里会显示单元测试的成功,失败数。


五、Maven常用命令

来看一下maven几个常用的构建命令,格式为mvn xxx。

命令 功能 备注

mvn compile

编译源代码 这个过程会下载工程所有依赖的jar包
mvn clean 清理环境 清理target目录
mvn test 执行单元测试用例  
mvn install 安装jar包到本地仓库  
mvn dependency:tree 树型显示maven依赖关系 用于排查依赖冲突的问题
mvn dependency:list 显示maven依赖列表  
mvn package 打包,将java工程打成jar包或war包  


除了以上命令之外,还有之前介绍的查看maven版本的命令:mvn -v 。

 

最后

以上,用hellomaven为例,首先介绍了如何创建maven项目、然后maven项目的结构,最后将如何编译运行maven项目。是不是特别简单。虽然简单,但这是所有开发者必学必会的基础技能!

相关文章
|
4月前
|
Java Maven
解决idea每次新建maven项目都需要重新配置maven的问题
解决idea每次新建maven项目都需要重新配置maven的问题
187 1
|
20天前
|
XML Java 测试技术
从零开始学 Maven:简化 Java 项目的构建与管理
Maven 是一个由 Apache 软件基金会开发的项目管理和构建自动化工具。它主要用在 Java 项目中,但也可以用于其他类型的项目。
31 1
从零开始学 Maven:简化 Java 项目的构建与管理
|
1月前
|
Java Maven
maven项目的pom.xml文件常用标签使用介绍
第四届人文,智慧教育与服务管理国际学术会议(HWESM 2025) 2025 4th International Conference on Humanities, Wisdom Education and Service Management
111 8
|
1月前
|
Java 应用服务中间件 Maven
Maven的三种项目打包方式——pom,jar,war的区别
Maven 提供了多种打包方式,分别适用于不同类型的项目。pom 用于父项目或聚合项目,便于项目的结构和依赖管理;jar 用于Java类库或可执行的Java应用程序;war 则专用于Java Web应用程序的部署。理解这些打包方式的用途和特点,可以帮助开发者更好地配置和管理Maven项目,确保构建和部署过程的顺利进行。无论是单模块项目还是多模块项目,选择合适的打包方式对于项目的成功至关重要。
79 3
|
2月前
|
Java 关系型数据库 MySQL
Maven——创建 Spring Boot项目
Maven 是一个项目管理工具,通过配置 `pom.xml` 文件自动获取所需的 jar 包,简化了项目的构建和管理过程。其核心功能包括项目构建和依赖管理,支持创建、编译、测试、打包和发布项目。Maven 仓库分为本地仓库和远程仓库,远程仓库包括中央仓库、私服和其他公共库。此外,文档还介绍了如何创建第一个 SpringBoot 项目并实现简单的 HTTP 请求响应。
159 1
Maven——创建 Spring Boot项目
|
2月前
|
Java 关系型数据库 MySQL
如何使用 maven 创建一个 Spring Boot项目
Maven 是一个强大的项目管理工具,通过配置 `pom.xml` 文件自动获取所需的 jar 包,提高开发效率。其核心功能包括项目构建和依赖管理。项目构建支持编译、测试、打包和发布等流程,而依赖管理则通过中央仓库、本地仓库和私有服务器获取和管理项目依赖。示例中展示了如何创建第一个 SpringBoot 项目并实现简单接口。
45 1
如何使用 maven 创建一个 Spring Boot项目
|
2月前
|
Java Maven Kotlin
idea maven创建kotlin项目
本文介绍了在IntelliJ IDEA中使用Maven创建Kotlin项目的步骤,包括在`pom.xml`文件中添加Maven中央仓库、配置`kotlin-maven-plugin`插件、指定源目录、添加测试插件和执行插件,以及添加Kotlin测试依赖和标准库依赖。文中还提到了如何通过更换镜像或使用代理来解决依赖下载速度慢的问题,并展示了运行示例代码的截图。
120 4
idea maven创建kotlin项目
|
2月前
|
Java Maven Android开发
eclipse创建maven项目
本文介绍了在Eclipse中创建Maven项目的步骤,包括打开Eclipse、选择Java项目、完成项目创建以及自动下载插件的过程。
107 2
eclipse创建maven项目
|
2月前
|
缓存 IDE Java
idea的maven项目打包时没有source下的文件
【10月更文挑战第21天】idea的maven项目打包时没有source下的文件
79 1
|
2月前
|
Java API Apache
除了 Maven,还有哪些工具可以管理项目的依赖和版本冲突
除了Maven,常用的项目依赖管理和版本冲突解决工具有Gradle、Ivy、Ant+Ivy、SBT等。这些工具各有特点,适用于不同的开发环境和需求。
143 2