SSM框架之Mybatis学习笔记1

最新推荐文章于 2025-08-12 21:03:53 发布

你不必是我的

最新推荐文章于 2025-08-12 21:03:53 发布

阅读量242

点赞数

CC 4.0 BY-SA版权

文章标签： java spring 开发语言

本文链接：https://blog.csdn.net/qq_46003863/article/details/122296588

MyBatis是一款优秀的持久层框架，提供自定义SQL、存储过程和高级映射，简化数据库操作。其SqlSessionFactoryBuilder用于创建SqlSessionFactory，SqlSessionFactory作为应用范围内的单例对象，SqlSession则代表每个数据库连接，需要在使用后关闭。MyBatis通过XML或注解配置映射，支持动态SQL。在实际应用中，包括创建数据库、配置环境、编写Mapper接口及XML文件，以及进行CRUD操作等步骤。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Mybatis

是一款优秀的持久层框架
- 持久化：将程序的数据在持久状态和瞬时状态转化的过程
- 持久层：完成持久化工作的代码块
支持自定义 SQL、存储过程以及高级映射
免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作
MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。
获取 Mybatis 的方法
1. Maven
2. Github
Mybatis 的优点
- 简单易学
- 灵活
- 解除 sql 与程序代码的耦合，sql 和代码的分离，提高了可维护性。
- 提供映射标签，支持对象与数据库的 orm 字段关系映射
- 提供对象关系映射标签，支持对象关系组建维护
- 提供 xml 标签，支持编写动态 sql。

生命周期和作用域

不同作用域和生命周期类别是至关重要的，错误的使用会导致非常严重的并发问题

在这里插入图片描述

SqlSessionFactoryBuilder

一旦创建了 SqlSessionFactory，就不再需要它了
该实例的最佳作用域是方法作用域（局部变量）

SqlSessionFactory

可以看做是数据连接池
SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在
最佳作用域是应用作用域（全局变量）
最简单的就是使用单例模式或者静态单例模式

SqlSession

可以看做是连接到数据连接池的一个请求
SqlSession 的实例不是线程安全的，不能被共享，最佳的作用域是请求或方法作用域（局部变量）
用完之后需要及时关闭，防止资源被占用

第一个 Mybatis 程序

搭建环境

创建数据库

create database `mybatis`;
use `mybatis`;
create table `user`(
    `id` int not null ,
    `name` varchar(30) default null,
    `password` varchar(50) default null,
    primary key(`id`)
);
insert into `user`(`id`,`name`,`password`) values
(1,'张三','123456'),
(2,'李三','123456'),
(3,'王三','123456'),
(4,'赵三','123456')

导入依赖

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.9</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.25</version>
        <scope>compile</scope>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13.2</version>
        <scope>compile</scope>
    </dependency>
</dependencies>

创建模块

编写 Mybatis 的核心配置文件

每一个 xml 文件都必须在 Mybatis 核心配置文件中注册

<?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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?userSSL=true&amp;userUnicode=true&amp;characterEncoding=utf-8"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <!--注册xml文件-->
    <mappers>
        <mapper resource="org/mybatis/example/BlogMapper.xml"/>
    </mappers>
</configuration>

编写 Mybatis 的工具类

package com.yqly.utils;

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 java.io.IOException;
import java.io.InputStream;

public class MybatisUtils {

    private static SqlSessionFactory sqlSessionFactory;
    static {
        try {
            //获取sqlSessionFactory对象
            String resource="mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }
}

编写代码

实体类

package com.yqly.pojo;

public class User {
    private int id;
    private String name;
    private String password;

    public User() {
    }

    public User(int id, String name, String password) {
        this.id = id;
        this.name = name;
        this.password = password;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", name='" + name + '\'' +
                ", password='" + password + '\'' +
                '}';
    }
}

Dao/Mapper 接口

public interface UserDao {
    List<User> getUserList();
}

接口实现类

由原来的 UserDaoImpl 文件转化为一个 Mapper.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">
<!--通过namespace绑定一个对应的Dao/Mapper接口-->
<mapper namespace="com.yqly.dao.UserDao">
    <!--通过id绑定对应的方法，result设置返回值类型-->
    <select id="getUserList" resultType="com.yqly.pojo.User">
        select * from mybatis.user
    </select>
</mapper>

测试

public class UserDaoTest {
    @Test
    public void test(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();       //获得SqlSession对象
        //执行SQL
        UserDao mapper = sqlSession.getMapper(UserDao.class);
        List<User> userList = mapper.getUserList();
        for (User user : userList) {
            System.out.println(user);
        }
        sqlSession.close();       //关闭SqlSession
    }
}

CRUD

namespace 中的包名要和 Dao/Mapper 接口的包名一致
id：对应的 namespace 中的方法名
resultType：Sql 语句执行的返回值
parameterType：参数类型

参数用 #{参数名} 形式获得
增删改需要提交事务
当实体类或数据表的字段过多，可以考虑使用 Map，提高效率
只有一个基本类型的情况下，可以直接在 sql 中取到
多个参数用 Map 或者注解

增删改查的步骤

1.编写接口

//获取指定id的用户列表User getUserById(int id);//添加用户int addUser(User user);//修改用户int updateUser(User user);//删除用户int deleteUser(int id);

2.编写对应 Mapper.xml 中的 sql 语句

<!--获取指定id的用户列表--><select id="getUserById" resultType="com.yqly.pojo.User" parameterType="int">    select * from mybatis.user where id=#{id}</select><!--添加用户--><insert id="addUser" parameterType="com.yqly.pojo.User">    insert into mybatis.user (id,name,password) values (#{id},#{name},#{password})</insert><!--修改用户--><update id="updateUser" parameterType="com.yqly.pojo.User">    update mybatis.user    set password = #{password}    where id=#{id};</update><!--删除用户--><delete id="deleteUser" parameterType="int">    delete    from mybatis.user    where id=#{id};</delete>

3.测试

//获取指定id的用户列表@Testpublic void test1(){    SqlSession sqlSession = MybatisUtils.getSqlSession();    UserDao mapper = sqlSession.getMapper(UserDao.class);    User user = mapper.getUserById(2);    System.out.println(user);    sqlSession.close();}//添加用户@Testpublic void test2(){    SqlSession sqlSession = MybatisUtils.getSqlSession();    UserDao mapper = sqlSession.getMapper(UserDao.class);    int i = mapper.addUser(new User(5,"王五","123456"));    sqlSession.commit();    System.out.println(i);    sqlSession.close();}//修改用户@Testpublic void test3(){    SqlSession sqlSession = MybatisUtils.getSqlSession();    UserDao mapper = sqlSession.getMapper(UserDao.class);    int i = mapper.updateUser(new User(5, "王麻子", "111111"));    sqlSession.commit();    System.out.println(i);    sqlSession.close();}//删除用户@Testpublic void test4(){    SqlSession sqlSession = MybatisUtils.getSqlSession();    UserDao mapper = sqlSession.getMapper(UserDao.class);    int i = mapper.deleteUser(5);    sqlSession.commit();    System.out.println(i);    sqlSession.close();}

模糊查询

方法一：

Java 执行代码时传递通配符

List<User> userlist=mapper.getUserLike("%value%");

方法二：

在 sql 拼接中使用通配符

select * from mybatis.user where name like "%"#{value}"%"

问题总结

org.apache.ibatis.binding.BindingException: Type interface com.yqly.dao.UserDao is not known to the MapperRegistry.

绑定异常，类型接口没有在 Mapper 注册中心注册

解决方法：

在 Mybatis 核心配置文件中注册对应的 xml

ExceptionInInitializerError The error may exist in com/yqly/dao/UserMapper.xml

初始化失败，xml 文件或许不存在

解决方法：

在 pom.xml 文件中加入以下代码，防止资源导出失败问题

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.properties</include>
                <include>**/*.xml</include>
            </includes>
            <filtering>true</filtering>
        </resource>
    </resources>
</build>