信息系统开发实践 | 系列文章传送门
课程概述
Maven上_创建Maven项目
Maven下_Maven项目依赖配置
创建SpringBoot3项目
Spring组件与自动装配
ISDP逻辑架构设计
1 Maven安装配置
Maven(发音[ˈmeɪvn]) 是一个项目管理工具,可以对 Java 项目进行自动化的构建和依赖管理。
目前绝大多数Java项目都是使用Maven进行管理。本课程后端项目使用SpringBoot3框架,需要使用Maven管理项目众多依赖。
因此课程首先介绍Maven的基本配置与使用。
1.1 安装JDK
Maven需要JDK环境。SpringBoot3项目要求JDK17+环境。
JDK17是长期支持版本LTS,建议安装JDK17。笔者安装的是17.0.9,读者可以下载JDK17最新版本。版本无论是前后端开发,都非常重要。开发者需要关注项目的环境和各种依赖版本。
推荐一个JDK下载网站 https://www.injdk.cn/,提供各种版本的JDK,下载速度快。常用有Oracle JDK和OpenJDK。
JDK安装与配置此处不予赘述。
1.2.下载Maven
1.2.1 IDEA捆绑Maven
本课程后端项目使用IDEA,版本为2022.3.3。
IDEA为收费软件,笔者使用教育版。
高校师生可以申请免费Lisence,有效期1年且可以续。
需要说明的是,IDEA捆绑了Maven,版本为Maven v3.8.1。
因此,在开发机上即使不安装Maven,并不影响本课程项目开发。
1.2.2 下载maven压缩包
通常在测试或部署的虚拟机或云服务器上,需要安装Maven。
当然,你也可以在开发机上安装Maven,可以使用命令管理maven项目。
建议下载安装Maven3.8.1版本,保持与IDEA捆绑的版本一致。
maven v3.8.1版本下载地址:
https://archive.apache.org/dist/maven/maven-3/3.8.1/binaries/
Linux建议下载tar.gz压缩包; Windows或Mac可直接选择zip压缩包。
解压到开发机任意目录即完成安装。
注意开发相关的任何文件夹都不要使用中文。Window建议安装到非系统盘。
新建Maven本地仓库目录maven_repository用于存放下载的jar。
1.2.3 配置环境变量
和JDK类似,配置环境变量,可以在cmd环境下运行maven命令。
在系统变量中增加MAVEN_HOME,指向本地maven安装目录
在Path中增加%MAVEN_HOME%\bin
配置好后,打开cmd命令窗口,输入mvn -version,如果看到版本号,配置成功。
1.3 Maven仓库配置
1.3.1 什么是Maven仓库
在 Maven 的术语中,仓库是一个位置。
软件开发中不可避免的需要引入大量的第三方库,这些库所在的位置在Maven中被称为 “仓库”。仓库中存放就是Jar包。
Maven 仓库主要分本地仓库和中央仓库。本地仓库即为本地文件夹。前面已经创建了本地仓库maven_repository
远程Maven中央仓库主要放置公共jar包,是由Apache Maven社区创建的,中央库的网址是:https://repo.maven.apache.org/maven2
Maven项目初始化时会根据项目根目录下的pom.xml配置,从中央仓库下载依赖Jar包到本地仓库。
1.3.2 配置本地仓库路径
Windows系统Maven默认配置文件/仓库路径为C:\用户\xxxx.m2。
Eclipse或IDEA捆绑的Maven之前可能已经在此建有配置文件setting.xml文件和repository仓库。
Maven本地仓库用于存放从中央仓库下载的Jar包,日积月累仓库jar越来越多,设在系统盘可能会影响性能或因为重装windows系统丢失Jar。
强烈建议本地非系统盘创建本地仓库文件夹,如D:\isdp\maven_repository
修改Maven本地安装目录下conf/setting.xml文件中的localRepository标签对内容。指向本地仓库路径。
笔者mac配置参考如下。Windows直接配置本地仓库完整路径。
1.3.3 配置远程仓库阿里云镜像
由于国内访问Maven中央仓库速度较慢,建议使用阿里云镜像仓库。
阿里云镜像仓库地址可能会变化,可通过以下地址查看最新仓库地址。https://developer.aliyun.com/mvn/guide
将上面红色这段代码放入到Maven安装目录下conf/setting.xml文件对应mirrors标签对中。
mirros中可以放入多个mirro,注意保持所有标签成对。
<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
1.4 配置IDEA的Maven环境
由于IDEA已经捆绑了Maven。找到捆绑的Maven的配置文件路径。
然后将前面修改过的setting.xml拷贝到捆绑的配置文件路径予以覆盖。
再次打开设置,观察本地仓库路径是否已经更换成前面配置的本地仓库路径。
2 Maven项目结构
Maven 是一个项目管理工具,可以对 Java 项目进行构建、依赖管理。
Maven 可被用于构建和管理各种项目,例如 C#,Ruby,Scala 等语言编写的项目。
Maven 提倡使用一个共同的标准目录结构,Maven 使用约定优于配置的原则,大家尽可能的遵守这样的目录结构。
下图为Java Maven项目参考标准目录结构。
pox.xml是Maven项目必须的文件。项目有该文件,才能被IDE工具识别为Maven项目。
该文件用于编写依赖坐标。Maven会根据坐标将依赖jar下载到本地仓库。
src为源代码目录。
target为编译后class文件目录。
main用于存放项目代码。
java存放Java源程序.java文件。
resource通常用于存放配置文件等。
test用于存放测试代码。Maven项目打包时,test文件夹会被忽略。
3 创建Maven项目
接下来创建课程后端项目isdp-boot3
选择Java语言、Maven构建系统、JDK17
可以看到创建了标准Maven项目。
打开pom.xml,为方便管理,修改版本号为1.0。
可以看到项目目前只依赖了JDK库。
选中项目,右键,选择打开项目模块设置。
可以对项目进行设置。可以选择语言级别,配置源代码目录等。
本项目暂时不用修改。如果是打开下载的项目,可能需要在此处进行配置。
4 小结
本篇笔记介绍了Maven项目开发环境搭建,IDEA配置、如何创建Maven项目等。
下一篇介绍Maven依赖配置以及常用命令。