Skip to content

15. 附录

15.1. 使用 Laragon 的 MySQL 数据库管理系统

本文档的第 10 章和第 11 章使用 MySQL 8 数据库管理系统。在 Windows 上安装它最简单的方法是安装 Laragon,这是一个便携式开发环境,包含 MySQL、图形客户端 HeidiSQL、已配置好的终端、Apache 和 PHP。作者在其 PHP 课程中也使用它。

15.1.1. 安装

可以从以下地址下载 Laragon: https://laragon.org。安装过程是标准的;你可以保留建议的安装文件夹([C:\laragon])。Laragon 提供 MySQL 8(确切版本取决于 Laragon 的版本),其管理员账户 [root] 没有密码,服务器在本机的 3306 端口上监听。这就是本文档示例所假定的配置,其中 JDBC URL 的形式为:

jdbc:mysql://localhost:3306/dbarticles

用户名为 [root] ,密码为空。如果 MySQL 是以其他方式安装的,并为 [root] 设置了密码,则必须相应地修改示例([.properties] 文件或程序顶部的常量)。

对于没有 Laragon 的系统,你也可以从 https://dev.mysql.com/downloads/mysql/ 安装 MySQL Community Server,或其开源衍生版本 MariaDB。不过,这些示例只在 MySQL 8 上测试过:第 10 章的脚本使用了 MySQL 8 特有的排序规则([utf8mb4_0900_ai_ci]),对于 MariaDB,需要对其进行调整,JDBC 驱动也一样(MariaDB 提供自己的驱动)。

15.1.2. 启动和停止 MySQL

Laragon 主窗口包含一个启动服务器(Apache 和 MySQL)的 “Start All” 按钮和一个停止它们的 “Stop” 按钮。MySQL 不是在系统启动时运行的 Windows 服务:它只在从 Laragon 启动时运行,这样可以避免它在不使用时消耗资源。Laragon 菜单(在窗口中右键单击)还允许你只启动 MySQL 并选择其版本。

当 MySQL 没有运行时,第 10 章和第 11 章的程序会因 JDBC 驱动抛出异常而失败,表示无法建立连接([CommunicationsException]:“Communications link failure”):出错时这是首先要检查的事项。

15.1.3. 命令行客户端

Laragon 中的 Terminal 按钮会打开一个终端,其中可使用 Laragon 命令,包括 MySQL 命令行客户端([mysql])。要连接到服务器,请使用:

> mysql -u root

然后输入以分号结尾的 SQL 命令([show databases;]、[use dbarticles;]、[select * from articles;]),并用 [exit] 退出。该客户端还可以运行 SQL 脚本,第 10 章正是这样创建其数据库的:

1
2
3
> cd java-oct-2026\10-jdbc\sql
> mysql -u root < dbarticles.sql
> mysql -u root < dbtaxes.sql

这些脚本在每次运行时都会完全重新创建其数据库:测试之后,你可以重新运行它们,把数据恢复到初始状态。

15.1.4. HeidiSQL 图形客户端

Laragon 的 Database 按钮会启动图形客户端 HeidiSQL。首次启动时,HeidiSQL 提供一个已为 Laragon 的 MySQL 服务器配置好的连接会话(主机 [127.0.0.1],用户 [root],密码为空,端口 3306);只需打开它即可。你将看到:

  • 左侧是服务器的数据库及其表的树状视图;
  • 右侧是一些选项卡,显示表的结构、其数据(可以直接编辑),以及用于输入 SQL 查询的区域(“Query”选项卡),查询通过 [F9] 执行。

要使用第 10 章的脚本创建数据库,请在查询选项卡中打开该脚本(通过“File”菜单中加载 SQL 文件的命令),然后执行它([F9])。你也可以使用 HeidiSQL 的菜单创建数据库、用户和用户权限(右键单击连接 /“Create New”/“Database”;“Tools”菜单 /“User Manager”),但 SQL 脚本的优点是可重现、可重新运行。

IDE 也可以连接到数据库:IntelliJ IDEA 通过其“Database”窗口,VS Code 通过“SQLTools”或“MySQL”等扩展。

15.1.5. 本文档中的数据库

第 10 章和第 11 章使用以下数据库,它们都位于本地 MySQL 服务器上:

数据库
章
创建方式
[dbarticles]
10
脚本 [10-jdbc/sql/dbarticles.sql]:来自 JDBC 示例的表 [articles]
[dbtaxes]
10
脚本 [10-jdbc/sql/dbtaxes.sql]:[Tax] 应用程序版本 6 的 [brackets] 表和 [admtaxes] 用户
[hbfirst], [hbarticles], [hbshop], [hbclients], [hbconcurrency]
11
由程序自身创建(JDBC URL 的选项 [createDatabaseIfNotExist=true] ;表由 Hibernate 或带版本的脚本创建)
[hbtaxes]
11
由 [Tax] 应用程序版本 7 中的 [CreateDatabase] 程序创建并填充

测试完成后,可以使用 SQL 命令 [drop database name;] 在 [mysql] 客户端或 HeidiSQL 中删除数据库。

15.2. 所用的 Maven 依赖

下表汇总了本文档中 Maven 项目所使用的库,以及测试这些示例时所用的版本。当项目首次构建时,它们会由 [mvn] 命令(或 IDE 的命令)连同它们所依赖的库一起自动从 Maven Central 下载:因此那时需要 Internet 访问。

库(groupId:artifactId)
版本
章
[tools.jackson.core:jackson-databind] (Jackson 3)
3.1.5
5, 6, 12, 13
[org.junit.jupiter:junit-jupiter] (JUnit 6)
6.0.3
6, 10
[org.springframework:spring-context] (Spring Framework)
7.0.9
6, 10, 11, 12
[org.springframework:spring-orm]
7.0.9
11
[com.mysql:mysql-connector-j] (MySQL JDBC 驱动)
9.7.0
10, 11
[com.zaxxer:HikariCP] (连接池)
7.0.2
10, 11
[ch.qos.logback:logback-classic] (日志)
1.5.38
10, 11
[org.hibernate.orm:hibernate-core] (Hibernate ORM)
7.4.5.Final
11
[org.eclipse.angus:angus-mail] (Jakarta Mail)
2.0.3
12
[org.springframework.boot:spring-boot-starter-parent] 和 [spring-boot-starter-webmvc] (Spring Boot)
4.1.1
13

所用的 Maven 插件有 [maven-compiler-plugin] 3.15.0、[maven-surefire-plugin] 3.5.6(测试执行)、[exec-maven-plugin] 3.5.1([mvn exec:java])和 [spring-boot-maven-plugin] 4.1.1([mvn spring-boot:run])。第 10 章至第 13 章中 [Tax] 应用程序的项目还依赖于模块 [examples.tax:tax-dao], [tax-business], and [tax-ui] (版本 5.0),必须使用在 [mvn install] 文件夹中输入的 [06-architectures/TaxV5] 命令将其安装到本地仓库中(第 6 章)。