2.3 MyBatis基础操作

关注

原创 2023-06-08 14:35:36 254 阅读 AI 写同款· GEO 优化 ›

MyBatis 3.4.2实战：数据库交互与操作指南 MyBatis 是一个开源的持久层框架，它提供了对象关系映射（ORM）的持久层框架解决方案。MyBatis 封装了几乎全部的 JDBC 代码和手动设置参数以及获取结果集的过程，使得开发者可以更加专注于 SQL 本身，同时，MyBatis 还支持定制化 SQL、存储过程以及高级映射。MyBatis作为一款优秀的持久层框架，其架构设计简洁且高效，为开发人员提供了方便的数据库操作方式。MyBatis的核心组件包括SqlSessionExecutor和等。：用于构建。阅读详情

1.Mybatis框架

1.1 Mybatis框架介绍

MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。
iBATIS一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBATIS提供的持久层框架包括SQL Maps和Data Access Objects（DAOs）。

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录，利用ORM思想实现了数据库持久化操作。

虽然JDBC是操作数据库性能最好的方式，但因为其操作的复杂性，所以在实际项目开发中并不使用JDBC，MyBatis的性能，便捷性做了很好的均衡，所以大多数项目中都使用MyBatis进行数据库的操作。

1.2 ORM思想

对象关系映射（英语：Object Relational Mapping，简称ORM，或O/RM，或O/R mapping），是一种程序设计技术，用于实现面向对象编程语言里不同类型系统的数据之间的转换。从效果上说，它其实是创建了一个可在编程语言里使用的“虚拟对象数据库”。如今已有很多免费和付费的ORM产品，而有些程序员更倾向于创建自己的ORM工具。

关系映射:

对象映射：映射表
对象中有属性：表中有字段

总结: 以对象的方式操作数据库.

举例说明:

JDBC 方式完成入库操作
- insert into xxxx(字段名称) values (字段的值…)
- select * from xxxxx 结果集需要自己手动封装为对象 (繁琐)
ORM方式实现入库
- userDao.insert(对象)
ORM方式的查询
- List userList = userDao.selectList(对象);

1.3 数据库数据准备

在项目中找到jt.sql文件：
在这里插入图片描述

在SQLyog目录结构空白处单机鼠标右键，选择从外部导入：
在这里插入图片描述

选中文件后，点击执行，完成，然后点击刷新看是否成功导入：
在这里插入图片描述

2.入门案例

2.1 创建项目

首先，我们在当前工程下，新建一个Module：
在这里插入图片描述

在这里插入图片描述

在新项目中添加Lombok，MyBatis，JDBC的jar包：

  		<!--引入插件lombok 自动的set/get/构造方法插件  -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

        <!--mybatis依赖包-->
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.2.0</version>
        </dependency>

        <!--jdbc依赖包-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>

2.2 创建相关物料

2.2.1 创建pojo类

在这里插入图片描述

package com.study.pojo;

import lombok.Data;
import lombok.experimental.Accessors;

import java.io.Serializable;
@Data
@Accessors(chain = true)
public class User implements Serializable {
    private Integer id;
    private String name;
    private Integer age;
    private String sex;
}

2.2.2 编辑mybatis-config.xml文件

Mybatis中需要定义核心配置文件, 在配置文件中需要指定数据库. 相关接口等信息.

首先创建目录和文件：
在这里插入图片描述

mybatis-config.xml文件内容：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
        PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<!--核心配置文件-->
<configuration>

    <!--环境配置标签-->
    <!--MyBatis支持多个数据源的配置，default=“默认链接数据源”-->
    <environments default="development">

        <!--编辑开发环境-->
        <environment id="development">
            <!--MyBatis使用JDBC的方式控制数据库事物-->
            <transactionManager type="JDBC"/>
            <!--type="POOLED" 创建一个数据源吗链接池，每次从池中获取链接-->
            <dataSource type="POOLED">
                <!--版本信息：
                    如果数据源采用5.x的版本， value="com.mysql.jdbc.Driver"
                    如果数据源采用8.x的版本， value="com.mysql.cj.jdbc.Driver"
                -->
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <!--数据库链接地址及用户名，密码-->
                <property name="url" value="jdbc:mysql://127.0.0.1:3306/jt?serverTimezone=GMT%2B8&amp;useUnicode=true&amp;characterEncoding=utf8&amp;autoReconnect=true&amp;allowMultiQueries=true"/>
                <property name="username" value="root"/>
                <property name="password" value="root"/>
            </dataSource>
        </environment>
    </environments>

    <!--Mybatis加载Mapper映射文件-->
    <mappers>
        <mapper resource="mybatis/mappers/UserMapper.xml"/>
    </mappers>
</configuration>

我们可以在idea中查看当前数据库依赖版本：
在这里插入图片描述

2.2.3 编辑UserMapper.xml文件

MyBatis根据接口的规范，需要在自己指定的映射文件中添加sql的语句，从而实现数据库的操作，并且一个接口对应一个映射文件，接下来我们编辑此前创建的映射文件：

<?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">

<!--namespace是mybaits映射文件的唯一标识,与接口对应-->
<mapper namespace="com.study.mapper.UserMapper">
    <!--id 表示接口方法
        resultType 返回值结果类型
    -->
    <select id="findAll" resultType="com.study.pojo.User">
        select * from demo_user
    </select>
</mapper>

2.2.4 编辑测试接口

在这里插入图片描述

此时我们开始接触面向接口编程，因为持久层直接调用处理业务类耦合度太高，所以引入接口的概念，持久层调用接口，实现类实现接口，进行耦合度的分离。

2.2.5 编辑Mybatis测试类

在这里插入图片描述

package com.study;

import com.study.mapper.UserMapper;
import com.study.pojo.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.jupiter.api.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;

class SpringbootDemo2ApplicationTests {
    /**
     * 核心问题: SqlSession 理解为Mybatis操作数据的连接
     * 1. 通过 SqlSessionFactoryBuilder 构建SqlSessionFactory
     */
    @Test
    public void testMyBatis() throws IOException {
        //1.定义核心配置文件的路径
        String resource = "mybatis/mybatis-config.xml";
        //2.通过工具API读取资源文件
        InputStream inputStream = Resources.getResourceAsStream(resource);
        //3.构建SqlSessionFactory
        SqlSessionFactory sqlSessionFactory =
                new SqlSessionFactoryBuilder().build(inputStream);
        //4.获取SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //5.获取Mapper的接口对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        //6.调用接口方法 获取返回值数据
        List<User> userList = userMapper.findAll();
        System.out.println(userList);
        //7.连接用完记得关闭
        sqlSession.close();
        inputStream.close();
    }

}

2.2.6 运行查看测试结果

我们当前面向接口进行测试，所以不能借助spring框架，所以要去掉测试类上的@SpringBootTest注解，单独运行我们的测试方法，查看测试结果：

在这里插入图片描述

2.3 常见错误总结

2.3.1 resultType错误

请添加图片描述

resultType错误，在输入时，一般会自动提示后续路径，建议根据提示输入。

2.3.2 namespace 命名错误

请添加图片描述

检查UserMapper.xml文件中的namespace 命名空间即可。
在这里插入图片描述

2.3.3 mybaits关联mapper映射文件异常

说明: 检查mybatis.config.xml文件中的resource路径请添加图片描述

3.简化测试操作

目前我们在测试时，测试类的代码还是十分的繁琐，其获取SqlSession以及关闭连接完全可以封装起来，接下来我们使用AOP的思想，将其封装，我们在测试类中完成下列代码进行简化测试操作：

package com.study;

import com.study.mapper.UserMapper;
import com.study.pojo.User;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;


class SpringbootDemo2ApplicationTests {

    /**
     * 设计思路:
     *   1.要求每次执行测试方法时 都先生成一个SqlSessionFactory
     *   2.从sqlSessionFactory中获取sqlSession
     *   3.完成业务操作
     *   注解说明:
     *      @BeforeEach 当每次执行@Test注解方法时,都会先执行该方法.
     */
    private SqlSessionFactory sqlSessionFactory;
    @BeforeEach
    public void init() throws IOException {
        String resource = "mybatis/mybatis-config.xml";
        InputStream inputStream = Resources.getResourceAsStream(resource);
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

    }

    @Test
    public void testFind2(){
        SqlSession sqlSession = sqlSessionFactory.openSession();
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        List<User> userList = userMapper.findAll();
        System.out.println(userList);
        sqlSession.close();
    }

    /**
     * 核心问题: SqlSession 理解为Mybatis操作数据的连接
     * 1. 通过 SqlSessionFactoryBuilder 构建SqlSessionFactory
     */
    @Test
    public void testMyBatis() throws IOException {
        //1.定义核心配置文件的路径
        String resource = "mybatis/mybatis-config.xml";
        //2.通过工具API读取资源文件
        InputStream inputStream = Resources.getResourceAsStream(resource);
        //3.构建SqlSessionFactory
        SqlSessionFactory sqlSessionFactory =
                new SqlSessionFactoryBuilder().build(inputStream);
        //4.获取SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();
        //5.获取Mapper的接口对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        //6.调用接口方法 获取返回值数据
        List<User> userList = userMapper.findAll();
        System.out.println(userList);
        //7.连接用完记得关闭
        sqlSession.close();
        inputStream.close();
    }

}