什么是mybatis?
mybatis是一款用于持久层的、轻量级的半自动化ORM框架,封装了所有jdbc操作以及设置查询参数和获取结果集的操作,支持自定义sql、存储过程和高级映射
mybatis用来干什么?
用于处理java和数据库的交互
使用mybatis的好处
- 与JDBC相比,减少了50%以上的代码量。
- MyBatis灵活,不会对应用程序或者数据库的现有设计强加任何影响,SQL可以写在XML里(还可以以注解方式写到Java代码中),从程序代码中彻底分离,降低耦合度,便于统一管理和优化,可重用。
- 提供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 configuration
PUBLIC "-//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 mapper
PUBLIC "-//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.sid
inner 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.sid
left 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/>
<cache
eviction="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”