[simple-orm-mybaits]基於Mybatis的ORM封裝介紹

由 admin · 已發表 2019-10-02 · 已更新 2019-10-02

前言
ORM框架現狀
Mybatis優缺點
simple-orm-mybatis設計思路介紹
simple-orm-mybatis使用說明
simple-orm-mybatis實際使用
推薦最佳實踐
更多說明

simple-orm-mybatis在github開源，直接跳轉查看，歡迎大家fork和star。有什麼建議也可以提出，我會儘快修復或實現。

前言

最早接觸Java的web開發框架就是SSH，其中的H就是Hibernate。Hibernate作為最出名的Java的ORM框架，現在的版本已經到了5.3.10.Final，6.0.0.Alpha2。圍繞數據持久化或者DAL層也發展了多種工具，Hibernate Validator目前也是在很多的企業框架中被用作數據有效性檢查。
接下來還有用過JPA來實現ORM。JPA全稱Java Persistence API，是JSR-220（EJB3.0）規範的一部分，在JSR-220中規定實體對象（EntityBean）由JPA進行支持。在我的使用中，實際上底層實現仍然使用了Hibernate，只是標註或者操作類都是使用了JPA的接口標準而沒有直接使用Hibernate。
Hibernate具有強大的ORM封裝能力，極大的簡化了CUD的操作，而且無需做太多的配置，使用標準註解就能解決很多問題。簡單的查詢操作也不在話下，多級關聯、延遲查詢等豐富特性基本上也可以說是極大覆蓋了開發過程的各種需求。但是實際上在這麼多團隊中，很多人的反饋是這樣的：“Hibernate的ORM確實很方便，但是在一些特殊條件下很難用，比如複雜查詢就很難控制語句生成的效率”。Hibernate有三種查詢方式：HQL、Criteria、Native Sql。確實在複雜查詢下，如果使用Criteria，確實能夠拼出想要的語句，但是可能對於其中的方法要非常熟悉，學習曲線很高，沒辦法做到團隊中每個成員都能數量輕易的掌握，而且後期的審核很困難無法直接看清邏輯。HQL和NativeSql對我的感覺，似乎回到了JSP時代，HTML和Java代碼混寫，很難忍受。這時候大家找到了另外的框架Mybatis。

ORM框架現狀

截止（2019/5/27）Mybatis的Star是10806，UsedBy140381；Hibernate的Star是3817，UsedBy157879。看使用量Hibernate和Mybatis其實已經差不多了，實際企業開發中，Mybatis可能還會更多一些。

Mybatis優缺點

Mybatis放棄了Hibernate的強封裝，主要包含了映射的部分，而且放棄了自動解析生成Sql，而直接使用用戶XML配置Sql的方式，只是在Sql的拼接上提供了一些標籤來避免重複代碼。這樣的討巧之處在於：

門檻降低：開發人員不需要了解框架的內部語法，只需要了解Sql語法即可。
可讀性提高：審核代碼時，很容易的就能看清楚多級關聯以及關聯使用的條件、語法是否正確。
維護方便：當查詢語法出錯時，Mybatis只需要修改XML，而Hibernate則需要修改代碼重新編譯，操作相對複雜。

缺點也有幾處：

簡單操作複雜：由於放棄了自動解析生成Sql，所以普通的CUD也需要手動編寫Sql
實體映射複雜：必須在XML文件中配置大量的字段映射
SqlMapper中的sql id風險：由於XML中的sql id是一個字符串，只能複製粘貼出來，所以出錯的幾率也比較大。

實際上，針對上面缺點，Mybatis也提供了解決方案。
先說sql id的，在新的Mybatis中，實際上已經採用了面向接口的編碼方式，如下面的例子：

接口類

public interface UserMapper {
    public User findUserById(Integer id);
}

mapper的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" >
<mapper namespace="com.software5000.mapper.dao.UserMapper">
    <select id="findUserById" resultType="com.software5000.entity.User" parameterType="int" >
        select * from user where id =#{id}
    </select>
</mapper>

這樣就可以直接調用sql語句：

UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
User user = userMapper.findUserById(1);

再說映射複雜的，Mybatis提供了MyBatis Generator作為解決方案，一個命令生成下列內容：

匹配表結構的Java POJOs。可能包括：
- 表結構中主鍵字段（如果存在主鍵）
- 表結構中的非主鍵字段（除了BLOB字段）
- 表結構中的BLOB字段（如果有BLOB字段）
- 動態查詢、更新和刪除的接口類

自動生成也能夠合理的生成類之間的繼承關係。注意生成器也能夠定義生產不同的POJO層次 – 例如如果你想要可以為每個表格生成一個單獨的領域對象。

Mybatis/iBATIS兼容的SQL MAP的XML文件。按照配置針對每個表生成簡單的增刪改查的SQL方法。生成的SQL包括：
- 插入
- 按主鍵更新
- 使用example更新 (使用動態的where條件)
- 按主鍵刪除
- 使用example刪除 (使用動態的where條件)
- 按主鍵查詢
- 使用example查詢 (使用動態的where條件)
- 使用example統計

生成的SQL語句取決於表格的結構（例如，表格如果沒有主鍵，就不會生成按主鍵更新的方法）

Java客戶端生成類能夠合理使用上面的對象。生成的Java客戶端類也是有選擇性的。

使用Mybatis 3.x的會生成：
- 一個mapper接口和XML中的語句id相同，用於直接調用。
使用iBATIS 2.x的會生成：
- 適用於Spring框架的DAO層
- 使用IBATIS SQL映射API的DAO層。這些DAO可以使用兩種方式：使用構造函數提供SqlMapClient，或者通過注入方式提供。
- DAOs that conform to the iBATIS DAO Framework (an optional part of iBATIS, this framework is now deprecated and we suggest that you use the Spring framework instead)
- iBATIS的DAO框架符合的DAO層（iBATIS的一個額外部分，但是現在這個框架已經失效了，所以建議使用Spring DAO的框架代替）

但是，我對於MyBatis Generator的態度是堅定的反對。原因是我認為自動生成違反了簡單的原則，“如無必要，勿增實體”。自動生成的可復用性和可讀性一定是比較差的。我覺得最好的代碼就是不存在的代碼。因此我希望能夠有一個簡單框架在Mybatis之上，接入簡單無侵入，能夠提供基本的增刪改查方法。這就是下面的 simple-orm-mybatis 。

simple-orm-mybatis設計思路介紹

simple-orm-mybatis設計的初衷就是希望提供一個簡單無侵入，而且無需編寫或者生成任何代碼就可以使用直接操作對象的方式來進行增刪改查的操作。要實現這樣的要求，主要是兩個主要技術點：

利用反射機制對應實體對象與數據庫結構
解析對象並且生成對應操作的SQL語句

第一點核心就是反射，設計要點如下：

Java對象與數據庫結構的對應規則
虛字段（無數據庫對應字段）的處理
考慮多層繼承的對象解析
值的設置與獲取方式

第二點核心在於SQL解析，設計要點如下：

根據不同入口區分基本CRUD語法結構
字段（列名）需要分為值字段與查詢字段兩類
更新操作的時候，Null，空，有值的區分
支持多種匹配操作符（大於、小於、Like等）

simple-orm-mybatis使用說明

首先引入依賴，項目已經發布在Maven Central上，可以直接引入。

<dependency>
    <groupId>com.software5000</groupId>
    <artifactId>simple-orm-mybatis</artifactId>
    <version>1.0.2</version>
</dependency>

接着需要將 BaseDaoMapper.xml文件放在你的 mapper 的掃描文件夾內。
最後需要在你的代碼中添加一個 BaseDao 實現類，用於提供數據庫操作服務（注意：需要在spring的掃描包內，因為需要注入某些屬性），整個複製即可，類名可以改為你自己需要的名字

import com.software5000.base.BaseDao;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.mybatis.spring.SqlSessionTemplate;
import org.springframework.stereotype.Component;

import javax.annotation.Resource;

/**
 * 整個類以 <code>org.mybatis:mybatis-spring:2.0.0</code> 的 <code>org.mybatis.spring.supportSqlSessionDaoSupport</code>
 * 為參考編寫而成
 */
@Component
public class MyBaseDao extends BaseDao {
    private SqlSessionTemplate sqlSessionTemplate;
    
    public MyBaseDao() {
            // 在默認構造函數中設置 數據庫是否蛇形， 數據庫格式大小寫， 通用忽略的字段名稱
            this.initConfig(true,false,"serialVersionUID");
    }
        
    @Resource
    public void setSqlSessionFactory(SqlSessionFactory sqlSessionFactory) {
        if (this.sqlSessionTemplate == null || sqlSessionFactory != this.sqlSessionTemplate.getSqlSessionFactory()) {
            this.sqlSessionTemplate = this.createSqlSessionTemplate(sqlSessionFactory);
        }
    }

    protected SqlSessionTemplate createSqlSessionTemplate(SqlSessionFactory sqlSessionFactory) {
        return new SqlSessionTemplate(sqlSessionFactory);
    }

    @Override
    public SqlSession getSqlSession() {
        return this.sqlSessionTemplate;
    }
}

simple-orm-mybatis實際使用

這裏給了一個單元測試的例子，實際一般是在service層直接使用，無需添加任何代碼。
示例中的 DailyRecord是一個普通實體類，沒有任何繼承。

// 獲取啟動類，加載配置，確定裝載 Spring 程序的裝載方法，它回去尋找 主配置啟動類（被 @SpringBootApplication 註解的）
@SpringBootTest
// 讓 JUnit 運行 Spring 的測試環境， 獲得 Spring 環境的上下文的支持
@RunWith(SpringRunner.class)
public class BaseDaoTest {

    @Autowired
    private MyBaseDao myBaseDao;

    @Test
    public void testBaseDao(){
        DailyRecord dailyRecord = new DailyRecord();
        List<DailyRecord> dailyRecords = myBaseDao.selectEntity(dailyRecord);
        System.out.println(dailyRecords.size());
    }
}

基本類型	默認值
byte	0
short	0
int	0
long	0L
float	0.0f
double	0.0d
char	‘\u0000’
boolean	false

[simple-orm-mybaits]基於Mybatis的ORM封裝介紹

前言

ORM框架現狀

Mybatis優缺點

simple-orm-mybatis設計思路介紹

simple-orm-mybatis使用說明

simple-orm-mybatis實際使用

推薦最佳實踐

更多說明

您可能也會喜歡…

近期文章

分類

彙整

[simple-orm-mybaits]基於Mybatis的ORM封裝介紹

前言

ORM框架現狀

Mybatis優缺點

simple-orm-mybatis設計思路介紹

simple-orm-mybatis使用說明

simple-orm-mybatis實際使用

推薦最佳實踐

更多說明

您可能也會喜歡…

特斯拉拼了：中國車主貸款購車3年後可享50%回購

Chrome OS 80 將可以直接構建 Android 應用

MacBook Air M2 通過 NCC 認證，預計近期將在台開賣

近期文章

標籤

分類

彙整