MyBatis還是JPA?終于有答案了

更新時間：2020年10月12日 10:30:44 作者：猿邏輯

這篇文章主要介紹了MyBatis還是JPA,中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧

對于一個和數據庫打交道的程序員來說，很快會面臨著一個艱難的選擇。到底是選擇MyBatis還是JPA呢？

很多人說，技術選擇，都要根據需求來，這個沒錯。但是，除了需求，還有很重要的一個環(huán)節(jié)，那就是隊友的水平。如果你選擇了一些比較高級的技術，那么就是在給整個團隊埋坑。

JPA的抽象層次更高，代碼寫起來也更簡潔，但是它一點都不簡單。雖然經過了多次的培訓，我呆過的幾個團隊，還是把它用的和屎一樣。

我扔掉了JPA

我仔細想了一下，有下面幾點原因，造成了JPA在很多團隊根本就玩不下去。

JPA適合業(yè)務模型固定的場景，適合比較穩(wěn)定的需求。但是國內這種朝三暮四的需求風格，產品經理這種傳話筒式的設計模式，造成了需求的泛濫和不確定。JPA在這種模式下就是渣。
JPA的技術要求比較高。不要懷疑，你剛開始用起里可能覺得非常簡單。但隨著你的深入使用，你會發(fā)現這是一個災難。里面的各種轉換和緩存，會把人繞暈。而大多數的快餐程序員是不想要了解這些的。
很多程序員很會寫SQL，所以很多SQL語句長的很胖，長的要命。業(yè)務混亂，多張表關聯，我甚至見過上百張業(yè)務表關聯的復雜業(yè)務。DBA無奈之下，通常都會有sql審核。JPA搞sql審核？還是弱了一點。

所以，不是JPA不好，而是它不符合國情而已。想要在公司內推行JPA，你需要給我一個穩(wěn)定的產品團隊、一個牛X的技術團隊才行。

所以，大多數公司寧可寫一堆重復的、亂七八糟的Mybaits代碼，也不會輕易嘗試JPA，這是符合邏輯的，符合事物發(fā)展規(guī)律的。

所以，我們下面的文章就是來討論MyBatis的，來看一下Mybaits到底要怎么寫才算優(yōu)雅。

MyBatis為什么不好用

優(yōu)秀的程序員都是很懶的。所以很多人不想設計實體的sql。JPA可以直接根據Java的實體代碼，生成sql的庫表，這在使用Mybatis的人來看，是非常羨慕的。

使用MyBatis，要倒著來。需要先設計庫表，然后根據庫表反向生成一堆Java代碼和配置文件。

這個代碼生成器，就是mybatis-generator。

但是，請注意。這個生成器生成的代碼，有四種模式?。。∵@就是最讓初學者難受的地方。如果你也是剛接觸MyBatis，強烈推薦只關注下面第一種模式。

MyBatis3 這種模式就是我們常用的方式，會生成domain類、Example類、mapper映射文件等。它生成的信息比較啰嗦，內容幾乎無法改動。對于項目中自己寫的sql，一般都采用手寫的方式再寫一份，而不是改動原來的文件。
MyBatis3Simple 上面這種模式的簡易代碼生成模式，缺少一些東西，但很簡潔。對MyBatis沒有經驗，不推薦使用它。
MyBatis3DynamicSql 這是通過Builder模式實現的動態(tài)SQL特性，你還需要加入額外的jar包。加上它之后，其實和JPA是有點相似的。既然如此，那為何不直接使用JPA呢？所以這個DSQL雖然是默認的生成行為，但是非常不推薦。
MyBatis3Kotlin 這個不廢話。就是生成Kotlin版的一些配置和代碼信息。

所以，下面僅僅介紹MyBatis3模式的代碼生成。

要使用它，需要在pom.xml里加入它的依賴。

<dependency>
  <groupId>org.mybatis.generator</groupId>
  <artifactId>mybatis-generator-core</artifactId>
  <optional>true</optional>
  <scope>test</scope>
  <version>1.4.0</version>
</dependency>

我個人喜歡使用Java代碼來操作代碼生成這個過程，所以下面就是生成代碼的代碼。

public class MBGTool {
  public static void main(String[] args) throws Exception {
    List<String> warnings = new ArrayList<>();
    boolean overwrite = true;
    InputStream configFile = MBGTool.class.getResourceAsStream("/generator/generatorConfig.xml");
    ConfigurationParser cp = new ConfigurationParser(warnings);
    Configuration config = cp.parseConfiguration(configFile);
    DefaultShellCallback callback = new DefaultShellCallback(overwrite);
    MyBatisGenerator myBatisGenerator = new MyBatisGenerator(config, callback, warnings);
    myBatisGenerator.generate(null);
  }
}

從代碼中，我們可以看到需要配置一個generatorConfig.xml文件，用來規(guī)定怎么生成代碼文件。

<!DOCTYPE generatorConfiguration PUBLIC
    "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
    "http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
  <context id="simple" targetRuntime="MyBatis3">
    <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
            connectionURL="jdbc:mysql://localhost:3306/mbye"
            userId="root"
            password="root"
    />
    <javaModelGenerator targetPackage="com.github.javarunfast.mbye.domain" targetProject="src/main/java">
      <property name="enableSubPackages" value="true"/>
      <property name="trimStrings" value="true"/>
    </javaModelGenerator>
    <sqlMapGenerator targetPackage="com.github.javarunfast.mbye.mapper" targetProject="src/main/resources"/>
    <javaClientGenerator type="XMLMAPPER" targetPackage="com.github.javarunfast.mbye.mapper" targetProject="src/main/java">
      <property name="enableSubPackages" value="true"/>
    </javaClientGenerator>
    <table tableName="test"/>
  </context>
</generatorConfiguration>

運行我們的MBGTool文件之后，就可以生成MyBatis的代碼了。

怎么寫代碼最優(yōu)雅

但是，我這里并不是要推薦你使用這種模式。因為，它生成了一大堆無用的文件。假如你的項目使用了sonar這樣的代碼質量審查工具，你會發(fā)現很多飄紅的地方，還有那要命的覆蓋率問題。
怎么辦？

經過我多年的摸索，我現在推薦一種非常好用的寫法。自從我采用了這種方式之后，就再也沒有換過。

第一、不需要代碼生成器了
數據表的設計，還有domain的書寫，全部靠手工。這樣我們的代碼，如果有必要，還可以遷移到JPA上去。這種模式還能順便學習一下Java里面的數據類型，是如何和SQL里的數據類型一一對應的。在做表設計的時候，順便能夠了解一些背后的原理。

第二、不需要寫映射文件了
生成器生成的東西，確實是有一堆無用的邏輯。比如我的某個數據表，根本不需要提供查詢所有和刪除這種動作，它還是默認提供了。

在這種簡約模式下，我們直接手寫Mapper文件，然后只聲明所需要的接口方法就可以了。

@Mapper
public interface AccountBasicMapper {
  @Insert("AccountBasicMapper/insert.sql")
  void insert(@Param("r") AccountBasic record);
}

可以看到，里面有一個Insert注解，我們傳入了一個具體的domain，然后，就可以在AccountBasicMapper目錄下的insert.sql文件里，書寫具體的sql語句了。

sql語句樣例如下：

INSERT INTO account_basic(
  account_id,
  nick_name,
  password,
  sex,
  state,
  photo_url,
  created,
  modified,
  version
)VALUES (
  <@p name="r.accountId"/>,
  <@p name="r.nickName"/>,
  <@p name="r.password"/>,
  <@p name="r.sex"/>,
  <@p name="r.state"/>,
  <@p name="r.photoUrl"/>,
  <@p name="r.created"/>,
  <@p name="r.modified"/>,
  <@p name="r.version"/>
)

那么這是什么語法呢？它又是如何知道是這樣配置的呢？這就需要引入MyBatis的腳本語言配置功能。在這里，我們使用的freemark的模版。

不要忘了加入它的依賴。

<dependency>
  <groupId>org.mybatis.scripting</groupId>
  <artifactId>mybatis-freemarker</artifactId>
  <version>1.2.2</version>
</dependency>

然后，在yaml文件里做上相應的配置就ok了。

mybatis:
 check_config_location: false
 scripting-language-driver:
  freemarker:
   template-file:
    base-dir: mappers/
   path-provider:
    includes-package-path: false
    separate-directory-per-mapper: false

這種方式的好處和壞處

我個人是非常喜歡這種模式的。因為它有下面幾個好處：