Mybatis詳解
- 2021 年 3 月 6 日
- 筆記
1. Mybatis介紹
1.1什麼是Mybatis
- Mybatis是是一款優秀的持久層框架。
- 它支持定製SQL,存儲過程和高級映射。
- Mybatis幾乎避免了所有的JDBC代碼和手動設置參數已經獲取結果集。
- Mybatis可以用簡單的xml或註解來配置和映射原生信息,將接口和 Java 的 POJOs(Plain Ordinary Java Object,普通的 Java對象)映射成數據庫中的記錄。
1.2 Mybatis的優點
- 簡單易學:本身就很小且簡單。沒有任何第三方依賴,最簡單安裝只要兩個jar文件+配置幾個sql映射文件易於學習,易於使用,通過文檔和源代碼,可以比較完全的掌握它的設計思路和實現。
- 靈活:mybatis不會對應用程序或者數據庫的現有設計強加任何影響。 sql寫在xml里,便於統一管理和優化。通過sql語句可以滿足操作數據庫的所有需求。
- 解除sql與程序代碼的耦合:通過提供DAO層,將業務邏輯和數據訪問邏輯分離,使系統的設計更清晰,更易維護,更易單元測試。sql和代碼的分離,提高了可維護性。
- 提供映射標籤,支持對象與數據庫的orm字段關係映射
- 提供對象關係映射標籤,支持對象關係組建維護
- 提供xml標籤,支持編寫動態sql。
1.3 Mybatis的執行流程
1.4如何獲得Mybatis
- maven倉庫
- Github
1.5 為什麼要使用Mybatis
- 幫助程序員把數據存入數據庫中
- 因為懶:傳統的JDBC代碼太複雜,於是就有了Mybatis,它可以使代碼更加的簡化。
- 方便:作為一個框架,條條框框已經幫我們約定好,我們只需要往裏面填自己需要的東西即可
2.我的第一個mybatis程序
2.1 搭建環境
2.1.1 搭建數據庫
2.1.2 新建一個項目
- 新建一個普通maven項目
- 刪除src目錄
- 導入maven依賴
<dependencies>
<!--servlet依賴-->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
</dependency>
<!--jsp依賴-->
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>javax.servlet.jsp-api</artifactId>
<version>2.3.3</version>
</dependency>
<!--mybatis依賴-->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.5</version>
</dependency>
<!--mysql依賴-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.22</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13</version>
<scope>test</scope>
</dependency>
</dependencies>
2.1.3 新建一個模塊
- 編寫mybatis核心配置文件
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"//mybatis.org/dtd/mybatis-3-config.dtd">
<!--configuration核心配置文件-->
<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工具類
package com.lee.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;
public class mybatisUtils {
//第一步:使用mybatis獲取sqlsessionfactory對象
private static SqlSessionFactory sqlSessionFactory;
static {
try {
String resource = "mybatis-config.xml";
InputStream inputstream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputstream);
} catch (IOException e) {
e.printStackTrace();
}
}
//第二步:既然有了 SqlSessionFactory,顧名思義,我們可以從中獲得 SqlSession 的實例。
// SqlSession 提供了在數據庫執行 SQL 命令所需的所有方法。
public static SqlSession getSqlsession()
{
return sqlSessionFactory.openSession();
}
}
- 編寫代碼
- 實體類
package com.lee.pojo;
public class User {
public User(int id, String name, String pwd) {
this.id = id;
this.name = name;
this.pwd = pwd;
}
private int id;
private String name;
private String pwd;
public int getId() {
return id;
}
public String getName() {
return name;
}
public String getPwd() {
return pwd;
}
public void setId(int id) {
this.id = id;
}
public void setName(String name) {
this.name = name;
}
public void setPwd(String pwd) {
this.pwd = pwd;
}
}
-
Dao接口
-
接口實現類
2.1.4 測試
注意點:錯誤Type interface com.lee.dao.UserMapper is not known to the MapperRegistry.
- 需要把Mapper接口放到資源文件
3.配置解析
3.1 核心配置文件
- mybatis-config.xml
- mybatis的配置文件包含了會深深影響mybatis行為的設置和屬性的信息。
3.1.1 配置環境(environments)
- MyBatis 可以配置成適應多種環境,這種機制有助於將 SQL 映射應用於多種數據庫之中, 現實情況下有多種理由需要這麼做。例如,開發、測試和生產環境需要有不同的配置;或者共享相同 Schema 的多個生產數據庫, 想使用相同的 SQL 映射。許多類似的用例。
- 不過要記住:儘管可以配置多個環境,每個 SqlSessionFactory 實例只能選擇其一。
<environments default="development"> <!--默認選擇的ID-->
<environment id="development">
<transactionManager type="JDBC"> <!--mybatis默認事務管理器-JDBC-->
<property name="..." value="..."/>
</transactionManager>
<dataSource type="POOLED"> <!--mybatis默認數據源-POOLED-->
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
3.1.2 屬性(properties)
- 我們可以通過properties屬性來實現引用配置文件
- 編寫一個配置文件
3.1.3 類型別名(typeAliases)
- 類型別名是為 Java 類型設置一個短的名字。它只和 XML 配置有關,存在的意義僅在於用來減少類完全限定名的冗餘。
例如:
<typeAliases>
<typeAlias alias="Author" type="domain.blog.Author"/>
<typeAlias alias="Blog" type="domain.blog.Blog"/>
<typeAlias alias="Comment" type="domain.blog.Comment"/>
<typeAlias alias="Post" type="domain.blog.Post"/>
<typeAlias alias="Section" type="domain.blog.Section"/>
<typeAlias alias="Tag" type="domain.blog.Tag"/>
</typeAliases>
- 也可以指定一個包名,MyBatis 會在包名下面搜索需要的 Java Bean;每一個在包中的 Java Bean,在沒有註解的情況下,會使用 Bean 的首字母小寫的非限定類名來作為它的別名。比如 domain.blog.Author 的別名為 author.
例如:
<typeAliases>
<package name="domain.blog"/>
</typeAliases>
3.1.4 設置(settings)
目前只需要挑重點記憶
一個配置完整的 settings 元素的示例如下:
<settings>
<setting name="cacheEnabled" value="true"/>
<setting name="lazyLoadingEnabled" value="true"/>
<setting name="multipleResultSetsEnabled" value="true"/>
<setting name="useColumnLabel" value="true"/>
<setting name="useGeneratedKeys" value="false"/>
<setting name="autoMappingBehavior" value="PARTIAL"/>
<setting name="defaultExecutorType" value="SIMPLE"/>
<setting name="defaultStatementTimeout" value="25"/>
<setting name="safeRowBoundsEnabled" value="false"/>
<setting name="mapUnderscoreToCamelCase" value="false"/>
<setting name="localCacheScope" value="SESSION"/>
<setting name="jdbcTypeForNull" value="OTHER"/>
<setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>
4.生命周期和作用域
理解我們之前討論過的不同作用域和生命周期類別是至關重要的,因為錯誤的使用會導致非常嚴重的並發問題。
SqlSessionFactoryBuilder
- 這個類可以被實例化、使用和丟棄,一旦創建了 SqlSessionFactory,就不再需要它了。
- 因此 SqlSessionFactoryBuilder 實例的最佳作用域是方法作用域(也就是局部方法變量)。
SqlSessionFactory
- 說白了可以想像成數據庫連接池
- SqlSessionFactory 一旦被創建就應該在應用的運行期間一直存在,沒有任何理由丟棄它或重新創建另一個實例。
- 使用 SqlSessionFactory 的最佳實踐是在應用運行期間不要重複創建多次,多次重建 SqlSessionFactory 被視為一種代碼「壞習慣」。因此 SqlSessionFactory 的最佳作用域是應用作用域。
SqlSession - 可以理解為連接到連接池的請求
- 每個線程都應該有它自己的 SqlSession 實例。SqlSession 的實例不是線程安全的,因此是不能被共享的,所以它的最佳的作用域是請求或方法作用域。
5. 解決字段名和屬性名不一致的辦法
5.1 起別名
5.2 result Map(結果集映射)
- resultMap 元素是 MyBatis 中最重要最強大的元素。
- ResultMap 的設計就是簡單語句不需要明確的結果映射,而很多複雜語句確實需要描述它們 的關係。
- ResultMap 最優秀的地方你已經了解了很多了,但是你還沒有真正的看到一個。
- 如果世界總是那麼簡單就好了!!!
6.日誌
如果一個數據庫操作出現了異常,我們需要拍錯,日誌就是最好的幫手。
- SLF4J
- LOG4J 《掌握》
- LOG4J2
- JDK_LOGGING
- COMMONS_LOGGING
- STDOUT_LOGGING《掌握》
- NO_LOGGING
6.1 STDOUT_LOGGING標準日誌輸出
6.2 LOG4J
6.2.1 什麼是LOG4J
- Log4j是Apache的一個開源項目,通過使用Log4j,我們可以控制日誌信息輸送的目的地是控制台、文件、GUI組件
- 我們也可以控制每一條日誌的輸出格式
- 通過定義每一條日誌信息的級別,我們能夠更加細緻地控制日誌的生成過程
- 最令人感興趣的就是,這些可以通過一個配置文件來靈活地進行配置,而不需要修改應用的代碼
6.2.2 使用LOG4J
- 導入log4j的包
<dependencies>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.12</version>
</dependency>
</dependencies>
- 配置log4j.properties
#將等級為DEBUG的日誌信息輸出到console和file這兩個目的地,console和file的定義在下面的代碼
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/lee.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
#日誌輸出級別
log4j.logger.org.mybatis=DEBUG
log4j.logger.java.sql=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.ResultSet=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG
- 配置log4j為日誌實現
<settings>
<setting name="logImpl"value="LOG4J"/>
</settings>
- 使用log4j
- 在使用LOG4J的類中導入包
- 生成日誌對象,參數為當前類的class
7. 分頁
為什麼要分頁?
- 減少數據處理量
7.1 使用limit分頁
7.1.1語法
select * from user startindex,pageSize
7.1.2 使用mybatis實現分頁
-
接口
-
Mapper.xml配置文件
-
測試
8. Mybatis執行流程剖析
9. Lombok
9.1 使用步驟
- 在idea中安裝Lombok插件
- 導入Maven依賴
9.2 作用
- Project Lombok is a java library that automatically plugs into your editor and build tools, spicing up your java.
Never write another getter or equals method again, with one annotation your class has a fully featured builder, Automate your logging variables, and much more. - 使用註解,簡化操作
9.3註解的使用
-
@Getter/@Setter: 作用類上,生成所有成員變量的getter/setter方法;作用於成員變量上,生成該成員變量的getter/setter方法。可以設定訪問權限及是否懶加載等。
-
@Getter @Setter private boolean funny;
-
@ToString:作用於類,覆蓋默認的toString()方法,可以通過of屬性限定顯示某些字段,通過exclude屬性排除某些字段。
-
@EqualsAndHashCode:作用於類,覆蓋默認的equals和hashCode
-
@NonNull:主要作用於成員變量和參數中,標識不能為空,否則拋出空指針異常。
-
@NoArgsConstructor, @RequiredArgsConstructor, @AllArgsConstructor:作用於類上,用於生成構造函數。有staticName、access等屬性。
staticName屬性一旦設定,將採用靜態方法的方式生成實例,access屬性可以限定訪問權限。 -
@NoArgsConstructor:生成無參構造器;
-
@RequiredArgsConstructor:生成包含final和@NonNull註解的成員變量的構造器;
-
@AllArgsConstructor:生成全參構造器
-
@Data:作用於類上,是以下注解的集合:@ToString
-
@EqualsAndHashCode @Getter @Setter
-
@RequiredArgsConstructor
-
@Builder:作用於類上,將類轉變為建造者模式
-
@Log:作用於類上,生成日誌變量。針對不同的日誌實現產品,有不同的註解:
10.複雜查詢處理
10.1 多對一的處理
- 按照查詢嵌套處理
<!--
思路:按照查詢嵌套處理
1.查詢所以學生信息
2.根據查詢出來的學生tid查詢對應的老師!子查詢
-->
<select id="getStudent" resultMap="Student">
select * from mybatis.student;
</select>
<resultMap id="Student" type="Student">
<result property="id" column="id"/>
<result property="name" column="name"/>
<association property="teacher" column="tid" javaType="Teacher" select="getTeacher"/>
</resultMap>
<select id="getTeacher" resultType="Teacher">
select * from teacher where id=#{id};
</select>
- 按照結果嵌套處理
<!--2
思路:按照結果嵌套處理
-->
<select id="getStudent" resultMap="Student">
select s.id sid,s.name sname,t.name tname
from student s,teacher t
where s.tid=t.id;
</select>
<resultMap id="Student" type="Student">
<result property="id" column="sid"/>
<result property="name" column="sname"/>
<association property="teacher" javaType="Teacher">
<result property="name" column="tname"/>
</association>
</resultMap>
10.2 一對多處理
- 按照結果嵌套處理
<select id="getTeacher" resultMap="Teacher">
select s.id sid,s.name sname,s.tid stid,t.id tid,t.name tname
from student s,teacher t
where s.tid=t.id and t.id=#{tid};
</select>
<resultMap id="Teacher" type="Teacher">
<result property="id" column="tid"/>
<result property="name" column="tname"/>
<collection property="students" ofType="Student">
<result property="id" column="sid"/>
<result property="name" column="sname"/>
<result property="tid" column="tid"/>
</collection>
</resultMap>
小結
- 關聯–association 【多對一】
- 集合–collection 【一對多】
3.Javatype–用來指定實體類中屬性類型
4.oftype–用來指定映射到List或者集合中的pojo類型
11.動態SQL
什麼是動態SQL?
- 根據不同的的條件生成不同的SQL
11.1 搭建環境
- 創建表
CREATE TABLE `blog`(
`id` VARCHAR(50) NOT NULL COMMENT '博客id',
`title` VARCHAR(100) NOT NULL COMMENT '博客標題',
`author` VARCHAR(30) NOT NULL COMMENT '博客作者',
`create_time` DATETIME NOT NULL COMMENT '創建時間',
`views` INT(30) NOT NULL COMMENT '瀏覽量'
)ENGINE=INNODB DEFAULT CHARSET=utf8
- 創建一個基礎工程
- 編寫核心配置文件–mybatis-config.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"//mybatis.org/dtd/mybatis-3-config.dtd">
<!--configuration核心配置文件-->
<configuration>
<!--引入外部配置文件-->
<properties resource="db.properties"/>
<settings>
<setting name="logImpl" value="STDOUT_LOGGING"/>
</settings>
<typeAliases>
<typeAlias type="com.lee.pojo.Teacher" alias="Teacher"/>
<typeAlias type="com.lee.pojo.Student" alias="Student"/>
</typeAliases>
<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="StudentMapper.xml"/>
<mapper resource="TeacherMapper.xml"/>
</mappers>
</configuration>
- 編寫工具類–utils.java
package com.lee.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;
public class Utils {
private static SqlSessionFactory sqlSessionFactory;
static{
String resource = "mybatis-config.xml";
try {
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
} catch (IOException e) {
e.printStackTrace();
}
}
public static SqlSession getSqlSession(){
return sqlSessionFactory.openSession();
}
}
- 編寫實體類
package com.lee.pojo;
import java.util.Date;
public class Blog {
private String id;
private String title;
private String author;
private Date createTime;
private int views;
}
- 編寫實體類對應的Mapper接口和Mapper.xml實現文件
11.2 動態SQL之if語句
動態 SQL 通常要做的事情是有條件地包含 where 子句的一部分。比如:
<select id="getBlogIF" parameterType="map" resultType="Blog">
select * from mybatis.blog
where 1=1
<if test="title != null">
and title=#{title}
</if>
</select> <!--if語句-->
這條語句提供了一個可選的文本查找類型的功能。如果沒有傳入”title”,那麼所有處於”ACTIVE”狀態的BLOG都會返回;反之若傳入了”title”,那麼就會把模糊查找”title”內容的BLOG結果返回(就這個例子而言,細心的讀者會發現其中的參數值是可以包含一些掩碼或通配符的)。
11.3 動態SQL之where語句
where 元素知道只有在一個以上的if條件有值的情況下才去插入”WHERE”子句。而且,若最後的內容是”AND”或”OR”開頭的,where 元素也知道如何將他們去除。
也就是說如果有如果一個以上的if條件有值的情況下,它不會去除”AND”或”OR”,如果如果有多個if語句,但只有第一個語句有值的情況下,它將會省略後面的”AND”或”OR”,這樣則避免了後面if語句因為沒有值而出錯的可能。
<where>
<if test="title != null">
title=#{title}
</if>
<if test="author != null">
and author = #{author}
</if>
</where>
11.4 動態SQL之choose,when語句
有些時候,我們不想用到所有的條件語句,而只想從中擇其一二。針對這種情況,MyBatis 提供了 choose 元素,它有點像 Java 中的 switch 語句。
還是上面的例子,但是這次變為提供了”title”就按”title”查找,提供了”author”就按”author”查找,若兩者都沒有提供,就返回所有符合條件的BLOG(實際情況可能是由管理員按一定策略選出BLOG列表,而不是返回大量無意義的隨機結果)。
<select id="getBlogIF" parameterType="map" resultType="Blog">
select * from mybatis.blog
<where>
<choose>
<when test="title!=null">
title=#{title}
</when>
<when test="author != null">
author = #{author}
</when>
<when test="views !=null">
views = #{views}
</when>
</choose>
</where>
</select>
11.5 SQL片段
有時候我們可能需要將一些公共的部分抽取出來,方便復用
- 使用SQL標籤抽取公共的部分
<sql id="sql_when">
<choose>
<when test="title!=null">
title=#{title}
</when>
<when test="author != null">
author = #{author}
</when>
<when test="views !=null">
views = #{views}
</when>
</choose>
</sql>
2 在需要的地方使用include標籤進行插入
select * from mybatis.blog
<where>
<include refid="sql_when"/>
</where>
</select>
注意:最好基於單表定義SQL片段
11.6 動態SQL之Foreach標籤
foreach 元素的功能是非常強大的,它允許你指定一個集合,聲明可以用在元素體內的集合項和索引變量。它也允許你指定開閉匹配的字符串以及在迭代中間放置分隔符。這個元素是很智能的,因此它不會偶然地附加多餘的分隔符。
<select id="queryBlogForeach" parameterType="map" resultType="Blog">
select * from mybatis.blog
where id in
<foreach collection="ids" item="id" open="(" close=")" separator=",">
#{id}
</foreach>
</select>
12. 緩存
12.1 什麼是緩存
- 存在內存當中的臨時數據
- 將用戶經常查詢的數據放到緩存當中,當用戶去查詢數據的時候就不用從磁盤(關係型數據庫數據文件)中查詢,從緩存當中查詢,從而提高了查詢效率,解決了高並發系統問題。
12.2 為什麼使用緩存
- 減少和數據庫交互的次數,減少系統開銷,提高系統效率。
12.3 什麼樣的數據能使用緩存
- 經常使用且不常改變的數據。
12.4 一級緩存
12.4.1 生命周期
- 從sqlsession的開始到結束
12.4.2 實例
SqlSession sqlSession = Utils.getSqlSession();
BlogMapper mapper = sqlSession.getMapper(BlogMapper.class);
Blog blog1=mapper.getBlog(1);
System.out.println(blog1);
Blog blog2=mapper.getBlog(1);
System.out.println(blog2);
sqlSession.close();
結果: 查詢相同數據兩次只連接了一次數據庫。第二次查詢是從緩存當中查詢。可以分析日誌的到。
12.4.3 緩存失效的情況
- 查詢不同的東西
- 增刪改操作可能會改變原來的緩存,所以必定會刷新緩存。
- 在不同的Mapper.xml中查詢
- 手動清理緩存
小結:一級緩存默認是開啟的,只在一次sqlsession中有效,也就是拿到連接到關閉連接!
12.5 二級緩存
12.5.1 概念
二級緩存也叫全局緩存,因為一級緩存作用域太低了,所以就有了二級緩存,它是基於namespace級別的緩存,一個名稱空間對應一個二級緩存。
12.5.2 工作機制
- 一個會話查詢一個數據,那這個數據就會被放到會話的一級緩存當中。
- 如果當前會話關閉了,那這個會話對應的一級緩存就沒了,但是一級緩存當中的數據會被保存到二級緩存中。
- 新的會話查詢信息就可以從二級緩存中獲取內容
- 不同的mapper查處的信息會放到自己對應的緩存當中
12.5.3 步驟
- 開啟全局緩存
- 在需要使用二級緩存的Mapper中開啟
- 測試