MyBatis

MyBatis

開發かいはつ者しゃ	MyBatis团队
当とう前ぜん版本はんぽん	3.5.16 (2024年ねん4月がつ4日にち；穩定版本はんぽん)
源みなもと代だい码库	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 （页面存そん档备份，存そん于互联网档案あん馆）

外部がいぶ链接

• 官かん方かた网站