当前位置： 首页 > news >正文

【SpringBoot + MyBatis + MySQL + Thymeleaf 的使用】

news 来源：原创 2025/5/11 14:15:29

目录：

    • 一：创建项目
    • 二：修改目录
    • 三：添加配置
    • 四：创建数据表
    • 五：创建实体类
    • 六：创建数据接口
    • 七：编写xml文件
    • 八：单元测试
    • 九：编写服务层
    • 十：编写控制层
    • 十一：创建页面
    • 十二：返回JSON数据

一：创建项目

 
🟢第一步：打开 IDEA，选择 New Project，选择 Spring Boot，然后按照下面截图进行操作…

在这里插入图片描述

🟢 第二步：添加依赖 (Spring Web场景启动器、Thymeleaf依赖、MyBatis依赖、MySQL驱动依赖 等)

在这里插入图片描述

🟢 稍作等待，IDEA正在帮助我们从Spring官网下载SpringBoot项目的框架，并且正在通过Maven进行构建…

在这里插入图片描述

🟢在IDEA的右下角会有Maven的下载进度。想了解Maven的使用可以参考：Maven的安装与配置教程 👈

 

二：修改目录

 
🟠项目刚创建完的目录结构大致如下，可能包的路径名有所区别，一般用自己所在组织的简拼 👇

https://blog.csdn.net/SuperCodeZhy/article/details/143754767

🟠 添加一些新包，添加之后的项目结构如下 👇

在这里插入图片描述

🟠一般情况下，还会创建一些名为 utils 、common 的包，是为了方便管理和存放其他工具类等。

 

三：添加配置

 

🟣打开项目的默认配置文件 application.properties ，然后复制粘贴以下代码 👇

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/数据库名
spring.datasource.username=数据库用户名
spring.datasource.password=数据库密码
mybatis.mapper-locations=classpath:mapper/*.xml
mybatis.configuration.map-underscore-to-camel-case=true

🟣粘贴后修改 数据库名、数据库用户名、数据库密码 ，修改后的效果如下图所示👇(第一行是项目名，可忽略)

在这里插入图片描述

🟣通常为了结构更加清晰，会将默认配置文件 application.properties 的后缀 改为 .yml 其配置格式如下：

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/数据库名
    username: 数据库用户名
    password: 数据库密码
mybatis:
  mapper-locations: classpath:mapper/*.xml
  configuration:
    map-underscore-to-camel-case: true

在这里插入图片描述

🟣其他配置信息这里就不过多介绍了，大家用到时自会了解~ 😁😁😁

 

接下来，我以 药品管理 为例，简单演示一下各模块代码的编写~ 😊😊😊

 

四：创建数据表

 

🟡首先，在 MySQL 数据库中创建一个数据库，然后在库中创建一个 药品表，SQL 如下 👇

CREATE DATABASE `drug`;
USE DATABASE `drug`;
CREATE TABLE `medicine`  (
  `id` int UNSIGNED NOT NULL AUTO_INCREMENT COMMENT '药品编号',
  `name` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '药品名称',
  `code` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '国药准字',
  `compose` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '药品成分',
  `specs` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '药品规格',
  `usage` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '用法用量',
  `image` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '药品照片',
  `origin` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '生产厂家',
  `count` int UNSIGNED NOT NULL COMMENT '库存数量',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 1 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci ROW_FORMAT = Dynamic;

🟡 然后，在数据表中添加几条数据 (下面是我使用 Navicat 连接了 本地的 MySQL 数据库的截图) 👇

在这里插入图片描述

 

五：创建实体类

 

🔵在 entity 包下创建一个名为 Medicine 的 Java类，如下

package com.nxu.entity;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;

@Data
@AllArgsConstructor
@NoArgsConstructor
@ToString
public class Medicine {
    private int id;             // 药品编号
    private String name;        // 药品名称
    private String code;        // 国药准字
    private String compose;     // 药品成分
    private String specs;       // 药品规格
    private String usage;       // 用法用量
    private String image;       // 药品照片
    private String origin;      // 生产厂家
    private int count;          // 库存数量
}

在这里插入图片描述

 

六：创建数据接口

 

🔴在 Java目录下的 mapper 包中，创建一个名为 MedicineMapper 的 Java接口，如下

package com.nxu.mapper;

import com.nxu.entity.Medicine;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

@Mapper
public interface MedicineMapper {

    List<Medicine> selectAllMedicine();

    Medicine selectOneMedicine(@Param("id") int id);

}

在这里插入图片描述

 

七：编写xml文件

 

接下来我们要使用 Mybatis 框架编写 SQL 语句。为了以后使用的方便，可以添加一个 Mybatis 的 模板文件。

Mybatis 模板文件的代码如下：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="">

</mapper>

🟤复制上面的模板代码，然后打开 IDEA 的 File → Settings，然后进行如下操作 👇

在这里插入图片描述

在这里插入图片描述

🟤然后 我们在 resources 目录下的 mapper 文件中 创建一个名为 MedicineMapper 的 MyBatis XML 文件，并添加以下代码 👇

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.nxu.mapper.MedicineMapper">

    <select id="selectAllMedicine" resultType="com.nxu.entity.Medicine">
        select * from medicine
    </select>

    <select id="selectOneMedicine" resultType="com.nxu.entity.Medicine">
        select * from medicine where id = #{id}
    </select>

</mapper>

🟤这里大家可以安装一个名为 MyBatisX 的插件，挺好用的，如下 👇

在这里插入图片描述

🟤安装好之后，我们的 MyBatis接口 和 MyBatis 的 xml 文件可以点击小鸟进行跳转，还有其他提示功能~

在这里插入图片描述

 

八：单元测试

 

写到这里，我们可以先简单的做个单元测试，确保数据库连通，以及测试 MyBatis 是否可以正常使用。😀😀😀

🟢在我们的 test 目录下，新建一个名为 MedicineTest 的 Java测试类，然后添加以下代码进行测试 👇

package com.nxu;

import com.nxu.entity.Medicine;
import com.nxu.mapper.MedicineMapper;
import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

import java.util.List;

@Slf4j
@SpringBootTest
public class MedicineTest {

    @Autowired
    private MedicineMapper medicineMapper;

    @Test
    public void testSelectAllMedicine() {
        List<Medicine> allMedicine = medicineMapper.selectAllMedicine();
        for (Medicine medicine : allMedicine) {
            log.info(medicine.toString());
        }
    }
}

在这里插入图片描述

🟢点击 方法前面的 启动 按钮，执行单元测试，控制台效果如下 👇

在这里插入图片描述

 

九：编写服务层

 

🟠首先，在 java 目录 下的 service 包中 创建一个名为 MedicineService 的 Java接口，如下 👇

package com.nxu.service;

import com.nxu.entity.Medicine;

import java.util.List;

public interface MedicineService {

    List<Medicine> getAllMedicine();

    Medicine getOneMedicine(int id);
}

🟠然后，继续 在 service 包中创建一个名为 MedicineServiceImpl 的 Java类 继承刚才的接口 👇

package com.nxu.service;

import com.nxu.entity.Medicine;
import com.nxu.mapper.MedicineMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class MedicineServiceImpl implements MedicineService {

    @Autowired
    private MedicineMapper medicineMapper;

    @Override
    public List<Medicine> getAllMedicine() {
        // 此处可以写更多业务逻辑，这里只是简单调用
        return medicineMapper.selectAllMedicine();
    }

    @Override
    public Medicine getOneMedicine(int id) {
        // 此处可以写更多业务逻辑，这里只是简单调用
        return medicineMapper.selectOneMedicine(id);
    }
}

在这里插入图片描述

 

十：编写控制层

 

🟣在 java目录 下的 controller 包中，创建一个名为 MedicineController 的 Java类 👇

package com.nxu.controller;

import com.nxu.entity.Medicine;
import com.nxu.service.MedicineService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

import java.util.List;

@Controller
public class MedicineController {

    @Autowired
    private MedicineService medicineService;

    @RequestMapping("/")
    public String index(Model model) {
        
        model.addAttribute("msg", "我的第N个SpringBoot项目！");

        List<Medicine> list = medicineService.getAllMedicine();
        model.addAttribute("list", list);
        
        return "index";
    }

}

在这里插入图片描述

 

十一：创建页面

 

🔴在 resources 目录的 templates 文件下 创建一个名为 index 的 html 文件，然后添加以下代码 👇

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
    <title>药品管理</title>
    <link href="//unpkg.com/layui@2.10.3/dist/css/layui.css" rel="stylesheet">
</head>
<body>
<h1 th:text="${msg}" style="text-align: center;"></h1>

<table class="layui-table">
    <thead>
    <tr>
        <th>序号</th>
        <th>药品编号</th>
        <th>药品名称</th>
        <th>国药准字</th>
        <th>药品成分</th>
        <th>药品规格</th>
        <th>用法用量</th>
        <th>药品照片</th>
        <th>生产厂家</th>
        <th>库存数量</th>
    </tr>
    </thead>
    <tbody>
    <!--此处演示Thymeleaf的循环，sb是单个数据体的名字，it是迭代器的别名，${medicines}是我们存的集合-->
    <tr th:each="sb,it : ${medicines}">
        <td th:text="${it.index+1}"></td>
        <td th:utext="|编号${sb.id}|"></td>
        <td th:text="${sb.name}"></td>
        <td th:text="${sb.code}"></td>
        <td th:text="${sb.compose}"></td>
        <td th:text="${sb.specs}"></td>
        <td th:text="${sb.usage}"></td>
        <td>
            <img th:src="${sb.image}" width="30px" height="30px" alt="">
        </td>
        <td th:text="${sb.origin}"></td>
        <td>[[${sb.count}]]</td>
    </tr>
    </tbody>
</table>

<script src="//unpkg.com/layui@2.10.3/dist/layui.js"></script>
</body>
</html>

🔴启动项目

在这里插入图片描述

在这里插入图片描述

🔴打开浏览器，输入 localhost:8080，回车，即可看到我们的index页面，以及使用Thymeleaf显示的数据。

在这里插入图片描述

🔴像图片这些静态资源，一般放在 resources 目录下的 static 文件夹中，页面中通过 / 路径 的方式引用 👇

在这里插入图片描述

🔴那么在引用 该 照片时的路径就是 /image/samil.jpg

 

十二：返回JSON数据

 

🟢如果我们写了一个前后端分离项目，或者本身我需要返回JSON格式的数据，那么我们可以这么写 👇

🟡在原来的 MedicineController 中添加以下代码：

    @GetMapping("/medicine/{id}")
    @ResponseBody
    public Medicine getMedicine(@PathVariable Integer id) {
        return medicineService.getOneMedicine(id);
    }

在这里插入图片描述

🟢重启项目，然后浏览器中输入 localhost:8080/medicine/1 然后回车，可以看到返回的数据 👇

在这里插入图片描述

🟢如果你的某个 controller 仅作为数据接口，不返回视图，可以直接用 @RestController ，这个注解相当于 @Controller 和 @ResponseBody 注解的组合，这样当前整个 controller 中都跳过 Spring 的视图解析器。

 

至此，关于 SpringBoot 的简单使用就介绍完了。想要了解更多知识或交个朋友，欢迎访问 👉 作者博客 😁😁😁

 

相关文章：

  • 【数据分享】2020年中国1km精度住宅用地密度栅格数据
  • 机器学习-04-分类算法-03KNN算法案例
  • 腻子刮的遍数越多越好？刮的越厚墙面越平？
  • JAVA- 锁机制介绍 进程锁
  • 力扣百大算法题精选【Hard 模式】Top 100 Liked LeetCode
  • conda安装python 遇到 pip is configured with locations that require TLS/SSL问题本质解决方案
  • 城电科技 | 光伏地砖：零碳城市的 太阳能发电“隐形发电站”
  • Muduo网络库实现 [五] - Poller模块
  • 技术回顾day2
  • Linux 2021韩顺平网课笔记：进程管理
  • 树莓派超全系列文档--(19)树莓派配置网络
  • 音乐缓存管理器的性能优化方法分析
  • 相机的曝光和增益
  • CSS中的overflow属性
  • C#从入门到精通（5）
  • 激活函数学习笔记
  • es 3期 第28节-深入掌握集群组建与集群设置
  • 清理redis缓存
  • 架构师论文《论软件质量保证及其应用》
  • 令牌与签名的区别（IT安全/认证机制）
  • 人民时评：莫让“假俗乱”讲解侵蚀“文博热”
  • 武汉旅游体育集团有限公司原党委书记、董事长董志向被查
  • “拼好假”的年轻人，今年有哪些旅游新玩法？
  • 巴军事行动致印度70%电网瘫痪
  • 秦洪看盘｜交易型资金收缩，释放短线压力
  • 央行：当前我国债券市场定价效率、机构债券投资交易和风险管理能力仍有待提升