Mybatis | Mybatis学习笔记（上）

个人主页：BoBooY的CSDN博客_Java领域博主前言：本篇文章总结了Mybatis的入门知识（上），希望能通过文字代码截图的方式帮助大家快速掌握 Mybatis入门知识（下）：https://blog.csdn.net/qq_58233406/article/details/127112954

文章目录

Mybatis简介
- （一）什么是Mybatis？
- （二）持久化
- （三）持久层
- （四）为什么需要Mybatis
一、第一个Mybatis程序
- （一）分析思路
- （二）创建一个数据库并建一张表
- （三）创建一个普通Maven项目并删除src目录
- （四）导入相关依赖
- （五）创建一个模块（子工程）
- （六）编写Mybatis核心配置文件
- （七）IDEA与mysql数据库连接
- （八）编写Mybatis工具类
- （九）编写实体类
- （十）编写Mapper接口类
- （十一）编写UserMapper.xml配置文件
- （十二）添加核心配置文件mybatis-config中的mapper
- （十三）使用JUnit测试
- （十四）常见问题
  - 1.配置文件加载不出来
    - （1）情况一：resource里面的路径错误
    - （2）情况二：Maven资源没有导出问题
  - 2.空指针异常
  - 3.标签错误
  - 4.namespace
  - 5.输出的xml文件中存在中文乱码问题
二、增删改查
- （一）通过id查询用户
  - 1.编写UserMapper接口
  - 2.编写UserMapper.xml的配置文件
  - 3.JUnit测试
- （二）添加用户
  - 1.编写UserMapper接口
  - 2.编写UserMapper.xml的配置文件
  - 3.JUnit测试
- （三）修改用户信息
  - 1.编写UserMapper接口
  - 2.编写UserMapper.xml的配置文件
  - 3.JUnit测试
- （四）删除用户
  - 1.编写UserMapper接口
  - 2.编写UserMapper.xml的配置文件
  - 3.JUnit测试
三、配置解析
- （一）核心配置文件
- （二）环境配置（environments）
- （三）属性（properties）
  - 1.优化配置文件
  - 2.细节问题
- （四）类型别名（typeAliases）
- （五）设置（settings）
- （六）其他配置
- （七）映射器（mappers）
  - 方式一：使用相对于类路径的资源引【推荐】
  - 方式二：使用完全限定资源定位符（URL）【非常不推荐】
  - 方式三：使用class文件绑定注册
  - 方式四：使用扫描包进行注册绑定
- （八）生命周期和作用域
  - 1.SqlSessionFactoryBuilder
  - 2.SqlSessionFactory
  - 3.SqlSession
四、ResultMap
- （一）查询为null问题
- （二）解决方案
  - 方案一：为列名指定别名 , 别名和java实体类的属性名一致
  - 方案二：使用结果集映射 ResultMap 【推荐】

Mybatis简介

环境说明：

jdk 8
MySQL 5.7.19
maven-3.6.1
IDEA

学习前需要掌握：

JDBC
MySQL
Java 基础
Maven
Junit

（一）什么是Mybatis？

MyBatis 是一款优秀的持久层框架
MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的过程
MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的实体类【Plain Old Java Objects,普通的 Java对象】映射成数据库中的记录。
MyBatis 本是apache的一个开源项目ibatis, 2010年这个项目由apache 迁移到了google code，并且改名为MyBatis 。
2013年11月迁移到Github .
Mybatis官方文档 : http://www.mybatis.org/mybatis-3/zh/index.html
GitHub : https://github.com/mybatis/mybatis-3

（二）持久化

持久化是将程序数据在持久状态和瞬时状态间转换的机制。

即把数据（如内存中的对象）保存到可永久保存的存储设备中（如磁盘）。持久化的主要应用是将内存中的对象存储在数据库中，或者存储在磁盘文件中、XML数据文件中等等。
JDBC就是一种持久化机制。文件IO也是一种持久化机制。
在生活中 : 将鲜肉冷藏，吃的时候再解冻的方法也是。将水果做成罐头的方法也是。

为什么需要持久化服务呢？那是由于内存本身的缺陷引起的

内存断电后数据会丢失，但有一些对象是无论如何都不能丢失的，比如银行账号等，遗憾的是，人们还无法保证内存永不掉电。
内存过于昂贵，与硬盘、光盘等外存相比，内存的价格要高2~3个数量级，而且维持成本也高，至少需要一直供电吧。所以即使对象不需要永久保存，也会因为内存的容量限制不能一直呆在内存中，需要持久化来缓存到外存。

（三）持久层

什么是持久层？

完成持久化工作的代码块 . ----> dao层【DAO (Data Access Object) 数据访问对象】
大多数情况下特别是企业级应用，数据持久化往往也就意味着将内存中的数据保存到磁盘上加以固化，而持久化的实现过程则大多通过各种关系数据库来完成。
不过这里有一个字需要特别强调，也就是所谓的“层”。对于应用系统而言，数据持久功能大多是必不可少的组成部分。也就是说，我们的系统中，已经天然的具备了“持久层”概念？也许是，但也许实际情况并非如此。之所以要独立出一个“持久层”的概念,而不是“持久模块”，“持久单元”，也就意味着，我们的系统架构中，应该有一个相对独立的逻辑层面，专注于数据持久化逻辑的实现.
与系统其他部分相对而言，这个层面应该具有一个较为清晰和严格的逻辑边界。【说白了就是用来操作数据库存在的！】

（四）为什么需要Mybatis

Mybatis就是帮助程序猿将数据存入数据库中 , 和从数据库中取数据 .
传统的jdbc操作 , 有很多重复代码块 .比如 : 数据取出时的封装 , 数据库的建立连接等等… , 通过框架可以减少重复代码,提高开发效率 .
MyBatis 是一个半自动化的ORM框架 (Object Relationship Mapping) -->对象关系映射
所有的事情，不用Mybatis依旧可以做到，只是用了它，所有实现会更加简单！技术没有高低之分，只有使用这个技术的人有高低之别
MyBatis的优点

代码语言：txt复制

- 简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件 配置几个sql映射文件就可以了，易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
- 灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
- 解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
- 提供xml标签，支持编写动态sql。
- …最重要的一点，使用的人多！公司需要！

一、第一个Mybatis程序

（一）分析思路

思路流程：搭建环境–>导入Mybatis—>编写代码—>测试

（二）创建一个数据库并建一张表

代码语言：javascript复制

CREATE DATABASE `Mybatis`;
use `Mybatis`;
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user`  (
  `id` int(20) NOT NULL,
  `name` varchar(30) DEFAULT NULL,
  `pwd` varchar(30) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE = InnoDB CHARACTER SET = utf8;
INSERT INTO `user` VALUES (1, '赵惟', 'zhaowei');
INSERT INTO `user` VALUES (2, '彭浩', 'penghao');
INSERT INTO `user` VALUES (3, '郝文虎', 'haowenhu');

（三）创建一个普通Maven项目并删除src目录

注意更改Maven版本为3.6.1，不要使用IDEA自带的版本

（四）导入相关依赖

mybatis、mysql、junit

代码语言：javascript复制

<dependencies>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.5.2</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.47</version>
    </dependency>
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>
</dependencies>

（五）创建一个模块（子工程）

（六）编写Mybatis核心配置文件

代码语言：javascript复制

<?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.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&amp;useUnicode=true&amp;characterEncoding=utf8"/>
                <property name="username" value="root"/>
                <property name="password" value="1234"/>
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="org/mybatis/example/BlogMapper.xml"/> <!--这里千万注意是“/”号-->
    </mappers>
</configuration>

（七）IDEA与mysql数据库连接

（八）编写Mybatis工具类

代码语言：javascript复制

package com.bby.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 {
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    //获取SqlSession
    public static SqlSession getSession() {
        return sqlSessionFactory.openSession();
    }
}

（九）编写实体类

代码语言：javascript复制

package com.bby.pojo;

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

    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 getPwd() {
        return pwd;
    }

    public void setPwd(String pwd) {
        this.pwd = pwd;
    }
}

（十）编写Mapper接口类

代码语言：javascript复制

package com.bby.Dao;

import com.bby.pojo.User;

import java.util.List;

public interface UserMapper {
    List<User> selectUser();
}

（十一）编写UserMapper.xml配置文件

代码语言：javascript复制

<?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.bby.Dao.UserMapper">
    <select id="selectUser" resultType="com.bby.pojo.User">
        select * from User
    </select>
</mapper>

（十二）添加核心配置文件mybatis-config中的mapper

代码语言：javascript复制

<mappers>
    <mapper resource="com/bby/Dao/UserMapper.xml"/>
</mappers>

（十三）使用JUnit测试

代码语言：javascript复制

package com.bby.Dao;

import com.bby.pojo.User;
import com.bby.utils.MybatisUtils;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserMapperTest {
    @Test
    public void test() {
        SqlSession sqlSession = MybatisUtils.getSession();
        //方式一（推荐）
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        List<User> users = mapper.selectUser();
        //方式二
        List<User> users1 = sqlSession.selectList("com.bby.Dao.UserMapper.selectUser");

        for(User user : users) {
            System.out.println(user);
        }
    }
}

（十四）常见问题

1.配置文件加载不出来

（1）情况一：resource里面的路径错误

mybatis核心配置文件的mapper 中的资源路径必须使用 " / "

（2）情况二：Maven资源没有导出问题

Maven没有在build中配置resource，导致资源读取不到，因为正常情况下，xml配置文件应该放在resources目录下，而Maven约定大于配置，所以可能读取不到

代码语言：javascript复制

java.lang.ExceptionInInitializerError
	at com.bby.Dao.UserMapperTest.test(UserMapperTest.java:13)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:498)
	at org.junit.runners.model.FrameworkMethod$1.runReflectiveCall(FrameworkMethod.java:50)
	at org.junit.internal.runners.model.ReflectiveCallable.run(ReflectiveCallable.java:12)
	at org.junit.runners.model.FrameworkMethod.invokeExplosively(FrameworkMethod.java:47)
	at org.junit.internal.runners.statements.InvokeMethod.evaluate(InvokeMethod.java:17)
	at org.junit.runners.ParentRunner.runLeaf(ParentRunner.java:325)
	at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:78)
	at org.junit.runners.BlockJUnit4ClassRunner.runChild(BlockJUnit4ClassRunner.java:57)
	at org.junit.runners.ParentRunner$3.run(ParentRunner.java:290)
	at org.junit.runners.ParentRunner$1.schedule(ParentRunner.java:71)
	at org.junit.runners.ParentRunner.runChildren(ParentRunner.java:288)
	at org.junit.runners.ParentRunner.access$000(ParentRunner.java:58)
	at org.junit.runners.ParentRunner$2.evaluate(ParentRunner.java:268)
	at org.junit.runners.ParentRunner.run(ParentRunner.java:363)
	at org.junit.runner.JUnitCore.run(JUnitCore.java:137)
	at com.intellij.junit4.JUnit4IdeaTestRunner.startRunnerWithArgs(JUnit4IdeaTestRunner.java:69)
	at com.intellij.rt.junit.IdeaTestRunner$Repeater.startRunnerWithArgs(IdeaTestRunner.java:33)
	at com.intellij.rt.junit.JUnitStarter.prepareStreamsAndStart(JUnitStarter.java:221)
	at com.intellij.rt.junit.JUnitStarter.main(JUnitStarter.java:54)
Caused by: org.apache.ibatis.exceptions.PersistenceException: 
### Error building SqlSession.
### The error may exist in com/bby/Dao/UserMapper.xml
### Cause: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: java.io.IOException: Could not find resource com/bby/Dao/UserMapper.xml
	at org.apache.ibatis.exceptions.ExceptionFactory.wrapException(ExceptionFactory.java:30)
	at org.apache.ibatis.session.SqlSessionFactoryBuilder.build(SqlSessionFactoryBuilder.java:80)
	at org.apache.ibatis.session.SqlSessionFactoryBuilder.build(SqlSessionFactoryBuilder.java:64)
	at com.bby.utils.MybatisUtils.<clinit>(MybatisUtils.java:22)
	... 23 more
Caused by: org.apache.ibatis.builder.BuilderException: Error parsing SQL Mapper Configuration. Cause: java.io.IOException: Could not find resource com/bby/Dao/UserMapper.xml
	at org.apache.ibatis.builder.xml.XMLConfigBuilder.parseConfiguration(XMLConfigBuilder.java:121)
	at org.apache.ibatis.builder.xml.XMLConfigBuilder.parse(XMLConfigBuilder.java:98)
	at org.apache.ibatis.session.SqlSessionFactoryBuilder.build(SqlSessionFactoryBuilder.java:78)
	... 25 more
Caused by: java.io.IOException: Could not find resource com/bby/Dao/UserMapper.xml
	at org.apache.ibatis.io.Resources.getResourceAsStream(Resources.java:114)
	at org.apache.ibatis.io.Resources.getResourceAsStream(Resources.java:100)
	at org.apache.ibatis.builder.xml.XMLConfigBuilder.mapperElement(XMLConfigBuilder.java:372)
	at org.apache.ibatis.builder.xml.XMLConfigBuilder.parseConfiguration(XMLConfigBuilder.java:119)
	... 27 more


进程已结束，退出代码为 -1

解决方式：

在父工程和子工程中都配置一下pom.xml文件：

代码语言：javascript复制

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

2.空指针异常

java.lang.NullPointerException

3.标签错误

insert、update、select、delete标签不要乱用，应该一一对应

4.namespace

5.输出的xml文件中存在中文乱码问题

二、增删改查

（一）通过id查询用户

1.编写UserMapper接口

添加selectUserById()方法

代码语言：javascript复制

//根据id查询用户
User selectUserById(int id);

2.编写UserMapper.xml的配置文件

添加映射接口的查询语句

代码语言：javascript复制

<select id="selectUserById" parameterType="int" resultType="com.bby.pojo.User">
    select * from User where id = #{id}
</select>

3.JUnit测试

代码语言：javascript复制

//测试通过id查询用户
@Test
public void test2() {
    SqlSession sqlSession = MybatisUtils.getSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user = mapper.selectUserById(1);
    System.out.println(user);
}

（二）添加用户

1.编写UserMapper接口

代码语言：javascript复制

//添加用户
int insertUser(User user);

2.编写UserMapper.xml的配置文件

代码语言：javascript复制

<insert id="insertUser" parameterType="com.bby.pojo.User">
    insert into user(`id`,`name`,`pwd`) values(#{id},#{name},#{pwd})
</insert>

3.JUnit测试

代码语言：javascript复制

//测试添加用户
@Test
public void test3() {
    SqlSession sqlSession = MybatisUtils.getSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user = new User(4,"张三","zhangsan");
    int result = mapper.insertUser(user);
    //提交事务
    sqlSession.commit();
    if(result > 0) {
        System.out.println("添加成功");
    } else {
        System.out.println("添加失败");
    }

    //关闭资源
    sqlSession.close();
}

（三）修改用户信息

1.编写UserMapper接口

代码语言：javascript复制

//修改用户信息
int updateUser(User user);

2.编写UserMapper.xml的配置文件

代码语言：javascript复制

<update id="updateUser" parameterType="com.bby.pojo.User">
	update user set `name`=#{name},`pwd`=#{pwd} where `id`=#{id}
</update>

3.JUnit测试

代码语言：javascript复制

//测试修改用户信息
@Test
public void test4() {
    SqlSession sqlSession = MybatisUtils.getSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    User user = mapper.selectUserById(4);
    user.setPwd("123");
    int result = mapper.updateUser(user);
    //提交事务
    sqlSession.commit();

    if(result > 0) {
        System.out.println("修改成功");
    } else {
        System.out.println("修改失败");
    }

    //关闭资源
    sqlSession.close();
}

（四）删除用户

1.编写UserMapper接口

代码语言：javascript复制

//删除用户
int deleteUser(int id);

2.编写UserMapper.xml的配置文件

代码语言：javascript复制

<delete id="deleteUser" parameterType="int">
    delete from user where `id`=#{id}
</delete>

3.JUnit测试

代码语言：javascript复制

//测试删除用户
@Test
public void test5(){
    SqlSession sqlSession = MybatisUtils.getSession();
    UserMapper mapper = sqlSession.getMapper(UserMapper.class);
    int result  = mapper.deleteUser(5);

    //提交事务
    sqlSession.commit();

    if(result > 0) {
        System.out.println("删除成功");
    } else {
        System.out.println("删除失败");
    }

    //释放资源
    sqlSession.close();
}

三、配置解析

（一）核心配置文件

mybatis-config.xml 系统核心配置文件

MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。

能配置的内容如下：

代码语言：javascript复制

configuration（配置） 
properties（属性）
settings（设置）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂） 
plugins（插件） 
environments（环境配置） 
environment（环境变量）
transactionManager（事务管理器）
dataSource（数据源）
databaseIdProvider（数据库厂商标识） 
mappers（映射器） 
<!-- 注意元素节点的顺序！顺序不对会报错 -->

我们可以阅读 mybatis-config.xml 上面的dtd的头文件！【演示】

（二）环境配置（environments）

代码语言：javascript复制

<environments default="development"> 
	<environment id="development"> 
		<transactionManager type="JDBC">
			<property name="..." value="..."/>
		</transactionManager>
		<dataSource type="POOLED">
			<property name="driver" value="${driver}"/>
			<property name="url" value="${url}"/> 
			<property name="username" value="${username}"/> 
			<property name="password" value="${password}"/>
		</dataSource> 
	</environment> 
</environments>

配置MyBatis的多套运行环境，将SQL映射到多个不同的数据库上，必须指定其中一个为默认运行

环境（通过default指定）

子元素节点：environment

具体的一套环境，通过设置id进行区别，id保证唯一！

子元素节点：transactionManager - 事务管理器

代码语言：javascript复制

<!-- 语法 --> 
<transactionManager type="[ JDBC | MANAGED ]"/>

这两种事务管理器类型都不需要设置任何属性。

子元素节点：数据源（dataSource）

dataSource 元素使用标准的 JDBC 数据源接口来配置 JDBC 连接对象的资源。

数据源是必须配置的。

有三种内建的数据源类型

代码语言：javascript复制

type="[UNPOOLED|POOLED|JNDI]"）

unpooled：这个数据源的实现只是每次被请求时打开和关闭连接。
pooled：这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来 , 这是一种使得并发 Web 应用快速响应请求的流行处理方式。
jndi：这个数据源的实现是为了能在如 Spring 或应用服务器这类容器中使用，容器可以集中或在外部配置数据源，然后放置一个 JNDI 上下文的引用。
数据源也有很多第三方的实现，比如dbcp，c3p0，druid等等…

（三）属性（properties）

数据库这些属性都是可外部配置且可动态替换的，既可以在典型的 Java 属性文件中配置，亦可通过properties 元素的子元素来传递。

1.优化配置文件

第一步：在资源目录下新建一个db.properties

代码语言：javascript复制

driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=utf8
username=root
password=1234

第二步：将文件导入properties 配置文件

代码语言：javascript复制

<?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>
<!--导入properties文件--><!--注意配置文件中不要加中文！！！！使用此处代码不要复制这个中文注释-->
    <properties resource="db.properties"/>
    
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${driver}"/>
                <property name="url" value="${url}"/>
                <property name="username" value="${username}"/>
                <property name="password" value="${password}"/>
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="com/bby/Dao/UserMapper.xml"/>
    </mappers>
</configuration>

2.细节问题

可以直接引入外部文件或者在核心配置文件中映入，如下：

代码语言：javascript复制

<properties resource="db.properties">
	<property name="username" value="root"/>
	<property name="pwd" value="11111"/>
</properties>

可以在其中增加一些属性配置

如果两个文件有同一字段，优先使用外部配置文件的！

（四）类型别名（typeAliases）

类型别名是为 Java 类型设置一个短的名字

它只和 XML 配置有关，存在的意义仅在于用来减少类完全限定名的冗余。

代码语言：javascript复制

<typeAliases>
   <typeAlias type="com.bby.pojo.User" alias="User"/>
</typeAliases>

也可以制定一个包名，MyBatis 会在包名下面搜索需要的 Java Bean，比如:

扫描实体类的包，它的默认别名就为这个类的类名，首字母不区分大小写，例如：User / user

代码语言：javascript复制

<typeAliases>
   <package name="com.bby.pojo"/>
</typeAliases>

提示：在实体类比较少的时候，使用第一种方式

如果实体类特别多，建议使用第二种方式

第一种方式可以DIY别名，第二种则不行，如果非要改，需要在实体类上增加注解

代码语言：javascript复制

import org.apache.ibatis.type.Alias;

@Alias("use")//记住这种方式需要两步，第一步在typeAliases中配置扫描包名，第二步在实体类上面使用注解
public class User {}

（五）设置（settings）

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

代码语言：javascript复制

<settings>
  <setting name="cacheEnabled" value="true"/>
  <setting name="lazyLoadingEnabled" value="true"/>
  <setting name="multipleResultSetsEnabled" value="true"/>
  <setting name="useColumnLabel" value="true"/>
  <setting name="useGeneratedKeys" value="false"/>
  <setting name="autoMappingBehavior" value="PARTIAL"/>
  <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
  <setting name="defaultExecutorType" value="SIMPLE"/>
  <setting name="defaultStatementTimeout" value="25"/>
  <setting name="defaultFetchSize" value="100"/>
  <setting name="safeRowBoundsEnabled" value="false"/>
  <setting name="mapUnderscoreToCamelCase" value="false"/>
  <setting name="localCacheScope" value="SESSION"/>
  <setting name="jdbcTypeForNull" value="OTHER"/>
  <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>

具体看官方文档：https://mybatis.org/mybatis-3/zh/configuration.html#settings

（六）其他配置

typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins插件
- Mybatis Generator Core
- Mybatis-plus
- 通用mapper

（七）映射器（mappers）

MapperRegistry：注册绑定我们的Mapper文件

方式一：使用相对于类路径的资源引【推荐】

代码语言：javascript复制

<mappers>
	<mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>

方式二：使用完全限定资源定位符（URL）【非常不推荐】

代码语言：javascript复制

<mappers>
	<mapper url="file:///var/mappers/AuthorMapper.xml"/>
</mappers>

方式三：使用class文件绑定注册

这种方式是使用映射器接口实现类的完全限定类名

代码语言：javascript复制

<mappers>
	<mapper class="org.mybatis.builder.AuthorMapper"/>
</mappers>

注意点：

接口和它的Mapper配置文件必须同名
接口和它的Mapper配置文件必须位于同一目录下

方式四：使用扫描包进行注册绑定

这种方式可以将包内的映射器接口实现全部注册为映射器

代码语言：javascript复制

<mappers>
	<package name="org.mybatis.builder"/>
</mappers>

注意点：

接口和它的Mapper配置文件必须同名
接口和它的Mapper配置文件必须位于同一目录下

（八）生命周期和作用域

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

以下是Mybatis的执行过程：

1.SqlSessionFactoryBuilder

一旦创建了SqlSessionFactory，就不在需要它了
适合用在局部变量中

2.SqlSessionFactory

说白了可以想象为：数据库连接池
SqlSessionFactory一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或者重新创建另一个实例
因此SqlSessionFactory的最佳作用域是应用作用域（全局作用域）
最简单的就是使用单例模式或者静态单例模式

3.SqlSession

连接到连接池的一个请求！
SqlSession的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或者方法作用域
用完之后需要赶紧关闭，否则资源被占用！

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

四、ResultMap

（一）查询为null问题

要解决的问题：属性名和字段名不一致

环境：新建一个项目，将之前的项目拷贝过来

1、查看之前的数据库的字段名

2、Java中的实体类设计

代码语言：javascript复制

public class User {

   private int id;  //id
   private String name;   //姓名
   private String password;   //密码和数据库不一样！
   
   //构造
   //set/get
   //toString()
}

3、接口

代码语言：javascript复制

//根据id查询用户
User selectUserById(int id);

4、mapper映射文件

代码语言：javascript复制

<select id="selectUserById" resultType="user">
  select * from user where id = #{id}
</select>

5、测试

代码语言：javascript复制

@Test
public void testSelectUserById() {
   SqlSession session = MybatisUtils.getSession();  //获取SqlSession连接
   UserMapper mapper = session.getMapper(UserMapper.class);
   User user = mapper.selectUserById(1);
   System.out.println(user);
   session.close();
}

结果:

User{id=1, name=‘BoBooY’, password=‘null’}
查询出来发现 password 为空 . 说明出现了问题！

分析：

select * from user where id = #{id} 可以看做 select id,name,pwd from user where id = #{id}
mybatis会根据这些查询的列名(会将列名转化为小写,数据库不区分大小写) , 去对应的实体类中查找相应列名的set方法设值 , 由于找不到setPwd() , 所以password返回null ; 【自动映射】

（二）解决方案

方案一：为列名指定别名 , 别名和java实体类的属性名一致

代码语言：javascript复制

<select id="selectUserById" resultType="User">
  select id , name , pwd as password from user where id = #{id}
</select>

方案二：使用结果集映射 ResultMap 【推荐】

代码语言：javascript复制

<resultMap id="UserMap" type="User">
   <!-- id为主键 -->
   <id column="id" property="id"/>
   <!-- column是数据库表的列名 , property是对应实体类的属性名 -->
   <result column="name" property="name"/>
   <result column="pwd" property="password"/>
</resultMap>

<select id="selectUserById" resultMap="UserMap">
  select id , name , pwd from user where id = #{id}
</select>

resultMap元素是Mybatis中最强大的元素
ResultMap的设计思想是：对于简单的语句根本不需要配置显示的结果映射，而对于复杂一点的语句只需要描述他们的关系就行了
ResultMap最优秀的地方在与，虽然你已经对它相当的了解，但是根本就不需要显示的用到他们

Mybatis入门知识（下）：https://blog.csdn.net/qq_58233406/article/details/127112954

xml mybatis 数据库 sql ide

0 人点赞

Mybatis | Mybatis学习笔记（上）

文章目录

Mybatis简介

（一）什么是Mybatis？

（二）持久化

（三）持久层

（四）为什么需要Mybatis

一、第一个Mybatis程序

（一）分析思路

（二）创建一个数据库并建一张表

（三）创建一个普通Maven项目并删除src目录

（四）导入相关依赖

（五）创建一个模块（子工程）

（六）编写Mybatis核心配置文件

（七）IDEA与mysql数据库连接

（八）编写Mybatis工具类

（九）编写实体类

（十）编写Mapper接口类

（十一）编写UserMapper.xml配置文件

（十二）添加核心配置文件mybatis-config中的mapper

（十三）使用JUnit测试

（十四）常见问题

1.配置文件加载不出来

（1）情况一：resource里面的路径错误

（2）情况二：Maven资源没有导出问题

2.空指针异常

3.标签错误

4.namespace

5.输出的xml文件中存在中文乱码问题

二、增删改查

（一）通过id查询用户

1.编写UserMapper接口

2.编写UserMapper.xml的配置文件

3.JUnit测试

（二）添加用户

1.编写UserMapper接口

2.编写UserMapper.xml的配置文件

3.JUnit测试

（三）修改用户信息

1.编写UserMapper接口

2.编写UserMapper.xml的配置文件

3.JUnit测试

（四）删除用户

1.编写UserMapper接口

2.编写UserMapper.xml的配置文件

3.JUnit测试

三、配置解析

（一）核心配置文件

（二）环境配置（environments）

（三）属性（properties）

1.优化配置文件

2.细节问题

（四）类型别名（typeAliases）

（五）设置（settings）

（六）其他配置

（七）映射器（mappers）

方式一：使用相对于类路径的资源引【推荐】

方式二：使用完全限定资源定位符（URL）【非常不推荐】

方式三：使用class文件绑定注册

方式四：使用扫描包进行注册绑定

（八）生命周期和作用域

1.SqlSessionFactoryBuilder

2.SqlSessionFactory

3.SqlSession

四、ResultMap

（一） 查询为null问题

（二）解决方案

方案一：为列名指定别名 , 别名和java实体类的属性名一致

方案二：使用结果集映射 ResultMap 【推荐】

（一）查询为null问题