MyBatis最初是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation迁移到了Google Code。
随着开发团队转投Google Code旗下, iBatis3.x正式更名为MyBatis,代码于2013年11月迁移到GithubiBatis一词来源于"internet"和"abatis"的组合,是一个基于Java的持久层框架。
iBatis提供的持久层框架包括sQLMaps和Data Access Objects (DAO)
- MyBatis 是支持定制化SQL、存储过程以及高级映射的优秀的持久层框架。
- MyBatis避免了几乎所有的JDBC代码和手动设置参数以及获取结果集。
- MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO (Plain OldJava Objects,普通的Java对象)映射成数据库中的记录。
- MyBatis 是一个半自动的ORM (Object Relation Mapping)框架。
- Mybatis就是帮助程序员将数据存取到数据库里面。
IDEA:2021.2
JDK:1.8
Maven:3.8.1
Mysq版本:mysql 8.33
Mybatis:mybatis 5.3.7
使用自己的maven!!!
org.mybatis
mybatis
3.5.7
junit
junit
4.12
test
mysql
mysql-connector-java
8.0.33
public class User {
private Integer id;
private String userName;
private String password;
private Integer age;
private String sex;
private String email;
public User() {
}
public User(Integer id, String userName, String password, Integer age, String sex, String email) {
this.id = id;
this.userName = userName;
this.password = password;
this.age = age;
this.sex = sex;
this.email = email;
}
public Integer getId() {
return id;
}
public void setId(Integer id) {
this.id = id;
}
public String getUserName() {
return userName;
}
public void setUserName(String userName) {
this.userName = userName;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public Integer getAge() {
return age;
}
public void setAge(Integer age) {
this.age = age;
}
public String getSex() {
return sex;
}
public void setSex(String sex) {
this.sex = sex;
}
public String getEmail() {
return email;
}
public void setEmail(String email) {
this.email = email;
}
@Override
public String toString() {
return "User{" +
"id=" + id +
", userName='" + userName + '\'' +
", password='" + password + '\'' +
", age=" + age +
", sex='" + sex + '\'' +
", email='" + email + '\'' +
'}';
}
}
public interface UserMapper {
/**
* 添加用户信息
*/
int insertUser();
/**
* 修改用户信息
*/
int updateUser();
/**
* 删除用户
*/
int deleteUser();
/**
* 根据id查用户
*/
User getById();
/**
* 查询所有用户
*/
List getAllUser();
}
相关概念: ORM (Object Relationship Mapping)对象关系映射。
- 对象:Java的实体类对象
- 关系:关系型数据
- 库映射:二者之间的对应关系
java 数据库 类 表 属性 字段/列 对象 记录/行
1、映射文件的命名规则:表所对应的实体类的类名+Mapper.xml
例如:表t_user,映射的实体类为User,所对应的映射文件为UserMapper.xml
Mybatis面向接口编程的两个一致:
- 1.映射文件的namespace要和mapper接口的全类名保持一致
- 2.映射文件中sql语句的id要和mapper接口中的方法名一致
insert into t_user values(null,'冷落风','6',90,'男','[email protected]')
update t_user set username='张三' where id=18
delete from t_user where id=19
public class TestMybatis {
@Test
public void test1() throws Exception {
//1.加载核心配置文件
InputStream resource = Resources.getResourceAsStream("mybatis-config.xml");
//2.获取SqlSessionFactoryBuilder
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
//3.获取sqlSessionFactory
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(resource);
//4.获取mybatis操作数据库的会话对象SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession(true);
//5.获取mapper接口对象
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
//6.调用方法测试
int row = mapper.insertUser();
System.out.println("执行"+row+"行");
}
}
注意:
SqlSession默认不自动提交事务
若需要自动提交事务sqlSessionFactory.openSession(true)
以包为单位引入映射文件要求:
- 1.mapper接口所在的包要和映射文件所在的包一致
- 2.mapper接口要和映射文件的名字一致
在resource下创建目录,中间不能用 . 连接;应用 / 连接!!!
MyBatis获取参数值的两种方式:${}和#{}
- ${}的本质就是字符串拼接(自身不带单引号)
- #{}的本质就是占位符赋值(自身带单引号)
可以通过${}或#{}以任意的名称获取参数值,但需要注意${} 的单引号问题
此时Mybatis会将这些参数放在一个map集合中,以两种方式进行存储
- 1.以arg0,arg1..为键,以参数为值
- 2.以param1,param2为键,以参数为值
因此只需要通过#{}或${}以键的方式访问即可,但需要注意${}单引号问题
只需要通过#{}或${}以键的方式访问即可,但需要注意${}单引号问题
@Test
public void checkLoginByMap() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession("mybatis-config.xml");
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map map=new HashMap<>();
map.put("username","小张");
map.put("password","123456");
User user = mapper.checkLoginByMap(map);
System.out.println(user);
}
只需要通过#{}或${}以属性的方式访问属性值即可,但需要注意${}单引号问题
insert into t_user values(null,#{userName},#{password},#{age},#{sex},#{email})
@Test
public void insertUser() {
SqlSession sqlSession = SqlSessionUtils.getSqlSession("mybatis-config.xml");
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int row = mapper.insertUser(new User(null, "大黑", "999", 89, "男", "[email protected]"));
System.out.println("成功添加"+row+"行数据");
}
此时Mybatis会将这些参数放在一个map集合中,以两种方式进行存储
- 1.以@Parma注解的值为键,以参数为值
- 2.以param1,param2为键,以参数为值
- 因此只需要通过#{}或${}以键的方式访问即可,但需要注意${}单引号问题
/**
* 登录(使用@Parma)
*/
User checkLoginByParma(@Param("username")String username,@Param("password")String password);
总结:
分两种情况:
- 1.实体类类型
- 2.以@Parma注解命名
Mybatis设置的默认类型别名
java.lang.Integer------->int,integer
int------>_int._integer
Map----->map
String----->String
若查询出来的数据只有一条:
- 1.可以通过实体类对象
- 2.可以通过list集合接收
- 3.可以通过Map集合接收
若查询出来的数据有多条:
- 1.可以通过实体类类型的list集合接收
- 2.可以通过map类型的list集合接收
- 3.可以在mapper接口上的方法上添加@MapKey注解
一定不能通过实体类对象接收,否则报错TooManyResultsException
/**
* 根据Id查询用户
*/
User getUserById(@Param("id") Integer id);
/**
* 查询所有用户信息
*/
List getAllUser();
/**
* 查询用户信息的总数
*/
Integer getCount();
/**
* 根据id查询用户信息作为一个map集合
*/
Map getUserToMap(@Param("id") Integer id);
/**
* 查询所有用户
*/
List
/**
* 查询所有用户
*/
@MapKey("id")
Map getAllUserToMap();
三种方式:
- select * from t_user where username like '%$fusername}%'
- select * from t_user where username like concat('%',#fusername},'%')
- select * from t_user where username like "%"#fusername}"%"
/**
* 根据用户名模糊查询用户信息
*/
List getUserByLike(@Param("username")String username);
delete from t_user where id in(${fids})
/**
* 批量删除
*/
int deleteMore(@Param("ids") String ids);
delete from t_user where id in(${ids})
/**
* 查询指定表中的数据
*/
List getUserByTableName(@Param("tableName") String tableName);
/**
* 添加用户信息
*/
int insertUser(User user);
属性的含义:
- userGenerateKeys:设置当前标签中的sql使用了自增的id
- KeyProperty:将自增的主键的值赋值给传输到映射文件中参数的某个属性
insert into t_user values(null,#{userName},#{password},#{age},#{sex},#{email})
- mysql的命名规则 下划线 eg:emp_name
- java的命名规则驼峰 eg:empName;
两者需要对应,则需要一定的关系
在mybatis核心配置文件中配置,将下划线自动映射驼峰 eg:emp_name---->empName
resultMap:设置自定义映射关系
属性:
- id:唯一标识,不能重复
- type:设置映射关系中的实体类类型
子标签:
- id:设置主键的元素关系
- result:设置普通字段映射关系
子标签属性:
- property:设置映射关系中的属性名,必须是type属性所设置的实体类类型中的属性名
- colum:设置映射关系中的字段名,必须是sql语句查询出的字段名
注意:增,删,改,不用resultMap/resultType,仅在select中用到!!!!
/**
* 查询员工以及员工所对应的部门
*/
Emp getEmpAndDept(@Param("empId") Integer empId);
对象.属性的方式 eg:dept.deptName
- association:处理多对一映射关系
- property:需要处理多对一映射关系的属性名
- javaType:改属性的类型
- property:多对应的属性
- select:分布查询的sql的唯一标识(namespace.SQLId或mapper接口的全类名.方法名)
- colum:设置分布查询的条件
- fetchType:当开启全局的延迟加载之后,可通过此属性手动控制延迟加载的效果
- fetchType="lazy(延迟加载)|eager(立即加载)"
分步查询的优点:
- 可以实现延迟加载,必须在核心配置文件中设置全局配置信息(下划线映射驼峰)
第一步: 先查emp
/**
* 分布查询员工以及员工所对应的部门
* 第一步:查询员工信息
*/
Emp getEmpAndDeptByStepOne(@Param("empId")Integer empId);
第二部:在查dept
/**
* 分布查询员工以及员工所对应的部门
* 第二步:通过did查询员工所对应的部门
*/
Dept getEmpAndDeptByStepTwo(@Param("deptId")Integer deptId);
- lazyLoadingEnabled:延迟加载的全局开关。所有关联对象都会延迟加载(默认:false)
- aggressiveLazyLoading:任何方法的调用都会加载该对象的所有属性(默认:false)
- 可通过association和collection中的fetchType属性设置当前的分步查询是否使用延迟加载, fetchType="lazy(延迟加载)|eager(立即加载)"
延迟加载开启:获取去谁,就只会执行他所对应的sql语句!!!
collection:处理一对多的映射关系
ofType:标识该属性所对应的集合中存储数据的类型
/**
* 部门以及部门所有的员工信息
*/
Dept getDeptAndEmp(@Param("deptId") Integer deptId);
第一步:
/**
* 通过分布查询查询部门以及部门中所有的员工
* 分布查询第一步
*/
Dept getDeptAndEmpByStepOne(@Param("deptId")Integer deptId);
第二步:
/**
* 通过分布查询查询部门以及部门中所有的员工
* 第二步:根据did查询员工信息
*/
List getDeptAndEmpByStepTwo(@Param("did") Integer did);
Mybatis框架的动态SQL技术是一种根据特定条件动态拼装SQL语句的功能,它存在的意义是为了解决拼接SQL语句字符串时的痛点问题。
- if:根据标签中的test属性所对应的表达式决定标签中的内容是否需要拼接到sql中
小技巧:where 后添加 1=1 恒成立条件!!!
- where:动态生成where关键字
- where标签中有内容时,会自动生成where关键字,并且将内容前多余的and或or去掉;
- where标签中没有内容时,此时where没有任何效果
注意:where标签不能将其中内容后的and或or去掉
and emp_name=#{empName}
and age=#{age}
and sex=#{sex}
and email=#{email}
若标签中有内容时:
- prefix,suffix:将trim标签中内容前面或后面添加指定内容
- suffixOverrides,prefixOverrides:将trim标签中内容前面或后面删除指定内容
若标签中无内容时,trim标签没有任何效果!!!
相当于java中的if....else if.....else
- when至少有一个,otherwise至多有一个
foreach属性:
- collection:设置需要循环的数组或集合
- item:表示数组或集合中的每一个数据
- separator:循环体之间的分隔符
- open:foreach标签所循环的所有内容的开始符
- close:foreach标签所循环的所有内容的结束符
/**
* 通过数组实现批量删除
*/
int deleteMoreByArray(@Param("empIds") Integer[] empIds);
方式一:
delete from t_emp where emp_id in
#{empId}
方式二:
delete from t_emp where
emp_id=#{empId}
/**
* 批量添加
*/
int insertMoreByList(@Param("emps") List emps);
insert into t_emp values
(null,#{emp.empName},#{emp.age},#{emp.sex},#{emp.email},null)
emp_id,emp_name, age,sex,email:设置sql片段 :引用sql片段
emp_id,emp_name,age,sex,email
一级缓存是SqlSession级别的,通过同一个SqlSession查询的数据会被缓存,下次查询相同的数据,就会从缓存中直接获取,不会从数据库重新访问
使一级缓存失效的四种情况:
- 不同的SqlSession对应不同的一级缓存
- 同一个SqlSession但是查询条件不同
- 同一个SqlSession两次查询期间执行了任何一次增删改操作
- 同一个SqlSession两次查询期间手动清空了缓存
一级缓存默认开启!!!
Emp getEmpById(@Param("empId") Integer empId);
测试:
@Test
public void getEmpById() {
SqlSession session1 = SqlSessionUtils.getSession("mybatis-config.xml");
CacheMapper mapper = session1.getMapper(CacheMapper.class);
Emp emp1 = mapper.getEmpById(1);
System.out.println(emp1);
SqlSession session2 = SqlSessionUtils.getSession("mybatis-config.xml");
CacheMapper mapper1 = session2.getMapper(CacheMapper.class);
Emp emp2 = mapper1.getEmpById(1);
System.out.println(emp2);
}
结果:
二级缓存是SqlSessionFactory级别,通过同一个SqlSessionFactory创建的SqlSession查询的结果会被缓存;此后若再次执行相同的查询语句,结果就会从缓存中获取
二级缓存开启的条件:
- 在核心配置文件中,设置全局配置属性cacheEnabled="true",默认为true,不需要设置
- 在映射文件中设置标签
- 二级缓存必须在SqlSession关闭或提交之后有效
- 查询的数据所转换的实体类类型必须实现序列化的接口
使二级缓存失效的情况:两次查询之间执行了任意的增删改,会使一级和二级缓存同时失效
1. 实体类类型必须实现序列化的接口:
2.开启标签cache:
3.SqlSession关闭或提交之后有效:
@Test
public void testTwoCache() throws IOException {
InputStream resource = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(resource);
SqlSession sqlSession1 = sqlSessionFactory.openSession(true);
CacheMapper mapper = sqlSession1.getMapper(CacheMapper.class);
Emp emp = mapper.getEmpById(1);
System.out.println(emp);
sqlSession1.close();
SqlSession sqlSession2 = sqlSessionFactory.openSession(true);
CacheMapper mapper1 = sqlSession2.getMapper(CacheMapper.class);
Emp emp1 = mapper1.getEmpById(1);
System.out.println(emp1);
sqlSession2.close();
}
测试结果:
在mapper配置文件中添加的cache标签可以设置一些属性:
eviction属性:缓存回收策略
- LRU (Least Recently Used) -最近最少使用的:移除最长时间不被使用的对象。
- FIFO (First in First out) -先进先出:按对象进入缓存的顺序来移除它们。
- SOFT- 软引用:移除基于垃圾回收器状态和软引用规则的对象。
- WEAK - 弱引用:更积极地移除基于垃圾收集器状态和弱引用规则的对象。默认的是 LRU。
flushInterval属性:刷新间隔,单位毫秒
- 默认情况是不设置,也就是没有刷新间隔,缓存仅仅调用语句时刷新
size属性:引用数目,正整数
- 代表缓存最多可以存储多少个对象,太大容易导致内存溢出
readOnly属性:只读,true/false 此默认是 false。
- true:只读缓存;会给所有调用者返回缓存对象的相同实例。因此这些对象不能被修改。这提供了很重要的性能优势。
- false:读写缓存;会返回缓存对象的拷贝(通过序列化)。这会慢一些,但是安全,因
- 先查询二级缓存,因为二级缓存中可能会有其他程序已经查出来的数据
- 如果二级缓存没有命中,再查询一级缓存
- 如果一级缓存也没有命中,则查询数据库
- SqlSession关闭之后,一级缓存中的数据会写入二级缓存
添加依赖:
org.mybatis.caches
mybatis-ehcache
1.2.1
ch.qos.logback
logback-classic
1.2.3
配置文件:
设置二级缓存类型:
logback日志:
[%d{HH:mm:ss.SSS}] [%-5level] [%thread] [%logger] [%msg]%n
逆向工程:先创建数据库表,由框架负责根据数据库表,反向生成如下资源:
- Java实体类
- Mapper接口
- Mapper映射文件
org.mybatis.generator
mybatis-generator-maven-plugin
1.3.0
org.mybatis.generator
mybatis-generator-core
1.3.2
com.mchange
c3p0
0.9.2
mysql
mysql-connector-java
8.0.33
文件名必须是:generationConfig.xml
查询全部(无条件):
List emps = mapper.selectByExample(null);
根据条件查询:(QBC风格)
EmpExample example = new EmpExample();
example.createCriteria().andEmpNameEqualTo("张三").andAgeGreaterThanOrEqualTo(10);
List list = mapper.selectByExample(example);
com.github.pagehelper
pagehelper
5.2.0
设置在Mybatis的核心配置文件中!!!
1.查询之前开启分页:PageHelper.startPage( 3,2)
- 3:表示当前页数
- 2:表示每页显示的条数
2.查询功能之后获取分页相关信息:PageInfo
pageInfo=new PageInfo<>(emps, 5)
- emps:表示分页数据。
- 5:当前导航分页的数量
@Test
public void test() throws IOException {
InputStream resource = Resources.getResourceAsStream("mybatis-config.xml");
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(resource);
SqlSession sqlSession = sqlSessionFactory.openSession(true);
EmpMapper mapper = sqlSession.getMapper(EmpMapper.class);
PageHelper.startPage(3, 2);
List emps = mapper.selectByExample(null);
PageInfo pageInfo=new PageInfo<>(emps,5);
System.out.println(pageInfo);
}
PageInfo{pageNum=3, pageSize=2, size=2, startRow=5, endRow=6, total=11, pages=6, list=Page{count=true, pageNum=3, pageSize=2, startRow=4, endRow=6, total=11, pages=6, reasonable=false, pageSizeZero=false}[Emp{empId=9, empName='jj', age=12, sex='男', email='11qq.com', did=null}, Emp{empId=10, empName='kk', age=22, sex='男', email='22qq.com', did=null}], prePage=2, nextPage=4, isFirstPage=false, isLastPage=false, hasPreviousPage=true, hasNextPage=true, navigatePages=5, navigateFirstPage=1, navigateLastPage=5, navigatepageNums=[1, 2, 3, 4, 5]}
常用数据含义:
- pageNum:当前页的页码
- pageSize:每页显示的条数
- size:当前页显示的真实条数
- startRow:从第几行开始
- endRow:从第几行结束
- total:总记录数
- pages:总页数
- prePage:上一页的页码
- nextPage:下一页的页码
- isFirstPage/isLastPage:是否为第一页/最后一页
- hasPreviousPage/hasNextPage:是否存在上一页/下一页
- navigatePages:导航分页的页码数
- navigatepageNums:导航分页的页码,[1,2,3,4,5]