MyBatis操作数据库实现

说明:MyBatis是作用于三层架构开发,数据访问层(Data Access Object)的框架,用于访问数据库,对数据进行操作。

一、环境搭建

首先,创建一个SpringBoot模块,然后把MyBatis的环境搭建起来。因为MyBatis是作用于Dao层的,故先省去Service层,重点关注Dao层中与数据库的交流。

(1)创建Springboot模块

我这里是手动创建SpringBoot模块方式,在idea中创建一个SpringBoot模块,参考(http://t.csdn.cn/RJ2gu)

pom.xml文件中添加的继承和依赖

在这里插入图片描述

(2)添加MyBatis依赖

在SpringBoot模块基础上,添加MyBatis依赖和数据库的配置文件

添加MyBatis依赖

在这里插入图片描述

添加数据库的配置文件(application.properties)

放在 src/main/resources 目录下,注意 数据库链接(数据库端口号、数据库名)、用户名和密码
在这里插入图片描述

(3)添加其他依赖

启动项目,我们还需要一些额外的依赖(lombok、druid、test),方便开发和测试,另外数据库的配置文件也添加一些额外配置

pom.xml文件

lomhok:可以帮助我们一键生成javaBean的set()、get()、toString()方法;

druid:使用阿里巴巴提供的连接池;

test:方便测试功能;
在这里插入图片描述

数据库的配置文件(application.properties)

开启驼峰支持:Java和MySQL的命名规范不同,如createTime对应的是MySQL中的create_time,开启此设置,可以自动匹配;

SQL日志:可以将执行的SQL语句打印在控制台中,方便我们排查SQL语句是否执行错误;

在这里插入图片描述

(4)准备数据库

创建数据库,注意数据库名和上面application.properties中配置的数据库名要一致

创建表,添加一些数据

create database mybatis;

use mybatis;

create table tb_stu(
    id int auto_increment primary key comment '序列号',
    name varchar(10) comment '姓名',
    gender varchar(2) comment '性别',
    age tinyint comment '年龄',
    create_time date comment '创建日期'
) comment '学生表';

insert into tb_stu values (null, '加缪', '男', 20, null),
                          (null, '萨特', '男', 25, null),
                          (null, '陀思妥耶夫斯基', '男', 30, '2023-06-08'),
                          (null, '阿加莎克里斯蒂','女','27', null);

(5)创建类

创建学生类(Student)

@Data、@NoArgsConstructor、@AllArgsConstructor,相当于自动为类添加了set()、get()、toString()、无参和全参构造方法

package com.essay.domain;

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

import java.time.LocalDate;

/**
 * 学生类
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Student {
    private Integer id;
    private String name;
    private String gender;
    private Integer age;
    private LocalDate createTime;
}

创建Mapper类

Mapper,是Dao层中,MyBatis的取名方式,也是Dao层的具体表现之一。

package com.essay.mapper;

import org.apache.ibatis.annotations.Mapper;

@Mapper
public interface StuMapper {

    /**
     * 访问数据库,处理数据
     */
    
}

创建启动类(Start)

package com.essay;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Start {
    public static void main(String[] args) {
        SpringApplication.run(Start.class, args);
    }
}

创建测试类(MyTest),模拟Controller层。本来应该注入Service层依赖,因为是介绍MyBatis,我这里直接注入Mapper(Dao层)依赖

package com.essay;

import com.essay.mapper.StuMapper;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
public class MyTest {

    // 注入Mapper依赖
    @Autowired
    private StuMapper stuMapper;

    // 接收前端请求,响应数据
}

另外,还需要注意两点:

a. 测试类的目录要与main中的启动类平行

在这里插入图片描述

b. 测试类的类名,不要取名为Test,因为测试的注解也是Test(@Test)

至此,环境搭建完成,可以开始紧张又刺激的开发了。

二、注解方式

注解方式,是将对数据库进行操作的SQL语句,写在Dao层的各个方法上。

(1)查找所有:

在MyTest(Controller层)中接收请求

@SpringBootTest
public class MyTest {

    // 注入Mapper依赖
    @Autowired
    private StuMapper stuMapper;

    /**
     * 查找所有
     */
    @Test
    public void findAll(){
        List<Student> list = stuMapper.findAll();
        System.out.println(list);
    }
}

在StuMapper(Dao层)中访问数据库,返回数据

@Mapper
public interface StuMapper {


    /**
     * 查找所有
     */
    @Select("select * from tb_stu")
    List<Student> findAll();
}

在这里插入图片描述

(2)添加数据:

在MyTest(Controller层)中接收请求

这里是我手动创建的对象,在正式业务中,数据会由前端传过来,封装成一个对象(需要使用@RequestParam注解),另外对象的创建时间会在Service层中设置,之后再传至Dao层写入数据库。

    /**
     * 添加记录
     */
    @Test
    public void insertStu(){
        Student s = new Student();
        s.setName("伏尔泰");
        s.setGender("男");
        s.setAge(40);
        s.setCreateTime(LocalDate.now());
        stuMapper.insertStu(s);
    }

在StuMapper(Dao层)中访问数据库,添加数据

#{},表示对象s中的对应的属性值,所以一定要注意,#{}里面的名称是对象里面的属性名,而不是数据库里面的字段名

    /**
     * 添加记录
     */
    @Insert("insert into tb_stu(name,gender,age,create_time) value(#{name},#{gender},#{age},#{createTime})")
    void insertStu(Student s);

在这里插入图片描述

(3)修改数据:

在MyTest(Controller层)中接收请求,同样,具体业务中,被修改的对象会被前端传过来,我这里是手动创建模拟修改

    /**
     * 根据ID修改记录
     */
    @Test
    public void updateStu(){
        Student s = new Student();
        s.setId(1);
        s.setName("加缪——修改后");
        stuMapper.updateStu(s);
    }

在StuMapper(Dao层)中访问数据库,修改数据

    /**
     * 修改记录
     */
    @Update("update tb_stu set name=#{name},gender=#{gender},age=#{age} where id=#{id}")
    void updateStu(Student s);

这里,问题出现了,除了name,其他字段也被修改成了。这是因为传进来的对象,仅设置了name,其他属性未设置默认是null。那有没有一种方案,修改时判断对象的属性值是否为空,不为空说明需要修改此字段,则修改数据库中的数据;为空说明不需要修改此字段,那么数据库中就不修改,在xml方式中可以解决此问题(在修改之前,根据ID把数据库中的对象值先找出来,然后在Service层做逻辑判断,是否也可以解决?)。

在这里插入图片描述

(4)删除数据:

在MyTest(Controller层)中接收请求,我这里模拟删除ID是为1的记录

    /**
     * 根据ID删除记录
     */
    @Test
    public void deleteStu(){
        Integer id = 1;
        stuMapper.delete(id);
    }

在StuMapper(Dao层)中访问数据库,删除数据

    /**
     * 根据ID删除记录
     */
    @Delete("delete from tb_stu where id=#{id}")
    void delete(Integer id);

在这里插入图片描述
在这里插入图片描述

小结

以上展现了使用注解方式,对数据库进行查找所有、添加数据、根据ID修改和删除操作,如果还需要做条件查找、删除所有记录等功能,可以先写好SQL语句,根据SQL语句所需要的参数,再设计好Controller层的代码。

三、xml方式

除了注解方式,MyBatis还提供了xml的方式,将方法对应的SQL语句配置到xml文件中,通过方法调用,实现对数据操作。首先,创建好Mapper类对应的xml文件。

创建xml文件

创建xml文件,需要注意以下两点:

a. xml文件需要和Mapper类平行同包同名

在这里插入图片描述

b. 在Resource文件夹中创建多级目录,不能使用点(.),要用斜杠(/)

在这里插入图片描述

在这里插入图片描述

以上两点至关重要,这是xml文件与Mapper类建立联系的过程,联系建立不起来,程序跑不起来。

文件创建好之后,首先在xml文件开头添加约束,不要手敲,建议从官网复制过来(https://mybatis.net.cn/getting-started.html)

Mybatis中文官网

约束添加后,敲一个mapper标签,属性namaspace为Mapper类的全类名。同样,也不要手敲,点击类文件,快捷键ctrl+alt+shift+c,复制粘贴过来。

在这里插入图片描述

(1)查找所有:

在xml文件中配置查找所有方法

StuMapper.xml文件

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

<mapper namespace="com.essay.mapper.StuMapper">

    <!--1.查找所有-->
    <select id="findAll" resultType="com.essay.domain.Student">
        select * from tb_stu;
    </select>

</mapper>

StuMapper类(前面写的注解删掉)

    /**
     * 查找所有
     */
    List<Student> findAll();

需要注意以下两点:

a. xml文件中标签id要与StuMapper类中的对应的方法名一致

b. resultType为返回类型,即返回的数据,需要封装为对象的对象的类全名。

在这里插入图片描述

(2)添加数据:

在xml文件中配置添加数据方法

    <!--2.添加数据-->
    <insert id="insertStu">
        insert into tb_stu(name,gender,age,create_time) value(#{name},#{gender},#{age},#{createTime})
    </insert>

StuMapper类(前面写的注解删掉)

    /**
     * 添加记录
     */
    void insertStu(Student s);

MyTest(测试类)

    /**
     * 添加记录
     */
    @Test
    public void insertStu(){
        Student s = new Student();
        s.setName("卢梭");
        s.setGender("男");
        s.setAge(20);
        s.setCreateTime(LocalDate.now());
        stuMapper.insertStu(s);
    }

在这里插入图片描述

(3)修改数据:

前文说过使用注解方式修改数据的问题,修改指定字段的数据,因为传入Dao层的是一个新建的javaBean对象,未设置的属性,是null,修改数据库时会覆盖原数据。导致欲修改的字段,修改成功;未设置的字段,因为修改被置空。

使用xml方式,可以解决这个问题。使用if标签,判断传入的属性值是否为空,不为空说明是前端请求需要修改的字段,就修改;为空,说明是前端不需要修改的字段,就不修改。

StuMapper.xml文件(注意不要漏掉最后的where语句)

    <!--3.修改数据-->
    <update id="updateStu">
        update tb_stu
        <set>
            <if test="name!=null and name!='' ">
                name=#{name},
            </if>

            <if test="gender!=null and gender!='' ">
                gender=#{gender},
            </if>

            /*因为age是Integer类型,仅判断不为null就行,下面的时间格式也是*/
            <if test="age!=null" >
                age=#{age},
            </if>

            <if test="createTime!=null ">
                create_Time=#{createTime},
            </if>

        </set>
  
        where id=#{id}
    </update>

StuMapper类(前面写的注解删掉)

    /**
     * 修改记录
     */
    void updateStu(Student s);

MyTest(测试类),测试只修改ID为1的姓名字段

    /**
     * 根据ID修改记录
     */
    @Test
    public void updateStu(){
        Student s = new Student();
        s.setId(1);
        s.setName("加缪——修改后");
        stuMapper.updateStu(s);
    }

执行程序,达到了预期结果。

在这里插入图片描述

需要注意以下两点

a. 不要在set标签里面写注释,程序执行时会把注释也当做SQL语句的内容的,所以程序会报错;

在这里插入图片描述

b. set标签里面的每一个修改语句,末尾都要加一个英文逗号(,)

(4)删除数据:

StuMapper.xml文件

    <!--4.删除数据-->
    <delete id="deleteStu">
        delete from tb_stu where id=#{id}
    </delete>

StuMapper类(前面写的注解删掉)

    /**
     * 根据ID删除记录
     */
    void deleteStu(Integer id);

MyTest(测试类),测试删除ID为1的记录

    /**
     * 根据ID删除记录
     */
    @Test
    public void deleteStu(){
        Integer id = 1;
        stuMapper.deleteStu(id);
    }

在这里插入图片描述
在这里插入图片描述

小结

使用xml方式的where(条件查找)、set、if标签,可以完成一些复杂的SQL语句,另外,使用include标签,可以将重复的SQL语句抽取出来,给其他的语句复用。

如我们查询所有语句,使用全字段id,name,gender,age,create_time比使用*效率高,我们就可以把这部分抽出来。

    <!--定义SQL片段-->
    <sql id="selectAll">
        select id,name,gender,age,create_time
    </sql>
    
    <!--1.查找所有-->
    <select id="findAll" resultType="com.essay.domain.Student">
        <include refid="selectAll"></include>
        from tb_stu
    </select>

需要注意,写在sql片段内的SQL语句末尾不要加分号(建议xml内的所有语句末尾都不要加分号)。因为分号表示语句结束,加了分号被其他操作引用时,其他语句操作都会失效。
在这里插入图片描述

总结

(1)如果执行过程中出现以下异常,排查方向如下:

空指针异常:(1)检查数据库配置文件;(2)检查依赖注入和控制反转相关的注解

SQL异常:检查注解和xml文件中的SQL语句是否有错误

(2)关于注解方式和xml方式的选择,在MyBatis中文官网(https://mybatis.net.cn/getting-started.html)中有段话,值得参考。
在这里插入图片描述

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

何中应

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值