Mybatis
简介
什么是Mybatis?
-
Mybatis是一款优秀的持久层框架
-
它支持定制化SQL,存储过程以及高级映射。
-
Mybatis避免了几乎所有的JDBC代码和手动配置参数以及获取结果集。
-
Mybatis可以使用简单的XML,或者注解来配置和映射原始类型,接口和Java的pojo(Plain Old Java Objects,普通老式 Java 对象)为数据库中的记录。
-
MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了[google code](https://baike.baidu.com/item/google code/2346604),并且改名为MyBatis 。
-
2013年11月迁移到Github。
Maven仓库
<!-- https://mvnrepository.com/artifact/org.mybatis/mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
持久化
数据的持久化
- 持久化就是将程序的数据在持久状态和瞬时状态转化的过程。
- 内存:断电即失
- 数据库(jdbc),io文本持久化
持久层
- 完成持久化工作的代码块
为什么需要Mybatis
-
帮程序员将数据存储到数据库中
-
方便
-
简化jdbc代码
-
优点
- 简单易学:本身就很小且简单。没有任何第三方依赖,最简单安装只要两个jar文件+配置几个sql映射文件易于学习,易于使用,通过文档和源代码,可以比较完全的掌握它的设计思路和实现。
- 灵活:mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里,便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
- 解除sql与程序代码的耦合:通过提供DAO层,将业务逻辑和数据访问逻辑分离,使系统的设计更清晰,更易维护,更易单元测试。sql和代码的分离,提高了可维护性。
- 提供映射标签,支持对象与数据库的orm字段关系映射
- 提供对象关系映射标签,支持对象关系组建维护
- 提供xml标签,支持编写动态sql。
搭建Mybatis
搭建环境
搭建数据库
CREATE DATABASE `mybatis`;
USE `mybatis`;
CREATE TABLE `user`(
`id` INT(5) not null auto_increment,
`name` VARCHAR(20) DEFAULT null,
`pwd` VARCHAR(20) DEFAULT NULL,
PRIMARY KEY(`id`)
)ENGINE=INNODB DEFAULT CHARSET=utf8;
INSERT INTO `USER`(`id`,`name`,`pwd`) VALUES('1','周五','123456');
INSERT INTO `USER`(`id`,`name`,`pwd`) VALUES('2','王二','123456');
INSERT INTO `USER`(`id`,`name`,`pwd`) VALUES('3','李四','123456');
新建一个maven项目,删除src目录,变成父工程。
导入依赖
<!--导入依赖-->
<dependencies>
<!--mysql驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<!--mybatis依赖-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.3</version>
</dependency>
<!--junit-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
</dependencies>
创建一个模块
项目结构:
-
编写mybatis核心配置文件,resources/mybatis-config.xml
<?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 id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <property name="driver" value="com.mysql.jdbc.Driver"/> <property name="url" value="jdbc.mysql://localhost:3306/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF-8"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> </configuration>
-
编写mybatis的工具类,MybatisUtil
package com.zr.util; import org.apache.ibatis.io.Resources; import org.apache.ibatis.session.SqlSession; import org.apache.ibatis.session.SqlSessionFactory; import org.apache.ibatis.session.SqlSessionFactoryBuilder; import java.io.IOException; import java.io.InputStream; public class MybatisUtil { private static SqlSessionFactory sqlSessionFactory; static { try { //获取sqlSessionFactory对象 String resource = "mybatis-config.xml"; InputStream inputStream = Resources.getResourceAsStream(resource); sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); } catch (IOException e) { e.printStackTrace(); } } //既然有了 SqlSessionFactory,顾名思义,我们可以从中获得 SqlSession 的实例。 // SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。 public static SqlSession getSqlSession(){ return sqlSessionFactory.openSession(); } }
编写代码
-
实体类,User
package com.zr.pojo; public class User { private int id; private String name; private String pwd; public User() { } public User(int id, String name, String pwd) { this.id = id; this.name = name; this.pwd = pwd; } public int getId() { return id; } public void setId(int id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public String getPwd() { return pwd; } public void setPwd(String pwd) { this.pwd = pwd; } @Override public String toString() { return "User{" + "id=" + id + ", name='" + name + '\'' + ", pwd='" + pwd + '\'' + '}'; } }
-
dao接口(以后将dao改为Mapper),UserDao
package com.zr.dao; import com.zr.pojo.User; import java.util.List; public interface UserDao { List<User> getUserList(); }
-
接口实现类(由原来的Impl转化为一个Mapper配置文件),UserMapper.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"> <!--绑定一个对应的Dao/Mapper接口--> <mapper namespace="com.zr.dao.UserDao"> <select id="getUserList" resultType="com.zr.pojo.User"> select * from mybatis.user; </select> </mapper>
测试
注意点:org.apache.ibatis.binding.BindingException: Type interface com.zr.dao.UserDao is not known to the MapperRegistry.
在Mybatis的核心配置文件中注册!mybatis-config.xml!
<!-- 每一个Mapper.xml都需要在Mybatis的核心配置文件中注册!-->
<mappers>
<mapper resource="com/zr/dao/UserMapper.xml"/>
</mappers>
注意点:### Error building SqlSession. The error may exist in com/zr/dao/UserMapper.xml
在pom.xml中添加以下配置
<!-- 在build中配置resource,防止资源导出失败问题-->
<build>
<resources>
<resource>
<directory>src/main/resources</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
</build>
- junit测试
public class UserDaoTest {
@Test
public void test(){
//获得sqlSession对象
SqlSession sqlSession = MybatisUtil.getSqlSession();
System.out.println("获得sqlSession对象");
//执行sql 方式一:getMapper
UserDao mapper = sqlSession.getMapper(UserDao.class);
List<User> userList = mapper.getUserList();
//方式二 ,不建议使用
//List<User> userList = sqlSession.selectList("com.zr.dao.UserDao.getUserList");
for (User user : userList) {
System.out.println(user);
}
//关闭sqlSession
sqlSession.close();
}
}
CRUD
namespace中的包名要和Dao/Mapper接口的包名一致。
select:选择,查询语句。
- id:就是对应namespace中的方法名。
- resultType;Sql语句的返回值。
- parameterType:参数类型。
编写接口,UserDao
//根据id查询用户
User getUserById(int id);
//增加用户
int addUser(User user);
//修改用户
int updateUser(User user);
//删除用户
int deleteUser(int id);
编写对应的mapper中的sql语句,UserMapper.xml
<!-- 查询用户-->
<select id="getUserById" parameterType="int" resultType="com.zr.pojo.User">
select * from mybatis.user where id = #{id};
</select>
<!-- 对象中的属性可以直接取出来用-->
<insert id="addUser" parameterType="com.zr.pojo.User">
insert into mybatis.user(id,name,pwd) values(#{id},#{name},#{pwd});
</insert>
<!-- 修改用户-->
<update id="updateUser" parameterType="com.zr.pojo.User">
update mybatis.user set name=#{name},pwd=#{pwd} where id=#{id};
</update>
<!-- 删除用户-->
<delete id="deleteUser" parameterType="int">
delete * from mybatis.user where id = #{id};
</delete>
测试(增删改必须提交事务)
@Test
public void getUserById(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
User user = mapper.getUserById(1);
System.out.println(user);
sqlSession.close();
}
@Test
public void addUser(){
//增删改必须提交事务
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
int res = mapper.addUser(new User(4, "哈哈", "123454"));
System.out.println(res);
if (res>0){
System.out.println("插入成功!");
}
//提交事务
sqlSession.commit();
sqlSession.close();
}
@Test
public void updateUser(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
int res = mapper.updateUser(new User(4, "赵六", "66666"));
System.out.println(res);
sqlSession.commit();
sqlSession.close();
}
@Test
public void deleteUser(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
mapper.deleteUser(4);
sqlSession.commit();
sqlSession.close();
}
Map
当实体类中的参数过多,应该考虑使用Map
//万能的Map
int addUserx(Map<String,Object> map);
<!--传递map的key-->
<insert id="addUserx" parameterType="map">
insert into mybatis.user(id,name,pwd) values(#{userid},#{username},#{userpwd});
</insert>
@Test
public void addUserx(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
Map<String, Object> map = new HashMap<String, Object>();
map.put("userid",5);
map.put("username","集合");
map.put("userpwd","123444");
mapper.addUserx(map);
//提交事务
sqlSession.commit();
sqlSession.close();
}
Map传递的参数,直接在sql中取出key即可!
对象传递的参数,直接在sql中取对象的属性即可。
只有一个基本类型参数的情况下,直接在sql中取即可。
模糊查询
//模糊查询
List<User> getUserLike(String value);
<!-- java代码中使用通配符-->
<select id="getUserLike" resultType="com.zr.pojo.User" >
select * from mybatis.user where name like #{value};
</select>
<!-- sql拼接中使用通配符-->
<!-- select * from mybatis.user where name like "%"#{value}"%";-->
@Test
public void getUserLike(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserDao mapper = sqlSession.getMapper(UserDao.class);
List<User> userLike = mapper.getUserLike("%李%");
for (User user : userLike) {
System.out.println(user);
}
}
配置解析
核心配置文件
-
mybatis-config.xml
configuration(配置) properties(属性) settings(设置) typeAliases(类型别名) typeHandlers(类型处理器) objectFactory(对象工厂) plugins(插件) environments(环境配置) environment(环境变量) transactionManager(事务管理器) dataSource(数据源) databaseIdProvider(数据库厂商标识) mappers(映射器)
环境配置(environments)
MyBatis 可以配置成适应多种环境,但每个 SqlSessionFactory 实例只能选择一种环境。
Mybatis的默认事务管理器是JDBC,连接池是POOLED。
结构(忽略b.properties):
属性(properties)
我们可以通过properties属性来实现引用配置文件。
这些属性可以在外部进行配置,并可以进行动态替换。可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置【db.properties】。
编写一个配置文件db.properties
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=false&useUnicode=true&characterEncoding=UTF-8
username=root
password=123456
核心配置文件中加入
<properties resource="db.properties">
<property name="username" value="root"/>
<property name="password" value="123456"/>
</properties>
- 可以直接引入外部配置文件
- 也可以直接在properties中增加一些属性配置
- 如果拥有相同的字段,优先使用外部的配置文件
类型别名(typeAliases)
类型别名可为 Java 类型设置一个缩写名字。 它仅用于 XML 配置,意在降低冗余的全限定类名书写。
<!-- 可以给实体类起别名-->
<typeAliases>
<typeAlias type="com.zr.pojo.User" alias="User"/>
</typeAliases>
也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean。
扫描实体类的包,它的默认别名就是这个实体类(没有注解)的类名,首字母小写。若有注解,则别名为其注解值(@Alias("***"))。
<!-- 扫描包给实体类起别名-->
<typeAliases>
<package name="com.zr.pojo"/>
</typeAliases>
实体类较少时,使用第一种方式。
如果实体类十分多,使用第二种方式。
第一种方式可以给类自定义别名,第二种不行(可以给实体类使用注解来自定义别名)。
@Alias("user")
public class User {
...
}
设置(settings)
这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为(列举几个)。
设置名 | 描述 | 有效值 | 默认值 |
---|---|---|---|
logImpl | 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING | 未设置 |
cacheEnabled | 全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。 | true | false | true |
lazyLoadingEnabled | 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。 | true | false | false |
其它配置
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
- mybatis-generator-core
- mybatis-plus
- 通用mapper
映射器(mappers)
mapperRegister:注册绑定我们的mapper文件。
方式一:使用resource绑定【推荐使用】
<!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册-->
<mappers>
<mapper resource="com/zr/Mapper/UserMapper.xml"/>
</mappers>
方式二:使用class绑定
<!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册-->
<mappers>
<mapper class="com.zr.mapper.UserMapper"/>
</mappers>
注意:
- 接口和它的mapper配置文件必须同名!
- 接口和它的mapper配置文件必须在同一个包下!
方式三:使用package扫描包bangd
<!--每一个Mapper.xml都需要在Mybatis核心配置文件中注册-->
<mappers>
<package name="com.zr.mapper"/>
</mappers>
注意:
- 接口和它的mapper配置文件必须同名!
- 接口和它的mapper配置文件必须在同一个包下!
生命周期和作用域
不同作用域和生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题。
SqlSessionFactoryBuilder:
- 一旦创建了 SqlSessionFactory,就不再需要它了。
- SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域(也就是局部方法变量)。
SqlSessionFactory:
- 就相当于数据库连接池。
- 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
- 因此 SqlSessionFactory 的最佳作用域是应用作用域。
- 最简单的就是使用单例模式或者静态单例模式。
SqlSession:
- 连接到连接池的一个请求。
- SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。
- 用完之后需要关闭,否则资源被占用。
属性名和字段名不一致的问题
问题
数据库的字段:
新建一个项目,拷贝之前项目,测试实体类字段不一致的情况。
实体类
public class User {
private int id;
private String name;
private String password;
}
结果:
解决方法:
-
起别名
<!-- 查询用户--> <select id="getUserById" parameterType="int" resultType="com.zr.pojo.User"> select id,name,pwd as password from mybatis.user where id = #{id}; </select>
-
resultMap:结果集映射
resultMap
结果集映射,UserMapper.xml
<!-- 结果集映射-->
<resultMap id="UserMap" type="User">
<!-- column数据库中的字段,property实体类中的属性-->
<result column="id" property="id"/>
<result column="name" property="name"/>
<result column="pwd" property="password"/>
</resultMap>
<!-- 查询用户-->
<select id="getUserList" resultMap="UserMap" >
select * from mybatis.user;
</select>
resultMap
元素是 MyBatis 中最重要最强大的元素.- ResultMap 的设计思想是,对简单的语句做到零配置,对于复杂一点的语句,只需要描述语句之间的关系就行了。
ResultMap
的优秀之处——你完全可以不用显式地配置它们。
日志
日志工厂
如果数据库操作错误,排错使用日志输出。
logImpl | 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING | 未设置 |
掌握LOG4J(需要导包) ,STDOUT_LOGGING(标准日志工厂实现,可以直接使用)。
在mybatis的核心配置文件中配置日志:
<!--标准日志工厂实现-->
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
LOG4J
什么是LOG4J?
- Log4j是Apache的一个开源项目,通过使用Log4j,我们可以控制日志信息输送的目的地是控制台、文件、GUI组件。
- 可以控制每一条日志的输出格式。
- 通过定义每一条日志信息的级别,我们能够更加细致地控制日志的生成过程。
- 通过一个配置文件来灵活地进行配置。
-
导包
<!-- https://mvnrepository.com/artifact/log4j/log4j --> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency>
-
log.properties
### 配置根 ### log4j.rootLogger = debug,console,file ### 配置输出到控制台 ### log4j.appender.console = org.apache.log4j.ConsoleAppender log4j.appender.console.Target = System.out log4j.appender.console.Threshold=DEBUG log4j.appender.console.layout = org.apache.log4j.PatternLayout log4j.appender.console.layout.ConversionPattern = [%c]-%m%n ### 配置输出到文件 ### log4j.appender.file = org.apache.log4j.RollingFileAppender log4j.appender.file.File = ./log/zr.log log4j.appender.file.MaxFileSize = 10mb log4j.appender.file.Threshold = DEBUG log4j.appender.file.layout = org.apache.log4j.PatternLayout log4j.appender.file.layout.ConversionPattern = [%p][%d(yy-MM-dd)][%c]%m%n ### 设置输出sql的级别,其中logger后面的内容全部为jar包中所包含的包名 ### log4j.logger.org.mybatis=DEBUG log4j.logger.java.sql=DEBUG log4j.logger.java.sql.Connection=DEBUG log4j.logger.java.sql.Statement=DEBUG log4j.logger.java.sql.PreparedStatement=DEBUG log4j.logger.java.sql.ResultSet=DEBUG
-
配置log4j为日志的实现
<settings> <setting name="logImpl" value="LOG4J"/> </settings>
-
测试
简单使用:
-
在要使用LOG4J的类中,导包。
-
日志对象,参数为当前类的class。
static Logger logger = Logger.getLogger(UserDaoTest.class);
-
日志级别
@Test public void testLog4j(){ logger.info("info进入了testLog4j方法!"); logger.debug("debug进入了testLog4j方法!"); logger.error("error进入了testLog4j方法!"); }
分页
limit分页
语法:
select * from user limit startIndex,pageSize;
使用mybatis分页
-
接口
//分页 List<User> getUserByLimit(Map<String,Integer> map);
-
Mapper.xml
<!-- 分页查询--> <select id="getUserByLimit" parameterType="map" resultMap="UserMap"> select * from mybatis.user limit #{startIndex},#{pageSize}; </select>
-
测试
@Test public void getUserByLimit(){ SqlSession sqlSession = MybatisUtil.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); HashMap<String, Integer> map = new HashMap<String, Integer>(); map.put("startIndex",2); map.put("pageSize",3); List<User> list = mapper.getUserByLimit(map); for (User user : list) { System.out.println(user); } sqlSession.close(); }
RowBounds分页(了解)
不使用sql实现分页
-
接口
//分页2 List<User> getUserByRounds();
-
mapper.xml
<!-- 分页查询2--> <select id="getUserByRounds" resultMap="UserMap"> select * from mybatis.user; </select>
-
测试
@Test public void getUserByRounds(){ SqlSession sqlSession = MybatisUtil.getSqlSession(); //UserByRounds实现 RowBounds rowBounds = new RowBounds(1, 2); //通过java代码层面进行分页 List<User> userList = sqlSession.selectList("com.zr.mapper.UserMapper.getUserByRounds",null,rowBounds); for (User user : userList) { System.out.println(user); } sqlSession.close(); }
分页插件
地址:https://pagehelper.github.io/
了解即可,详细使用参考官方文档。
使用注解开发
面向接口编程
优点:解耦,可拓展,提高复用,分层开发中,上层不用管具体的实现,大家遵守共同的标准,使开发变得容易,规范性更好。
关于接口的理解:
- 定义(规范,约束)与实现的分离。
- 接口的本身反映了系统设计人员对系统的抽象理解。
- 接口应有两类:
- 第一类是对一个个体的抽象,它可对应为一个抽象体(abstract class)。
- 第二类是对一个个体某一方面的抽象,即形成一个抽象面(interface)。
- 一个个体可能有多个抽象面,抽象面和抽象体是有区别的。
三个面向区别:
- 面向对象:以对象为单位,考虑它的属性及方法。
- 面向过程:以具体的流程(事务过程)为单位,考虑它的实现。
- 接口设计与非接口设计是针对复用技术而言的,与面向对象(过程)不是一个问题,更多体现就是对系统的架构。
使用注解开发
-
注解在接口上实现,UserMapper
public interface UserMapper{ @Select("select * from user") List<User> getUsers(); }
-
需要在核心配置文件中绑定接口
<!-- 绑定接口--> <mappers> <mapper class="com.zr.mapper.UserMapper"/> </mappers>
-
测试
public class UserMapperTest { @Test public void getUsers(){ SqlSession sqlSession = MybatisUtil.getSqlSession(); //底层主要应用反射 UserMapper mapper = sqlSession.getMapper(UserMapper.class); List<User> users = mapper.getUsers(); for (User user : users) { System.out.println(user); } sqlSession.close(); } }
本质:反射机制实现
原理:动态代理!
CRUD
可以在工具类创建的时候实现自动提交事务。
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession(true);
}
}
编写接口,增加注解,UserMapper
//方法存在多个参数,所有的参数前面必须加上@Param注解
@Select("select * from user where id=#{id}")
User getUserById(@Param("id") int id);
@Insert("insert into user(id,name,pwd) values(#{id},#{name},#{password})")
int addUser(User user);
@Update("update user set name=#{name},pwd=#{password} where id=#{id}")
int updateUser(User user);
@Delete("delete from user where id=#{uid}")
int deleteUser(@Param("uid") int id);
测试
@Test
public void getUserById(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User userById = mapper.getUserById(3);
System.out.println(userById);
sqlSession.close();
}
@Test
public void addUser(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.addUser(new User(7, "韩信", "234444"));
sqlSession.close();
}
@Test
public void updateUser(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.updateUser(new User(6,"李白","6666"));
sqlSession.close();
}
@Test
public void deleteUser(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.deleteUser(7);
sqlSession.close();
}
@param()注解
- 基本数据类型或者String类型,需要加上
- 引用类型不需要加
- 如果只有一个基本类型的话,可以忽略,但是建议加上
- 我们在sql中引用的就是@param()中设置的属性名
Lombok
使用步骤:
-
在idea中安装Lombok插件
-
在项目中导入Lombok的jar包
<!-- https://mvnrepository.com/artifact/org.projectlombok/lombok --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <version>1.18.16</version> </dependency>
-
在实体类上加注解
@Data:无参构造,get,set,toString,hashcode,equals
@AllArgsConstructor:有参构造
@NoArgsConstructor:无参构造
@ToString
@Getter
多对一处理
数据库
CREATE TABLE `teacher`(
`id` int(8) not null,
`name` VARCHAR(20) DEFAULT null,
PRIMARY KEY(`id`)
)ENGINE=INNODB DEFAULT CHARSET=utf8
INSERT INTO teacher(`id`,`name`) VALUES('1','周周');
CREATE TABLE `student`(
`id` INT(8) not null,
`name` VARCHAR(20) DEFAULT null,
`tid` INT(8) DEFAULT null,
PRIMARY KEY(`id`),
KEY `fktid` (`tid`),
CONSTRAINT `fktid` FOREIGN KEY (`tid`) REFERENCES `teacher` (`id`)
)ENGINE=INNODB DEFAULT CHARSET=utf8
INSERT INTO student(`id`,`name`,`tid`) VALUES('1','小明','1');
INSERT INTO student(`id`,`name`,`tid`) VALUES('2','小张','1');
INSERT INTO student(`id`,`name`,`tid`) VALUES('3','小红','1');
INSERT INTO student(`id`,`name`,`tid`) VALUES('4','小刘','1');
INSERT INTO student(`id`,`name`,`tid`) VALUES('5','小周','1');
测试环境搭建
项目结构:
-
导入Lombok
-
创建实体类Teacher,Student
@Data public class Teacher { private int id; private String name; }
@Data public class Student { private int id; private String name; //学生要关联一个老师 private Teacher teacher; }
-
建立Mapper接口
-
建立Mapper.xm文件
-
核心配置文件中绑定mapper
-
测试
按照查询嵌套处理
StudentMapper.xml
<mapper namespace="com.zr.mapper.StudentMapper">
<select id="getStudent" resultMap="StudentTeacher">
select * from student
</select>
<resultMap id="StudentTeacher" type="Student">
<result property="id" column="id"/>
<result property="name" column="name"/>
<!--复杂的属性,我们要单独处理,对象:association,集合:collection-->
<association property="teacher" column="tid" javaType="Teacher" select="getTeacher"/>
</resultMap>
<select id="getTeacher" resultType="Teacher">
select * from teacher where id=#{id}
</select>
</mapper>
按照结果嵌套处理
TeacherMapper.xml
<!-- 按照结果嵌套处理-->
<select id="getStudent2" resultMap="StudentTeacher2">
select s.id sid,s.name sname,t.name tname from student s,teacher t where s.tid=t.id
</select>
<resultMap id="StudentTeacher2" type="Student">
<result property="id" column="sid"/>
<result property="name" column="sname"/>
<association property="teacher" javaType="Teacher">
<result property="name" column="tname"/>
</association>
</resultMap>
回顾MySql多对一查询方式
- 子查询
- 连表查询
一对多处理
老师和学生一对多的关系
搭建环境,和之前一样
实体类
@Data
public class Student {
private int id;
private String name;
private int tid;
}
@Data
public class Teacher {
private int id;
private String name;
//一个老师有多个学生
private List<Student> students;
}
按照结果嵌套处理
TeacherMapper.xml
<!--按结果嵌套查询-->
<select id="getTeacher" resultMap="TeacherStudent">
select s.id sid,s.name sname,t.name tname,t.id tid from student s,teacher t where s.tid=t.id and t.id=#{tid}
</select>
<resultMap id="TeacherStudent" type="Teacher">
<result property="id" column="tid"/>
<result property="name" column="tname"/>
<!-- javaType=“” 指定属性的类型 集合中泛型的信息,用oftype获取 -->
<collection property="students" ofType="Student">
<result property="id" column="sid"/>
<result property="name" column="sname"/>
<result property="tid" column="tid"/>
</collection>
</resultMap>
按照查询嵌套处理
TeacherMapper.xml
<!-- 按照查询嵌套处理 -->
<select id="getTeacher2" resultMap="TeacherStudent2">
select * from mybatis.teacher where id = #{tid}
</select>
<resultMap id="TeacherStudent2" type="Teacher">
<collection property="students" javaType="ArrayList" ofType="Student" select="getStudentByTeacherId" column="id"/>
</resultMap>
<select id="getStudentByTeacherId" resultType="Student">
select * from mybatis.student where tid = #{id}
</select>
测试,MyTeat
public class MyTeat {
@Test
public void getTeachers(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
TeacherMapper mapper = sqlSession.getMapper(TeacherMapper.class);
List<Teacher> teachers = mapper.getTeachers();
for (Teacher teacher : teachers) {
System.out.println(teacher);
}
sqlSession.close();
}
@Test
public void getTeacher(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
TeacherMapper mapper = sqlSession.getMapper(TeacherMapper.class);
Teacher teacher = mapper.getTeacher(1);
System.out.println(teacher);
sqlSession.close();
}
@Test
public void getTeacher2(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
TeacherMapper mapper = sqlSession.getMapper(TeacherMapper.class);
Teacher teacher2 = mapper.getTeacher2(1);
System.out.println(teacher2);
sqlSession.close();
}
}
小结
-
关联:association【多对一】
-
集合:collection【一对多】
-
javaType:用来指定实体类中属性的类型
-
ofType:用来指定映射到list或集合中pojo的类型,泛型中的约束类型
注意点:
- 保证sql的可读性,通俗易懂
- 注意一对多和多对一中,属性名和字段问题
- 如果问题不好排错,建议使用日志(Log4j)
动态SQL
动态sql:指根据不同的条件生成不同的sql语句。
例如拼接时要确保不能忘记添加必要的空格,还要注意去掉列表最后一个列名的逗号。利用动态 SQL,可以彻底摆脱这种痛苦。
if
choose (when, otherwise)
trim (where, set)
foreach
搭建环境
create table blog
(
id int(10) not null comment '博客id' primary key,
title varchar(25) not null comment '博客标题',
author varchar(25) not null comment '博客作者',
create_time datetime not null comment '创建时间',
views int(25) not null comment '浏览量'
)engine=innodb default charset=utf8
创建一个基础工程
项目结构:
-
导包
-
编写配置文件
-
编写实体类
@Data public class Blog { private String id; private String title; private String author; private Date createTime;//属性名和字段名不一致 private int views; }
在mybatis核心文件settings中添加
<!-- 开启驼峰命名转换--> <setting name="mapUnderscoreToCamelCase" value="true"/>
-
编写实体类对应Mapper接口和Mapper.xml文件
public interface BlogMapper {
//插入数据
int addBlog(Blog blog);
}
<mapper namespace="com.zr.mapper.BlogMapper">
<insert id="addBlog" parameterType="blog">
insert into mybatis.blog (id,title,author,create_time,views)
values (#{id},#{title},#{author},#{createTime},#{views});
</insert>
</mapper>
IDutils
package com.zr.util;
import org.junit.Test;
import java.util.UUID;
public class IDutils {
public static String getId(){
return UUID.randomUUID().toString().replaceAll("-","");
}
@Test
public void test(){
System.out.println(IDutils.getId());
System.out.println(IDutils.getId());
System.out.println(IDutils.getId());
}
}
- 测试
@Test
public void addBlog(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
Blog blog = new Blog();
blog.setId(IDutils.getId());
blog.setTitle("MyBatis学习!");
blog.setAuthor("周周周");
blog.setCreateTime(new Date());
blog.setViews(8888);
mapper.addBlog(blog);
blog.setId(IDutils.getId());
blog.setTitle("Java学习!");
mapper.addBlog(blog);
blog.setId(IDutils.getId());
blog.setTitle("Spring学习!");
mapper.addBlog(blog);
blog.setId(IDutils.getId());
blog.setTitle("SpringBoot学习!");
mapper.addBlog(blog);
sqlSession.commit();
sqlSession.close();
}
If
//查询博客
List<Blog> queryBlogIf(Map map);
<select id="queryBlogIf" parameterType="map" resultType="blog">
select * from blog where 1=1
<if test="title != null">
and title = #{title}
</if>
<if test="author != null">
and author=#{author}
</if>
</select>
@Test
public void queryBlogIf(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
HashMap map = new HashMap();
//map.put("title","Java学习!");
map.put("author","周周周");
List<Blog> blogs = mapper.queryBlogIf(map);
for (Blog blog : blogs) {
System.out.println(blog);
}
sqlSession.close();
}
choose(when、otherwise)
where 元素只会在子元素返回任何内容的情况下才插入 “WHERE” 子句。而且,若子句的开头为 “AND” 或 “OR”,where 元素也会将它们去除。
choose只拼接when中满足条件的第一条语句,when中的都不满足的时候,拼接otherwise的语句。
List<Blog> queryBlogChoose(Map map);
<select id="queryBlogChoose" parameterType="map" resultType="blog">
select * from blog
<where>
<choose>
<when test="title != null">
title = #{title}
</when>
<when test="author != null">
and author = #{author}
</when>
<otherwise>
and views = #{views}
</otherwise>
</choose>
</where>
</select>
@Test
public void queryBlogChoose(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
HashMap map = new HashMap();
map.put("title","Java学习!");
//map.put("author","周周周");
map.put("views",8888);
List<Blog> blogs = mapper.queryBlogChoose(map);
for (Blog blog : blogs) {
System.out.println(blog);
}
sqlSession.close();
}
trim(where、set)
<select id="queryBlogIf" parameterType="map" resultType="blog">
select * from blog
<where>
<if test="title != null">
title = #{title}
</if>
<if test="author != null">
and author=#{author}
</if>
</where>
</select>
set 元素会动态地在行首插入 SET 关键字,并会删掉额外的逗号(这些逗号是在使用条件语句给列赋值时引入的)。
//更新
int update(Map map);
<update id="update" parameterType="map">
update blog
<set>
<if test="title != null">
title = #{title},
</if>
<if test="author != null">
author = #{author}
</if>
</set>
where id = #{id}
</update>
@Test
public void update(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
HashMap map = new HashMap();
map.put("title","Java学习ing!");
map.put("author","睿睿睿");
map.put("id","7f49cd0235874456ba754dc6b07f44f1");
int update = mapper.update(map);
sqlSession.commit();
sqlSession.close();
}
动态sql,本质还是sql语句,只是我们可以在sql层面,去执行一个逻辑代码。
Foreach
动态 SQL 的另一个常见使用场景是对集合进行遍历(尤其是在构建 IN 条件语句的时候)。比如:
<select id="selectPostIn" resultType="domain.blog.Post">
SELECT *
FROM POST P
WHERE ID in
<foreach item="item" index="index" collection="list"
open="(" separator="," close=")">
#{item}
</foreach>
</select>
查询id为1,2,3的数据
//查询1,2,3记录
List<Blog> queryForeach(Map map);
<select id="queryForeach" parameterType="map" resultType="Blog">
select * from blog
<where>
<foreach collection="ids" item="id" open=" (" close=")" separator="or">
id = #{id}
</foreach>
</where>
</select>
@Test
public void queryForeach(){
SqlSession sqlSession = MybatisUtil.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
HashMap map = new HashMap();
ArrayList<Integer> ids = new ArrayList<Integer>();
ids.add(1);
ids.add(2);
ids.add(3);
map.put("ids",ids);
List<Blog> blogs = mapper.queryForeach(map);
for (Blog blog : blogs) {
System.out.println(blog);
}
sqlSession.close();
}
SQL片段
有的时候我们会将一些功能的部分抽取出来,方便复用。
使用sql标签抽取公共部分,再使用include标签引用。
<sql id="select">
<if test="title != null">
title = #{title}
</if>
<if test="author != null">
and author=#{author}
</if>
</sql>
<select id="queryBlogIf" parameterType="map" resultType="blog">
select * from blog
<where>
<include refid="select"></include>
</where>
</select>
注意事项,最好基于单表来定义sql片段,不要在sql中存在where标签。
动态sql就是在拼接sql语句,我们只要保证sql的正确性,按照sql的格式,去拼接组合就可以了。
缓存
简介
什么是缓存:
- 存在内存中的临时数据。
- 将用户经常查询的数据放在缓存(内存)中,用户去查询数据就不用从磁盘上(关系型数据库文件)查找,直接从缓存中查找,提高效率,解决了高并发系统的性能问题。
为什么使用缓存:减少和数据库的交互,减少系统开销,提高系统效率。
什么样的数据使用缓存:经常查询且不经常改变的数据。
Mybatis缓存
Mybatis包含一个非常强大的缓存特性,它可以非常方便地定制和配置缓存。
Mybatis系统中默认定义了两级缓存:一级缓存和二级缓存
- 默认情况下,只有一级缓存开启。(SqlSession级别的缓存,也称为本地缓存)
- 二级缓存需要手动开启配置,它是基于namespace级别的缓存。
- 为了提高拓展性,Mybatis定义了缓存接口Cache,我们可以通过实现Cache接口来自定义二级缓存。
一级缓存
一级缓存也叫本地缓存:SqlSession
- 数据库同一次会话期间查询到的数据会放到本地缓存中。
- 以后如果需要获取相同的数据,直接从缓存中拿,不用查询数据库。
测试步骤:
-
开启日志
-
测试在一个Session中查询两次相同的记录
-
查看日志输出
UserMapper
//根据id查询用户 User queryUserById(@Param("id") int id);
UserMapper.xml
<mapper namespace="com.zr.mapper.UserMapper"> <select id="queryUserById" resultType="user"> select * from user where id = #{id} </select> </mapper>
@Test public void queryUserById() { SqlSession sqlSession = MybatisUtil.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); User user = mapper.queryUserById(1); System.out.println(user); System.out.println("================="); User user1 = mapper.queryUserById(1); System.out.println(user==user1); sqlSession.close(); }
缓存失效:
- 查询不同的数据。
- 增删改会改变原来的数据,必定会刷新缓存。
- 查询不同的Mappe.xml。
- 手动清理缓存 sqlSession.clearCache()。
一级缓存是默认开启的,只在一次sqlSession中有效,也就是在拿到连接到关闭连接这个区间段。
二级缓存
- 二级缓存也叫全局缓存,因为一级缓存的作用域太低,诞生二级缓存。
- 基于namespace级别的缓存,一个命名空间,对应一个二级缓存。
工作机制:
- 一个会话查询一条数据,这个数据就会被放在当前会话的一级缓存中;
- 如果当前会话关闭,这个会话对应的一级缓存就没了,但是我们要让一级缓存中的数据保存到二级缓存中;
- 新的会话查询信息就可以从二级缓存中获取;
- 不同的mapper查出的数据会放在自己对应的缓存中;
步骤:
- 开启缓存
<!-- 显式地开启全局缓存-->
<setting name="cacheEnable" value="true"/>
-
在要使用二级缓存的mapper中开启
<!-- 在当前的mapper.xml中开启缓存--> <cache/>
也可以自定义参数
<!-- 在当前的mapper.xml中开启缓存--> <cache eviction="FIFO" flushInterval="60000" size="512" readOnly="true"/>
-
测试
@Test public void queryUserById2() { SqlSession sqlSession = MybatisUtil.getSqlSession(); UserMapper mapper = sqlSession.getMapper(UserMapper.class); User user = mapper.queryUserById(1); System.out.println(user); sqlSession.close(); System.out.println("================="); SqlSession sqlSession2 = MybatisUtil.getSqlSession(); UserMapper mapper2 = sqlSession2.getMapper(UserMapper.class); User user2 = mapper2.queryUserById(1); System.out.println(user==user2); sqlSession2.close(); }
注意:直接使用不带参数,控制台会输出Cause: java.io.NotSerializableException: com.zr.pojo.User这个错误;需要将实体类序列化,实现Serializable接口。
小结:
- 只要开启了二级缓存,在同一个UserMapper下就有效。
- 所有的数据都会先放在一级缓存中,只有当会话提交或者关闭的时候才会提交到二级缓存中。
自定义缓存-ehcache
Ehcache是一种广泛使用的开源Java分布式缓存。主要面向通用缓存,Java EE和轻量级容器。
使用Ehcache,导包
<!-- https://mvnrepository.com/artifact/org.mybatis.caches/mybatis-ehcache -->
<dependency>
<groupId>org.mybatis.caches</groupId>
<artifactId>mybatis-ehcache</artifactId>
<version>1.1.0</version>
</dependency>
在Mapper中指定缓存实现
<cache type="org.mybatis.caches.ehcache.EhcacheCache"/>
在resources下添加ehcache.xml
<?xml version="1.0" encoding="UTF-8"?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://ehcache.org/ehcache.xsd"
updateCheck="false">
<!--
diskStore:为缓存路径,ehcache分为内存和磁盘两级,此属性定义磁盘的缓存位置。参数解释如下:
user.home – 用户主目录
user.dir – 用户当前工作目录
java.io.tmpdir – 默认临时文件路径
-->
<diskStore path="./tmpdir/Tmp_EhCache"/>
<!--
defaultCache:默认缓存策略,当ehcache找不到定义的缓存时,则使用这个缓存策略。只能定义一个。
-->
<!--
name:缓存名称。
maxElementsInMemory:缓存最大数目
maxElementsOnDisk:硬盘最大缓存个数。
eternal:对象是否永久有效,一但设置了,timeout将不起作用。
overflowToDisk:是否保存到磁盘,当系统宕机时
timeToIdleSeconds:设置对象在失效前的允许闲置时间(单位:秒)。仅当eternal=false对象不是永久有效时使用,可选属性,默认值是0,也就是可闲置时间无穷大。
timeToLiveSeconds:设置对象在失效前允许存活时间(单位:秒)。最大时间介于创建时间和失效时间之间。仅当eternal=false对象不是永久有效时使用,默认是0.,也就是对象存活时间无穷大。
diskPersistent:是否缓存虚拟机重启期数据 Whether the disk store persists between restarts of the Virtual Machine. The default value is false.
diskSpoolBufferSizeMB:这个参数设置DiskStore(磁盘缓存)的缓存区大小。默认是30MB。每个Cache都应该有自己的一个缓冲区。
diskExpiryThreadIntervalSeconds:磁盘失效线程运行时间间隔,默认是120秒。
memoryStoreEvictionPolicy:当达到maxElementsInMemory限制时,Ehcache将会根据指定的策略去清理内存。默认策略是LRU(最近最少使用)。你可以设置为FIFO(先进先出)或是LFU(较少使用)。
clearOnFlush:内存数量最大时是否清除。
memoryStoreEvictionPolicy:可选策略有:LRU(最近最少使用,默认策略)、FIFO(先进先出)、LFU(最少访问次数)。
FIFO,first in first out,这个是大家最熟的,先进先出。
LFU, Less Frequently Used,就是上面例子中使用的策略,直白一点就是讲一直以来最少被使用的。如上面所讲,缓存的元素有一个hit属性,hit值最小的将会被清出缓存。
LRU,Least Recently Used,最近最少使用的,缓存的元素有一个时间戳,当缓存容量满了,而又需要腾出地方来缓存新的元素的时候,那么现有缓存元素中时间戳离当前时间最远的元素将被清出缓存。
-->
<defaultCache
eternal="false"
maxElementsInMemory="10000"
overflowToDisk="false"
diskPersistent="false"
timeToIdleSeconds="1800"
timeToLiveSeconds="259200"
memoryStoreEvictionPolicy="LRU"/>
<cache
name="cloud_user"
eternal="false"
maxElementsInMemory="5000"
overflowToDisk="false"
diskPersistent="false"
timeToIdleSeconds="1800"
timeToLiveSeconds="1800"
memoryStoreEvictionPolicy="LRU"/>
</ehcache>