Mybatis学习笔记（一）

目录

• 前言
• • 1. MyBatis简介
  • • 1.1 Mybatis特性
    • 1.2 Mybatis下载
    • 1.3 和其它持久化层技术对比
  • 2. 搭建Mybatis步骤
  • • 2.1 开发环境
    • 2.2 创建Mybatis工程
    • 2.3 创建MyBatis核心配置文件
    • 2.4 创建Mapper接口
    • 2.5 创建UserMapper的映射文件
    • 2.6 加入log4j日志功能
  • 3. 核心配置文件详情
  • 4. 将MyBatis的核心配置文件与映射文件设置成模板
  • 5. MyBatis 的增删改查
  • • 5.1 增删改
    • 5.2 查询数据库中的信息
  • 6. MyBatis获取参数值得两种方式
  • • 6.1 单个字面量类型的参数
    • 6.2 多个字面量类型的参数
    • 6.3 map集合类型的参数
    • 6.4 实体类类型的参数
    • 6.5 使用@Param标识参数
    • 6.6 总结
  • 7. MyBatis中的各种查询
  • • 7.1 查询一个实体类对象
    • 7.2 查询一个list集合
    • 7.3 查询单个数据
    • 7.4 查询一条数据为map集合
    • 7.5 查询多条数据为map集合

前言 1. MyBatis简介 1.1 Mybatis特性

1） MyBatis 是支持定制化 SQL、存储过程以及高级映射的优秀的持久层框架
2） MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集
3） MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（Plain Old Java
Objects，普通的Java对象）映射成数据库中的记录
4） MyBatis 是一个 半自动的ORM（Object Relation Mapping）框架

1.2 Mybatis下载

MyBatis下载地址：https://github.com/mybatis/mybatis

1.3 和其它持久化层技术对比

JDBC
（1）SQL 夹杂在Java代码中耦合度高，导致硬编码内伤
（2）维护不易且实际开发需求中 SQL 有变化，频繁修改的情况多见
（3）代码冗长，开发效率低
Hibernate 和 JPA
（1）操作简便，开发效率高
（2）程序中的长难复杂 SQL 需要绕过框架
（3）内部自动生产的 SQL，不容易做特殊优化
（4）基于全映射的全自动框架，大量字段的 POJO 进行部分映射时比较困难。
（5）反射操作太多，导致数据库性能下降
MyBatis
（1）轻量级，性能出色
（2）SQL 和 Java 编码分开，功能边界清晰。Java代码专注业务、SQL语句专注数据
（3）开发效率稍逊于HIbernate，但是完全能够接受

2. 搭建Mybatis步骤 2.1 开发环境

IDE：idea 2019.2
构建工具：maven 3.5.4
MySQL版本：MySQL 8
MyBatis版本：MyBatis 3.5.7
以下Mybaits的工程搭建都在Maven中完成

2.2 创建Mybatis工程

（1）Maven配置参考以下文章
https://blog.csdn.net/weixin_44262932/article/details/125953580?spm=1001.2014.3001.5502
（2）新建工程
创建一个java工程

创建一个Module

确保Maven配置

a> 创建完成后在pom.xml文件中首先在 pom.xml 文件中设置 packing 标签，将打包方式设置为 jar 包；
b> 然后点击右上角的小图标自动导入 jar 包，或者使用你自己设置的快捷键自动导包。

c> 导入依赖

        
        
            org.mybatis
            mybatis
            3.5.10
        

        
        
            junit
            junit
            4.12
            test
        

        
        
            mysql
            mysql-connector-java
            8.0.16
        
        
        
            log4j
            log4j
            1.2.17
        

2.3 创建MyBatis核心配置文件

1. 在 src/main/resources 包下面新建一个核心配置文件，一般命名为 mybatis-config.xml ；
2. 核心配置文件主要用于配置连接数据库的环境以及 MyBatis 的全局配置信息，这里用的是优化版；

注：以上代码除了package标签内name属性的全类名需要更换，其他可不作更换。
3. 在 src/main/resources 文件夹下创建关于数据库连接的配置文件 jdbc.properties:

jdbc.driver=com.mysql.cj.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/ssm?serverTimezone=UTC
jdbc.username=root
jdbc.password=123456

注：设置 properties 的时候为了区分同名的不同功能的参数，在配置文件中某一参数前面加上前缀，例如： jdbc.xxx；在MyBatis核心配置文件通过 properties 标签引入。

2.4 创建Mapper接口

1. 这里的Mapper接口相当于之前的DAO接口，但区别在于，mapper仅仅是接口，不需要提供实现类，即“面向接口编程”
2. 根据mybatis-mapper.xml文件配置，调用接口方法中对应的sql语句
3. 首先在src/main/java路径下新建包，例如“com.xiaole.mybatis.mapper”用来放置实现各个模块功能的mapper接口，这里以接口UserMapper为例

package com.xiaole.mybatis.mapper;

import com.xiaole.mybatis.pojo.User;

import java.util.List;

public interface UserMapper {
    
    int insertUser();
    
    void updateUser();
    
    void deleteUser();
    
    User getUserById();
    
    List getAllUser();
}

2.5 创建UserMapper的映射文件

在src/main/resource文件夹下创建与Mapper接口所在包名相一致的包，即“com.xiaole.mybatis.mapper”，在该包下创建UserMapper的映射文件，UserMapper.xml

  
    
    
        insert into t_user values (null,'admin','123456',23,'男','746873213@qq.com')
    

    
    
        update t_user set username='root',password='123' where id='3'
    

    
    
        delete from t_user where id='4'
    

    
    
    
        select * from t_user where id='2'
    


    
        select * from t_user;
    

注意： mapper接口和映射文件保证两个一致
1. mapper接口的全类名和映射文件的namespace保持一致
2. mapper接口中的方法名要和映射文件的sql的id保持一致

2.6 加入log4j日志功能

1. 加入log4j依赖

log4j
log4j
1.2.17

2. 在src/main/resources目录下创建名为“log4j.xml”的配置文件

3. 在testjava编写代码测试。在此之前封装一个SqlSessionUtil工具类，代码如下

package com.xiaole.mybatis.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 SqlSessionUtil {
    public static SqlSession getSqlSession(){
        SqlSession sqlSession = null;
        //获取核心配置文件的输入流
        InputStream inputStream = null;
        try {
            inputStream = Resources.getResourceAsStream("mybatis-config.xml");
            //获取SqlSessionFactoryBuilder对象
            SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
            //获取SqlSessionFactory对象
            SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
            //获取sql的会话对象Sqlsession,是Mybatis提供的操作数据库的对象
            sqlSession = sqlSessionFactory.openSession(true);

        } catch (IOException e) {
            e.printStackTrace();
        }
        return sqlSession;
    }
}

然后是调用mapper接口中的方法来测试，这里以测试其中的更新方法为例

	@Test
    public void testMybatis() throws IOException {
        SqlSession sqlSession = SqlSessionUtil.getSqlSession();
        //获取UserMapper的代理实现类对象
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        //调用mapper接口中的方法，实现添加用户信息的功能
        int result = mapper.insertUser();
        //提供sql以及唯一标识找到sql并执行，唯一标识namespace.sqlId
//        int result = sqlSession.insert("com.xiaole.mybatis.mapper.UserMapper.insertUser");//用的不多
        System.out.println("结果" + result);
        //提交事务,这里可以不写，直接设置openSession(true)即可
//        sqlSession.commit();
        sqlSession.close();
    }

执行结果如下

以上虽报错但是执行成功了。解决上述报错方案：可将log4j的依赖中的版本往下降，然后重启再运行即可。我降到1.2.14版本后无报错信息。

3. 核心配置文件详情

    


    key}的方式访问value  -->
    
    
    
    
    
    
    
    
        
    
    
    
    
        
    
            
    
            
                
                
                
                
            
        
    
    
    
    
    
        
    

4. 将MyBatis的核心配置文件与映射文件设置成模板

（1）在File>Setting>Editor>File and Code Templates中设置MyBatis核心配置文件模板mybatis-config

（2）创建映射文件模板

创建完成之后我们就可以在新建xml文件中找到该模板，然后直接创建即可

5. MyBatis 的增删改查 5.1 增删改

（1）对于增删改只需要在 mapper 接口中先创建一个方法，然后自己编写 mapper 映射文件中对应的 sql 语句即可；
（2）mapper接口的全类名和映射文件的namespace保持一致
（3）mapper接口中的方法名要和映射文件的sql的id保持一致

    
        insert into t_user values (null,'Lina','123456',23,'男','746873213@qq.com')
    

    
    
        update t_user set username='root',password='123' where id='3'
    

    
    
        delete from t_user where id='4'
    

5.2 查询数据库中的信息

 
    
        select * from t_user where id='2'
    


    
        select * from t_user;
    

注：
（1）查询的标签 select 必须设置属性 resultType 或 resultMap ，用于设置实体类和数据库表的映射关系， mybatis 省了处理结果集的的过程，但是我们还要指定返回的结果集的类型：

resultType: 设置结果类型，即查询的数据要转换为java类型
resultMap: 自定义映射，处理多对一或一对多的映射关心

（2）当我们在核心配置文件中设置了 typeAliases 标签时，即我们设置了以包为单位，将包下所有的类型设置默认的类型别名，这里映射的 id 可以改为 User 即类的类名（不区分大小写）

	
        select * from t_user;
	

（3）当查询的数据为多条时，不能使用实体类作为返回值，只能使用集合，否则会抛出异常；

TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 8

（4） 没有设置属性 resultType 或 resultMap 的时候，报错信息如下：

Cause: org.apache.ibatis.executor.ExecutorException: A query was run and no Result Maps were found for the Mapped Statement ‘com.atguigu.mybatis.mapper.UserMapper.getUserById’. It’s likely that neither a Result Type nor a Result Map was specified.

6. MyBatis获取参数值得两种方式

${}的本质就是字符串拼接，#{}的本质就是占位符赋值
${}使用字符串拼接的方式拼接sql，若为字符串类型或日期类型的字段进行赋值时，需要手动加单引号。
但是#{}使用占位符赋值的方式拼接sql，此时为字符串类型或日期类型的字段进行赋值时，可以自动添加单引号

6.1 单个字面量类型的参数

可以通过 ${} 和 #{} 以任意的名称获取参数值，但是需要注意 ${} 的单引号问题； ${} 需要手动设置单引号 ；#{} 在解析的时候会自动添加单引号

6.2 多个字面量类型的参数

6.3 map集合类型的参数

注：需要我们手动的创建map集合，并设置键

6.4 实体类类型的参数

6.5 使用@Param标识参数

6.6 总结

（1）建议有实体类的时候用属性值来访问；
（2）没有实体类的时候用 @Param 注解命名参数，不管字面量单个还是多个，是不是 map 集合都可以使用自己用注解定义的参数来访问。

7. MyBatis中的各种查询 7.1 查询一个实体类对象

（1）可以通过实体类对象接收
（2）可以通过list集合接收（建议直接用 list 集合接收）

mapper接口中定义的方法

mapper接口中映射文件sql语句编写

测试类编写

测试结果

通过 map 集合接收到的数据是乱序的，因为 map 集合本身是通过计算 hashcode 散射来放置数据的。

7.2 查询一个list集合

7.3 查询单个数据

7.4 查询一条数据为map集合

7.5 查询多条数据为map集合