下载掌阅APP，畅读海量书库
立即打开
本章将进入正式的项目开发。首先介绍如何搭建Spring Boot项目的基础环境，其中主要包括JDK的安装和配置、项目开发工具的安装与体验，以及Maven的安装和配置。建议读者的开发环境与本书安装的环境等版本保持一致，以避免因版本不兼容等问题而导致各种错误的发生。这样能够确保在开发过程中获得更加稳定和一致的工作环境。
在2.1.3节中提到了本项目所使用的Spring Boot版本为3.1.3，要求最低使用JDK 17的环境，因此，需要选择安装和配置JDK 17版本。
JDK（Java Development Kit）是Java语言的软件开发工具包，提供了Java程序的编译器、虚拟机、调试器及其他辅助工具。它被用于开发和运行Java应用程序和Applet。作为Java平台的核心组件，JDK在Java语言体系中扮演着重要角色。主要版本包括Java SE（标准版）、Java EE（企业版）和Java ME（微型版），分别针对桌面应用程序、Web应用程序和移动应用程序的开发。
首先访问Oracle官方网站https://www.oracle.com/，然后进行登录。如果没有账号，则需要自行注册一个Oracle账号，登录界面如图3-1所示。
选择Resources→Java Downloads选项，如图3-2所示。
跳转页面之后，页面上会出现相关版本的JDK安装包供下载，选择JDK 17→Windows→x64 Installer选项，如图3-3所示。根据计算机系统的配置，选择后缀为.exe的安装包下载，如果是64位的系统，则需要下载对应的x64 Installer的JDK版本；如果是32位的系统，则需要下载对应的x86 Installer的JDK版本。
图3-1 Oracle登录界面
图3-2 选择Resources→Java Downloads选项
图3-3 选择JDK 17安装包
单击对应版本的JDK文件，直接下载即可（本书写作时JDK 17版本还在维护，所以可以直接下载到2024年9月）。如果弹出以下界面，在登录的状态下，勾选“同意许可协议”之后就可以正常下载了（这里笔者使用JDK 8作为演示），如图3-4所示。
图3-4 JDK下载界面
JDK下载完成后，双击该安装文件，然后根据安装向导进行安装。根据页面向导的提示，单击“下一步”按钮，如图3-5所示。
图3-5 JDK安装向导
选择JDK安装的目标文件夹，安装的目录可以进行修改，或者保持默认路径C：\Program Files\Java\jdk-17，笔者直接将其安装到默认路径下。
注意 ： 如果选择自定义安装路径 ， 则安装路径的文件夹名不要包含文字和空格 。
然后单击“下一步”按钮，等待安装完成，如图3-6所示。
提示安装成功后，单击“关闭”按钮，这时JDK已经安装完成，如图3-7所示。
打开安装JDK的地址目录，查看是否有安装信息相关文件夹。例如，笔者选择安装在默认的路径，所以在C：\Program Files\Java\jdk-17目录下就可以看到JDK安装的相关文件夹了，如图3-8所示。
图3-6 选择JDK安装的目标文件夹
图3-7 JDK安装完成
图3-8 JDK安装成功后生成的目录
安装完JDK为什么还要配置环境变量呢？这样做主要是为了确保系统能够准确地定位和正确地使用JDK。当在命令行或其他开发工具中执行与Java相关的命令时，系统需要知道JDK的安装路径，以便找到相应的可执行文件。通过配置环境变量，向系统提供JDK的安装路径信息，从而确保系统能够正确地执行与Java相关的命令。
如果找不到，则可以在计算机左下角的任务栏中找到“搜索”图标，并在搜索栏输入“系统环境变量”就会出现对应的搜索结果，如图3-9所示。
图3-9 搜索“系统环境变量”
打开“编辑系统环境变量”窗口后，单击“环境变量”按钮，如图3-10所示。
打开后会看到共有上下两栏，第一栏是用户变量；第二栏是系统变量，这里要做的就是在系统变量的下方新建一个系统变量。变量名输入JAVA_HOME（这里名字全部大写）。变量值输入JDK安装的路径。具体内容如图3-11所示。
添加完成后，再次新建一个系统变量，变量名为CLASSPATH，变量值为.；%JAVA_HOME%\lib，然后单击“确定”按钮添加完成，具体内容如图3-12所示。
注意 ： 是英文格式下的点 . 分号 ； 百分号 %JAVA_HOME 百分号 % 反斜杠 \lib。
图3-10 打开“系统属性”对话框
图3-11 新建系统变量
图3-12 编辑系统变量
在系统变量中找到Path变量，选中Path，单击“编辑”按钮，然后在窗口的右侧单击“新建”按钮，输入%JAVA_HOME%\bin，最后单击“确定”按钮即可添加成功，如图3-13所示。
图3-13 编辑环境变量
至此，JDK环境变量已经配置完成。接下来测试JDK环境是否配置成功。按Win+R快捷键输入cmd命令，按Enter键，此时会弹出命令提示符窗口，然后输入如下命令：
如果环境配置正确，则在命令提示符窗口中会输出JDK的版本信息，如图3-14所示；如果执行命令后报错，则应先检查一下环境变量配置中的路径和Path中添加的变量是否有问题，然后去分析其他的错误原因。
图3-14 JDK版本信息
JDK和JRE两个有什么区别？这也是在面试时面试官会经常问到的基础题目。先来看一下JDK和JRE的定义。
（1）JDK（Java Development Kit）：JDK是用于Java应用程序开发的工具包。它包含了Java编译器（javac）、Java虚拟机、调试器和其他开发工具，还包括了用于开发Java应用所需的各种类库、头文件和示例代码。JDK适用于开发者，提供了创建、编译和调试Java程序的工具。
（2）JRE（Java Runtime Environment）：JRE是用于运行Java应用程序的环境。它包含了Java虚拟机和Java类库，用于执行Java程序。JRE适用于用户端，用户可以使用JRE来运行Java应用，而不需要进行开发工作。
简而言之，JDK是用于开发Java应用程序的工具包，而JRE是用于运行Java应用程序的运行环境。
目前，Java开发者主要使用的主流开发工具是IntelliJ IDEA。此外，还有两款Java开发工具，分别是Eclipse和MyEclipse，这两款在高校或一些初学者中使用比较多。本项目选择使用企业主流的开发工具IDEA，所有涉及的Java开发编码均采用IDEA开发工具。
IDEA可以被形容为一款现代智能化的开发工具，而Eclipse则有些过时。IDEA拥有强大的静态代码分析功能，能够检测代码错误、潜在问题和代码规范性问题，并提供相应的修复建议。这一特性旨在提升Java开发人员的工作效率和代码质量，因此，它成为许多Java开发者首选的IDE之一。
本书中的项目使用JDK 17的版本，则要求IDEA最低是2022.1及以上的版本，之前的IDEA版本不支持使用JDK 17，所以本书使用的IDEA是Ultimate 2023.1.2的版本。
官方下载网址https://www.jetbrains.com/idea/，单击Download按钮，下载IntelliJ IDEA，如图3-15所示。
图3-15 IntelliJ IDEA官方首页
IDEA官方提供了两个下载版本，一个是IDEA收费的Ultimate版本，但可以免费试用30天，如图3-16（a）所示；另一个是免费的社区Community版本，如图3-16（b）所示。
图3-16 不同版本下载界面
那么这两个版本有什么区别？该如何选择？
（1）IntelliJ IDEA Ultimate版包含了全部功能，并提供了更多高级的功能和工具，如Spring、Hibernate、Web和企业开发等方面的全面支持，而IntelliJ IDEA Community版则是免费的开源版本，功能相对较少，主要关注于核心的Java开发功能。
（2）IntelliJ IDEA Ultimate版支持所有插件，Community版则只支持一部分插件。
综上所述，本项目使用IntelliJ IDEA Ultimate版本来编写项目代码。由于官方提供了30天的免费试用期，对于完成本书的项目开发基本上够用了。
下载完成后，双击运行.exe安装文件，然后单击Next按钮，根据提供的安装导航开始安装，如图3-17所示。
图3-17 IntelliJ IDEA开始安装页面
设置IDEA的安装路径，默认安装在C：\Program Files\JetBrains\IntelliJ IDEA 2023.1.2的目录下，笔者将默认安装地址改为自定义的D：\Software\IntelliJ IDEA 2023.1.2\目录下，然后单击Next按钮，如图3-18所示。
图3-18 设置IDEA安装路径
勾选IDEA需要安装的配置项，IntelliJ IDEA选项表示是否添加桌面图标；Add＂bin＂folder to the PATH选项表示是否添加到系统环境变量；Add＂Open Folder as Project＂选项表示打开文件夹作为项目；Create Associations选项表示默认打开类型。勾选完单击Next按钮，如图3-19所示。
图3-19 勾选IDEA安装配置项
最后，单击Install按钮进行安装，等待安装完成即可，如图3-20所示。
图3-20 安装IDEA
Apache Maven（简称Maven）是一个用于软件项目构建和管理的工具。Maven通过采用标准的目录结构，使不同开发工具中的项目结构能够保持一致。它提供了一系列命令，如清理、编译、测试、安装、打包和发布等，使项目构建变得更加便捷。本书的后端项目也是选择了Maven作为项目依赖管理的工具。
选择Maven主要有以下优点。
（1）自动构建项目，包括清理、编译、测试、安装、打包、发布等。
（2）JAR包依赖管理会自动下载JAR及其依赖的JAR包。
（3）在多种开发工具中也能实现项目结构的统一。
打开Maven官方网站https://maven.apache.org/，单击Download按钮，如图3-21所示。
图3-21 Maven官方首页
目前Maven的最新版本是3.9.4，因Spring Boot使用的版本是3.0以上的，所以笔者在本书中使用的Maven的版本为3.6.3，可以选择历史的版本下载，如图3-22所示。
图3-22 选择下载历史版本
查找到该版本，选择binaries目录下的apache-maven-3.6.3-bin.zip下载完成即可，如图3-23所示。
图3-23 选择Maven安装包
下载完成后无须安装，直接对下载的压缩包进行解压，然后将文件存放到硬盘中即可，例如笔者放在了D：\apache-maven-3.6.3目录下，如图3-24所示。
图3-24 Maven文件目录
接下来配置Maven的环境变量，这里需要注意的是，配置Maven环境变量之前要确保JDK环境的配置没有问题。和之前配置JDK环境变量基本一致。先创建一个系统变量，变量名为MAVEN_HOME（这里的字母全部大写），变量值为Maven存放的路径D：\apachemaven-3.6.3。填写完成后，单击“确定”按钮，保存系统变量，如图3-25所示。
图3-25 Maven编辑系统变量
在系统变量中选中Path，然后单击“编辑”按钮，新建一个Maven的变量，配置Maven的bin目录，添加的配置如下：
配置完成后，打开命令提示符窗口，输入mvn-v命令，查看Maven版本信息。如果配置正确，则会出现版本、安装地址等信息；如果没有显示图3-26所示的信息，则首先需要检查配置的环境变量是否有问题，其次查看下载的Maven包是否完整，如图3-26所示。
图3-26 Maven安装验证
在使用Maven下载项目依赖文件时，首先它会检查本地仓库是否已经存在所需的依赖包，如果没有，则会尝试从中央仓库获取。然而，中央仓库通常位于国外服务器，导致下载速度比较慢，甚至可能导致下载失败，接下来就解决这个问题。
Maven默认的仓库下载地址是在C盘中，但一般不推荐使用C盘存放本地仓库，所以在其他硬盘中创建一个文件夹用来当作Maven的本地仓库文件。例如，笔者将仓库的默认地址改为D：\maven\maven_repository。
本地仓库其实起到了一个缓存的作用，它的默认地址是C：\Users\用户名.m2。现在要修改成自定义的仓库文件，进入Maven的安装目录，在conf文件夹中打开settings.xml配置文件，在文件中找到localRepository标签，localRepository节点是用于配置本地仓库，将创建的仓库地址添加到配置文件中，代码如下：
为了解决下载依赖慢的问题，要对Maven配置进行修改，将默认的中央仓库换成阿里云的中央仓库或者华为云的中央仓库，需要修改Maven在配置文件中的mirrors标签来配置镜像仓库。
本书以阿里云镜像仓库为例，打开Maven的settings.xml配置文件，添加阿里云仓库镜像的配置，需要添加在＜mirrors＞＜/mirrors＞标签中，mirrors可以配置多个子节点，但是它只会使用其中的一个节点生效，即在默认情况下，如果配置多个mirror，则只有第1个生效，代码如下：
如果要在Maven中设置JDK环境，则需要在settings.xml配置文件中的profiles标签中添加代码配置，代码如下：
配置完成后，打开命令提示符窗口，输入mvn help：system命令，如果第1次执行该命令，则在执行命令后会从Maven仓库下载一些必要的插件，下载完成后就会显示有关Maven系统的信息，如图3-27所示。
图3-27 Maven相关信息
到此，Maven安装和配置就结束了，接下来还需要完成MySQL数据库的安装与配置及Navicat工具的安装。
本书中的项目使用的数据库是MySQL，MySQL是目前最流行的关系数据库管理系统，在Web应用方面MySQL是最好的关系数据库管理系统应用软件之一。项目使用的是MySQL 8以上的版本，本项目使用的是MySQL 8.0.34版本。
打开MySQL官方网站https://dev.mysql.com/downloads/mysql/，单击General Availability（GA）Releases按钮，在Select Version中选择下载MySQL的版本；并在Select Operating System中选择下载的操作系统，然后单击Go to Download Page按钮，跳转到下载页面，如图3-28所示。
图3-28 MySQL选择下载版本
然后选择mysql-installer-community-8.0.34.0.msi安装包，单击Download按钮进行下载，如图3-29所示。
单击No thanks，just start my download.协议后，开始下载并安装包，如图3-30所示。
下载完成后，双击下载的安装包，在安装首页勾选Custom选项，即修改成自定义安装，然后单击Next按钮，进行下一步操作，如图3-31所示。
选择要安装的产品，将左侧选择框中的树结构展开，单击MySQL Server 8.0.34-X64，然后单击中间向右的箭头，将其添加到右边待安装区，选择完成后，单击Next按钮，如图3-32所示。
图3-29 选择下载并安装包
图3-30 下载MySQL安装包
图3-31 选择MySQL安装方式
图3-32 选择要安装的MySQL
接下来，选择MySQL安装目录，安装的路径不要有中文名称出现。例如，笔者将MySQL的安装路径修改为D：\Software\MySQL8.0.34，选择完成后，单击Next按钮，如图3-33所示。
图3-33 选择安装路径
接下来根据MySQL安装向导，依次单击Next按钮或Execute按钮安装相关环境。执行到配置MySQL端口的界面时，Port默认为3306端口，其余的配置默认不变，单击Next按钮，如图3-34所示。
接下来的步骤依次单击Next按钮往下执行，直到提示安装完成即可。
安装完成后，打开系统环境变量，在系统变量的Path中添加安装MySQL的路径，这个路径要配置到MySQL路径下的bin目录。如果安装时选择的是默认安装路径，则目录为C：\Program Files\MySQL\MySQL Server 8.0，添加完成后，单击“确定”按钮，保存成功，如图3-35所示。
打开命令提示符窗口，执行的命令如下：
图3-34 设置MySQL端口号
图3-35 编辑环境变量
执行该命令后，显示要输入MySQL密码，该密码是安装数据库时设置的密码，输入密码后按Enter键执行。如果出现图中的Welcome to the MySQL monitor.及数据库版本等信息就说明已经配置成功，如图3-36所示。
图3-36 执行命令后进入MySQL
MySQL已成功安装并运行，但每次操作数据库都需通过命令行方式进入MySQL，然后使用命令进行数据操作。对技术人员而言，这种方式过于烦琐，因此，需要安装一款连接数据库的可视化工具，以便轻松进行数据库操作。
在丰富的可视化工具中，可供选择的主要有DataGrip、DBeaver、Navicat for MySQL（简称：Navicat）及MySQL官方的MySQL Workbench，本项目选择了流行且广泛应用的Navicat。Navicat界面友好、功能强大，可用于多种数据库管理任务。它能通过直观的图形界面连接数据库、执行查询、管理数据，并支持数据库设计等任务，大幅减少了单调的命令行输入。
打开Navicat for MySQL官网https://www.navicat.com.cn/products，可以直接下载目前最新版本Navicat Premium 16，它可以从单一应用程序中同时连接MySQL、Redis、MariaDB、MongoDB、SQL Server、Oracle、PostgreSQL和SQLite等，功能比较全面。本书选择Navicat Premium 16版本来连接数据库。
因为Navicat是收费的工具，所以优先选择免费试用，然后根据计算机的配置进行选择性下载并安装包。下载完成后直接安装，如图3-37所示。
图3-37 Navicat官网下载界面
Navicat安装完成后，打开Navicat工具，单击左上角的“连接”图标，选择MySQL选项，如图3-38所示。
图3-38 新建数据库连接
选择完成后，需要填写MySQL连接信息，这里的密码和端口号都是安装MySQL时配置的。填写完信息后，单击左下角的“测试连接”按钮，如果弹出连接成功窗口，则说明填写的信息是正确的，然后单击“确定”按钮，新建连接成功，如图3-39所示。
图3-39 新建连接
本章着重介绍了项目开发前所需的环境配置工作。通过本章的介绍，目前已经掌握了以下内容。
（1）JDK的重要性不言而喻，JDK作为Java开发所必不可少的工具包，为项目提供了必要的核心库和工具，它确保能够编写、编译和运行Java代码。
（2）本书选择IDEA作为项目的开发工具，IDEA提供了丰富的功能和集成开发环境，有助于提高开发效率。
（3）了解到如何使用Maven来管理项目的依赖关系。Maven能够自动下载并管理所需的库和框架，使项目的依赖管理更加便捷。
（4）目前已经安装了MySQL数据库并配置成功，同时选择了Navicat等可视化工具来方便地操作数据库。
接下来，将迈入项目的正式开发阶段。在这一阶段，将能够运用所搭建的环境，开始编写代码、构建应用程序，并逐步实现项目的各项功能和特性。