Mybatis从认识到了解

目录

首发日期：2018-10-31

MyBatis的介绍

介绍：

  • MyBatis是Apache旗下的开源项目，是一个持久层框架
  • 与Hibernate的全自动ORM框架可以仅仅依靠映射关系进行SQL查询不同，MyBatis是一个基于SQL语句的半自动ORM框架，它需要我们手动去定义SQL语句。

为什么选择MyBatis：

与JDBC的对比中，MyBatis是基于ORM的，天然要比JDBC强，基于ORM使得MyBatis具有查询的数据可以自动封装到对象中的等好处，而JDBC需要手动编码的位置就较多了（就算是使用DButils，你也需要使用定义不同的方法来给不同的持久类赋值。）。

在互联网应用程序开发中，对于存储过程和复杂的SQL，Hibernate并没有很好地去处理，所以它比较难提升性能（并不是说不能，而是耗费心思较多），无法满足高并发和高响应的需求（如果要强行优化，又破坏了Hibernate的全自动ORM设计）。

与之对应的，Mybatis可以说是基于SQL的，它需要我们去自定义SQL，那么我们可以根据需要去设计和优化SQL，这种可针对SQL的优化的持久层框架，恰巧符合高并发和高响应的互联网应用程序开发开发需求。


与Hibernate的对比：

  • ORM区别：
    • Hibernate是完全面向POJO的，它基本不需要编写SQL，可以直接通过映射关系来操作数据。
    • 而MyBatis需要我们自定义SQL语句。
  • 面向的需求：
    • 对于一些不需要太高性能的，可以使用Hibernate去开发。【ERP，CRM,OA之类的】
    • 对于有性能要求的，通常需要使用MyBatis。

MyBatis的优点：

  • 支持存储过程
  • 由于是自定义SQL，方便进行SQL优化
  • 可以简化开发，对比JDBC开发，省去了很多代码；
  • 基于Mapper发送SQL的方式使得DAO层仅需要定义接口，而不需要DAO实现类了。

入门示例


1.首先要下载依赖包https://github.com/mybatis/mybatis-3/releases

  • 文件\文件夹详情:
    • lib：包含MyBatis依赖包,MyBatis的功能需要这些依赖包。
    • mybatis-3.4.5.jar：mybatis的核心包。
    • mybatis-3.4.5.pdf：mybatis的官方文档。

2.创建普通javase工程,导入依赖包（我这里使用mybatis-3.4.5 ）：

  • 导入MyBatis核心包：mybatis-3.4.5.jar
  • 导入数据库驱动包：mysql-connector-java-5.1.7-bin.jar
  • 导入MyBatis依赖包：

3.创建持久类和创建数据表：持久类是用于封装从数据库中返回的结果，可以说持久类的对象就是数据库记录在java中的实体（这里约定数据表的列名与持久类的属性名一致）。

  • 持久类
   package work.pojo;
   
   public class User {
   	private Integer id;
   	private String name;
   	private Integer age;
   	//省略setter,getter，toString
   }
  • 数据表：
create table user(
id int primary key auto_increment,
name varchar(20),
age int
);

4.在持久类User.java同级目录下创建映射文件user.xml：这个映射文件的意义是用来定义sql语句，使得我们可以在代码中调用sql语句【不同类的标签定义不同类的SQL，id用于标识SQL语句，parameterType是传入SQL语句的参数，resultType定义了返回结果的类型（这里由于表字段和类属性名一致，查询的记录的各个值会自动赋给对象）】

<?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="user">
    <!--id用于标识SQL，parameterType是传给SQL的参数的类型,resultType是返回结果的类型  -->
	<select id="getUserById" parameterType="int" resultType="work.pojo.User" >
	<!-- 使用#{}来传入参数 -->
		SELECT * FROM USER WHERE id = #{id}
	</select>
</mapper>

5.配置mybatis配置文件,这里命名为mybatis-config.xml。配置文件的意义是配置MyBatis的运行设置，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>
	<environments default="development">
		<!-- environment用来定义数据库连接环境，environments用来定义多个environment -->
		<environment id="development">
			<!-- transactionManager配置事务管理，使用jdbc事务管理 -->
			<transactionManager type="JDBC" />
			<!-- dataSource配置数据库连接池 -->
			<dataSource type="POOLED">
				<property name="driver" value="com.mysql.jdbc.Driver" />
				<property name="url" value="jdbc:mysql://localhost:3306/mybatis" />
				<property name="username" value="root" />
				<property name="password" value="123456" />
			</dataSource>
		</environment>
	</environments>
	<mappers>
		<!-- 导入映射文件，这样MyBatis才能管理到SQL语句 -->
		<mapper resource="work/pojo/user.xml"/>
	</mappers>
</configuration>

6.编写测试方法：

配置文件配完后，要想通过mybatis操作数据库，那么就需要使用SqlSessionFactoryBuilder、SqlSessionFactory和SqlSession几个对象。

  • SqlSessionFactoryBuilder：用来读取配置文件，得到一个SqlSessionFactory
  • SqlSessionFactory：SqlSessionFactory相当于连接池工厂，可以获得一个SqlSession对象
  • SqlSession：相当于JDBC的Connection对象，可以调用方法来操作数据表
@Test
	public void test1() throws IOException {
		// 创建SqlSessionFactoryBuilder对象
		SqlSessionFactoryBuilder sfb = new SqlSessionFactoryBuilder();
		// 通过Mybatis包的Resources类来将配置文件转成输入流
		InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
		// 加载配置文件输入流，创建SqlSessionFactory对象
		SqlSessionFactory	sqlSessionFactory = sfb.build(inputStream);
		// sqlSessionFactory创建SqlSession对象
		SqlSession sqlSession = sqlSessionFactory.openSession();
		// 执行查询，第一个参数是映射文件中定义的SQL的id名，第二个参数是传给SQL的参数。
		User user = sqlSession.selectOne("getUserById", 1);
		// 输出查询结果
		System.out.println(user);
		// 释放资源
		sqlSession.close();
	}

这里给一下文件结构、数据表数据和测试结果。

文件结构：

数据表数据：

测试结果：User [id=1, name=沙僧, age=18]


上面演示了MyBatis的使用，相信你对MyBatis已经有了一个初步的了解，下面将对各个部分的知识进行讲解。

1.核心组件【关于SqlSessionFactoryBuilder这些对象,以及了解Mybatis的运行流程】
2.mybatis配置文件的配置【关于数据库连接之类的配置】
3.映射文件的配置【关于SQL语句的定义方式】

Mybatis核心组件


四大核心组件

  • SqlSessionFactoryBuilder：负责根据配置文件来生成SqlSessionFactory
  • SqlSessionFactory：一个用来生成SqlSession的工厂（这个工厂由SqlSessionFactoryBuilder生成）
  • SqlSession：SqlSession是会话的意思，即与数据库的会话，相当于JDBC中的Connection。它是一个既可以既可以发送SQL去执行并返回结果，也可以获取Mapper的接口。
  • SQL Mapper：它是Mybatis新设计的组件，它由一个Java接口和一个配置文件（XML式或注解式的）组成，它可以获取配置文件中的SQL语句和映射关系，它也可以发生SQL去执行并返回结果。


SqlSessionFactoryBuilder

  • SqlSessionFactoryBuilder是一个基于建造者设计模式的接口，它可以根据配置去生成SqlSessionFactory
  • SqlSessionFactoryBuilder生成SqlSessionFactory依靠build方法，build可以传入多种参数（下面是其中三种方式），常见情况是传入一个配置文件的字节输入流对象。
    • build(InputStream inputStream)【传入一个配置文件的字节输入流对象】
    • build(Reader reader)【传入一个配置文件的字符输入流对象】
    • build(Reader reader, String environment)【传入一个配置文件的字符输入流对象，并根据指定的environment生成工厂，默认是使用environments中的默认值】
    • build(Configuration config)【传入一个Configuration 对象，这里不讲它怎么配置】

以传入一个配置文件的字节输入流对象为例，MyBatis提供了一个Resource类，它可以很方便地将配置文件转成输入流：

  • // 创建SqlSessionFactoryBuilder对象
SqlSessionFactoryBuilder sfb = new SqlSessionFactoryBuilder();
// 通过Resources类来将配置文件转成输入流，Resources是mybatis提供的
InputStream inputStream=Resources.getResourceAsStream("mybatis-config.xml");
// 加载配置文件输入流，创建SqlSessionFactory对象
SqlSessionFactory sqlSessionFactory = sfb.build(inputStream);

SqlSessionFactory

  • SqlSessionFactory是SqlSessionFactoryBuilder读取了配置文件之后生成的对象，它解析了配置文件的信息（mybatis的数据库连接信息、缓存信息、事务管理等等）。
  • SqlSessionFactory可以调用openSession方法来获取一个SqlSession，openSession方法是可以传入参数的，如果你传入一个布尔值那么将影响事务管理，为true时将自动提交，为false将默认不提交，默认为false，这时候需要你手动提交:sqlSession.commit();。
  • openSession除了可以传入布尔值，还可以传入其他类型的对象，这里不讲。
    // sqlSessionFactory创建SqlSession对象
    SqlSession sqlSession = sqlSessionFactory.openSession();
    //开启自动提交，默认增、删、改是不自动提交的
    //SqlSession sqlSession = sqlSessionFactory.openSession(true);

SqlSession

  • SqlSession的作用类似于JDBC中的Connection对象。

  • 作用：

    • 管理事务：SqlSession可以调用commit和rollback方法【要注意，MyBatis使用JDBC作为事务管理器时，事务是默认不自动提交的】
    • 提交SQL：SqlSession内置了selectOne、insert、update、delete等超过20种操作数据库的方法。
      • 调用的方法里面通常的第一个参数都是字符串，这个字符串是映射文件中的SQL语句的id,本质上是调用映射文件中的SQL语句。
    • 释放资源：SqlSession可以调用close方法来关闭连接资源。

  • 使用示例：

    SqlSession sqlSession = sqlSessionFactory.openSession();
    User user = new User();
    user.setName("铁头娃");
    user.setAge(4);
    //发送sql
    sqlSession.insert("insertUser", user);
    //提交事务
    sqlSession.commit();
    // 释放资源
    sqlSession.close();

SQL Mapper

  • SQL Mapper是mybatis新设计的一个组件，也是一种新的执行SQL的模式，在ibatis时代，主要使用sqlSession来进行查询，而有了SQL Mapper之后，只要遵循一种开发规范，那么就可以利用一个接口和一份映射文件

  • 如果这个接口遵循了Mapper的开发规范，并且有对应的映射文件，那么sqlSession调用getMapper方法可以获取一个mapper对象，mapper对象可以直接调用接口方法来执行映射文件中对应的SQL语句。

    • sqlSession.getMapper(某个接口.class);

  • Mapper的规范

    • 映射文件的namespace是接口的全限定名
    • 接口的方法名通常与映射文件的SQL id同名【使得Mapper的方法与SQL对应起来，这样调用方法就是调用对应的SQL】【还有各种各样的要求，由于这涉及两种开发方式，所以这将在后面讲】
    • 映射文件就是配置SQL语句的文件

  • 功能：

    • Mapper也可以发送SQL，调用Mapper接口中的方法就相当于sqlSession调用映射文件中的SQL。【这样的调用是完全面向对象的，现在普遍用这种。】

      • SqlSession sqlSession = sqlSessionFactory.openSession();
//发送sql
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.getUserById(1);
//User user = sqlSession.selectOne("getUserById", 1); //原方式
System.out.println(user);
// 释放资源
sqlSession.close();

核心组件的生命周期

  • SqlSessionFactoryBuilder的主要作用是创建SqlSessionFactory，一旦创建了 SqlSessionFactory 后，这个类就不需要存在了。通常只让它处在局部环境(本地方法变量)中。
  • SqlSessionFactory用于创建Session接口对象，所以SqlSessionFactory应该是长期有效的，但不应该重复创建，所以通常使用单例模式或静态单例模式来获取SqlSessionFactory对象。
  • SqlSession相当于一个连接对象，每次获取它，都是用来处理业务的，所以每个业务（线程）都应该有一个SqlSession对象，而它通常应该在业务结束后归还给SqlSessionFactory，SqlSession的范围为一个业务的请求范围。
  • Mapper是绑定了SQL的接口，在使用Mapper来操作的时候，很明显的--Mapper的生命周期与SqlSession有关。Mapper的生命周期最大可以与SqlSession等同，但如果把Mapper放到try-catch这样的语句或方法中，那么它的生命周期就会变小了。

总结

稍微了解了一下核心组件之后，再回头看一下之前的代码：

@Test
	public void test1() throws IOException {
		// 创建SqlSessionFactoryBuilder对象
		SqlSessionFactoryBuilder sfb = new SqlSessionFactoryBuilder();
		// 通过Mybatis包的Resources类来将配置文件转成输入流
		InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
		// 加载配置文件输入流，创建SqlSessionFactory对象
		SqlSessionFactory	sqlSessionFactory = sfb.build(inputStream);
		// sqlSessionFactory创建SqlSession对象
		SqlSession sqlSession = sqlSessionFactory.openSession();
		// 执行查询，第一个参数是映射文件中定义的SQL的id名，第二个参数是传给SQL的参数。
		User user = sqlSession.selectOne("getUserById", 1);
		// 输出查询结果
		System.out.println(user);
		// 释放资源
		sqlSession.close();
	}

映射文件的配置


我们现在先来了解一些映射文件的配置，也就是映射文件里面所谓的SQL语句之类的怎么写。这里了解了映射文件怎么配置之后，你可以先使用sqlSession来执行SQL体验一下其中的意义的。

    SqlSession sqlSession = sqlSessionFactory.openSession();
    User user = new User();
    user.setName("铁头娃");
    user.setAge(4);
    //发送sql
    sqlSession.insert("insertUser", user);
    //提交事务
    sqlSession.commit();
    // 释放资源
    sqlSession.close();

dtd约束：

映射文件需要dtd约束，在依赖包没有包含dtd的配置方法，只能从官方文档中获取，这里给一下。

<!DOCTYPE mapper
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd">

可配置标签：

基础结构，下面是一个大致的映射文件结构，在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="user">
	<select id="getUserById" parameterType="int" resultType="work.pojo.User" >
		SELECT * FROM USER WHERE id = #{id}
	</select>
</mapper>

mapper标签：

  • mapper标签中的属性namespace是命名空间的意思，它可以将定义的SQL语句区分到不同的命名空间上，就好像把类区分到不同的包中。命名空间可以解决SQL ID相同的问题，SQL ID唯一时，可以调用SQL ID来调用对应的SQL语句；不唯一时，应该使用命名空间.SQL ID。
  • mapper标签是映射文件的顶级标签，子标签有：
    • select：用于定义查询语句，可以自定义入参类型和返回的结果集类型。
    • insert：用于定义插入语句，可以自定义入参类型，返回结果是插入的记录数。
    • update：用于定义更新语句，可以自定义入参类型，返回结果是更新的记录数。
    • delete：用于定义删除语句，可以自定义入参类型，返回结果是删除的记录数。
    • sql：用来封装一部分经常出现的SQL，这样可以在别的地方进行引用，避免了老是重复。
    • resultMap：用来手动将数据库返回的结果与Java中的数据建立上关系，使用了resultMap的地方，会根据resultMap的规则来封装数据。
    • cache：给命名空间配置缓存。【配置缓存可以影响CRUD语句是否保留缓存值】
    • cache-ref：引用其他命名空间中的缓存配置。

select标签:

  • select标签用来定义查询类的SQL语句。

  • 属性：

    • id：与命名空间组合，用来唯一标识SQL语句。MyBatis可以根据id来调用对应的SQL语句。【要注意唯一性，唯一的时候，可以直接使用SQL ID；如果不是唯一，那么要使用命名空间.SQL ID 来调用对应的SQL语句。】
    • parameterType：用来定义传给SQL语句的参数的数据类型。可以是各种数据类型，也可以是POJO类对象（要求是类的全限定名），也可以给出别名（别名是指数据类型的别名或类的全限定名的别名，由于Mybatis提前定义了一堆别名，所以我们直接使用int的时候，相当于使用了java.lang.Integer）。
    • resultType：用来定义SQL语句返回结果的参数类型。可以是各种数据类型，也可以是POJO类（要求是类的全限定名），也可以给出别名（数据类型的别名或类的全限定名的别名）。【给出POJO类的时候，如果允许自动匹配，将自动根据映射关系自动将返回结果封装到对象中】。【resultType不能与resultMap一起用，他们的功能重复了】
    • resultMap：resultMap标签用来定义返回结果与类的映射关系，在select中使用resultMap属性时，可以将返回结果根据映射关系来赋值。【后面将具体介绍】

  • 示例：

    • <select id="getUserById" parameterType="int" resultType="user" >
	SELECT * FROM USER WHERE id = #{id1}
</select>

  • 使用问题：

    • 传参问题：
      • 可以使用#{参数名}来向SQL语句传递参数。

        • 对于基本数据类型，由于仅有一个参数（不像集合或类包含多个变量），参数名是可以随意取的。

          • <select id="getUserById" parameterType="int" resultType="work.pojo.User" >
		SELECT * FROM USER WHERE id = #{id1}
</select>

        • 对于对象类型，由于对象中有属性，所以要使用#{属性名}来把对象中的数据传递给SQL。如果对象的属性还是一个对象那么可以使用#{内含对象名.属性名}。

          • <!-- 由于传参是一样的用法，这里用insert作为例子,User中有属性name和age -->
<insert id="insertUser" parameterType="work.pojo.User" >
		INSERT INTO USER(name,age)
		VALUES 
		(#{name},#{age});
</insert>
      • 对于集合类的入参，这需要使用到动态SQL中的foreach标签,这个留到后面再讲。

  • 对于模糊查询，在传参的时候可能会有问题，你可能会思索%这个东西在哪里存：
    • 方式一：在函数调用方法并传参给SQL的时候，手动拼接；然后在SQL正常的使用#{参数名}来获取参数。
      • 代码中进行拼接：sqlSession.selectList("user.getUserByName","%唐%");，SQL中使用#{参数名}：SELECT * FROM USER WHERE name LIKE #{name};
    • 方式二：${参数名}可以用来字符串拼接，它可以在将字符串包裹的${参数名}转成对应的数据,但对于非POJO类型的参数名只能为value，对于POJO类型的就只能使用POJO类型的属性了。
      • SELECT * FROM USER WHERE name LIKE '%${value}%';
    • 方式三：调用SQL内置函数concat来拼接。【这个要注意数据库有没有这个函数】
      • SELECT * FROM USER WHERE name LIKE CONCAT('%',#{name},'%')

  • 返回结果问题：
    • 可以使用resultType和resultMap来定义返回结果，由于resultMap属性借助resultMap标签，resultMap留到resultMap标签再讲
    • resultType的值可以是各种数据类型，不过要符合数据的封装要求，比如返回多列数据时resultType不应该设置成int，resultType的值是什么要你自己去判断，只要你符合封装规则，那么就能封装成功。比如SELECT * FROM USER WHERE id = #{id}的返回值应该是一个User类。
    • 返回结果是多条记录的时候，返回结果类型也可以是POJO类，MyBatis会自动将返回结果转成POJO类的数组。

  • 映射规则问题：

    • 如果传入一个POJO类，默认是自动映射的，【如果属性名不一致，可以使用字段别名或者resultMap来进行强制映射】

      • 假设数据表中的字符名为username,但对象中的属性名为name，那么怎么对应上呢？

        <!-- SELECT id,username ,age FROM USER WHERE id = #{id}  --><!--由于字符名与属性名不完全相同，自动映射失败-->
<!-- 使用下面的语句，利用别名 -->
SELECT id,username as name ,age FROM USER WHERE id = #{id}

      • 使用resultMap,显式对应：property是类对象的属性名，column是字段名

        <resultMap type="work.pojo.User" id="userMap">
			<id property="id" column="id" />
			<!-- 手动把字段名与属性对应上 -->
			<result property="name" column="username" />
			<result property="age"  column="age"/>
</resultMap>

    • 多表时必须使用resultMap。因为没有自动跨表映射（除非你定义了返回结果是一个包含了多个表所有字段的类）。


resultMap

  • resultMap用来显式定义数据封装规则，resultMap把数据表的数据与对象的属性一一对应起来，如果SQL语句的返回结果类型使用了resultMap，这样MyBatis就会根据resultMap中的规则来封装返回的数据。

  • 属性

    • id：resultMap的id，有了id，就可以在其他标签的resultMap属性中引用了。
    • type：要建立映射关系的POJO类的全限定名。

  • id标签：用来定义主键的映射关系

    • property：对象的属性名，代表映射到对象的哪个属性中。
    • column：代表数据表中的列名。

  • result标签：用来定义普通字段的映射关系。

  • <!-- 定义resultMap -->	
<resultMap type="work.pojo.User" id="userMap">
    		<!--id标签把数据表中的id字段与User类中的id属性对应起来 -->
			<id property="id" column="id" />
			<result property="name" column="name" />
			<result property="age"  column="age"/>
</resultMap>
<!-- 引用resultMap -->
<select id="getUserById" parameterType="int"  resultMap="userMap">
		SELECT * FROM USER WHERE id = #{id1}
</select>

  • resultMap还与关联查询有关系，关联查询依靠resultMap来定义映射关系。这留到后面讲。


insert标签:

  • insert用来定义插入语句

  • 属性：

    • parameterType：定义传入的参数类型，使用可以参考select中的parameterType。
    • useGeneratedKeys：获取插入记录的主键（数据库自动生成的）
    • keyProperty：用来标识主键返回结果赋给哪个变量，复合主键时，使用逗号分隔变量名。【keyColumn】

  • 使用说明：增删改三种语句默认是不提交，要commit

  • <insert id="insertUser" parameterType="work.pojo.User" >
		INSERT INTO USER(name,age)
		VALUES 
		(#{name},#{age});
</insert>

  • 主键返回问题，有时候我们希望插入了一条记录后，获取到它的ID来处理其他业务，那么这时候我们怎么获取它的主键呢？下面列举两种方法：

JDBC式：在insert标签上配置useGeneratedKeys和keyProperty属性，useGeneratedKeys用来表明这个数据库是不是自增长id的，所以这个获取主键的方式不适用与Oracle。keyProperty用来指明返回的主键值存储到哪个属性中。

<insert id="save" parameterType="work.domain.User" useGeneratedKeys="true" keyProperty="userId" >
    insert into user(userName,password,comment)
    values(#{userName},#{password},#{comment})
</insert>

数据库式：利用数据库的函数来获取主键，keyProperty用来指明返回的主键值存储到哪个属性中。order用来指定执行的顺序，究竟是插入前获取--BEFORE，还是插入后获取--AFTER。resultType用来指明返回主键的数据类型。

    <insert id="save" parameterType="work.domain.User" >
       <selectKey resultType="java.lang.Long" order="AFTER" keyProperty="userId">
          SELECT LAST_INSERT_ID()
      </selectKey>
        insert into user(userName,password) values(#{userName},#{password})
    </insert>

update标签：

  • 属性与insert差不多

  • MyBatis由于是根据SQL去修改，所以它不会发生覆盖修改问题（Hibernate基于对象来查询，对于没有设置值的属性也会修改到数据表中，所以Hibernate中通常都是先查询后修改）

  • <update id="updateUser" parameterType="com.pojo.User">
		UPDATE USER SET username = #{username} WHERE id = #{id}
</update>

delete标签:

  • 属性与insert差不多

  • <delete id="deleteUser" parameterType="int">
		DELETE FROM user WHERE `id` = #{id1}
</delete>

sql标签：

  • sql标签可以用来定义一部分SQL语句，定义的部分SQL语句可以在别的地方引用。比如我们经常会用到列名，我们需要反复填写列名，如果我们将这一部分列名定义到sql标签中，我们就可以通过引用来使用了。
  <sql id="userCols">
  	    id,name,age
  </sql>
  <!-- 开始引用 -->
  <select id="getUserById" parameterType="int"  resultType="work.pojo.User">
  	    <!-- SELECT id,name,age FROM USER WHERE id = #{id1} -->
  	    SELECT <include refid="userCols"></include> FROM USER WHERE id = #{id1} 
  </select>

补充：

  • 由于cache和cache-ref涉及缓存问题，这将留到后面缓存部分再讲。

SQL发送


上面学过了映射文件里面定义SQL，那么下面来了解一下怎么使用这些SQL语句。发送SQL的方式有两种，一种是使用SqlSession来发送，一种是使用Mapper来发送。


使用SqlSession发送：


1.创建映射文件，这里假设为user.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="user">
	<select id="getUserById" parameterType="int" resultType="user" >
		SELECT id,name,age FROM USER WHERE id = #{id} 
	</select>
</mapper>

2.在配置文件中引入映射文件：【由于没有怎么讲mybatis配置文件，你可以先按照基础示例里面来修改】

<mappers>
		<!-- 导入映射文件 -->
		<mapper resource="work/pojo/user.xml"/>
</mappers>

3.获取SqlSession,并使用SqlSession调用对应的SQL:

	@Test
	public void test3() throws IOException {
		SqlSessionFactoryBuilder sfb=new SqlSessionFactoryBuilder();
		InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
		SqlSessionFactory sessionFactory = sfb.build(inputStream);
		SqlSession sqlSession = sessionFactory.openSession();
        //根据SQL ID来发送SQL，第二个是传给SQL的参数。
		User user = sqlSession.selectOne("user.getUserById",3);
		System.out.println(user);
		sqlSession.close();
	}

常用方法

  • selectOne("sql id")方法表示调用的是查询语句，并且返回的是一个对象【如果返回结果是多个，会报错。】
  • selectList("sql id")方法表示调用的是查询语句，并且返回的是一个列表。
  • insert("sql id")方法表示调用的是插入语句,对应映射文件中使用insert标签定义的SQL语句。
  • delete("sql id")方法表示调用的是删除语句,对应映射文件中使用delete标签定义的SQL语句。
  • update("sql id")方法表示调用的是修改语句,对应映射文件中使用update标签定义的SQL语句。

使用Mapper接口发送：动态代理开发


1.首先创建一个接口，

  • 接口名通常都是XXXMapper，如果是针对User类，可以是UserMapper
  • 接口名要求与映射文件名一致
  • 接口的方法名要求与映射文件的SQL id一致，
  • 接口的方法的形参必须要与对应SQL的parameterType类型一致，
  • 接口的返回类型必须与对应的SQL的resultType类型一致。
package work.pojo;

public interface UserMapper {
	public User getUserById(int id);
}

2.创建映射文件(这里假设为UserMapper.xml)，映射文件要求namespace必需是接口的全路径名：

<!-- namespace要写接口的全限定名 -->
<mapper namespace="work.pojo.UserMapper">
    <!--注意返回类型和入参类型要与接口的一致 -->
	<select id="getUserById" parameterType="int" resultType="work.pojo.User" >
		SELECT id,name,age FROM USER WHERE id = #{id}
	</select>
</mapper>

3.在配置文件中引入Mapper：

<mappers>
		<!-- 导入映射文件 -->
    	<!--既可以导入接口，也可以导入映射文件 -->
    	<!--<mapper resource="work/pojo/UserMapper.xml"/> -->
		<mapper class="work.pojo.UserMapper"/>
</mappers>

4.在代码中利用sqlSession获取接口的Mapper，并使用Mapper发送SQL（调用对应的接口方法就是发送对应SQL）：【这里提一下，虽然获取的是接口，但由于遵循了开发规范，Mybatis会帮忙创建一个这个接口的实现类，所以实质返回的是一个实现类对象】

	@Test
	public void test4() throws IOException {
		SqlSessionFactoryBuilder sfb=new SqlSessionFactoryBuilder();
		InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
		SqlSessionFactory sessionFactory = sfb.build(inputStream);
		SqlSession sqlSession = sessionFactory.openSession();
		//根据接口.class来获取mapper
		UserMapper mapper = sqlSession.getMapper(UserMapper.class);
     //调用接口的方法就是调用方法对应的SQL。
		User user = mapper.getUserById(3);
		System.out.println(user);
		sqlSession.close();
	}

Mapper说明：

  • 在UserMapper mapper = sqlSession.getMapper(UserMapper.class);传入一个UserMapper.class就可以获取一个能够调用方法的mapper,我们仅仅定义了UserMapper接口，为什么能获取一个能够获取一个能够调用方法的mapper呢？因为mybatis底层自动帮我们去创建这个接口的实现类了，由于我们遵循了设计规范，mybatis能够很容易地了解该如何去创建实现类。创建完实现类后，返回一个实现类的对象。

两种方式对比与DAO层开发问题

  • MyBatis通常用于数据访问层DAO的开发，对于使用SqlSession发送SQL的方式来说，它跟以往的开发一样，也需要定义DAO接口和实现方法；但对于使用Mapper发送SQL的方式来说，它跟以往的开发不同，它只需要定义接口了，而不再需要接口实现类了。

  • SqlSession方式：

  • Mapper方式：由于UserMapper接口已经包含原来的UserDao的功能了，并且不需要自定义实现类，所以这里可以省去DAO层。


两种方式比较： - 建议使用Mapper方式发送 - SqlSession发送是直接发送；Mapper方式是先通过SqlSession获取Mapper接口再发送。 - SqlSession方式是面向SQL的，Mapper方式是面向对象的。SqlSession发送SQL，需要一个SQL id 去匹配SQL。Mapper发送SQL只需要调用调用对应的方法，例如`mapper.getRole(1L)`。 - 使用Mapper方式发生SQL要调用对应的接口方法，接口方法能帮我们检查入参类型，参数类型不对时编译器会检错，而sqlsession.selectOne()只有在运行时才报错。

MyBatis配置文件


  • 上面谈完了一些“定义SQL和发送SQL”方面的内容，这节主要是讲解MyBatis配置文件的内容，配置文件是用来配置Mybatis的运行环境的，例如数据库驱动、url、用户名、密码、采用的事务管理方式等。
  • 配置文件的命名是可以随意的，通常可以命名为mybatis-config.xml

配置文件的约束

  • 配置文件的dtd约束配置信息并没有写在jar包中,所以我们不能从依赖包中查到，只能依靠官方文档来获取，下载的包中的mybatis-3.4.5.pdf中就有，在 Getting started中可以复制dtd约束。

    • <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd">

可配置标签：

标签的出现的顺序必须按照顺序。

<configuration><!-- configuration是配置文件的顶级标签  -->
	<!-- properties用于配置一些参数，这些参数可以被引用到下面的其他配置中，相当于properties文件 -->
	<properties></properties>
	<!-- setting用于配置一些mybatis底层相关的属性，比如缓存 -->
	<settings></settings>
	<!--typeAliases 用于配置类型命名 -->
	<typeAliases></typeAliases>
	<!-- typeHandlers用于配置类型处理器  -->
	<typeHandlers></typeHandlers>
	<!-- objectFactory用于配置对象工厂  -->
	<objectFactory type=""></objectFactory>
	<!--plugins用于配置插件 -->
	<plugins></plugins>
	<!-- environments配置不同的数据库连接环境 -->
	<environments default="">
		<environment id="">	<!--environment用于配置数据库连接环境  -->
			<!-- transactionManager用于配置事务管理器 -->
			<transactionManager type=""></transactionManager> 
			<!--dataSource用于配置数据源  -->
			<dataSource type=""></dataSource>
		</environment>
	</environments>
	<!-- databaseIdProvider是数据库产商标识 -->
	<databaseIdProvider type=""></databaseIdProvider>
	<!-- mappers用于配置映射器 -->
	<mappers></mappers>
</configuration>

上面的标签中，plugins涉及插件，是偏向底层的内容，如果不了解mybatis运行原理，那么可能会比较晦涩，这会留到另外一篇博文再讲述（如果有空的话）。【databaseIdProvider和objectFactory不讲述】
下面主要讲properties、settings、typeAliases、typerHandler、environments、mappers。



常用标签:

environments标签

  • environments用来配置多个数据库连接环境，每一个环境都使用environment标签来定义。（不同的环境可以定义不同的数据库连接信息）

    • 唯一属性--default：代表默认使用哪个环境，值为environment的id,这里的值影响SqlSessionFactoryBuilder调用build(配置文件输入流)时使用哪个环境初始化SqlSessionFactory。例如：<environments default="development">省略environment配置</environments>代表默认使用id="development"的环境。

  • environment标签:是environments的子标签，用来定义数据库连接环境，子标签有transactionManager（用来定义事务管理器，事务管理器负责定义这个数据库环境中的事务怎么处理）、dataSource（用来定义数据源，主要是配置数据库连接信息）。

    • 唯一属性——id:用来唯一标识每个环境。
    • 子标签transactionManager：用来定义事务管理器
      • 唯一属性：type:
        • JDBC：以JDBC的方式对数据库的提交和回滚进行操作。MyBatis中JDBC事务管理器的事务默认是不自动提交的，所以增删改操作需要sqlSession.comit()来进行事务提交。
        • MANAGED：把事务交给容器来管理，如JBOSS，Weblogic这样的容器。
      • transactionManager有子标签property，可以配置事务管理器的一些规则【这里不讲，有兴趣自查。】
      • 示例：<transactionManager type="JDBC" ></transactionManager>
    • 子标签dataSource：用来定义数据源
      • 唯一属性：type:
        • POOLED：数据库连接池的方式，配置这个值代表使用MyBatis自带的数据库连接池。
        • UNPOOLED：非数据库连接池的方式
        • JNDI：使用外部数据库连接源，tomcat数据源之类的外部数据库连接源
        • 第三方连接池【mybatis可以整合第三方连接池，但这需要创建新的类，所以留到后面再讲。】
      • 子标签property可以配置一些数据库连接的参数，除了基本的数据库driver、url、username、password，还可以根据type的不同值来配置一些不同参数，不同type里面的数据库驱动的定义方式可能也是不同的。
  <environments default="development">
  		<!-- environment用来定义数据库环境，environments用来定义多个environment -->
  		<environment id="development">
  			<!-- 配置事务管理，使用jdbc事务管理 -->
  			<transactionManager type="JDBC" />
  			<!-- 配置数据库连接池 -->
  			<dataSource type="POOLED">
  				<property name="driver" value="com.mysql.jdbc.Driver" />
  				<property name="url" value="jdbc:mysql://localhost:3306/mybatis2" />
  				<property name="username" value="root" />
  				<property name="password" value="123456" />
  			</dataSource>
  		</environment>
  </environments>

properties标签

  • properties标签的作用类似properties文件，properties标签可以导入properties配置文件，也可以直接使用子标签property来配置参数。properties标签中配置的参数可以在后面的其它属性配置中引用。

  • 使用方式：

    • 用properties标签导入配置文件：

      • <!-- 示例 -->
<properties resource="jdbc.properties"></properties>

        导入后，根据${键名}来引用配置文件中配置的参数，例如在配置数据源的时候：<property name="driver" value="${jdbc.driverClass}" />

    • 用properties标签定义property变量，定义后也可以使用${键名}来引用。

      • 设置参数：

        • <properties>
		<property name="db.driver" value="com.mysql.jdbc.Driver"/>
		<property name="db.url" value="jdbc:mysql://localhost:3306/mybatis2"/>
		<property name="db.user" value="root"/>
		<property name="db.password" value="123456"/>
	</properties>

  • 引用参数：

    •    <environment id="test">
   			<!-- 配置事务管理，使用jdbc事务管理 -->
   			<transactionManager type="JDBC" />
   			<!-- 配置数据库连接池 -->
   			<dataSource type="POOLED">
   				<property name="driver" value="${db.driver}" />
   				<property name="url" value="${db.url}" />
   				<property name="username" value="${db.user}" />
   				<property name="password" value="${db.password}" />
   			</dataSource>
   		</environment>

  • 为了分清楚配置的属性的作用，通常都会使用点分法来定义变量，如可以使用db.xxx代表这个配置与数据库相关。【当然，不使用点分法也可以】


Settings标签

  • Settings用于配置一些涉及MyBatis底层运行的参数（比如日志打印、自动映射、缓存管理），大部分情况下使用默认值。
  • 配置项以及配置项的值，可以参考这篇博文https://blog.csdn.net/u014231523/article/details/53056032,好像写的算靠谱了。

typeAliases标签

  • typeAliases通常用来别名，定义别名后，可以把很长的名字定义成一个较短的名字，例如类的全限定名（qualified name）很长时，可以用一个别名来代表这个类路径。

  • 别名可以使用在映射文件中，通常可以把类的全限定名定义成别名，这样就可以简写了。

  • 别名分为系统定义别名和自定义别名

    • 系统定义别名主要是一些数据类型别名，所以要注意定义sql的入参类型和结果类型，SQL语句的结果类型resultType定义成int的时候，返回的结果应该用Integer类型的变量存储

      别名 映射的类型
      _byte byte
      _long long
      _short short
      _int int
      _integer int
      _double double
      _float float
      _boolean boolean
      string String
      byte Byte
      long Long
      short Short
      int Integer
      integer Integer
      double Double
      float Float
      boolean Boolean
      date Date
      decimal BigDecimal
      bigdecimal BigDecimal

    • 自定义别名：

      • 可以使用typeAlias标签来定义别名：

        • <typeAliases>
		<!-- alias的值是别名，type的值是要定义别名的名字 -->
		<typeAlias type="work.pojo.User" alias="user"/>
</typeAliases>

      • 别名包扫描：

        • 由于别名很多时候都用在映射文件中（解决类全限定名过长问题），所以MyBatis支持对包进行别名扫描，扫描的包下的类都被定义成别名，别名就是类名
      • <typeAliases>
    <!-- 整个包下的类都被定义别名，别名为类名，不区分大小写-->
	    <package name="work.pojo"/>
    <!--这样pojo下的类都被定义成了别名，例如work.pojo.User可以简写成user -->
</typeAliases>

  • 别名是忽略大小写的，所以别名user，你既可以使用user来引用，也可以使用User来引用。



typeHandler标签：

  • typeHandler是用来处理类型转换问题的，从数据库中获取的数据要想装入到对象中，势必要经过类型转换，好比MyBatis必须知道如何将varchar转成String。对于常见的类型转换，MyBatis已经帮我们定义了不少类型转换器,下面给出常见的。

    • 数据库数据类型 Java类型 类型转换器
      CHAR, VARCHAR String StringTypeHandler
      BOOLEAN Boolean BooleanTypeHandler
      SMALLINT Short ShortTypeHandler
      INTEGER Integer IntegerTypeHandler
      FLOAT Float FloatTypeHandler
      DOUBLE Double DoubleTypeHandler

  • 由于MyBatis的转换器已经能够解决大部分问题了，所以这里不讲怎么自定义转换器，有兴趣的可以自查。



mappers标签

  • mappers是用来引入映射器（映射文件）的，有了映射器，Mybatis才能够管理到在映射文件中定义的SQL。

  • 引入方式：

    • 导入配置文件，通过配置文件的路径名导入：

      • <mappers>
		<!-- 第一种方式，根据映射文件路径-->
		<mapper resource="work/pojo/user.xml"/>
</mappers>

    • 使用mapper方式开发时，由于映射文件与mapper对应，也可以通过mapper的全限定名导入：

      • 【要求映射文件与mapper处于同一目录，而且映射文件的文件名与要mapper名一致】

        <mappers>
		<!-- 对下面的配置，要求映射配置文件的文件名为UserMapper.xml；要求UserMapper.xml与UserMapper处于同一目录下-->
		<mapper class="work.mapper.UserMapper"/> 
</mappers>

    • 使用mapper方式开发时，由于映射文件与mapper对应，也可以通过扫描mapper所在的包来导入：

      • 【要求映射文件与mapper处于同一目录，而且映射文件的文件名与要mapper名一致】

      • <mappers>
		<!-- 第三种方式，包扫描器：
			 1、映射文件与接口同一目录下
			 2、映射文件名必需与接口文件名称一致
		-->
		<package name="work.mapper"/>
</mappers>

补充：

  • plugin插件是一个比较大的内容，而且偏向底层，这会留到另外一篇博文再讲述。。
  • 除了上面的，还有databaseIdProvide数据库厂商标识，objectFactory对象工厂，但不常用。有兴趣的自查。

动态SQL

  • 当允许使用不定数量的条件来查询的时候（这种情况就是多条件查询的情况），入参无法确定是否已经正确填写，那么你可能遇到查询条件为空的情况。所以我们需要对查询条件进行判断，动态SQL就可以解决这种问题。

标签：

if标签

  • 单条件分支判断

  • 属性：

    • test：对条件进行判断，test里面可以是一个表达式。判断字符串时，允许字符串调用函数。

  • 下面的SQL语句，如果调用的时候不传参，将得到SELECT * FROM USER WHERE age = null;

    <select id="getUserByAge" parameterType="int" resultType="work.pojo.User">
		SELECT * FROM USER WHERE age = #{age};
</select>

  • 利用if标签解决问题：

    <select id="getUserByAge" parameterType="int" resultType="work.pojo.User">
		SELECT * FROM USER 
		<if test="age!=null ">
		WHERE  age = #{age}
		</if>
</select>

where标签

  • where主要用于处理多个判断条件的拼接。在where A条件 and B条件可能需要判断一下A和B的合法性，如果仅仅使用if标签那么可能会导致where、and字符串重复，而where会自动处理多余的and和where，还会自动加上where。

  • <select id="getUserByAgeOrName" parameterType="work.pojo.User" resultType="work.pojo.User">
		SELECT * FROM USER 
		<where>
			<if test="age!=null ">
				and age = #{age}
			</if>
			<if test="name!=null">
				and name like '%${name}%'
			</if>
		</where>
</select>

set标签：

  • where标签可以解决查询条件中的where问题，但如果对一个对象进行update时，如何判断传入的set值是否为空呢？可以使用if来进行判断，然后再使用set标签解决条件字符串重复问题，set标签可以去除多余的逗号。

  • <update id="updateUser" parameterType="work.pojo.User">
		UPDATE USER SET 
			name=#{name},
			age=#{age}
		where id=#{id}
</update>

  • <update id="updateUser" parameterType="work.pojo.User">
		UPDATE USER
		<set>
			<if test="name!=null">name=#{name},</if>
			<if test="age!=null">age=#{age}</if>
		</set>
			where id=#{id}
</update>

foreach标签

  • 当传入的参数是一个集合的时候，遇到的问题是怎么把集合中的数据遍历出来，foreach标签可以遍历集合。
  • 标签的属性：
    • collection：要遍历的集合【传入类型为List,那么集合名为list；传入的是数组，数组名为array】
    • item：用来迭代的变量
    • open：循环开始之前输出的内容
    • close：循环完成后输出的内容
    • seperator：分隔符
  <select id="getUserByAgeCollection" parameterType="List" resultType="work.pojo.User">
  		SELECT * FROM USER WHERE 
  		<foreach item="age" collection="list" open="age  IN("  separator=","  close=")">
  			#{age}
  		</foreach>
  	</select>

补充：

  • 除了上面的标签，还有例如trim,choose,when标签，由于上面的足够日常使用了，所以就不讲那么多了。其他的有兴趣可以自查了解一下。

关联查询


  • 在开发中，关联查询是非常常见的，关联查询就是在查询某个表时，通过字段关联关系，查出我们所需要的另外一个表中的数值。例如：通常来说，班级信息表和学生表是独立的，但班级信息表和学生表是有关系的，我们不能从班级信息表中获取到学生信息，如果我们查询班级信息表时希望同时获取到班级下的学生信息，那么我们就需要使用到关联查询。
  • 关联查询通常有一对一查询（关系类似于一个部门只有一个经理），一对多查询（关系类似于一个部分可以有多个员工），多对多查询（关系类似于一个学生可以选修多门课，一门课也可以被多名学生选修）。

一对一关联查询：

以一个部门对应一个经理为例。


方式一：

创建一个POJO类，用连接查询语句查询出两个表的数据，通过resultType封装到一个POJO类中。


步骤：
1.首先创建一个POJO类，要求包含了部门信息和经理信息（如果你不想重复定义属性，也可以选择继承单个类的信息继承两个类，这里考虑到有选择地查询字段所以不继承）：

package work.pojo;

public class Department_Manager {
	//部门的信息
	private Integer did;
	private String department_name;
	//经理的信息
	private Integer mid;
	private String name;
	private Double salary;
	public Integer getDid() {
		return did;
	}
	public void setDid(Integer did) {
		this.did = did;
	}
	public String getDepartment_name() {
		return department_name;
	}
	public void setDepartment_name(String department_name) {
		this.department_name = department_name;
	}
	public Integer getMid() {
		return mid;
	}
	public void setMid(Integer mid) {
		this.mid = mid;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public Double getSalary() {
		return salary;
	}
	public void setSalary(Double salary) {
		this.salary = salary;
	}
	@Override
	public String toString() {
		return "Department_Manager [did=" + did + ", 部门名=" + department_name + ", mid=" + mid + ", 经理名="+ name + ", 工资=" + salary + "]";
	}
}

数据表的创建(要注意，由于存在关系，那么两个表之间肯定有一个字段用于建立关联，在POJO类中可以没有这个字段，但表中一定要有，因为SQL语句依靠这个来查询)： 
use mybatis2;
create table department(
did int primary key auto_increment,
department_name varchar(20)
);
create table manager(
mid int primary key auto_increment,
name varchar(20),
salary double(7,2),
did int,
foreign key(did) references department(did) --这里用外键关联
);
insert into department values(null,'开发部'),(null,'市场部');
insert into manager values(null,'张三',20000.00,1),(null,'李四',20000.00,2);

2.编写SQL语句：【这里使用Mapper方式】

定义接口：

package work.pojo;

public interface UserMapper {
	public Department_Manager[] getDepartmentManager();
}

创建映射文件：

<?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="work.pojo.UserMapper">
	<select id="getDepartmentManager" resultType="work.pojo.Department_Manager" >
		SELECT
			 d.did,d.department_name,
			 m.mid,m.name,m.salary
		FROM department d
		LEFT JOIN manager m
		ON d.did = m.did
	</select>
</mapper>

3.编写测试方法：

  • @Test
	public void test5() throws IOException {
		SqlSessionFactoryBuilder sfb=new SqlSessionFactoryBuilder();
		InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
		SqlSessionFactory sessionFactory = sfb.build(inputStream);
		SqlSession sqlSession = sessionFactory.openSession();
		UserMapper mapper = sqlSession.getMapper(UserMapper.class);
		Department_Manager[] departmentManager = mapper.getDepartmentManager();
		for (Department_Manager department_Manager : departmentManager) {
			System.out.println(department_Manager);
		}
		sqlSession.close();
	}

所以第一种方式是把数据封装到一个包含了多个表的所有字段的POJO对象的方式。如果有多个表，有多种关系的话，第一种方式会显得麻烦复杂。

方式二：


创建一个在部门类里面添加一个经理类对象，用连接查询语句查询出两个表的数据，通过resultMap把查出来的数据封装到部门类中。
步骤：

1.创建经理类，创建部门类，在部门类中添加一个经理类对象。

经理类：

​```java
package work.pojo;
public class Manager {
private Integer mid;
private String name;
private Double salary;
private Integer did;
//did是部门表的主键，你可以不定义，因为关注点在部门,你也可以定义成一个部门对象。
public Integer getMid() {
return mid;
}
public void setMid(Integer mid) {
this.mid = mid;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public Double getSalary() {
return salary;
}
public void setSalary(Double salary) {
this.salary = salary;
}
public Integer getDid() {
return did;
}
public void setDid(Integer did) {
this.did = did;
}
@Override
public String toString() {
//由于没有给did封装数据，所以这里不打印did
return "Manager [mid=" + mid + ", name=" + name + ", salary=" + salary + "]";
}
}



部门类：

```java
package work.pojo;
public class Department {
	private Integer did;
	private String department_name;
	//经理的映像
	private Manager manager;
	public Integer getDid() {
		return did;
	}
	public void setDid(Integer did) {
		this.did = did;
	}
	public String getDepartment_name() {
		return department_name;
	}
	public void setDepartment_name(String department_name) {
		this.department_name = department_name;
	}
	public Manager getManager() {
		return manager;
	}
	public void setManager(Manager manager) {
		this.manager = manager;
	}
	@Override
	public String toString() {
		return "Department [did=" + did + ", department_name=" + department_name + ", manager=" + manager + "]";
	}
}

2.定义映射文件和接口：

定义接口：

package work.pojo;

public interface UserMapper {
	public Department_Manager[] getDepartmentManager2();
}

创建映射文件，使用resultMap定义多表关联映射规则：

<?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="work.pojo.UserMapper">
	<resultMap type="work.pojo.Department" id="department_manager">
			<id property="did" column="did" />
			<result property="department_name" column="department_name" />
        	<!--association用来处理对象中存在另一个类的对象的情况，
 			property是对象中另一个类的对象变量名，javaType是另一个类的全限定名
			标签里面使用id和result来映射数据与另一个类的对象的关系。
			-->
			<association property="manager" javaType="work.pojo.Manager">
				<id property="mid" column="mid"/>
				<result property="name" column="name" />
				<result property="salary" column="salary"/>
				<!-- 这里要注意不要封装外键字段，因为我们这里的经理表的外键是did，部门表主键是did，会命名冲突；由于这里没封装数据给经理类的did，所以经理类的did是没有数据的；如果你想给经理类的did赋值，那么你应该利用别名,在SQL中令m.did m_did，然后上面使用<result property="did"  column="m_did"/> -->
			</association>
	</resultMap>
    
	<select id="getDepartmentManager2"  resultMap="department_manager" >
		SELECT
			 d.did,d.department_name,
			 m.mid,m.name,m.salary
		FROM department d
		LEFT JOIN manager m
		ON d.did = m.did
	</select>
</mapper>

3.编写测试方法：

	@Test
	public void test6() throws IOException {
		SqlSessionFactoryBuilder sfb=new SqlSessionFactoryBuilder();
		InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
		SqlSessionFactory sessionFactory = sfb.build(inputStream);
		SqlSession sqlSession = sessionFactory.openSession();
		UserMapper mapper = sqlSession.getMapper(UserMapper.class);
		Department[] departments = mapper.getDepartmentManager2();
		for (Department department : departments) {
			System.out.println(department);
		}
		sqlSession.close();
	}


一对多关联查询：

如果采用类似上面一对一的方式一来处理一对多话，一一方的会出现很多次（方式一是封装查询的每行记录，一对多查询的时候一一方的数据会出现多次，所以采用方式二来实现一对多）。下面以一个班级可以有多个学生为例。

步骤：

1.创建Student类，创建Grade类，在Grade中添加一个由Student对象组成的List：

Student类：

package work.pojo;

public class Student {
	private Integer sid;
	private String stu_name;
	public Integer getSid() {
		return sid;
	}
	public void setSid(Integer sid) {
		this.sid = sid;
	}
	public String getStu_name() {
		return stu_name;
	}
	public void setStu_name(String stu_name) {
		this.stu_name = stu_name;
	}
	@Override
	public String toString() {
		return "Student [sid=" + sid + ", stu_name=" + stu_name + "]";
	}
}

Grade类：

package work.pojo;

import java.util.List;

public class Grade {
	private Integer gid;
	private String grade_name;
	private List<Student> students;
	public Integer getGid() {
		return gid;
	}
	public void setGid(Integer gid) {
		this.gid = gid;
	}
	public String getGrade_name() {
		return grade_name;
	}
	public void setGrade_name(String grade_name) {
		this.grade_name = grade_name;
	}
	public List<Student> getStudents() {
		return students;
	}
	public void setStudents(List<Student> students) {
		this.students = students;
	}
	@Override
	public String toString() {
		return "Grade [gid=" + gid + ", grade_name=" + grade_name + ", students=" + students + "]";
	}
}

2.创建数据表，插入测试数据：

create table grade(
gid int primary key auto_increment,
grade_name varchar(20)
);
create table student(
sid int primary key auto_increment,
stu_name varchar(20),
gid int,
foreign key(gid) references grade(gid) 
);
insert into grade values(null,"python班"),(null,'Java班');
insert into student values(null,'张三',1),(null,'李四',1),(null,'王五',2),(null,'赵六',2);

3.创建mapper接口和映射文件：

接口：

package work.pojo;
public interface UserMapper {
	public Grade[] getGradeStudent();
}

映射文件：

<?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="work.pojo.UserMapper">
	<resultMap type="work.pojo.Grade" id="grade_student_map">
		<id property="gid" column="gid"/>
		<result property="grade_name" column="grade_name"/>
		<!-- collection用来处理一个类中含有其他类的集合时的数据映射（一对多）
			property是集合的变量名，ofType是集合元素的全限定名，
			collection内使用id和result建立映射关系
		  -->
		<collection property="students" ofType="work.pojo.Student" >
			<id property="sid" column="sid"/>
			<result property="stu_name" column="stu_name" />
		</collection>
	</resultMap>
    
	<select id="getGradeStudent" resultMap="grade_student_map">
			SELECT
				 g.gid,g.grade_name,
				 s.sid,s.stu_name
			FROM grade g
			LEFT JOIN student s
			ON g.gid = s.gid
	</select>
</mapper>

4.编写测试方法：

	@Test
	public void test7() throws IOException {
		SqlSessionFactoryBuilder sfb=new SqlSessionFactoryBuilder();
		InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
		SqlSessionFactory sessionFactory = sfb.build(inputStream);
		SqlSession sqlSession = sessionFactory.openSession();
		UserMapper mapper = sqlSession.getMapper(UserMapper.class);
		Grade[] gradeStudent = mapper.getGradeStudent();
		for (Grade grade : gradeStudent) {
			System.out.println(grade);
		}
		sqlSession.close();
	}


多对多：

由于多对多太过复杂，Mybatis不支持多对多，Mybatis选择使用两个一对多来实现多对多。下面以一名学生可以选多门课，一门课可以被多个学生选为例。【多对多关系模型是两方都有对方的数据，两方都能查询到对方的数据，所以我们使用一对多的时候，能向两方的对象中都装入数据，就可以达到多对多的效果；但有一点效果不能达到，（以例子讲解）课程对象中的学生集合没有与课程对象建立上关系，但从业务需求来说通常不关注另外一方的关系（如果关注，从学生一方查询即可，为什么要使用课程中的学生对象？），所以这个缺点也不算缺点。另外，下面也会讲一下解决这个问题的方法。】

步骤：

1.创建Cource类，创建SchoolChild类，分别在两个类中创建对方类的集合：【这里要注意toString问题，如果A的toString包含B，B包含A，那么会死循环。】

Cource类：

package work.pojo;

import java.util.List;

public class Cource {
	private Integer cid;
	private String cource_name;
	private List<SchoolChild> schoolchilds;
	public Integer getCid() {
		return cid;
	}
	public void setCid(Integer cid) {
		this.cid = cid;
	}
	public String getCource_name() {
		return cource_name;
	}
	public void setCource_name(String cource_name) {
		this.cource_name = cource_name;
	}
	public List<SchoolChild> getSchoolchilds() {
		return schoolchilds;
	}
	public void setSchoolchilds(List<SchoolChild> schoolchilds) {
		this.schoolchilds = schoolchilds;
	}
}

SchoolChild类：

package work.pojo;

import java.util.List;

public class SchoolChild {
	private Integer sid;
	private String stu_name;
	private List<Cource> cources;
	public Integer getSid() {
		return sid;
	}
	public void setSid(Integer sid) {
		this.sid = sid;
	}
	public String getStu_name() {
		return stu_name;
	}
	public void setStu_name(String stu_name) {
		this.stu_name = stu_name;
	}
	public List<Cource> getCources() {
		return cources;
	}
	public void setCources(List<Cource> cources) {
		this.cources = cources;
	}
}

2.创建表（注意有中间表）：

create table cource(
cid int primary key auto_increment,
cource_name varchar(20)

);
create table schoolChild(
sid int primary key auto_increment,
stu_name varchar(20)
);
create table cource_schoolChild(
cid int, 
sid int,
foreign key(cid) references cource(cid),
foreign key(sid) references schoolChild(sid)
);
insert into cource values(null,"python"),(null,'Java');
insert into schoolChild values(null,'张三'),(null,'李四'),(null,'王五');
insert into cource_schoolChild values(1,1),(1,2),(1,3),(2,1),(2,3);

3.创建接口和映射文件：

接口：

package work.pojo;

public interface UserMapper {
	public Cource[] getCource();
	public SchoolChild[] getSchoolChild();
}

映射文件：【难点是sql语句，其他的resultMap与一对多的一样】

<?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="work.pojo.UserMapper">
	<resultMap type="work.pojo.Cource" id="cource_schoolchild_map">
			<id property="cid" column="cid" />
			<result property="cource_name" column="cource_name" />
			<collection property="schoolchilds" ofType="work.pojo.SchoolChild">
				<id property="sid" column="sid" />
				<result  property="stu_name" column="stu_name" />
			</collection>
	</resultMap>
	<select id="getCource" resultMap="cource_schoolchild_map">
		select 
			t1.cid,t1.cource_name,
			t3.sid,t3.stu_name
		from cource t1 left join cource_schoolChild t2 on t1.cid=t2.cid left join schoolChild t3 on t2.sid=t3.sid;
	</select>
    
	<resultMap type="work.pojo.SchoolChild" id="schoolchild_cource_map">
			<id property="sid" column="sid" />
			<result property="stu_name" column="stu_name" />
			<collection property="cources" ofType="work.pojo.Cource">
				<id property="cid" column="cid" />
				<result  property="cource_name" column="cource_name" />
			</collection>
	</resultMap>
	<select id="getSchoolChild" resultMap="schoolchild_cource_map">
		select 
			t1.cid,t1.cource_name,
			t3.sid,t3.stu_name
		from cource t1 left join cource_schoolChild t2 on t1.cid=t2.cid left join schoolChild t3 on t2.sid=t3.sid;
	</select>
	
</mapper>

4.编写测试方法：

	@Test
	public void test8() throws IOException {
		SqlSessionFactoryBuilder sfb=new SqlSessionFactoryBuilder();
		InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
		SqlSessionFactory sessionFactory = sfb.build(inputStream);
		SqlSession sqlSession = sessionFactory.openSession();
		UserMapper mapper = sqlSession.getMapper(UserMapper.class);
		Cource[] cources = mapper.getCource();
		for (Cource cource : cources) {
			System.out.println(cource);
		}
		System.out.println("---分隔线---");
		SchoolChild[] schoolChilds = mapper.getSchoolChild();
		for (SchoolChild schoolChild : schoolChilds) {
			System.out.println(schoolChild);
		}

5.测试结果：

Cource [cid=1, cource_name=python, schoolchilds=[SchoolChild [sid=1, stu_name=张三, cources=null], SchoolChild [sid=2, stu_name=李四, cources=null], SchoolChild [sid=3, stu_name=王五, cources=null]]]
Cource [cid=2, cource_name=Java, schoolchilds=[SchoolChild [sid=1, stu_name=张三, cources=null], SchoolChild [sid=3, stu_name=王五, cources=null]]]
---分隔线---
SchoolChild [sid=1, stu_name=张三, cources=[Cource [cid=1, cource_name=python, schoolchilds=null], Cource [cid=2, cource_name=Java, schoolchilds=null]]]
SchoolChild [sid=2, stu_name=李四, cources=[Cource [cid=1, cource_name=python, schoolchilds=null]]]
SchoolChild [sid=3, stu_name=王五, cources=[Cource [cid=1, cource_name=python, schoolchilds=null], Cource [cid=2, cource_name=Java, schoolchilds=null]]]

使用说明：

  • 在上面的测试结果中，课程对象中查出的学生对象的课程对象是null，这是因为没有封装上，下面可以提供一种方法来解决上面这个问题，但要注意--这个问题是解决不了的：这是因为MyBatis是面向SQL的，你定义了映射规则它才能帮你封装，MyBatis对于对象与对象中嵌套对象的关系并不了解，它不知道怎么做，只有你进行了封装定义才能够给嵌套对象封装数据。如果你在resultMap的collection中嵌套一个collection就可以对嵌套对象中的嵌套对象封装数据，但嵌套对象中的嵌套对象的嵌套对象里的对象还是会空的。

    • <?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="work.pojo.UserMapper">
	<resultMap type="work.pojo.Cource" id="cource_schoolchild_map">
			<id property="cid" column="cid" />
			<result property="cource_name" column="cource_name" />
			<collection property="schoolchilds" ofType="work.pojo.SchoolChild">
				<id property="sid" column="sid" />
				<result  property="stu_name" column="stu_name" />
                <!-- 给嵌套对象里面的嵌套对象封装数据 -->
				<collection property="cources" ofType="work.pojo.Cource">
					<id property="cid" column="cid" />
				<result  property="cource_name" column="cource_name" />
			</collection>
			</collection>
	</resultMap>
	<select id="getCource" resultMap="cource_schoolchild_map">
		select 
			t1.cid,t1.cource_name,
			t3.sid,t3.stu_name
		from cource t1 left join cource_schoolChild t2 on t1.cid=t2.cid left join schoolChild t3 on t2.sid=t3.sid;
	</select>
	<!-- 省略SchoolChild的。 -->
</mapper>

关联对象的插入问题

  • 如果你学过一些其他的ORM框架，你可能会有点迷糊有关联关系的对象怎么插入到数据表。这里提一下，MyBatis是面向SQL的，上面的一对多查询本质上都是面向对象的，association和collection主要作用于Java对象，而不作用于数据库，association和collection只是定义了返回的数据的封装规则，从本质来看，SQL操作还是join操作。
  • 所以，明白了MyBatis是面向SQL的之后，那么怎么插入有关联关系的对象数据呢？像直接操作SQL那样，插入记录即可。一对多的，通常都是多一方维护外键，那么直接在多一方的表插入带外键的记录即可，插入的时候获取一下关联对象的主键作为外键值；多对多的，直接在中间表插入记录，插入的时候获取一下关联对象的主键作为中间表的外键值。
<mapper namespace="work.mapper.ProductMapper">
	<resultMap type="work.domain.Product" id="product_category">
		<id property="pid" column="pid"/>
		<result property="pname" column="pname"/>
		<result property="price" column="price"/>
		<result property="pimage" column="pimage"/>
		<result property="pdesc" column="pdesc"/>
		<!-- 这里是多表查询操作，这里商品里面有一个商品分类外键 -->
		<association property="category" javaType="work.domain.Category">
			<result property="category_name" column="category_name"/>
		</association>
	</resultMap>
	<select id="findAll" resultMap="product_category">
		select 
			p.pid,p.pname,p.price,p.pimage,p.pdesc,
			c.cid,c.category_name
		 from product p left join category c on p.cid = c.cid;
	</select>
	
	<insert id="save" parameterType="work.domain.Product">
		insert into product(pname,price,pimage,pdesc,cid) values(
		#{pname},#{price},#{pimage},#{pdesc},#{category.cid}
		);
	</insert>
</mapper>

补充：

  • 不论一对一、一对多、多对多，都是两种方式，但其实还有一种方式。建立独立的查询语句（关系模型中的每个对象都有），通过在resultMap中配置，进行某个对象查询的时候，调用查询另一个对象的SQL来传入指定参数并封装结果。【有兴趣的自查。】

缓存

  • 一级缓存存放在sqlSession上，默认开启。
  • 二级缓存存放在SqlSessionFactory上
  • 缓存的意义：
    • 一级缓存在sqlSession上，重复查询时，不会重复发送SQL，会从缓存中获取之前查询到的数据。
    • 二级缓存是SqlSessionFactory层次上的缓存，它是面向命名空间，同一个命名空间（不同的SqlSession可以使用同一个命名空间下的SQL）中使用重复的查询时，不会重复发送SQL，会从缓存中获取之前查询到的数据。【二级缓存默认是不开启的，而且涉及序列化内容，这里不讲。】

测试一级缓存的存在性：

  • 一级缓存是默认开启的。
  • 尝试重复查询，如果仅仅发送一次SQL语句。那么就可以得出一级缓存是存在的【mybatis的运行信息输出依赖log4j,所以要给一个log4j的配置文件】。
		@Test
		public void test9() throws IOException {
			SqlSessionFactoryBuilder sfb=new SqlSessionFactoryBuilder();
			InputStream inputStream = Resources.getResourceAsStream("mybatis-config.xml");
			SqlSessionFactory sessionFactory = sfb.build(inputStream);
			SqlSession sqlSession = sessionFactory.openSession();
			//根据接口.class来获取mapper
			UserMapper mapper = sqlSession.getMapper(UserMapper.class);
			User user = mapper.getUserById(3);
			User user2 = mapper.getUserById(3);
			System.out.println(user);
			System.out.println(user==user2);
			sqlSession.close();
		}

缓存的配置

在select\delete\insert标签 中，有一个flushCache属性：设置查询之后是否删除本地缓存和二级缓存。


补充：

  • 还可以自定义缓存，然后在映射文件中使用cache引入，其他映射文件再想引入时，可以直接使用cache-ref。通常采用Redis这类数据库来进行缓存。

mybatis整合第三方连接池


整合第三方连接池，当然要引入依赖包啦。这里就不多讲了,就是第三方连接池的依赖包。


首先需要定义一个数据源工厂，这个工厂要继承UnpooledDataSourceFactory，在构造函数中返回需要使用的连接池对象

package work.dataSource;

import org.apache.ibatis.datasource.unpooled.UnpooledDataSourceFactory;
import com.mchange.v2.c3p0.ComboPooledDataSource;

public class C3P0DataSourceFactory extends UnpooledDataSourceFactory {
    public C3P0DataSourceFactory(){
        this.dataSource=new ComboPooledDataSource();
    }
}

然后在mybatis-config.xml中配置使用第三方连接池：

 <!-- type里填刚才定义的连接池工厂的全限定名 -->
<dataSource type="work.dataSource.C3P0DataSourceFactory">
				<!-- 下面的属性名要按照连接池自身的规则来配置，比如c3p0的驱动参数是driverClass -->
				<property name="driverClass" value="com.mysql.jdbc.Driver" />
				<property name="jdbcUrl" value="jdbc:mysql://localhost:3306/mybatis2" />
				<property name="user" value="root" />
				<property name="password" value="123456" />
		        <property name="idleConnectionTestPeriod" value="60" />
		        <property name="maxPoolSize" value="20" />
		        <property name="maxIdleTime" value="600" />
</dataSource>

补充：

  • 上面的演示采用的是c3p0的，dbcp的也一样。
  • 除此之外，还有一种实现DataSourceFactory接口来整合连接池的方式，里面有个setProperties可以把mybatis-config.xml的连接池配置封装到形参properties中，然后在getDataSource利用properties来新建目标连接池对象，返回的时候返回连接池对象；然后也需要在mybatis-config.xml中像上面一样配置。【原本也想写一下这个方式的，但不知道为什么dataSource.setProperties(properties)的时候无法获取到properties中的数据，打印过发现properties中是有数据的。】

写在最后


现在没有写的内容：

  • mybatis的运行原理
  • 插件
    • 分页插件
  • 存储过程
  • 延迟加载

不写，有兴趣自查的内容：

  • 注解式mybatis：由于mybatis使用注解来配置有几点非常不方便的地方，一般都会使用XML来配置。
  • 二级缓存,自定义缓存。
posted @ 2018-10-31 19:46  随风行云  阅读(983)  评论(0)  编辑  收藏  举报