当前位置: 首页 > news >正文

【Maven】(二)使用 Maven 创建并运行项目、聊聊 POM 中的坐标与版本号的规则

文章目录

  • 1.前言
  • 2.hello-world
    • 2.1.Archetype 创建
    • 2.2.使用 IDE 创建
    • 2.3.Maven的目录结构
  • 3.pom的基本组成
    • 3.1.Maven坐标的概念与规则
    • 3.2.版本号规则
    • 2.3.打包成可运行的JAR
  • 4.结语

1.前言

本系列文章记录了从0开始到实战系统了解 Maven 的过程,Maven 系列历史文章:

(一)5分钟做完 Maven 的安装与配置

在上一篇文章中,我们已经快速的安装并配置好了 Maven 的环境,现在就可以开始将 Maven用起来了,在开始创建 Maven 项目之前,先介绍一个本篇文中涉及到的内容,包括:

  • Maven 的快速开始
  • Maven 项目的目录结构
  • POM 文件的基本组成(简要版,更详细的介绍会随着本专题的推进慢慢展开)
  • 坐标、版本号、以及SNAPSHOT的含义
  • Maven 自带插件的使用

接下来,我们就开始吧!

2.hello-world

首先,我需要创建一个 Maven 的项目,创建项目的方式多种多样,例如:手动创建 Maven 的目录结构与 pom 文件、使用 Archetype 生成Maven 的项目、或者直接使用 IDE 进行创建。

2.1.Archetype 创建

Archetype 是 Maven 用来初始化项目骨架的插件(Maven 有很多自带的插件,很多时候我们都意识不到自己在使用),由于我们使用的是 Maven3,可以直接运行下面的指令:

mvn archetype:generate

第一次运行这个指令的时候,会从中央仓库中下载插件,所以会看到控制台一长串的输出,直到:
在这里插入图片描述
这里的左边那一串数字有点类似于需要使用的 Maven项目目标,右边默认的 1982 指的是maven-archetype-quickstart,我们可以在控制台中找到它:
在这里插入图片描述
如果不需要使用其他模板的话,直接回车即可,接下来回提示输入 groupIdartifactIdversion 等,这个其实就是生成的 POM 中需要的坐标数据,此处将 groupId 填写为 com.ls.mavendemoartifactId 填写为 hello-world(在下面POM的基本组成中会解释为什么),再一顿回车之后,项目就创建成功了。
在这里插入图片描述在这里插入图片描述

2.2.使用 IDE 创建

在实际的开发中,我们可能更多的会使用IDE来生成 Maven 项目,图形化的界面会更加友好,例如使用 Idea 来创建:

File -> new -> project
在这里插入图片描述
然后,就可以输入 groupIdartifactIdversion 几个参数了:
在这里插入图片描述
点击Next -> Finish 项目就创建完成了。

2.3.Maven的目录结构

在这里插入图片描述
忽略掉 .idea 文件夹,上图中的剩余部分就是 Maven 的目录结构了,这种目录结构是 Maven 的规范所规定的,在 src 下面会包含 maintest两个文件夹,两者代表了不同的分工环境:

  • main:写功能代码
  • test:写测试代码

在这里面的 java 指的是放置代码的文件夹,同样的在 java 的同级目录下,往往还会有一个 resources 文件夹用于放置项目中使用到的配置文件、模板文件等静态文件,例如:xml、properties等。
在这里插入图片描述

3.pom的基本组成

打开 pom.xml ,可以看到里面有大概有70多行配置:

<?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>com.ls.mavendemo</groupId><artifactId>hello-world</artifactId><version>1.0-SNAPSHOT</version><name>hello-world</name><!-- FIXME change it to the project's website --><url>http://www.example.com</url><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><maven.compiler.source>1.7</maven.compiler.source><maven.compiler.target>1.7</maven.compiler.target></properties><dependencies><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.11</version><scope>test</scope></dependency></dependencies><build><pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) --><plugins><!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle --><plugin><artifactId>maven-clean-plugin</artifactId><version>3.1.0</version></plugin><!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging --><plugin><artifactId>maven-resources-plugin</artifactId><version>3.0.2</version></plugin><plugin><artifactId>maven-compiler-plugin</artifactId><version>3.8.0</version></plugin><plugin><artifactId>maven-surefire-plugin</artifactId><version>2.22.1</version></plugin><plugin><artifactId>maven-jar-plugin</artifactId><version>3.0.2</version></plugin><plugin><artifactId>maven-install-plugin</artifactId><version>2.5.2</version></plugin><plugin><artifactId>maven-deploy-plugin</artifactId><version>2.8.2</version></plugin><!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle --><plugin><artifactId>maven-site-plugin</artifactId><version>3.7.1</version></plugin><plugin><artifactId>maven-project-info-reports-plugin</artifactId><version>3.0.0</version></plugin></plugins></pluginManagement></build>
</project>

我们先把这个文件改纯净一点,删除一部分内容

  • build -> pluginManagement: 里面的内容是Maven会使用到的默认插件,这里不需要进行配置先删除掉。
  • url: 是建立网站需要的信息,我们现在不需要建站。
  • properties:是配置的变量,这个常用于统一管理依赖包的版本,后续的文章中会将,这里暂时用不到。

下面是清理过后的 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>com.ls.mavendemo</groupId><artifactId>hello-world</artifactId><version>1.0-SNAPSHOT</version><name>hello-world</name><dependencies><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.11</version><scope>test</scope></dependency></dependencies></project>

先看一下各个标签的含义:

  • <project> :POM 的根元素,定义了一些POM相关的规范。
  • <modelVersion>: POM版本号,我们用的是 Maven3 这里只能是4.0.0
  • <groupId> <artifactId> <version>:项目的坐标,用于确定一个唯一的项目,下面会详细提到
  • <name>:当前项目的名称
  • <dependencies>:当前项目引入的依赖
  • <dependency>:单个需要引入的具体的依赖包
  • <scope>:依赖的范围,常见的有 compiletest,不同的范围起到包隔离的作用,这个在后面依赖相关的文章中详细讲

3.1.Maven坐标的概念与规则

在一个三维的空间坐标系中,我们可以通过 x,y,z 三个方向的坐标确定做坐标系上的唯一一个点。
Maven的坐标概念与之类似,在建立Maven仓库的时候我们也可以通过 <groupId> <artifactId> <version> 的值来确定唯一一个构件,下面依次来看看这三者的填写规则。

  • <groupId>:指的是当前构建隶属的实际项目,一般是 公司的网址倒序 + 项目名
  • <artifactId>:一般是指的当前项目中的其中一个模块
  • <version>:当前项目的版本号

以 SpringBoot 为例:

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter</artifactId><version>2.7.8</version>
</dependency>

org.springframework.boot 就是 Spring 所在公司的 SpringBoot 项目,spring-boot-starter这个项目的其中一个模块,版本号为2.7.8
同理如果我们要引入Web模块,自然就应该是:

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><version>2.7.8</version>
</dependency>

为什么 groupId 不能直接是一个组织呢,要细化到一个项目呢?
一般来说一个公司、组织上不会只有一个项目,如果 groupId 直接占用了组织,那项目名就只有放到 artifactId 中了,但是一个项目也有可能会有过个模块,模块名就没有地方放了。
所以我们在实际开发中创建一个 Maven 项目的时候,可以尽可能的遵守这样的约定。

3.2.版本号规则

看到这里,相信大家已经注意到了,上面引入的 SpringBoot 的版本号是 3位数,而自己创建的 hello-world 项目版本号只有 2位,并且后面还有一个 SNAPSHOT

Maven 的版本号规则实际上也是业界的通过规则,它的定义方式如下:

{主版本号}.{次版本号}.{增量版本号}-{里程碑版本}
  • 主版本号:一般是指的当前的项目有了重大的架构变动,版本之间几乎完全不兼容,例如:最近出的 SpringBoot3 就已经放弃了Java8,如果不升级 JDK的话,还是只能使用SpringBoot2
  • 次版本号:一般是指的项目的迭代版本,这种版本会修复大量的bug,带来一些小的新特性等,但是没有什么架构上的重大变化。
  • 增量版本号:一般是用于修复一些紧急bug,改动量很小时,可以使用增量版本号。
  • 里程碑版本:就是项目的当前版本处于一个什么样的阶段了,常见的里程碑版本有 SNAPSHOTalphabetareleaseGA 等。
    在里程碑的版本中,标注SNAPSHOT的为开发版,此时会存在大量的代码变动,alphabeta分别对应的是内测版与公测版这三个版本都是属于不稳定版本,使用的时候非常容易踩坑,所以一般只用的demo体验,在正式环境中不能使用。
    releaseGA都属于是稳定的正式版本,可以在正式环境中使用。

下面是SpringBoot的一些版本号,可以体验一下:
在这里插入图片描述


这里需要再提一嘴,SNAPSHOT 在 Maven仓库中有特别的含义,处于这个里程碑版本的项目可以多次install到仓库中,每一次都会覆盖前一次生成的包,但是非 SNAPSHOT 的版本是不能覆盖的,每次install都需要修改版本号。

如果不理解这段话,可以继续关注后续的文章,会讲到如何将项目打包到本地仓库以及推送到私服中。

2.3.打包成可运行的JAR

我们在开发完代码之后,需要将代码打包到测试环境中测试,Maven 提供了项目构建相关的插件,我们只需要直接使用即可。单项目的打包非常简单,我们可以进入到项目所在的根目录中(pom所在目录),执行下面的指令。

mvn clean package
  • clean:清空上一次生成的target目录,避免最新修改的代码没有被打包到新版本中造成一些意外的情况。
  • package:将当前代码打成一个可以执行的jar包。

执行完成之后,在src 目录下会出现一个同级的target目录,里面就会出现一个满足当前项目坐标的jar包:
在这里插入图片描述
我们通过 java -jar 运行这个 jar 包,会发现无法运行:

hello-world-1.0-SNAPSHOT.jar中没有主清单属性

如何才能运行呢?
在这里插入图片描述
我们需要执行的是这个App类里面的main方法,而正常的打包方式,没有指定执行它,所以我们需要通过shade插件来指定一下,在pom.xml中加入插件:

<build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-shade-plugin</artifactId><version>3.2.4</version><executions><execution><phase>package</phase><goals><goal>shade</goal></goals><configuration><transformers><transformerimplementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer"><mainClass>com.ls.mavendemo.App</mainClass></transformer></transformers></configuration></execution></executions></plugin></plugins>
</build>

mainClass 中指定需要运行的类的全类名
在这里插入图片描述
再次重试打包运行,运行成功。
在这里插入图片描述


4.结语

本篇讲述了如何使用 Maven 自带的插件以及IDE 创建、打包、运行项目,同时介绍了 pom.xml 文件的基本组成,以 SpringBoot为例,介绍了坐标和版本号的使用规则。

到目前为止,已经可以使用Maven来进行一些简单的开发工作了,但距在公司中与同事一起协作开发较大的项目还有一定的差距,可以继续关注本专题的后续文章。

下一篇将会讲述 Maven 仓库的使用以及 Maven 私服的安装和使用。


如果觉得本文有帮助的话,可以帮忙点点赞哦!

http://www.lryc.cn/news/17942.html

相关文章:

  • (考研湖科大教书匠计算机网络)第六章应用层-第六节:电子邮件
  • 一、初识TypeScript、什么是类型系统
  • 一文了解什么是字节对齐(超详细)
  • Java无法通过形参设置为null改变实参
  • GEE:样本点选择教程
  • 3.知识图谱相关学习资料汇总,提供系统化的知识图谱学习路径。一份详细的指南,补全你知识的漏洞
  • TypeScript学习笔记(一)编译环境、数据类型、函数类型、联合类型
  • 为什么要移除数据库物理外键?
  • Linux 计划任务讲解
  • Qt智能指针模板类的使用方式和区别总结
  • 【STL】模拟实现vector
  • Window 的 PHP XAMPP 安装 mongodb 的扩展
  • Codeforces Round #849 (Div. 4)(E~G)
  • 网易云音乐财报解读:收入大增亏损收窄,“云村”草长莺飞
  • MariaDB-10.8.6安装+主从搭建
  • Win11系统user profile service服务登录失败解决方法
  • Solon2 之基础:四、应用启动过程与完整生命周期
  • Java性能分析
  • 2023年阿里云ECS服务器S6/C6/G6/N4/R6/sn2ne/sn1ne/se1ne处理器CPU性能详解
  • 数据分析与SAS学习笔记8
  • 切割多个conf文件Nginx和Apache配置多版本PHP
  • 使用Navicat进行SSH加密方式连接MySQL数据库
  • 大数据Hadoop教程-学习笔记04【数据仓库基础与Apache Hive入门】
  • 20230223 刚体上的两个点速度之间的关系
  • 17.1 Display system tasks
  • 【4】linux命令每日分享——cd切换路径
  • 诚邀您体验人工智能AI
  • 【蓝桥杯集训·每日一题】AcWing 2058. 笨拙的手指
  • 运维排查篇 | Linux 连接跟踪表满了怎么处理
  • docker网络基