Mybatis 学习笔记总结

Posted 2022-02-20 IT_Holmes

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Mybatis 学习笔记总结相关的知识，希望对你有一定的参考价值。

文章目录

1. Mybatis 生命周期和作用域
2. 解决实体类的属性名和数据库的字段名不一致的问题
3. resultMap结果集映射
4. 日志
- 4.1 日志工程
- 4.2 LOG4J日志输出
5. 分页
6. 使用注解开发
7. Lombok(了解就好)
8. 理解关联和集合
9. Maven的resource创建目录时遇到的一个小问题
10. 多对一的处理
- 10.1 准备工作
- 10.2 resultMap中的association关联（一对多处理）
11. 一对多处理
- 11.1 准备工作
- 11.2 resultMap中的collection集合（一对多处理）

1. Mybatis 生命周期和作用域

上面的SQL Mapper就是sqlSession通过getMapper来获取内容，sqlSession.getMapper(xxx.class)

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

SqlSessionFactoryBuilder：

一旦创建SqlSessionFactory，就不需要SqlSessionFactoryBuilder了。
因此，SqlSessionFactoryBuilder的作用域最佳是方法作用域也就是局部变量。

SqlSessionFactory：

sqlSessionfactory一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。该对象表现的效果就和数据库连接池一样！
因此，SqlSessionFactory的作用域最佳是应用作用域。
最简单的就是就用单例模式或者静态单例模式。

SqlSession：

sqlSession是连接到连接池的一个请求。每个线程都应该有它自己的SqlSession实例。
SqlSession的实例不是线程安全的，因此是不能被共享的，所以它的最佳作用域是请求或方法作用域。
每个SqlSession的实例用完之后，需要赶紧调用close()方法进行关闭，否则资源被占用！

上面的每一个Mapper，就代表一个具体的业务！

2. 解决实体类的属性名和数据库的字段名不一致的问题

如何解决实体类的属性名和数据库的字段名不一致的问题？

数据库中的表结构：

解决上面的问题，就要理解类型处理器(typeHandlers)的作用效果。

MyBatis 在设置预处理语句（PreparedStatement）中的参数或从结果集中取出一个值时，都会用类型处理器将获取到的值以合适的方式转换成 Java 类型。

大体上的流程就是：

-- 我们去数据库中要运行的语句。
select * from mybatis.`user` where id = #id;
-- 经过类型处理器，从而拿到一些列对应的字段和字段值等。
select id,name,pwd from mybatis.`user` where id = #id;

-- 而我们这里在数据库中提取的是pwd字段，而我们的实体类中定义的是password属性。
-- 简而言之，就是让password属性和pwd字段对应起来就解决问题了。

解决方法：

在mybatis中配置的xml文件，我们可以给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">

<mapper namespace="com.itholmes.dao.UserMapper">
    <select id="getUserById" resultType="User" parameterType="int">
        select id,name,pwd as password from mybatis.user where id = #id;
    </select>
</mapper>

还有一种方法就是使用resultMap结果集映射的方法，如下一节。

3. resultMap结果集映射

通过使用resultMap结果集映射来解决上面的问题：

我们在UserMapper.xml文件中，设置了resultMap标签。

resultMap标签中声明了result标签它的column属性和property属性分别对应的就是数据库中的字段和实体类中的属性。通过这种方式一一对应起来。

<?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.itholmes.dao.UserDao">

    <!--
        结果集映射:
            id属性：就是当前resultMap的标识。
            type属性：定义映射后的结果类型。
    -->
    <resultMap id="UserMap" type="User">
        <!--
            column数据库中的字段，property实体类中的属性。
            这就意思就是让column数据库字段和property实体类属性对应起来。
        -->
        <result property="id" column="id"></result>
        <result property="name" column="name"></result>
        <result property="password" column="pwd"></result>
    </resultMap>

    <select id="selectById" resultMap="UserMap">
        select * from `user` where id = #id;
    </select>
</mapper>

其实，我们不设置resultMap，MyBatis会在幕后自动创建一个resultMap，再基于属性名来映射到JavaBean(Java实体类)的属性上面。

4. 日志

4.1 日志工程

如果一个数据库sql操作，出现了异常，我们需要排错，日志就是最好的助手！

对于这样的异常，以前使用sout，debug。来进行排查找错。

现在，使用日志会更加方便！

在mybatis-config.xml核心配置文件的setting标签中，有个logImpl配置。

(后面的未设置，是没有设置默认值的意思。)

SLF4J
LOG4J(重点)
LOG4J2：LOG4J的升级版本。
JDK_LOGGING：Java自带的日志输出。
COMMONS_LOGGING：工具包(像之前的commons_io一样的工具包)。
STDOUT_LOGGING(重点)：标准日志输出。
NO_LOGGING：没有日志输出。

在Mybatis中具体使用那个日志实现，都在setting设置中设定。

STDOUT_LOGGING标准日志输出：
在mybatis-config.xml核心配置文件中，配置我们的日志：(注意顺序问题)

<settings>
    <!--
        name就对应logImpl ， value对应官方给定的值。
        注意这里不是我们自己设定的，而是官方给出来让我们用的，这些名字和value值我们不能随便改。
    -->
    <setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>

4.2 LOG4J日志输出

什么是Log4j？

Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台，文件，GUI组件等。
Log4j可以控制每一条日志的输出格式。
Log4j可以通过定义每一条日志信息的级别，能够更加细致地控制日志的生成过程。
Log4j可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码，非常方便。

第一步：导入log4j的包，一般我们在maven仓库加依赖。

<!-- https://mvnrepository.com/artifact/log4j/log4j -->
<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

第二步：创建log4j.properties文件。

#将等级为DEBUG的日志信息输出到console和file这两个目的地，console和file的定义在下面的代码
log4j.rootLogger=DEBUG,console,file

#控制台输出的相关设置
log4j.appender.console = org.apache.log4j.ConsoleAppender
log4j.appender.console.Target = System.out
log4j.appender.console.Threshold=DEBUG
log4j.appender.console.layout = org.apache.log4j.PatternLayout
log4j.appender.console.layout.ConversionPattern=[%c]-%m%n

#文件输出的相关设置
log4j.appender.file = org.apache.log4j.RollingFileAppender
log4j.appender.file.File=./log/itholmes.log
log4j.appender.file.MaxFileSize=10mb
log4j.appender.file.Threshold=DEBUG
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=[%p][%dyy-MM-dd][%c]%m%n

#日志输出级别
log4j.logger.org.mybatis=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG

第三步：在mybatis核心配置文件中，配置log4j日志的实现(logImpl)。

<settings>
    <setting name="logImpl" value="LOG4J"/>
</settings>

第四步：log4j的测试，直接运行测试类来进行测试。

简单实用:

1.在要使用Log4j的类中，导入Logger的包，注意这里Logger系统有自带的，我们要使用log4j里面的那个包，import org.apache.log4j.Logger;
2.定义好的Logger日志对象，参数为当前类的class。

在我们的测试类中，Logger对象一般我们放到上面(提升作用域)，并且设置为staitc，方便使用。

package com.itholmes.dao;

import com.itholmes.pojo.User;
import com.itholmes.utils.MybatisSqlSession;
import org.apache.ibatis.session.SqlSession;
import org.apache.log4j.Logger;
import org.junit.jupiter.api.Test;

public class test 

    //这里导入Logger是我们要之前导入import org.apache.log4j.Logger;的包，不要导错了。
    static Logger logger = Logger.getLogger(test.class);

    @Test
    public void test01()
        SqlSession sqlSession = MybatisSqlSession.getMybatisSqlSession();

        logger.info("测试，进入test01方法进行查询操作。");

        UserDao mapper = sqlSession.getMapper(UserDao.class);
        if (false)
            //一般使用在try-catch中。
            logger.error("发现异常");
        
        User user = mapper.selectById(1);

        System.out.println(user.toString());

        logger.info("测试结束。");
    

    @Test
    public void testLog4j()

        //我们可以根据不同级别信息，给日志追加一些信息等等。
        logger.info("info:进入了testLog4j");
        logger.debug("debug:进入了testLog4j");
        logger.error("error:进入testLog4j");

5. 分页

5.1 limit分页

为什么要分页？

减少数据的处理量。

使用Limit分页

-- 语法：
select * from `表名` limit startIndex,pageSize;

使用Mybatis实现分页效果：

1.接口里的分页方法。

UserDao类：

package com.itholmes.dao;

import com.itholmes.pojo.User;

import java.util.List;
import java.util.Map;

public interface UserDao 
    //分页查询的效果
    List<User> getUserByLimit(Map<String,Integer> map);

2.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">
<mapper namespace="com.itholmes.dao.UserDao">

    <!--分页查询的结果集映射-->
    <resultMap id="UserMap2" type="User">
        <result property="password" column="pwd"/>
    </resultMap>
    <!--分页查询-->
    <select id="getUserByLimit" parameterType="map" resultMap="UserMap2">
        select * from mybatis.user limit #startIndex,#pageSize;
    </select>

</mapper>

3.测试类。

package com.itholmes.dao;

import com.itholmes.pojo.User;
import com.itholmes.utils.MybatisSqlSession;
import org.apache.ibatis.session.SqlSession;
import org.apache.log4j.Logger;
import org.junit.jupiter.api.Test;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class test 

    static Logger logger = Logger.getLogger(test.class);

    @Test
    public void getUserByLimit()
        SqlSession sqlSession = MybatisSqlSession.getMybatisSqlSession();
        UserDao mapper = sqlSession.getMapper(UserDao.class);
        Map<String, Integer> map = new HashMap<>();
        map.put("startIndex",0);
        map.put("pageSize",2);
        List<User> list = mapper.getUserByLimit(map);
        for (User user : list) 
            System.out.println(user);
        
        sqlSession.close();

5.2 RowBounds分页(了解)

RowBounds就是不通过使用sql语句进行分页，而是通过java代码层面进行分页。

1.设置的接口中的方法。

package com.itholmes.dao;

import com.itholmes.pojo.User;

import java.util.List;
import java.util.Map;

public interface UserDao 
    //分页通过RowBounds实现
    List<User> getUserByRowBounds();

2.配置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">
<mapper namespace="com.itholmes.dao.UserDao">

    <!--分页查询的结果集映射-->
    <resultMap id="UserMap2" type="User">
        <result property="password" column="pwd"/>
    </resultMap>

    <!--limit分页-->
    <select id="getUserByLimit" parameterType="map" resultMap="UserMap2">
        select * from mybatis.user limit #startIndex,#pageSize;
    </select>

    <!--RowBounds分页-->
    <select id="getUserByRowBounds" resultMap="UserMap2">
        select * from mybatis.user;
    </select>

</mapper>

3.测试。

package com.itholmes.dao;

import com.itholmes.pojo.User;
import com.itholmes.utils.MybatisSqlSession;
import org.apache.ibatis.session.RowBounds;
import org.apache.ibatis.session.SqlSession;
import org.apache.log4j.Logger;
import org.junit.jupiter.api.Test;

import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class test 

	//limit sql分页方式
    @Test
    public void getUserByLimit()
        SqlSession sqlSession = MybatisSqlSession.getMybatisSqlSession();
        UserDao mapper = sqlSession.getMapper(UserDao.class);
        Map<String, Integer> map = new HashMap<>();
        map.put("startIndex",0);
        map.put("pageSize",2);
        List<User> list = mapper.getUserByLimit(map);
        for (User user : list) 
            System.out.println(user);
        
        sqlSession.close();
    

	//RowBounds java代码分页
    @Test
    public void getUserByRowBounds()
        SqlSession sqlSession = MybatisSqlSession.getMybatisSqlSession();

        //RowBounds实现,两个参数分别对应偏移量(从第几行读取)，限制条数。
        RowBounds rowBounds = new RowBounds(1, 2);

        //通过Java代码层面实现分页效果
        List<User> list = sqlSession.selectList("com.itholmes.dao.UserDao.getUserByRowBounds",null,rowBounds);
        for (User user : list) 
            System.out.println(user);
        
        sqlSession.close();

5.3 分页插件

想使用，直接点文档看看就可以了。

6. 使用注解开发

6.1 面向接口编程

理解好面向对象编程和面向接口编程：

6.2 Mybatis的注解开发

什么时候用注解，什么时候用xml？

注解开发的实现：

1.注解在接口上实现。

package com.itholmes.dao;

import com.itholmes.pojo.User;
import org.apache.ibatis.annotations.Select;
import java.util.List;

public interface 以上是关于Mybatis 学习笔记总结的主要内容，如果未能解决你的问题，请参考以下文章 
 Mybatis 学习笔记总结
 Mybatis 学习笔记总结
 Mybatis 学习笔记总结
 mybatis学习笔记(11)-多对多查询
 springmvc学习总结 -- maven+springmvc+spring+mybatis+mysql详细搭建整合过程讲解
 MyBatis自用MyBatis学习笔记