Mybatis再学习
Mybatis 学习
一、简介
环境要求：JDK1.8 maven 3.6.1 mysql5.7 IDEA 2019.1
1、什么是Mybatis?
官方文档：https://mybatis.org/mybatis-3/zh/index.html#
gitHub地址：https://github.com/mybatis/mybatis-3
maven仓库地址：https://mvnrepository.com/
MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生类型、接口和 Java 的 POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。
MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。
持久化：持久化是将程序数据在持久状态和瞬时状态间转换的机制。通俗的讲，就是瞬时数据（比如内存中的数据，是不能永久保存的）持久化为持久数据（比如持久化至数据库中，能够长久保存）。
mybatis的优点：
简单易学：本身就很小且简单。没有任何第三方依赖，最简单安装只要两个jar文件+配置几个sql映射文件易于学习，易于使用，通过文档和源代码，可以比较完全的掌握它的设计思路和实现。
灵活：mybatis不会对应用程序或者数据库的现有设计强加任何影响。 sql写在xml里，便于统一管理和优化。通过sql语句可以满足操作数据库的所有需求。
解除sql与程序代码的耦合：通过提供DAO层，将业务逻辑和数据访问逻辑分离，使系统的设计更清晰，更易维护，更易单元测试。sql和代码的分离，提高了可维护性。
提供映射标签，支持对象与数据库的orm字段关系映射
提供对象关系映射标签，支持对象关系组建维护
提供xml标签，支持编写动态sql。
2、mybatis入门
①常用对象的概念
每个基于 MyBatis 的应用都是以一个 SqlSessionFactory 的实例为核心的。SqlSessionFactory 的实例可以通过 SqlSessionFactoryBuilder 获得。而 SqlSessionFactoryBuilder 则可以从 XML 配置文件或一个预先定制的 Configuration 的实例构建出 SqlSessionFactory 的实例。
既然有了 SqlSessionFactory，顾名思义，我们就可以从中获得 SqlSession 的实例了。SqlSession 完全包含了面向数据库执行 SQL 命令所需的所有方法。你可以通过 SqlSession 实例来直接执行已映射的 SQL 语句。
②基于IDEA的maven项目创建
pom文件中添加数据库连接及mybtais的依赖
<dependency>
<groupId>org.mybatisgroupId>
<artifactId>mybatisartifactId>
<version>3.5.3version>
dependency>
<dependency>
<groupId>mysqlgroupId>
<artifactId>mysql-connector-javaartifactId>
<version>5.1.47version>
dependency>
创建mybatis-config.xml文件为mybatis的主配置文件(数据库连接参数及注册mapper接口配置文件)
<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://127.0.0.1:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
dataSource>
environment>
environments>
<mappers>
<mapper resource="com/ybjt/user/mapper/UserMapper.xml"/>
mappers>
configuration>
编写与数据库表对应的实体类
package com.ybjt.user.pojo;
import java.io.Serializable;
import java.util.Date;
/**
* @author zxh
* @create 2019-11-22 10:39
*/
public class User implements Serializable {
private static final long serialVersionUID = 8560630979196077356L;
private String id;
private String name;
private String address;
private Date time;
public User() {
}
public User(String id, String name, String address, Date time) {
this.id = id;
this.name = name;
this.address = address;
this.time = time;
}
public String getId() {
return id;
}
public void setId(String id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public Date getTime() {
return time;
}
public void setTime(Date time) {
this.time = time;
}
@Override
public String toString() {
return "User{" +
"id='" + id + '\'' +
", name='" + name + '\'' +
", address='" + address + '\'' +
", time=" + time +
'}';
}
}
编写与实体类对应的接口，定义数据库的操作。编写接口配置文件，定义详细的数据库操作。
package com.ybjt.user.mapper;
import com.ybjt.user.pojo.User;
import java.util.List;
/**
* @author zxh
* @create 2019-11-22 16:24
*/
public interface UserMapper {
List<User> selectUser();
}
<mapper namespace="com.ybjt.user.mapper.UserMapper">
<select id="selectUser" resultType="com.ybjt.user.pojo.User">
select * from mybatis.user
select>
mapper>
测试：
package com.ybjt.user;
import com.ybjt.user.mapper.UserMapper;
import com.ybjt.user.pojo.User;
import com.ybjt.utils.Mybatisutil;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.List;
/**
* @author zxh
* @create 2019-11-22 16:33
*/
public class UserDaoTest {
@Test
public void test(){
SqlSession sqlSession = Mybatisutil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> users = mapper.selectUser();
for(User u : users){
System.out.println(u);
}
sqlSession.close();
}
}
package com.ybjt.utils;
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;
/**
* @author zxh
* @create 2019-11-22 14:36
*/
public class Mybatisutil {
private static SqlSessionFactory sqlSessionFactory;
static{
try {
String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
注意：解决maven项目配置文件无法加载的问题
<build>
<resources>
<resource>
<directory>src/main/resourcesdirectory>
<includes>
<include>**/*.propertiesinclude>
<include>**/*.xmlinclude>
includes>
<filtering>truefiltering>
resource>
<resource>
<directory>src/main/javadirectory>
<includes>
<include>**/*.propertiesinclude>
<include>**/*.xmlinclude>
includes>
<filtering>truefiltering>
resource>
resources>
<plugins>
<plugin>
<groupId>org.apache.maven.pluginsgroupId>
<artifactId>maven-resources-pluginartifactId>
<version>2.6version>
<configuration>
<encoding>UTF-8encoding>
configuration>
plugin>
plugins>
build>
③ 增删改查
package com.ybjt.user.mapper;
import com.ybjt.user.pojo.User;
import java.util.List;
/**
* @author zxh
* @create 2019-11-22 16:24
*/
public interface UserMapper {
//查询全部用户
List<User> selectUser();
//根据id查询用户
User selectByID(int id);
//添加用户
int addUser(User user);
//修改用户的信息
void updateUser(User user);
//删除用户
void delectUserByID(int id);
}
<mapper namespace="com.ybjt.user.mapper.UserMapper">
<select id="selectUser" resultType="com.ybjt.user.pojo.User">
select * from mybatis.user
select>
<select id="selectByID" parameterType="int" resultType="com.ybjt.user.pojo.User" >
select * from mybatis.user where id = #{id};
select>
<insert id="addUser" parameterType="com.ybjt.user.pojo.User">
insert into mybatis.user(id,name,address,time) values(#{id},#{name},#{address},#{time});
insert>
<update id="updateUser" parameterType="com.ybjt.user.pojo.User" >
update mybatis.user set name = #{name},address = #{address},time=#{time} where id = #{id} ;
update>
<delete id="delectUserByID" parameterType="int" >
delete from mybatis.user where id = #{id};
delete>
mapper>
package com.ybjt.user;
import com.ybjt.user.mapper.UserMapper;
import com.ybjt.user.pojo.User;
import com.ybjt.utils.Mybatisutil;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;
import java.util.Date;
import java.util.List;
/**
* @author zxh
* @create 2019-11-22 16:33
*/
public class UserDaoTest {
@Test
public void test(){
SqlSession sqlSession = Mybatisutil.getSqlSession();
try {
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
List<User> users = mapper.selectUser();
for(User u : users){
System.out.println(u);
}
} catch (Exception e) {
e.printStackTrace();
}finally{
sqlSession.close();
}
}
@Test
public void test2(){
SqlSession sqlSession = Mybatisutil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
User user = mapper.selectByID(2);
System.out.println(user);
sqlSession.close();
}
@Test
public void test3(){
SqlSession sqlSession = Mybatisutil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
int num = mapper.addUser(new User("007","猪八戒","猪圈" ,new Date()));
System.out.println(num);
//增删改必须提交事务
sqlSession.commit();
sqlSession.close();
}
@Test
public void test4(){
SqlSession sqlSession = Mybatisutil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.updateUser(new User("007","猪八戒-天蓬元帅","猪圈-卷帘" ,new Date()));
sqlSession.commit();
sqlSession.close();
}
@Test
public void test5(){
SqlSession sqlSession = Mybatisutil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
mapper.delectUserByID(003);
sqlSession.commit();
sqlSession.close();
}
}
注意：增删改必须提交事务
二、使用细节
1、万能的Map
当数据库中字段或者对象的属性有很多时，可以使用map进行参数的传递：
Map传递参数，直接在sql中按key取出即可。
对象传递参数，直接在sql中取出对象的属性即可。
只有一个基本数据类型的情况下 ，可以在sql中直接取到。
多个参数的情况：后面学习
//根据姓名查询
User selectByName(Map map);
<select id="selectByName" parameterType="map" resultType="com.ybjt.user.pojo.User">
select * from user where name = #{name};
select>
@Test
public void test6(){
SqlSession sqlSession = Mybatisutil.getSqlSession();
UserMapper mapper = sqlSession.getMapper(UserMapper.class);
Map<String,String> map = new HashMap<String,String>();
map.put("name","张旭辉");
User user = mapper.selectByName(map);
System.out.println(user);
}
2、模糊查询
方式一：Java代码传递参数的时候拼接了通配符
方式二：在sql中嵌入通配符
使用中应避免sql注入的问题
3、配置解析
#### ①核心配置文件
mybatis-config.xml文件，MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
configuration（配置）
properties（属性）
settings（设置）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境配置）
environment（环境变量）
transactionManager（事务管理器）
dataSource（数据源）
databaseIdProvider（数据库厂商标识）
mappers（映射器）
②环境配置（environments）
MyBatis 可以配置成适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中。不过要记住：尽管可以配置多个环境，但每个 SqlSessionFactory 实例只能选择一种环境。使用default="development"绑定不同的数据源的ID，进行数据源的切换。
在 MyBatis 中有两种类型的事务管理器（也就是 type=”[JDBC|MANAGED]”），默认为JDBC;有三种内建的数据源类型（也就是 type=”[UNPOOLED|POOLED|JNDI]”），默认为POOLED。
③属性（properties）
可以通过properties属性来实现配置文件的引入，这些属性都是可外部配置且可动态替换的，既可以在典型的 Java 属性文件中配置，亦可通过 properties 元素的子元素来传递。然后其中的属性就可以在整个配置文件中被用来替换需要动态配置的属性值。
<properties resource="org/mybatis/example/config.properties">
<property name="username" value="dev_user"/>
<property name="password" value="F2Fa3!33TYyg"/>
properties>
可以直接引入外部文件；可以在其中增加一些属性配置；如果两个文件中有同一个字段，有限使用外部配置文件中的！
<configuration>
<properties resource="db.properties">properties>
<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="com/ybjt/user/mapper/UserMapper.xml"/>
mappers>
configuration>
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://127.0.0.1:3306/mybatis?useSSL=true&;useUnicode=true&;characterEncoding=UTF-8
username=root
password=root
④类型别名（typeAliases）
类型别名是为 Java 类型设置一个短的名字。 它只和 XML 配置有关，存在的意义仅在于用来减少类完全限定名的冗余。
<typeAliases>
<typeAlias type="com.ybjt.user.pojo.User" alias="User">typeAlias>
typeAliases>
<typeAliases>
<package name="com.ybjt.user.pojo"/>
typeAliases>
⑤设置（settings）
MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。
| 设置名 | 描述 |
|---|---|
| logImpl | 指定 MyBatis 所用日志的具体实现，未指定时将自动查找。 |
| lazyLoadingEnabled | 延迟加载的全局开关。当开启时，所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。 |
| cacheEnabled | 全局地开启或关闭配置文件中的所有映射器已经配置的任何缓存。 |
具体见： https://mybatis.org/mybatis-3/zh/configuration.html#settings 记住，是不可能记住的，用的时候来查就行了。
⑥映射器（mappers）
方式一：
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
<mapper resource="org/mybatis/builder/BlogMapper.xml"/>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
mappers>
方式二：
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
<mapper class="org.mybatis.builder.BlogMapper"/>
<mapper class="org.mybatis.builder.PostMapper"/>
mappers>
注意：
- 接口和它的mapper配置文件必须同名
- 接口和它的mapper配置文件必须在同一个包下
方式三：
<mappers>
<package name="org.mybatis.builder"/>
mappers>
注意：
- 接口和它的mapper配置文件必须同名
- 接口和它的mapper配置文件必须在同一个包下
⑥生命周期
SqlSessionFactoryBuilder
这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了。 因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域（也就是局部方法变量）。 你可以重用 SqlSessionFactoryBuilder 来创建多个 SqlSessionFactory 实例，但是最好还是不要让其一直存在，以保证所有的 XML 解析资源可以被释放给更重要的事情。
SqlSessionFactory
SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。 使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次，多次重建 SqlSessionFactory 被视为一种代码“坏味道（bad smell）”。因此 SqlSessionFactory 的最佳作用域是应用作用域。 有很多方法可以做到，最简单的就是使用单例模式或者静态单例模式。
SqlSession
每个线程都应该有它自己的 SqlSession 实例。SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。 绝对不能将 SqlSession 实例的引用放在一个类的静态域，甚至一个类的实例变量也不行。 也绝不能将 SqlSession 实例的引用放在任何类型的托管作用域中，比如 Servlet 框架中的 HttpSession。 如果你现在正在使用一种 Web 框架，要考虑 SqlSession 放在一个和 HTTP 请求对象相似的作用域中。 换句话说，每次收到的 HTTP 请求，就可以打开一个 SqlSession，返回一个响应，就关闭它。 这个关闭操作是很重要的，你应该把这个关闭操作放到 finally 块中以确保每次都能执行关闭。 下面的示例就是一个确保 SqlSession 关闭的标准模式：
try (SqlSession session = sqlSessionFactory.openSession()) {
// 你的应用逻辑代码
}
在你的所有的代码中一致地使用这种模式来保证所有数据库资源都能被正确地关闭。
映射器实例
映射器是一些由你创建的、绑定你映射的语句的接口。映射器接口的实例是从 SqlSession 中获得的。因此从技术层面讲，任何映射器实例的最大作用域是和请求它们的 SqlSession 相同的。尽管如此，映射器实例的最佳作用域是方法作用域。 也就是说，映射器实例应该在调用它们的方法中被请求，用过之后即可丢弃。 并不需要显式地关闭映射器实例，尽管在整个请求作用域保持映射器实例也不会有什么问题，但是你很快会发现，像 SqlSession 一样，在这个作用域上管理太多的资源的话会难于控制。 为了避免这种复杂性，最好把映射器放在方法作用域内。下面的示例就展示了这个实践：
try (SqlSession session = sqlSessionFactory.openSession()) {
BlogMapper mapper = session.getMapper(BlogMapper.class);
// 你的应用逻辑代码
}
4、resultMap结果集映射
解决属性名和字段名不一致的问题，导致不一致的字段查不出结果。
方式一：在sql中设置别名
<select id="selectUser" resultType="User">
select id,name as names,address,time from user
select>
方式二：自定义结果集映射
<resultMap id="UserMap" type="User">
<result column="name" property="names">result>
resultMap>
<select id="selectUser" resultMap="UserMap">
select * from user
select>
高级应用：一对一、一对多、多对多
5、日志工厂
标准的日志实现，不用导任何东西，配置即可。
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
settings>
LOG4J 日志实现：
Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件，甚至是套接口服务器、NT的事件记录器、UNIX Syslog守护进程等；我们也可以控制每一条日志的输出格式；通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程。最令人感兴趣的就是，这些可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。
导入LOG4J的jar包；编写logj.properties配置文件；修改settings设置。
### 设置###
log4j.rootLogger = debug,stdout,D,E
### 输出信息到控制抬 ###
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target = System.out
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
### 输出DEBUG 级别以上的日志到=E://logs/error.log ###
log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
log4j.appender.D.File = E://logs/log.log
log4j.appender.D.Append = true
log4j.appender.D.Threshold = DEBUG
log4j.appender.D.layout = org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
### 输出ERROR 级别以上的日志到=E://logs/error.log ###
log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
log4j.appender.E.File =E://logs/error.log
log4j.appender.E.Append = true
log4j.appender.E.Threshold = ERROR
log4j.appender.E.layout = org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss} [ %t:%r ] - [ %p ] %m%n
<settings>
<setting name="logImpl" value="LOG4J"/>
settings>
自定义简单使用：
//import org.apache.log4j.Logger;
Logger logger = Logger.getLogger(UserTest.class);
logger.info("详细信息输出");
6、limit实现分页
方式一：limit
select * from user limit startIndex,pageSize;
方式二：rowBounds
方式三：分页插件pageHelper
7、使用注解开发
在简单sql，使用注解发开。复杂sql不建议使用，开发中使用xml注册的方式，同一格式。
注解实现CRUD:
8、mybatis详细执行流程
- 返回创建SqlSessionFactory对象
- 返回SqlSession的实现类DefaultSqlSession对象
- 返回一个MapperProxy的代理对象
- 执行询流程。
9、多对一、一对多
<mapper namespace="com.ybjt.user.mapper.UserMapper">
<select id="selectUser" resultType="User">
select * from user;
select>
<resultMap id="myMap" type="User">
<id property="id" column="uid">id>
<result property="name" column="uname">result>
<result property="address" column="uaddress">result>
<result property="time" column="utime">result>
<association property="teacher" javaType="Teacher">
<result property="tname" column="tname">result>
<result property="tid" column="tid">result>
association>
resultMap>
<select id="selectUserAndTeacher" resultMap="myMap">
select u.id uid,u.name uname,u.address uaddress,u.time utime,t.tname tname,t.tid tid from user u ,teacher t where u.tid = t.tid;
select>
mapper>
<resultMap id="myResultMap" type="Teacher">
<result column="tid" property="tid">result>
<result column="tname" property="tname">result>
<collection property="list" javaType="List" ofType="User" autoMapping="true">
<result column="uid" property="id">result>
<result column="uname" property="name">result>
<result column="uaddress" property="address">result>
<result column="utime" property="time">result>
collection>
resultMap>
<select id="getTeacherAndUser" resultMap="myResultMap" >
select t.tid tid,t.tname tname,u.id uid,u.name uname,u.address uaddress,u.time utime from teacher t,user u where t.tid = u.tid and t.tid = #{tid};
select>
10、动态sql
MyBatis 的强大特性之一便是它的动态 SQL。如果你有使用 JDBC 或其它类似框架的经验，你就能体会到根据不同条件拼接 SQL 语句的痛苦。例如拼接时要确保不能忘记添加必要的空格，还要注意去掉列表最后一个列名的逗号。利用动态 SQL 这一特性可以彻底摆脱这种痛苦。
- if
- choose (when, otherwise)
- trim (where, set)
- foreach
11、缓存
在mybatis中，一级缓存默认是开启的，并且一直无法关闭
一级缓存满足条件：
1、同一个session中
2、相同的SQL和参数
使用：sqlSession.clearCache();可以强制清除缓存 ， 执行update、insert、delete的时候，会清空缓存 。
mybatis 的二级缓存的作用域是一个mapper的namespace ，同一个namespace中查询sql可以从缓存中命中。 开启二级缓存，必须序列化实体类。
<mapper namespace="com.zpc.mybatis.dao.UserMapper">
<cache/>
mapper>
12、自定义缓存
ehcache 意义不大，了解即可！
参考博客： https://blog.csdn.net/hellozpc/article/details/80878563#13_2031