Mybatis基础（1）——Mybatis入门案例和自定义Mybatis-优快云博客

本文链接：https://blog.youkuaiyun.com/qq_34805255/article/details/93594632

本文介绍了Mybatis框架的基本概念和优势，包括三层架构中的持久层技术解决方案。详细讲解了Mybatis的环境搭建过程，包括创建数据库、Maven工程，以及XML配置入门案例。内容涵盖实体类、Mapper接口、SqlMapconfig.xml和IUserMapper.xml的创建，同时探讨了Mybatis设计模式和注解方式的应用。

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

2.2 Mybatis的XML配置入门案例

（1）创建实体类和Mapper的接口

（2）创建Mybatis的主配置文件SqlMapconfig.xml

（3）创建映射配置文件IUserMapper.xml

（4）环境搭建注意事项

（5）测试方法

（6）修改为注解的方式进行测试

（7）Mybatis的入门案例中的设计模式分析

（8）写实现类的演示

1.Mybatis框架引入与概述

1.1 什么是框架

它是我们软件开发中的一套解决方案
不同的框架解决的是不同的问题，解决的是某一层或某一类的事情，如mybatis框架解决的就是持久层的问题，springMVC解决的是表现层的问题
使用框架的好处：
- 框架封装了很多细节，使开发者可以使用极简的方式实现功能，大大提高开发效率

1.2 三层架构

表现层：是用于展现数据的
业务层：是处理业务需求的
持久层：是和数据库交互的

1.3 持久层技术解决方案

JDBC技术：

Connection
PreparedStatement
ResultSet

Spring的JdbcTemplate：

Spring中对jdbc的简单封装

Apache的DBUtils：

它和Spring的JdbcTemplate很像，也是对Jdbc的简单封装

以上这些都不是框架

JDBC是规范
Spring的JdbcTemplate和Apache的DBUtils都只是工具类

比如以前我们所写的JDBC中从注册驱动到定义sql，到封装结果集，再到释放资源这些步骤中很多都是繁琐的操作，重复的操作，对于开发中我们的关注点应该是实现项目功能，我们只要有sql语句就能实现功能了，所以这些繁琐的操作需要被简化，mybatis就是来解决这样的问题。

1.4 Mybatis框架概述

1.Mybatis框架是基于Java编写的持久层框架，它内部封装了JDBC，使开发者只需关注sql本身
2.Mybatis通过xml或注解的方式将要执行的各种statement配置起来，并通过java中的对象和statement中sql的动态参数进行映射生成最终执行的sql语句，最终由mybatis框架执行sql，并将结果映射成Java对象返回

采用ORM思想解决了实体与数据库映射的问题

ORM（Object Relational Mapping：对象关系映射）：

把数据库和实体类以及实体类的属性对应起来，
就让我们可以操作实体类就可以实现操作数据库表

表              类
user            User

字段            类属性
id              userId      
user_name       userName

注意：类中属性的名称可以和表中的字段名称不完全相同，后文讲解它们之间的映射关系

2.Mybatis的入门

2.1 Mybatis的环境搭建

（1）创建数据库和示例表

DROP TABLE IF EXISTS `user`;

CREATE TABLE `user` (
  `id` INT(11) NOT NULL AUTO_INCREMENT,
  `username` VARCHAR(32) NOT NULL COMMENT '用户名称',
  `birthday` DATETIME DEFAULT NULL COMMENT '生日',
  `sex` CHAR(1) DEFAULT NULL COMMENT '性别',
  `address` VARCHAR(256) DEFAULT NULL COMMENT '地址',
  PRIMARY KEY  (`id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8;


INSERT  INTO `user`(`id`,`username`,`birthday`,`sex`,`address`) VALUES 
(41,'张三','2018-02-27 17:47:08','男','北京'),
(42,'李四','2018-03-02 15:09:37','女','北京金燕龙'),
(43,'李四','2018-03-04 11:34:34','女','北京金燕龙'),
(45,'王五','2018-03-04 12:04:06','男','北京金燕龙'),
(46,'张三','2018-03-07 17:37:26','男','北京'),
(48,'马六','2018-03-08 11:44:00','女','北京修正');

启动数据库

（2）创建Maven工程和导入坐标

mybatis官网教程：http://www.mybatis.org/mybatis-3/zh/index.html

导入坐标查找官网（如何查找导入坐标此处不再赘述）：https://mvnrepository.com

2.2 Mybatis的XML配置入门案例

（1）创建实体类和Mapper的接口

User.java

package cn.edu.cqu.mybatis01.entity;

import java.io.Serializable;
import java.util.Date;

public class User implements Serializable {
    private Integer id;
    private String username;
    private Date birthday;
    private String sex;
    private String address;

    public Integer getId() {
        return id;
    }

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

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public Date getBirthday() {
        return birthday;
    }

    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }

    public String getSex() {
        return sex;
    }

    public void setSex(String sex) {
        this.sex = sex;
    }

    public String getAddress() {
        return address;
    }

    public void setAddress(String address) {
        this.address = address;
    }

    @Override
    public String toString() {
        return "User{" +
                "id=" + id +
                ", username='" + username + '\'' +
                ", birthday=" + birthday +
                ", sex='" + sex + '\'' +
                ", address='" + address + '\'' +
                '}';
    }
}

IUserMapper.java

package cn.edu.cqu.mybatis01.mapper;

import cn.edu.cqu.mybatis01.entity.User;

import java.util.List;

/**
 * 用户的持久层接口
 */
public interface IUserMapper {
    /**
     * 查询所有操作
     */
    List<User> findAll();
}

（2）创建Mybatis的主配置文件SqlMapconfig.xml

在src/main/resources文件夹下创建

<?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">
<!--mybatis的主配置文件-->
<configuration>
<!--  配置好环境  -->
    <!--此处default不管为什么，必须在environment中有定义-->
    <environments default="mysql">
        <!--配置mysql的环境 -->
        <environment id="mysql">
            <!--      配置事务的类型      -->
            <transactionManager type="JDBC"></transactionManager>
            <!--    配置数据源（连接池）        -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mydb"/>
                <property name="username" value="root"/>
                <property name="password" value=""/>
            </dataSource>
        </environment>
    </environments>

    <!--  指定映射配置文件的位置，映射配置文件指的是每个dao独立的配置文件  -->
    <mappers>
            <mapper resource="cn/edu/cqu/mybatis01/mapper/IUserMapper.xml"/>
    </mappers>

</configuration>

（3）创建映射配置文件IUserMapper.xml

在src/main/resources文件夹下创建如下目录

<?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="cn.edu.cqu.mybatis01.mapper.IUserMapper">
    <select id="findAll" resultType="cn.edu.cqu.mybatis01.entity.User">
        select * from user
    </select>
</mapper>

（4）环境搭建注意事项

1.在Idea中创建目录的时候，它和包不一样
- 包在创建时：cn.edu.cqu是三级目录结构
- 目录在创建时：cn.edu.cqu是一级目录结构
2.mybatis的映射配置文件必须和mapper接口中的包结构相同
3.映射配置文件的mapper标签namespace属性的取值必须是mapper接口的全限定类名
4.映射配置文件的操作配置（select，insert，delete），id属性的取值必须是mapper接口的方法名
当我们遵从上述的2，3，4点之后，就无需再写mapper的实现类，也就是写完接口，剩下的操作mybatis就会帮我们去做

（5）测试方法

package cn.edu.cqu.test;

import cn.edu.cqu.mybatis01.entity.User;
import cn.edu.cqu.mybatis01.mapper.IUserMapper;
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;
import java.util.List;

/**
 * 入门案例
 */
public class MybatisTest {
    public static void main(String[] args) throws IOException {
        //1.读取配置文件
        InputStream in = Resources.getResourceAsStream("SqlMapConfig.xml");
        //2.创建SqlFactorySession工厂
        SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
        SqlSessionFactory factory = builder.build(in);
        //3.使用工厂生产一个SqlFactorySession对象
        SqlSession session = factory.openSession();
        //4.使用SqlFactorySession创建Mapper接口的代理对象
        IUserMapper userMapper = session.getMapper(IUserMapper.class);
        //5.使用代理对象执行方法
        List<User> users = userMapper.findAll();

        for(User user : users)
        {
            System.out.println(user);
        }
        //6.释放资源
        session.close();
        in.close();
    }
}

（6）修改为注解的方式进行测试

首先必须删除我们自定义的IUserMapper.xml，不然即便下面的步骤走完，也会报如下错误：

修改主配置文件SqlMapperConfig.xml

在接口的方法上添加注解，注解中的value为sql语句

package cn.cqu.mapper;

import cn.cqu.entity.User;
import org.apache.ibatis.annotations.Select;

import java.util.List;

/**
 * 用户的持久层接口
 */

public interface IUserMapper {
    /**
     * 查询所有操作
     */
    @Select("select * from user")
    List<User> findAll();
}

（7）Mybatis的入门案例中的设计模式分析

读配置文件一般使用如下两种方法：

1.使用类加载器，它只能读取类路径的配置文件
2.使用ServletContext对象的getRealPath()

注意事项：

1.不要忘记在映射配置中告知mybatis要封装到那个实体类中
- 配置的方式：指定实体类的全限定类名
2.我们实际开发中，都是越简便越好，所以都是采用不写mapper接口的实现类的方式，但是不管使用XML还是注解配置，mybatis是支持写mapper的实现类的

（8）写实现类的演示

以下演示一下写mapper的实现类：

package cn.edu.cqu.mybatis01.mapper.impl;

import cn.edu.cqu.mybatis01.entity.User;
import cn.edu.cqu.mybatis01.mapper.IUserMapper;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import java.util.List;

public class UserMapperImpl implements IUserMapper {

    private SqlSessionFactory factory;

    public UserMapperImpl(SqlSessionFactory sqlSessionFactory){
        factory = sqlSessionFactory;
    }

    @Override
    public List<User> findAll() {
        //1.使用工厂创建SqlSession对象
        SqlSession session = factory.openSession();
        //2.使用session执行查询所有方法
        List<User> users = session.selectList("cn.edu.cqu.mybatis01.mapper.IUserMapper.findAll");
        //上句的参数为mapper标签的namespace与select标签中的id的组合来唯一确定查询语句
        session.close();
        //3.返回查询结果
        return users;
    }
}

修改测试类中的代码，将第3，4步创建session，然后使用session创建代理对象的方式