MyBatis

MyBatis

開發かいはつ者しゃ	MyBatis團だん隊たい
當とう前ぜん版本はんぽん	3.5.11（2022年ねん9月がつ18日にち​（2022-09-18））
源みなもと代だい碼庫	github.com/mybatis/mybatis-3
編へん程ほど語ご言げん	Java
操作そうさ系統けいとう	跨またが平台ひらだい
類型るいけい	持久じきゅう化か框かまち架か
許可きょか協議きょうぎ	Apache許可きょか證しょう 2.0
網あみ站	https://mybatis.org/mybatis-3/zh_CN/

MyBatis是ぜ一いち個こJava持久じきゅう化か框かまち架か，它通過つうかXML描述符ふ或ある註解ちゅうかい把わ對象たいしょう與あずか存そん儲もうか過程かてい或あるSQL語句ごく關聯かんれん起おこり來らい，映うつ射い成なり資料しりょう庫こ內對應おう的てき紀き錄ろく。

MyBatis是ぜ在ざいApache許可きょか證しょう 2.0下分しもぶん發はつ的てき自由じゆう軟件，是ぜiBATIS 3.0的てき分ぶん支ささえ版本はんぽん，其維護まもる團だん隊たい也包含ほうがんiBATIS的てき初はつ創成そうせい員いん。

功こう能のう概況がいきょう

與あずか其他對象たいしょう關係かんけい映うつ射い框かまち架か不同ふどう，MyBatis沒ぼつ有ゆう將しょうJava對象たいしょう與あずか數かず據よりどころ庫こ表おもて關聯かんれん起おこり來らい，而是將はたJava方法ほうほう與あずかSQL語句ごく關聯かんれん。MyBatis允許いんきょ用よう戶ど充分じゅうぶん利用りよう數かず據よりどころ庫こ的てき各種かくしゅ功こう能のう，例れい如存儲もうか過程かてい、視み圖ず、各種かくしゅ複雜ふくざつ的てき查詢以及某ぼう數すう據よりどころ庫こ的てき專有せんゆう特性とくせい。如果要よう對たい遺留いりゅう數すう據よりどころ庫こ、不ふ規範きはん的てき數すう據よりどころ庫こ進行しんこう操作そうさ，或ある者もの要よう完全かんぜん控ひかえ制せいSQL的てき執行しっこう，MyBatis是ぜ一いち個こ不ふ錯的選擇せんたく。

與あずかJDBC相そう比ひ，MyBatis簡化了りょう相關そうかん代だい碼：SQL語句ごく在ざい一行代碼中就能執行。MyBatis提供ていきょう了りょう一個映射引擎，聲明せいめい式しき的てき把わSQL語句ごく執行しっこう結果けっか與あずか對象たいしょう樹じゅ映うつ射い起おこり來らい。通過つうか使用しよう一いち種しゅ內建的てき類るいXML表ひょう達たち式しき語ご言げん，或ある者もの使用しようApache Velocity集成しゅうせい的てき插件，SQL語句ごく可か以被動態どうたい的てき生成せいせい。

MyBatis與あずかSpring Framework和わGoogle Guice集成しゅうせい，這使開發かいはつ者しゃ免めん於依賴いらい性せい問題もんだい。

MyBatis支持しじ聲明せいめい式しき數すう據よりどころ緩なる存そん（declarative data caching）。當とう一いち條じょうSQL語句ごく被ひ標記ひょうき為ため「可か緩なる存そん」後ご，首しゅ次じ執行しっこう它時從したがえ數すう據よりどころ庫こ取得しゅとく的てき所有しょゆう數すう據よりどころ會かい被ひ存そん儲もうか在ざい一いち段だん高速こうそく緩なる存そん中なか，今後こんご執行しっこう這條語句ごく時じ就會從したがえ高速こうそく緩なる存そん中ちゅう讀取よみと結果けっか，而不是ぜ再さい次つぎ命中めいちゅう數すう據よりどころ庫こ。MyBatis提供ていきょう了りょう基もと於 Java HashMap 的てき默認もくにん緩なる存そん實現じつげん，以及用よう於與OSCache、Ehcache、Hazelcast和わMemcached連接れんせつ的てき默認もくにん連接れんせつ器き。MyBatis還かえ提供ていきょうAPI供きょう其他緩なる存そん實現じつげん使用しよう。

用法ようほう

SQL語句ごく存そん儲もうか在ざいXML文ぶん件けん或あるJava 註解ちゅうかい中なか。一いち個こMyBatis映うつ射的しゃてき示しめせ例れい（其中用よう到いた了りょうJava接せっ口こう和かずMyBatis註解ちゅうかい）：

package org.mybatis.example;

public interface BlogMapper {
    @Select("select * from Blog where id = #{id}")
    Blog selectBlog(int id);
}

執行しっこう的てき示しめせ例れい：

BlogMapper mapper = session.getMapper(BlogMapper.class);
Blog blog = mapper.selectBlog(101);

SQL語句ごく和わ映うつ射い也可以外いがい化か到いた一いち個こ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="org.mybatis.example.BlogMapper">
    <select id="selectBlog" parameterType="int" resultType="Blog">
        select * from Blog where id = #{id}
    </select>
</mapper>

也可以使用しようMyBatis API執行しっこう語句ごく：

Blog blog = session.selectOne("org.mybatis.example.BlogMapper.selectBlog", 101);

詳細しょうさい信しんじ息いき可か以參考さんこうMyBatis網もう站所提供ていきょう的てき用よう戶手とで冊さつ。參まいり見み外部がいぶ連結れんけつ。

與あずかSpring集成しゅうせい

MyBatis與あずかSpring Framework集成しゅうせい。Spring Framework允許いんきょMyBatis參與さんよSpring事務じむ，建立こんりゅう了りょうMyBatis映うつ射い器き和わ會話かいわ，並なみ把わ他た們注入ちゅうにゅう到いた其他bean中なか。

如下所しょ示しめせ是ぜ一いち個こ基本きほん的てきXML配置はいち示しめせ例れい：建立こんりゅう了りょう映うつ射い器き，並なみ注入ちゅうにゅう到いた「BlogService」bean中なか。

<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
    <property name="dataSource" ref="dataSource" />
</bean>

<bean id="blogMapper" class="org.mybatis.spring.mapper.MapperFactoryBean">
    <property name="sqlSessionFactory" ref="sqlSessionFactory" />
    <property name="mapperInterface" value="org.mybatis.example.BlogMapper" />
</bean>

<bean id="blogService" class="org.mybatis.example.BlogServiceImpl">
    <property name="blogMapper" ref="blogMapper" />
</bean>

現在げんざい調ちょう用ようMyBatis只ただ需要じゅよう調ちょう用よう一いち個こbean:

public class BlogServiceImpl implements BlogService {

    private BlogMapper blogMapper;

    public void setBlogMapper(BlogMapper blogMapper) {
        this.blogMapper = blogMapper;
    }

    public void doSomethingWithABlog(int blogId) {
        Blog blog = blogMapper.selectBlog(blogId);
        ...
    }
}

Velocity語ご言げん

Velocity語ご言げん驅動くどう程ほど序じょ允許いんきょ用よう戶と使用しようApache Velocity來らい快速かいそく生成せいせい動態どうたいSQL查詢。

<select id="findPerson" lang="velocity">
  #set( $pattern = $_parameter.name + '%' )
  SELECT *
  FROM person
  WHERE name LIKE @{pattern, jdbcType=VARCHAR}
</select>

MyBatis生成せいせい器き

MyBatis提供ていきょう了りょう代だい碼生成せいせい器き。MyBatis生成せいせい器き（MyBatis Generator）能のう對數たいすう據よりどころ庫こ表ひょう內省，生成せいせい執行しっこう的てき增ぞう刪改查（CRUD）時じ所しょ需的MyBatis代だい碼。有ゆう相關そうかん的てきEclipse插件可か供きょう使用しよう。

MyBatis Migrations

MyBatis Migrations是ぜ一いち個こJava控ひかえ制せい台だい應用おうよう程ほど序じょ，它通過つうか管理かんり數かず據よりどころ定義ていぎ語ご言げん（DDL）文ぶん件けん來らい跟蹤數かず據よりどころ庫こ模も式しき的てき變更へんこう。

Migrations可か以查詢當前まえ數すう據よりどころ庫こ的てき狀態じょうたい，應用おうよう或ある恢復かいふく對たい數かず據よりどころ庫こ模も式しき的てき變更へんこう。它也有ゆう助じょ於發現和げんな解決かいけつ由よし多た個こ開發かいはつ人員じんいん並行へいこう修おさむ改あらため數すう據よりどころ庫こ模も式しき的てき情況じょうきょう。

歷史れきし

MyBatis項目こうもく繼承けいしょう自じiBATIS 3.0，其維護まもる團だん隊たい也包含ほうがんiBATIS的てき初はつ創成そうせい員いん。

2010年ねん5月がつ19日にち項目こうもく創建そうけん。當時とうじApache iBATIS 3.0發布はっぷ，其開發かいはつ團だん隊たい宣布せんぷ會かい在ざい新しん的てき名字みょうじ、新しん的てき站點中ちゅう繼續けいぞく開發かいはつ。

2013年ねん11月がつ10日とおか，項目こうもく遷移せんい到いた了りょうGitHub。

參まいり見み

• Hibernate
• iBATIS
• JDBC
• Java持久じきゅう化かAPI（JPA）
• EclipseLink
• Ebean
• 面めん向こうJava對象たいしょう查詢（jOOQ）
• Apache Cayenne
• pureQuery
• NHydrate
• Hydrate（頁ぺーじ面めん存そん檔備份，存そん於網あみ際ぎわ網もう路ろ檔案館かん）
• OpenJPA
• Spring Framework
• Google Guice
• O/R Broker
• ObjectiveSql （頁ぺーじ面めん存そん檔備份，存そん於網あみ際ぎわ網もう路ろ檔案館かん）

外部がいぶ連結れんけつ

• 官かん方かた網もう站