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 的形式为:
用户名为 [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])。要连接到服务器,请使用:
然后输入以分号结尾的 SQL 命令([show databases;]、[use dbarticles;]、[select * from articles;]),并用 [exit] 退出。该客户端还可以运行 SQL 脚本,第 10 章正是这样创建其数据库的:
这些脚本在每次运行时都会完全重新创建其数据库:测试之后,你可以重新运行它们,把数据恢复到初始状态。
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 章)。