==>>MyBatis中文网
1、第一个 mybastis程序
1.1 导入jar包
代码语言：javascript复制<mybatis.version>3.4.1</mybatis.version>
<mysql.version>5.1.47</mysql.version>
<!-- mybatis begin -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>${mybatis.version}</version>
</dependency>
<!-- mybatis end -->
<!-- mysql begin -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>${mysql.version}</version>
</dependency>
<!-- mysql end -->1.2 jdcb.properties
代码语言：javascript复制driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/animedb?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=GMT+8
username=root
password=root1.3 mybatis-config.xml
数据配置信息可以直接在mybatis-config.xml中填写，也可以引入外部数据库配置信息文件；
代码语言：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 resource="jdbc.properties"></properties>
<typeAliases>
<!-- 给所有的实体类 批量取别名 -->
<package name="com.kgc.mybatis.bean"/>
</typeAliases>
<!-- 是指数据库配置环境，可以直接写值也可以引入外部配置文件 -->
<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>
<package name="com.kgc.mybatis.mapper"/>
</mappers>
</configuration>1.4 xxxMapper.xml
SQL映射文件；
代码语言：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">
<!--
SQl语句映射文件：
namespace ：名称空间
1.单独使用SqlSession的方法，可以随意的定义，仅限于全限定名的方式，指定sql语句唯一标识字符串使用
2.再面向接口开发时，不可以随便写了，必须时某个接口的全类名（全路径名：包名 类名）
-->
<!-- <mapper namespace="huayu"> 随意定义命名空间 -->
<mapper namespace="com.kgc.mybatis.mapper.AnimeMapper"> <!-- 接口开发 -->
<!--
select标签：查询标签
id属性：select标签的唯一标识，再面向开发时，对应的时namespace指定接口的某个方法名
resultType 属性: 返回值类型
#{id} :获取调用接口，获取参数值
-->
<select id="selectAnime" parameterType="int" resultType="com.kgc.mybatis.bean.Anime">
select * from animes where id = #{id}
</select>
</mapper>1.5 获取 SqlSession 并执行SQL
1.5.1 获取 SqlSessionFactory
- 指定mybatis的核心配置文件 “mybatis-config.xml”；
- 使用mybatis提供的Resources 工具类读取核心配置文件，转为输入流对象；
- 使用SqlSessionFactoryBuilder对象的build方法，获取到DefaultSqlSessionFactory；
//指定mybatis的核心配置文件路径
String resource = "mybatis-config.xml";
//使用mybatis提供的Resources 工具类读取核心配置文件，转为输入流对象
InputStream inputStream = Resources.getResourceAsStream(resource);
//使用SqlSessionFactoryBuilder对象的build方法，基于上一步的输入流对象
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
//获取到的是 DefaultSqlSessionFactory
System.out.println(sqlSessionFactory);
//org.apache.ibatis.session.defaults.DefaultSqlSessionFactory@45c8e6161.5.2 sqlSessionFactory 获取 SqlSession 实例
SqlSession 提供了在数据库执行 SQL 命令所需的所有方法，拿到SqlSession 就可以执行；
session.selectOne(statement，parameter）; 方法参数分析
参数 | 说明 |
|---|---|
statement | 准备要执行的SQL语句的唯一标识符（mybatis可以识别，目的是可以通过此标识，查找到要执行的SQL语句） |
parameter | 准备要执行的SQL语句的参数值 |
//将实例化SqlSession放在 try()中，会自动关闭资源
try (SqlSession session = sqlSessionFactory.openSession()) {
//通过获取的SqlSession的实例，执行查询操作
//根据动漫编号，查询动漫详情
//<mapper namespace="huayu">单独使用SqlSession的方法，namespace可以随意的定义
//namespace.方法名，通过sql语句唯一标识字符串,找到执行SQL
Anime anime = (Anime) session.selectOne("huayu.selectAnime", 101);
System.out.println(anime);
}1.5.3 面向接口开发
注意在resource下建立文件夹的时候需要 com/kcg/mybatis ,中间的分隔符要使用反斜杠，不能用点；
- 创建接口xxxMapper.java(注意路径要与xxxMapper.xml的包名结构一致；)
- 通过session.getMapper(xxxMapper.class); 获取接口代理类
- 使用接口代理类，调用接口方法
try (SqlSession session = sqlSessionFactory.openSession()) {
//面向接口开发
//推荐的方式
AnimeMapper animeMapper = session.getMapper(AnimeMapper.class);
System.out.println(animeMapper);
//代理对象 org.apache.ibatis.binding.MapperProxy@4cc0edeb
//直接就可以通过调用接口的方法，执行对象的SQl语句，并返回接口，不需要关心mybatis底层是调用那个方法
Anime anime = animeMapper.selectAnime(101);
System.out.println(anime);
}try()中实例化对象报错问题
https://cloud.tencent.com/developer/article/2143555
指定maven版本就可以
代码语言：javascript复制<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>8</source>
<target>8</target>
</configuration>
</plugin>2、配置
2.1 所有配置 和 顺序
注意：配置的顺序不能错，可以少写，但是不能顺序错
- configuration（配置）
- properties（属性）
- settings（设置）
- typeAliases（类型别名）
- typeHandlers（类型处理器）
- objectFactory（对象工厂）
- plugins（插件）
- environments（环境配置）
- environment（环境变量）
- transactionManager（事务管理器）
- dataSource（数据源）
- environment（环境变量）
- databaseIdProvider（数据库厂商标识）
- mappers（映射器）
2.2 properties 属性
1、properties 属性：自定义核心属性配置，也可以引入外部的属性文件，比如jdbc.properties;
- resource 属性：指定外部配置文件，优先级高于property子标签属性配置，可以以单独使用，如果二者同时存在，优先以外部为主
//resource属性引入的外部配置文件，优先级高于property子标签属性
<properties resource="jdbc.properties">
<!-- <property name="driver" value="com.mysql.jdbc.Driver"/>-->
<!-- <property name="url" value="jdbc:mysql://localhost:3306/animedb?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=GMT+8"/>-->
<!-- <property name="username" value="root"/>-->
<!-- <property name="password" value="17585273765"/>-->
</properties>2.3 settings 设置
一些设置的开启；
下面是简单举例，设置用很多，可以直接看官网；
代码语言：javascript复制<settings>
<!-- 开启驼峰自动映射 -->
<setting name="mapUnderscoreToCamelCase" value="true" />
<!-- mybatis自带日志 -->
<!-- <setting name="logImpl" value="STDOUT_LOGGING"/> -->
<!-- LOG4J日志 -->
<!-- <setting name="logImpl" value="LOG4J"/> -->
</settings>2.4 typeAliases 类型别名
在SQL的xml文件中，resultType 可以使用 别名，不区分大小写；
- 单个取别名，在SQL的xml文件中，resultType 可以使用 别名，不区分大小写
- 批量取别名 ：指定实体所在的父包路径，自动指定包及子包中所有的实体批量取别名，默认的类名是首字母小写，不区分大小写；
- 建议，如果没有安装插件，从SQL映射xml文件中，无法自动定位到目标实体，不利于代码的可读性；
- mybatis对 Java 的基本数据类型 有 内建的类型别名；
<typeAliases>
<!-- 单个实体类设置别名 -->
<!-- <typeAlias type="com.kgc.mybatis.bean.Anime" alias="Anime"></typeAlias>-->
<!-- 对整个个实体包下的实体类设置别名 -->
<package name="com.kgc.mybatis.bean"/>
</typeAliases>2.5 environments 环境配置
MyBatis 可以配置成适应多种环境；
不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。
代码语言：javascript复制<environments default="development_test">
<!-- 开发环境 -->
<environment id="development_dev">
<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>
<!-- 测试环境 -->
<environment id="development_test">
......
</environment>
<!-- 生产环境 -->
<environment id="development_prod">
.......
</environment>
</environments>2.5.1 transactionManager 事务管理
environment 标签的子标签 transactionManager;
- transactionManager：事务管理，使用的是jdbc的数据管理，以后框架整合会个Spring处理；
- MyBatis 中有两种类型的事务管理器（也就是 type="JDBC|MANAGED"）； JDBC – 这个配置直接使用了 JDBC 的提交和回滚设施，它依赖从数据源获得的连接来管理事务作用域。
- MANAGED – 这个配置几乎没做什么。它从不提交或回滚一个连接，而是让容器来管理事务的整个生命周期（比如 JEE 应用服务器的上下文）。 默认情况下它会关闭连接。然而一些容器并不希望连接被关闭，因此需要将 closeConnection 属性设置为 false 来阻止默认的关闭行为
- 如果使用Spring mybatis :事务管理，交给Spring处理;
<transactionManager type="JDBC"/>2.5.2 dataSource 数据源
- 数据源配置：有三种内建的数据源类型（也就是 type="UNPOOLED|POOLED|JNDI"） 以后由Spring处理；
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>2.6 mappers 映射器
- 用于指定SQL文件的加载，作用：告诉MySql 到哪里去找 映射文件；
2.6.1 单个SQL映射文件的加载
- resource
<mappers>
<mapper resource="com/kgc/mybatis/AnimeMapper.xml"></mapper>
</mappers>- 通过接口
<mappers>
<mapper class="com.kgc.mybatis.mapper.AnimeMapper"></mapper>
</mappers>2.6.2 批量SQL映射文件加载
只需要指定mapper接口的所在包；
代码语言：javascript复制<mappers>
<package name="com.kgc.mybatis.mapper"/>
</mappers>3、MyBatis 执行过程
3.1 代码分析执行过程
代码语言：javascript复制//1、加载全局配置文件
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
//2、实例化 SqlSessionFactoryBuilder 构建器
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
//3、解析 配置信息文件流，并返回 defaultSessionFactory
SqlSessionFactory defaultSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
//4、实例化 SqlSession
SqlSession sqlSession = defaultSessionFactory.openSession();
System.out.println(sqlSession);
//org.apache.ibatis.session.defaults.DefaultSqlSession@20398b7c
//5、获取接口的代理实现类
AnimeMapper animeMapper = sqlSession.getMapper(AnimeMapper.class);
//调用接口的 代理类，执行方法
Anime anime = animeMapper.selectAnimeById(101);
System.out.println(anime);
//Anime(id=101, cid=1, name=斗破苍穹, author=土豆, actor=萧炎, produce=玄机科技, createDate=Sun Aug 07 00:00:00 CST 2022)3.2 源码分析执行过程分析
3.2.1 Resources 加载全局配置文件
代码语言：javascript复制//加载全局配置文件
InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");3.2.2 SqlSessionFactoryBuilder 构建器
代码语言：javascript复制//实例化 SqlSessionFactoryBuilder 构建器
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();3.2.3 sqlSessionFactoryBuilder.build(inputStream);
解析 配置信息文件流，并返回 defaultSessionFactory;
代码语言：javascript复制//解析 配置信息文件流，并返回 defaultSessionFactory
SqlSessionFactory defaultSessionFactory = sqlSessionFactoryBuilder.build(inputStream);手动实现，体验实例化Configuration；
代码语言：javascript复制//手动解析配置文件流，实例化Configuration，体验Mybatsi自动实例化Configuration；
//实例化 XMLConfigBuilder 参数：配置文件流,环境名字,Properties实例
//XMLConfigBuilder xmlConfigBuilder = new XMLConfigBuilder(inputStream, "development_dev", new Properties());
//解析配置文件流
//Configuration configuration = xmlConfigBuilder.parse();`SqlSessionFactoryBuilder源码分析：
sqlSessionFactoryBuilder.build(inputStream)方法，首先进入sqlSessionFactoryBuilder类，
调用当前类的SqlSessionFactory build(InputStream inputStream, String environment, Properties properties)方法；
其中，又调用当前类的一个build方法，解析配置文件，并实例化DefaultSqlSessionFactory;
3.2.4 defaultSessionFactory.openSession();
代码语言：javascript复制//实例化 SqlSession
SqlSession sqlSession = defaultSessionFactory.openSession();
//org.apache.ibatis.session.defaults.DefaultSqlSession@20398b7cDefaultSqlSessionFactory源码分析：
openSession方法调用openSessionFromConnection；
openSessionFromDataSource(ExecutorType execType, TransactionIsolationLevel level, boolean autoCommit) 方法：方法：
3.2.5 sqlSession.getMapper(xxx.class);
代码语言：javascript复制//获取到接口的代理实现类
AnimeMapper animeMapper = sqlSession.getMapper(AnimeMapper.class);
//org.apache.ibatis.binding.MapperProxy@5abca1e0
//也可以通过，解析配置文件流 创建配置对象，并通过配置对象直接getMapper,前提是获得了sqlSession
//Configuration configuration = xmlConfigBuilder.parse();
//AnimeMapper animeMapper = configuration.getMapper(AnimeMapper.class, sqlSession);3.2.6 animeMapper.selectAnimeById(101);
代码语言：javascript复制//调用接口代理类，执行方法
Anime anime = animeMapper.selectAnimeById(101);
//Anime(id=101, cid=1, name=斗破苍穹, author=土豆, actor=萧炎, produce=玄机科技, createDate=Sun Aug 07 00:00:00 CST 2022)3.2.7 总结
