Mybatis框架学习

什么是mybatis？

mybatis是一款用于持久层的、轻量级的半自动化ORM框架，封装了所有jdbc操作以及设置查询参数和获取结果集的操作，支持自定义sql、存储过程和高级映射

mybatis用来干什么？

用于处理java和数据库的交互

使用mybatis的好处

1. 与JDBC相比，减少了50%以上的代码量。
2. MyBatis灵活，不会对应用程序或者数据库的现有设计强加任何影响，SQL可以写在XML里（还可以以注解方式写到Java代码中），从程序代码中彻底分离，降低耦合度，便于统一管理和优化，可重用。
3. 提供XML标签，支持编写动态SQL语句（XML中使用 if, else 等）

使用mybatis

下载Mybatis的jar包：Releases · mybatis/mybatis-3 (github.com)

创建xml文件：mybatis-config.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""https://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration><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="org/mybatis/example/BlogMapper.xml"/></mappers>
</configuration>

修改内容：

SqlSessionFactoryBuilder

通过SqlSessionFactoryBuilder可创建多个SqlSessionFactory实例

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("mybatis-config.xml"));

SqlSessionFactory

通过SqlSessionFactory创建多个会话，SqlSession对象，每个会话就相当于我不同的地方登陆一个账号去访问数据库。

一般SqlSessionFactory只需要创建一次

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("mybatis-config.xml"));

SqlSession

使用 MyBatis 的主要 Java 接口就是 SqlSession。你可以通过这个接口来执行命令，获取映射器实例和管理事务。SqlSession实例可直接执行已映射的sql语句。

确保SqlSession关闭的标准模式：

//try-with-resource
try(SqlSession session = sqlSessionFactory.openSession()) {}

XML映射语句

基于XML映射语句，便可满足sqlsession的调用

例如简单的select语句

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="TestMapper"><select id="selectEmployee" resultType="com.test.entity.Employee">select * from employee where id = #{id}</select>
</mapper>

参数符号：#{id}，这就告诉 MyBatis 创建一个预处理语句（PreparedStatement）参数，在 JDBC 中，这样的一个参数在 SQL 中会由一个?来标识，并被传递到一个新的预处理语句中.

MybatisUtil工具类

创建MybatisUtil工具类，以便集中创建SqlSession

public class MybatisUtil {private static SqlSessionFactory sqlSessionFactory;static {try {sqlSessionFactory = new SqlSessionFactoryBuilder().build(new FileInputStream("mybatis-config.xml"));} catch (FileNotFoundException e) {e.printStackTrace();}}/*** 获取一个新的会话* @param autoCommit 是否开启自动提交（跟JDBC是一样的，如果不自动提交，则会变成事务操作）* @return SqlSession对象*/public static SqlSession getSession(boolean autoCommit){return sqlSessionFactory.openSession(autoCommit);}
}

方便使用：

public class Main {public static void main(String[] args) throws FileNotFoundException {try(SqlSession session = MybatisUtil.getSession(true)) {TestMapper mapper = session.getMapper(TestMapper.class);}}
}

映射器接口

映射器是一些用来绑定映射语句的接口。创建com.test.mapper包，创建接口TestMapper。

这样做好处是将映射器的结果快速转换为需要的实体类，通过XML中的namespace绑定接口

• 全限定名（比如 “com.test.mapper.TestMapper"）将被直接用于查找及使用。

<mapper namespace="com.test.mapper.TestMapper"><select id="selectEmployee" resultType="com.test.entity.Employee">select * from employee</select>
</mapper>

将接口与XML放在同包资源中，修改mybatis-config.xml文件

    <mappers><mapper resource="com/test/mapper/TestMapper.xml"/></mappers>

XML配置属性typeAliases

typeAliases，类型别名，简化Mapper的缩写

<configuration><typeAliases><typeAlias type="com.test.entity.Employee" alias="Employee"/></typeAliases><environments default="development">........

或直接扫描包，默认别名为小写的开头

    <typeAliases><package name="com.test.entity"/></typeAliases>

也可写注解来指定别名

@Alias("employee")
public class Employee {...
}

ResultMap

当类中定义的字段与数据库的字段不统一时，用ResultMap来映射到对应的实体

column：数据库中的字段，property：java中编写的字段名称

<mapper namespace="com.test.mapper.TestMapper"><resultMap id="Test" type="Employee"><result column="id" property="xxx"/></resultMap><select id="selectEmployee" resultMap="Test">....

多个构造器如何选择

当有多个构造器，优先选择满足全部字段的构造器，如果没有则报错

如果只有一个构造器，不管满足几个字段，都会调用

那如果就是没有满足的呢？那就要用constructor

<mapper namespace="com.test.mapper.TestMapper"><resultMap id="Test" type="Employee"><constructor><arg column="id" javaType="Integer"/><arg column="name" javaType="String"/></constructor><result column="id" property="xxx"/></resultMap>.......

注意：这样写的话，构造器中形参需要对象类型，比如如果用int不用Interger，会报错：

另外，这样写的话构造器中的字段并不会映射到，因为映射器已经交给构造器来处理了。

bug：绑定错误

Exception in thread “main” org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)

解决：select中id与接口绑定错误，记得要一致

增删改查

创建接口实例

TestMapper mapper = session.getMapper(TestMapper.class);

TestMapper.xml中编写sql语句

<mapper namespace="com.test.mapper.TestMapper"><select id="getEmployeeId" resultType="Employee">select * from employee where id = #{id}</select><insert id="addEmployee" parameterType="Employee">insert into employee (id, name, sex, age, salary) values (#{id}, #{name}, #{sex}, #{age}, #{salary})</insert><delete id="deleteEmployee">delete from employee where id = #{id}</delete>
</mapper>

通过接口实例直接调用接口中的方法

update操作

mapper:

<update id="updateStudent" parameterType="student">update student set sex = #{sex} where sid = #{sid}
</update>

mapper接口：

int updateStudent(Student student);

测试：

Student student = mapper.getStudentSid(1940618805);
student.setSex("女");
mapper.updateStudent(student);

复杂查询

多表查询一对多：例如查询一个老师教多少个学生

collection：用于一对多关系，即实体里面放集合

<resultMap id="asTeacher" type="Teacher"><id column="tid" property="tid"/><result column="tname" property="name"/><collection property="studentList" ofType="Student"><id property="sid" column="sid"/><result column="name" property="name"/><result column="sex" property="sex"/></collection>
</resultMap>  <select id="getTeacherByTid" resultMap="asTeacher">select *, teacher.name as tname from student inner join teach on student.sid = teach.sidinner join teacher on teacher.tid where teach.tid = #{tid}</select>

<id column="tid" property="tid"/>

id用于唯一标识一个老师

多表查询多对一：如果要求学生类增加一个老师属性，即根据教师id来找教师的所有学生

association：用于多对一关系

    <resultMap id="test2" type="Student"><id column="sid" property="sid"/><result column="name" property="name"/><result column="sex" property="sex"/><association property="teacher" javaType="Teacher"><id column="tid" property="tid"/><result column="tname" property="name"/></association></resultMap><select id="selectStudent" resultMap="test2">select *, teacher.name as tname from student left join teach on student.sid = teach.sidleft join teacher on teach.tid = teacher.tid where teach.tid = #{tid}</select>

事务处理

自动提交关闭：

SqlSession session = MybatisUtil.getSession(false)

手动提交

session.commit();

动态SQL

if

test 为if的条件，如果为真，则拼接if标签里面的and语句，如查询学号是偶数的男同学

    <select id="getStudentSid" resultType="student">select * from student where sid = #{sid}<if test="sid % 2 == 0">and sex = '男'</if></select>

choose，when，otherwise

类似于switch，case，default

<select><choose><when test = "">and...</when><when test = "">and...</when><otherwise>and...</otherwise></choose>
</select>

where

where元素只会在有子元素有返回的情况下才会插入where，并且如果子元素的开头是and，or，（显然sql语句中 where and…是语法错误的吧），where元素会将他们去除

        select * from student<where><if test="sid != null">
<!--                and sid = #{sid}-->sid = #{sid}</if></where>

set

    <update id="updateStudent">update student<set><if test="name != null">name = #{name}</if></set>where sid = #{sid}</update>

缓存机制

查询出的对象存入SqlSession的一级缓存，如果后续有相同操作，则之间从缓存中获取，不需要重新构造一个对象，提高效率

Student student = mapper.getStudentSid(1940618805);
Student student1 = mapper.getStudentSid(1940618805);
System.out.println(student1 == student); // true

但是，如果在该两次相同的操作中，对数据库内容进行了增，删，改操作，则会清除缓存

并且，每一个SqlSession会话的一级缓存是分开来的。即在不同的会话下，上述操作得到的不是同一个对象

一级缓存也叫做本地缓存，它只对一个会话的数据进行缓存。

要使用全局的缓存，是需要开启二级缓存。只需要在mapper文件中加上

<cache/>

<cacheeviction="FIFO"flushInterval="60000"size="512"readOnly="true"/>

这个更高级的配置创建了一个 FIFO 缓存，每隔 60 秒刷新，最多可以存储结果对象或列表的 512 个引用，而且返回的对象被认为是只读的，因此对它们进行修改可能会在不同线程中的调用者产生冲突。

开启二级缓存后，不同会话中连续的相同操作也会直接从缓存中获取对象。（同样的，如果在这两次操作之间对数据库内容进行了增，删，改操作，则会清除缓存）

但是，多个会话时，只有当一个会话结束了才会将数据从一级缓存写入二级缓存：

public class Main {public static void main(String[] args) throws FileNotFoundException {try(SqlSession session1 = MybatisUtil.getSession(true);SqlSession session2 = MybatisUtil.getSession(true)) {TestMapper mapper1 = session1.getMapper(TestMapper.class);TestMapper mapper2 = session2.getMapper(TestMapper.class);Student student1 = mapper1.getStudentSid(1940618806);Student student2 = mapper2.getStudentSid(1940618806);System.out.println(student1 == student2); // false 获取对象时会话未结束，二级缓存没有内容}}
}

注解开发

去除mapper xml文件，直接在mapper接口方法上写上注解

@Insert("insert into student(sid, name, sex) values(#{sid}, #{name}, #{sex})")
int addStudent(Student student);

使用注解开发需要修改mybatis配置文件的mappers

    <mappers><mapper class="com.test.mapper.TestMapper"/>
<!--        <package name="com.test.mapper"/>--></mappers>

自定义映射规则

@Results

    @Results({@Result(id = true, column = "sid", property = "sid"),@Result(column = "name", property = "name"),@Result(column = "sex", property = "sex")})@Select("select * from student where sid = #{sid}")Student getStudentSid(int sid);

一对多查询，如一个教师教的学生

@Many(select="")

这个就是一对多关系中联结查询的条件

    @Results(value = {@Result(column = "tid", property = "tid"),@Result(column = "name", property = "name"),@Result(column = "tid", property = "studentList", many =@Many(select = "getStudentByTid"))})@Select("select * from teacher where tid = #{tid}")Teacher getTeacherByTid(int tid);@Select("select * from student inner join teach on student.sid = teach.sid where tid = #{tid}")List<Student> getStudentByTid(int tid);

@Param()

当select语句有多个参数条件时，使用@Param()

    @Select("select * from student where sid = #{sid} and sex = #{sex}")Student getStudentBySidAndSex(@Param("sid")int sid, @Param("sex")String sex);

否则报错

### Error querying database.  Cause: org.apache.ibatis.binding.BindingException: Parameter 'sid' not found. Available parameters are [arg1, arg0, param1, param2]

这是因为多个参数时，mybatis并不知道这些属性是哪里来的，“Parameter xxx not found”