1、配置环境——既然是基于spring boot和数据库的接口设计,那么首先需要下载并配置好Java和MySQL环境(可点击蓝色链接跳转到对应的详细配置教程)。于此同时,如果想要可视化数据库表,以便于更直观的管理数据库中的数据,本项目中使用的是DataGrip。
2、创建Spring Boot项目——这时候需要下载开发环境(IDE)了,即intellij idea,建议下载Ultimate版。如果有学校的邮箱的话,可申请免费教育许可证,即可免费使用全部功能。而后打开idea新建Spring Initializr项目,如下图所示:
点击下一步,选择Spring Boot的版本,这里选择了2.7.12,并添加了Spring Web、MySQL Driver、MyBatis Framework依赖项点击“创建”,如下图所示:
至此为止,一个初始的Spring Boot项目就算创建完成了。
3、配置数据库连接——打开 application.properties 文件,写入以下代码来配置MySQL连接:
jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/数据库名?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=UTC
jdbc.username=数据库用户名
jdbc.password=数据库密码
还有部分配置文件直接复制本博客config包中的全部文件即可使用。
4、使用MyBatis创建实体类(entity)、数据访问层(DAO)、mapper映射文件 ——在intellij idea中,找到偏好设置中的插件选项,搜索Free MyBatis plugin如下图所示:
点击安装图中的MyBatis插件后重启IDE。之后,你可对在项目右侧的数据库表点击鼠标右键,会出现如下图所示的选项:
点击mybatis-generator后,会出现生成页面:
按图中的路径设置后,即可自动生成entity、DAO、mapper文件。其中,entity是一个新的Java类来表示你的数据库表,一般我们称之为Java Bean。例如,有一个admin_user表,Spring中的entity文件夹中则需要创建一个 AdminUser 类,包含了相应的属性(字段)和访问器(getter和setter方法),关系对应示意图如下:
DataGrip中的数据库数据
Spring boot项目中的Java Bean
DAO中的接口则与mapper中SQL语句相对应,关系对应图如下:
DAO中与mapper对应的接口
mapper中的SQL语句
5、创建接口服务(service)——在service文件夹中创建对应服务的接口类,示例如下:
与此同时,我们需要再service文件夹下再创建一个Impl文件夹,用于实现这个接口类,如下图所示:
在这里,通过访问之前创建好的dao方法,实现对数据处理操作。
6、创建控制器类(controller)——在这里,你可为你的http服务接口取任何名字,这里以获取全部管理员账号接口(getAdminUserList)为例:
controller中的http接口实现
postman返回结果