Mybatis

Mybatis

环境：

• JDK1.8
• Mysql5.7
• maven3.6.1
• IDEA

回顾：

• JDBC
• MySQL
• Java基础
• Maven
• Junit

SSM框架：配置文件的

最好的方式：看官网文档

1、简介

1.1、什么是mybatis

• Mybatis是一款优秀的持久层框架
• 它支持定制化SQL，存储过程个以及高级映射
• Mybatis避免了激活所有的JDBC代码和手动设置参数以及获取结果集
• Mybatis可以使用简单的XML或注解来配置和映射原生类型，接口和Java的POJO（Plain Old Java Object，普通老式Java对象）为数据库中的记录
• Mybatis本是apache的一个开源项目iBatis，2010年这个项目有apache software foundation迁移到了Google code，并且改名为Mybatis
• 2013年11月迁移到Github

1.2、持久化

数据持久化

• 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
• 内存：断电即失
• 数据库（JDBC）,io文件持久化
• 生活：冷藏，罐头

为什么需要持久化？

• 有一些对象不可以让他丢掉
• 内存价格昂贵

1.3、持久层

Dao层 ，Service层，Controller层…

• 完成持久化工作的代码块
• 层的界限十分明显

1.4、为什么需要Mybatis？

• 帮助程序员将数据存入到数据库中
• 方便
• 传统的JDBC代码太复杂，简化操作，制成框架，自动化
• 不用Mybatis也可以，因为Mybatis是框架更容易上手，小白也可以，技术没有高低之分

优点：

• 简单易学
• 灵活
• SQL和代码的分离，提高了程序的可维护性
• 提供映射标签，支持对象与数据库的orm字段关系映射
• 提供对象关系映射标签，支持对象关系组建维护
• 提供xml标签，支持编写动态sql
• 最重要的一点：使用的人多！

2、第一个Mybatis程序

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

2.1、搭建环境

搭建数据库

create database `mybatis`;

use `mybatis`;

create table `user`(
	`id` int(20) not null primary key,
    `name` varchar(20) default null,
    `pwd` varchar(20) default null
)engine=innodb default charset=utf8;

insert into `user` ('id','name','pwd') values
(1,'阿波','123456'),
(2,'张三','123456'),
(3,'李四','123456')

新建项目

1.新建一个普遍的maven项目

2.删除src目录

3.导入maven依赖

<!--导入依赖-->
    <dependencies>
<!--        mysql驱动-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.28</version>
        </dependency>

<!--        mybatis-->
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.5.2</version>
        </dependency>
<!--        junit-->
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>
        </dependency>
    </dependencies>

2.2、创建一个模块

• 编写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 核心配置文件-->
<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=UTF-8&amp;serverTimezone=GMT"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
</configuration>

• 编写mybatis工具类

//SqlSessionFactory--->SqlSession
public class MybatisUtils {
    private static SqlSessionFactory sqlSessionFactory;
    static {

        try {
            //使用Mybatis第一步---> 获取SqlSessionFactory对象
            String resource = "mybatis-config.xml";
            InputStream inputStream = Resources.getResourceAsStream(resource);
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    //既然有了 SqlSessionFactory，顾名思义，我们可以从中获得 SqlSession 的实例。
    // SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。/
    public static SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();

    }
}

2.3、编写代码

• 实体类

//实体类
public class User {
    private int id;
    private String name;
    private String pwd;

    public User() {
    }

    public User(int id, String name, String pwd) {
        this.id = id;
        this.name = name;
        this.pwd = 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;
    }

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

• Dao接口

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

• 接口实现类由原来的UserDaolmpl转变为一个Mapper配置文件

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

<!--    select 查询语句-->
    <select id="getUserList" resultType="com.kaung.pojo.User">
        select * from mybatis.user;

    </select>
</mapper>

2.4、测试

注意点：

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

MapperRegistry是什么？

核心配置文件中注册Mappers

• junit测试

public class UserDaoTest {

    @Test
    public void test(){
        //第一步:获取SqlSession对象
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        //方式一：getMapper
        UserDao userDao = sqlSession.getMapper(UserDao.class);
        List<User> userList =  userDao.getUserList();

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

        }

        //关闭SqlSession
        sqlSession.close();
    }
}

可能会遇到的问题

• 配置文件没有注册
• 接口绑定错误
• 方法名不对
• 返回类型不对
• Meven导出资源问题

3、CRUD

3.1、namespace

namesapce中的包名要和Dao/mapper 接口的包名一致！

3.2、select

选择，查询语句；

• id:就是对应的namespace方法名
• resultType:sql语句执行的返回值！
• paramaterType:参数类型！

1、编写接口

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

2、编写对应的mapper中的sql语句

 <select id="getUserById" parameterType="int" resultType="com.kaung.pojo.User">
        select * from mybatis.user where id = #{id}
    </select>

3、测试

 @Test
    public void getUserById(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);

        User user = mapper.getUserById(2);
        System.out.println(user);

        sqlSession.close();

    };

3.3、insert

1、编写接口

    //insert
    int addUser(User user);

2、编写对应mapper中的sql语句

<insert id="addUser" parameterType="com.kaung.pojo.User">
        insert into mybatis.user(id, name, pwd) value (#{id},#{name},#{pwd});
    </insert>

3、测试

  //增删改需要提交事务
    @Test
    public void addUser(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();

        UserMapper mapper = sqlSession.getMapper(UserMapper.class);

        int res = mapper.addUser(new User(4, "哈哈", "123456"));
        if(res>0){
            System.out.println("插入成功！");
        }

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

    }

3.4、update

1、编写接口

//update
    int updateUser(User user);

2、编写对应mapper中的sql语句

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

3、测试

 @Test
    public void updateUser(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        mapper.updateUser(new User(4,"呵呵","123123"));

        sqlSession.commit();
        sqlSession.close();
    };

3.5、delete

1、编写接口

//delete
    int deleteUser(int id);

2、编写对应mapper中的sql语句

    <delete id="deleteUser" parameterType="com.kaung.pojo.User">
        delete from mybatis.user where id = #{id};
    </delete>

3、测试

 @Test
    public void deleteUser(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        mapper.deleteUser(4);
        sqlSession.commit();
        sqlSession.close();
    }

注意点：

• 增删改需要提交事务！

3.6、分析错误

• 标签不要匹配错误
• resource绑定mapper，需要使用路径！
• 程序配置文件必须符合规范
• NullPointerException,没有注册到资源（空指针异常）
• 输出的xml文件中存在中文乱码问题
• maven资源没有导出问题

3.7、万能Map

假如我们的实体类或者数据库中的表，字段或者参数过多，我们应当考虑使用Map！

//万能的Map
    int addUser2(Map<String,Object> map);

  <insert id="addUser2" parameterType="map">
        insert into mybatis.user(id, name, pwd) value (#{userid},#{userName},#{password});
    </insert>

 @Test
    //Map测试
    public void addUser2(){
        SqlSession sqlSession = MybatisUtils.getSqlSession();
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        Map<String,Object> map = new HashMap<String, Object>();

        map.put("userid",5);
        map.put("userName","Hello");
        map.put("password","111111");

        mapper.addUser2(map);

        sqlSession.commit();
        sqlSession.close();
    }

Map传递参数，直接在sql中取出key即可 【parameterType=“map”】

对象传递参数，直接在sql中取对象的属性即可 【parameterType=“Object”】

只有一个基本类型参数的情况下，可以直接在sql中取到

多个参数用Map，或者注解

3.8、思考题

模糊查询怎么写？

1、Java代码执行的时候，传递通配符% %

        List<User> userList = mapper.getUserLike("%李%");

2、在sql拼接中使用通配符！（防止sql注入问题）

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

4、配置解析

4.1、核心配置文件

• mybatis-config.xml
• Mybatis的配置文件包含了会深深影响Mybatis行为的设置和属性信息

configuration（配置）
properties（属性）
settings（设置）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境配置）
environment（环境变量）
transactionManager（事务管理器）
dataSource（数据源）
databaseIdProvider（数据库厂商标识）
mappers（映射器）

4.2、环境配置

Mybatis可以配置成适应多种环境

不过要记住：尽管可以配置多个环境，但是每个SqlSessionFactory实例只能选择一种环境

学会使用配置多套配置环境

Mybatis默认的事务管理器是JDBC

默认的连接池是：POOLED

4.3、属性

我们可以通过properties属性来实现引用配置文件

这些属性可以在外部进行配置，并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性，也可以在 properties 元素的子元素中设置。 【db.properties】

编写一个配置文件：db.properties

driver=com.mysql.cj.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT
username=root
password=123456

在核心配置文件中引入

<!--    引入外部配置文件-->
    <properties resource="db.properties">
        <property name="username" value="root"/>
        <property name="password" value="123456"/>
    </properties>

• 可以直接引入外部文件
• 可以在其中增加一些属性配置
• 如果有两个文件有同一个字段，优先使用外部配置文件的

4、类型别名

• 类型别名是为了Java类型设置一个短的名字
• 存在的意义仅在于用来减少类完全限定名的冗余

<!--可以给实体类起别名--> 
<typeAliases>
        <typeAlias type="com.kaung.pojo.User" alias="User"></typeAlias>
    </typeAliases>

也可以指定一个包名，Mybatis会在包名下搜索需要的Java Bean，比如：

扫描实体类的包，它的默认别名就是这个类的 类名，首字母小写

<!--    可以给实体类起别名-->
    <typeAliases>
        <package name="com.kaung.pojo"/>
    </typeAliases>

在实体类比较少的时候，使用第一种方式，如果实体类十分多，建议使用第二种！

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

@Alias（"user"）
public class user{}

5、设置

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

6、其他配置

• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）
  • mybatis-generator-core
  • mybatis-plus
  • 通用mapper

7、映射器

MapperRegistry:注册绑定我们的Mapper文件；

方式一：

<!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册！-->
<mappers>
        <mapper resource="com/kaung/dao/UserMapper.xml"/>
    </mappers>

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

<!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册！--> 
<mappers>
        <mapper class="com.kaung.dao.UserMapper"/>
    </mappers>

方式三：使用扫描包进行注入绑定

<!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册！--> 
<mappers>
        <package name="com.kaung.dao"/>
    </mappers>

注意点（方式二、三）：

• 接口和它的Mapper配置文件必须同名
• 接口和它的Mapper配置文件必须在同一个包下

8、生命周期和作用域

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

SqlSessionFactoryBuilder ：

• 一旦创建了SqlSessionFactory，就不再需要它了

• 局部变量

SqlSessionFactory：

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

SqlSession：

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

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

5、解决属性名和字段名不一致的问题

5.1、问题

数据库中的字段

测试出现问题

// select * from mybatis.user where id = #{id}
//类型处理器
// select id,name,pwd from mybatis.user where id = #{id}

解决方法：

• 起别名

<select id="getUserById" parameterType="int" resultType="User">
    select id,name,pwd as password from mybatis.user where id = #{id}
</select>

5.2、resultMap

• resultMap 元素是 MyBatis 中最重要最强大的元素

• ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。

• ResultMap 最优秀的地方在于，虽然你已经对它相当的了解，但是根本就不需要显式的用到他们

• 结果集映射:

id name pwd
id name password

<!--    结果集映射-->
    <resultMap id="UserMap" type="User">
<!--        column  数据库中的字段，property 实体类中的属性-->
        <result column="id" property="id"/>
        <result column="name" property="name"/>
        <result column="pwd" property="password"/>
    </resultMap>

    <select id="getUserById" parameterType="int" resultMap="UserMap">
        select * from mybatis.user where id = #{id}
    </select>