MyBatis简介
搭建MyBatis
通过junit调用执行SQL语句
查询select语句在Mapper.xml中的写法
核心配置文件详解mybatis-config.xml
在IDEA中添加mybatis-config.xml和mybatis-mapper.xml的模板
- mybatis-config.xml模板
- mybatis-mapper.xml模板

MyBatis简介

MyBatis历史

MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁移到了Google Code。随着开发团队转投Google Code旗下，iBatis3.x正式更名为MyBatis。代码于2013年11月迁移到Github
iBatis一词来源于“internet”和“abatis”的组合，是一个基于Java的持久层框架。iBatis提供的持久层框架包括SQL Maps和Data Access Objects（DAO）
NyBatis特性

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

MyBatis下载地址
其实不用下载这个，可以下载这个看里面的官方文档，但是jar包的话一般用maven依赖

和其它持久化层技术对比
JDBC
- SQL 夹杂在Java代码中耦合度高，导致硬编码内伤
- 维护不易且实际开发需求中 SQL 有变化，频繁修改的情况多见
- 代码冗长，开发效率低
Hibernate 和 JPA
- 操作简便，开发效率高
- 程序中的长难复杂 SQL 需要绕过框架
- 内部自动生产的 SQL，不容易做特殊优化
- 基于全映射的全自动框架，大量字段的 POJO 进行部分映射时比较困难。
- 反射操作太多，导致数据库性能下降

MyBatis

轻量级，性能出色
SQL 和 Java 编码分开，功能边界清晰。Java代码专注业务、SQL语句专注数据

开发效率稍逊于HIbernate，但是完全能够接受

搭建MyBatis

创建maven工程

创建了maven工程后，在pom.xml里面添加依赖

<dependencies>
<!-- Mybatis核心 -->
<dependency>
   <groupId>org.mybatis</groupId>
   <artifactId>mybatis</artifactId>
   <version>3.5.7</version>
</dependency>
<!-- junit测试 -->
<dependency>
   <groupId>junit</groupId>
   <artifactId>junit</artifactId>
   <version>4.12</version>
   <scope>test</scope>
</dependency>
<!-- MySQL驱动 -->
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
   <version>5.1.3</version>
</dependency>
</dependencies>

创建MyBatis的核心配置文件

习惯上命名为mybatis-config.xml，这个文件名仅仅只是建议，并非强制要求。将来整合Spring之后，这个配置文件可以省略，所以大家操作时可以直接复制、粘贴。
核心配置文件主要用于配置连接数据库的环境以及MyBatis的全局配置信息。
核心配置文件存放的位置是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">  
<configuration>  
<!--设置连接数据库的环境-->  
<environments default="development">  
   <environment id="development">  
       <transactionManager type="JDBC"/>  
       <dataSource type="POOLED">  
           <property name="driver" value="com.mysql.cj.jdbc.Driver"/>  
           <!--mybatisdb是数据库，?useUnicode=true&characterEncoding=utf8是设置utf8格式插入数据，不然乱码-->  
           <property name="url" value="jdbc:mysql://localhost:3306/mybatisdb?useUnicode=true&characterEncoding=utf8"/>  
           <property name="username" value="root"/>  
           <property name="password" value="123456"/>  
       </dataSource>  
   </environment>  
</environments>  
<!--引入映射文件-->  
<mappers>  
   <mapper resource="mappers/UserMapper.xml"/>  
</mappers>  
</configuration>

创建mapper接口

实体类例子

下面的代码例子都是通过这个实体类来写

右键，选择Generate，快捷键Alt+Insert，然后就可以快说创建构造器，get，set等

package com.lyd.mybatis.pojo;
public class User {
    //命名和数据库中一致
    private int id;
    private String username;
    private String password;
    private int age;
    private String sex;
    private String email;
    //构造器，get，set等........
}

创造mapper接口

MyBatis有面向接口编程，每当我们去调用一个mapper中的方法（这里还没有写方法），它就会去匹配一条SQL语句并执行

package com.lyd.mybatis.mapper;
public interface UserMapper {
}

创建MyBatis的映射文件

说明

相关概念：ORM（Object Relationship Mapping）对象关系映射。
- 对象：Java的实体类对象
- 关系：关系型数据库
- 映射：二者之间的对应关系 | Java概念 | 数据库概念 | | —- | —- | | 类 | 表 | | 属性 | 字段/列 | | 对象 | 记录/行 |
映射文件的命名规则
- 表所对应的实体类的类名+Mapper.xml
- 例如：表t_user，映射的实体类为User，所对应的映射文件为UserMapper.xml
- 因此一个映射文件对应一个实体类，对应一张表的操作
- MyBatis映射文件用于编写SQL，访问以及操作表中的数据
- MyBatis映射文件存放的位置是src/main/resources/mappers目录下
MyBatis中可以面向接口操作数据，要保证两个一致
- mapper接口的全类名和映射文件的命名空间（namespace）保持一致
- mapper接口中方法的方法名和映射文件中编写SQL的标签的id属性保持一致

创建映射文件

这是目录结构

package com.lyd.mybatis.mapper;
public interface UserMapper {
    int insertUser();//添加用户的接口
}

<?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.lyd.mybatis.mapper.UserMapper">  
  <!--int insertUser();-->  
  <insert id="insertUser">  
    insert into t_user values(null,'张三','123',23,'女','123@qq.com')  
  </insert>  
</mapper>

namespace要对应mapper接口的全类名
mapper标签里面可以写很多增删改查标签
每个增删改查标签有一个id属性，id属性对应mapper接口里面的调用方法
增删改查标签里面就写SQL语句

设置核心配置文件
因为都是在资源文件夹里里面，所以这里直接用路径就可以了，在mappers标签里里面添加映射文件

    <!--引入映射文件-->
    <mappers>
        <mapper resource="mappers/UserMapper.xml"/>
    </mappers>

通过junit调用执行SQL语句

SqlSession：代表Java程序和数据库之间的会话。（HttpSession是Java程序和浏览器之间的会话）
SqlSessionFactory：是“生产”SqlSession的“工厂”
工厂模式：如果创建某一个对象，使用的过程基本固定，那么我们就可以把创建这个对象的相关代码封装到一个“工厂类”中，以后都使用这个工厂类来“生产”我们需要的对象

此时需要手动提交事务，如果要自动提交事务，则在获取sqlSession对象时，使用SqlSession sqlSession = sqlSessionFactory.openSession(true);，传入一个Boolean类型的参数，值为true，这样就可以自动提交

/**
* @author liyadong
* @create 2022-03-28-13:49
*/
public class UserMapperTest {
  @Test
  public void testInsertUser() throws IOException {
      //读取MyBatis的核心配置文件
      InputStream is = Resources.getResourceAsStream("mybatis-config.xml");
      //获取SqlSessionFactoryBuilder对象
      SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
      //通过核心配置文件所对应的字节输入流创建工厂类SqlSessionFactory，生产SqlSession对象
      SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(is);
      //获取sqlSession，此时通过SqlSession对象所操作的sql都必须手动提交或回滚事务
      //SqlSession sqlSession = sqlSessionFactory.openSession();
      //创建SqlSession对象，此时通过SqlSession对象所操作的sql都会自动提交  
      SqlSession sqlSession = sqlSessionFactory.openSession(true);
      //通过代理模式创建UserMapper接口的代理实现类对象
      UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
      //调用UserMapper接口中的方法，就可以根据UserMapper的全类名匹配元素文件，通过调用的方法名匹配映射文件中的SQL标签，并执行标签中的SQL语句
      int result = userMapper.insertUser();
      //提交事务
      //sqlSession.commit();
      System.out.println("result:" + result);
  }
}

查询select语句在Mapper.xml中的写法

因为，添加，修改，删除的返回结果都是被影响行数，int类型，甚至可以void。
但是查询不一样，查出来的东西类型各种各样的。

查询的标签select必须设置属性resultType或resultMap，用于设置实体类和数据库表的映射关系

resultType：自动映射，用于属性名和表中字段名一致的情况
resultMap：自定义映射，用于一对多或多对一或字段名和属性名不一致的情况

当查询的数据为多条时，不能使用实体类作为返回值，只能使用集合，否则会抛出异常TooManyResultsException；但是若查询的数据只有一条，可以使用实体类或集合作为返回值

    <!--User selectUser();-->
    <select id="selectUser" resultType="com.lyd.mybatis.pojo.User">
        select * from t_user where id = 1
    </select>

核心配置文件详解mybatis-config.xml

核心配置文件中的标签必须按照固定的顺序(有的标签可以不写，但顺序一定不能乱)： properties、settings、typeAliases、typeHandlers、objectFactory、objectWrapperFactory、reflectorFactory、plugins、environments、databaseIdProvider、mappers

1. properties：设置变量

在main/resources文件夹下面创建.properties文件，在里面设置参数。

换行设置，一行一个。后期防止参数多了，为了区分，可以加个前缀什么的，这里加的时jdbc。
在核心配置文件里里面使用properties标签。
需要使用这个参数变量时，在配置文件里面用${变量名}

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

2. typeAliases：设置别名

设置了别名，在使用select查询时，结果类型就可以不写全限定类名了。

java默认类型的别名

自带的，不用自己去设置
默认的类型别名1.png
默认的类型别名2.png

详细mybatis-config.xml

<?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="jdbc.properties"></properties>
    <settings>
        <!--将表中字段的下划线自动转换为驼峰-->
        <setting name="mapUnderscoreToCamelCase" value="true"/>
        <!--开启延迟加载-->
        <setting name="lazyLoadingEnabled" value="true"/>
    </settings>
    <typeAliases>
        <!--
        typeAlias：设置某个具体的类型的别名
        属性：
        type：需要设置别名的类型的全类名
        alias：设置此类型的别名，且别名不区分大小写。若不设置此属性，该类型拥有默认的别名，即类名
        -->
        <!--<typeAlias type="com.lyd.mybatis.pojo.User"></typeAlias>-->
        <!--<typeAlias type="com.lyd.mybatis.pojo.User" alias="user">
        </typeAlias>-->
        <!--以包为单位，设置改包下所有的类型都拥有默认的别名，即类名且不区分大小写-->
        <package name="com.lyd.mybatis.pojo"/>
    </typeAliases>
    <!--
    environments：设置多个连接数据库的环境
    属性：
     default：设置默认使用的环境的id
    -->
    <environments default="development">
        <!--
        environment：设置具体的连接数据库的环境信息
        属性：
         id：设置环境的唯一标识，可通过environments标签中的default设置某一个环境的id，表示默认使用的环境
        -->
        <environment id="development">
            <!--
            transactionManager：设置事务管理方式
            属性：
             type：设置事务管理方式，type="JDBC|MANAGED"
             type="JDBC"：设置当前环境的事务管理都必须手动处理
             type="MANAGED"：设置事务被管理，例如spring中的AOP
            -->
            <transactionManager type="JDBC"/>
            <!--
            dataSource：设置数据源
            属性：
             type：设置数据源的类型，type="POOLED|UNPOOLED|JNDI"
             type="POOLED"：使用数据库连接池，即会将创建的连接进行缓存，下次使用可以从缓存中直接获取，不需要重新创建
             type="UNPOOLED"：不使用数据库连接池，即每次使用连接都需要重新创建
             type="JNDI"：调用上下文中的数据源
            -->
            <dataSource type="POOLED">
                <!--设置驱动类的全类名-->
                <property name="driver" value="${jdbc.driver}"/>
                <!--设置连接数据库的连接地址-->
                <property name="url" value="${jdbc.url}"/>
                <!--设置连接数据库的用户名-->
                <property name="username" value="${jdbc.username}"/>
                <!--设置连接数据库的密码-->
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    <!--引入映射文件-->
    <mappers>
        <!-- <mapper resource="UserMapper.xml"/> -->
        <!--
        以包为单位，将包下所有的映射文件引入核心配置文件
        注意：
   1. 此方式必须保证mapper接口和mapper映射文件必须在相同的包下
   2. mapper接口要和mapper映射文件的名字一致
   3.这个包在resources资源文件夹下，不能直接创建包，用创建普通目录的方式，“/”分割包名，如：com/lyd/mybatis/mapper
        -->
        <package name="com.atguigu.mybatis.mapper"/>
    </mappers>
</configuration>

目录结构

在IDEA中添加mybatis-config.xml和mybatis-mapper.xml的模板

把mybatis-config.xml和Mapper.xml写好一个固定的格式，把一些变量删掉，留个空格。
在IDEA中，进入设置

然后在创建新文件时，就可以创建这个模板了

mybatis-config.xml模板

<?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 resource="jdbc.properties"></properties>
    <typeAliases>
        <package name=""/>
    </typeAliases>
    <!--设置连接数据库的环境-->
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="${jdbc.driver}"/>
                <property name="url" value="${jdbc.url}"/>
                <property name="username" value="${jdbc.username}"/>
                <property name="password" value="${jdbc.password}"/>
            </dataSource>
        </environment>
    </environments>
    <!--引入映射文件-->
    <mappers>
        <package name=""/>
    </mappers>
</configuration>

mybatis-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="">
</mapper>

MyBatis 与plus

MyBatis基础与构建