MyBatis 本是apache的一個(gè)開(kāi)源項(xiàng)目iBatis, 2010年這個(gè)項(xiàng)目由apache software foundation 遷移到了google code勉耀,并且改名為MyBatis 瘫想。2013年11月遷移到Github。是一個(gè)基于Java的持久層框架靡菇。Mybatis 提供的持久層框架包括SQL Maps和Data Access Objects(DAOs)
1.第一個(gè) mybatis 小程序
-
創(chuàng)建一個(gè) maven 工程
- 配置 pom 文件 重归,導(dǎo)包
<dependencies>
<!-- 配置 mybatis 核心依賴(lài) -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.5</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.44</version>
</dependency>
<!-- 導(dǎo)入log4j 日志包 -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.21</version>
</dependency>
</dependencies>
- 配置全局配置文件 SqlMapConfig.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<environments default="dev">
<environment id="dev">
<transactionManager type="JDBC"></transactionManager>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql:///xingxue24"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/xingxue/mybatis/mapper/UserMapper.xml"/>
</mappers>
</configuration>
- 配置 mapper 映射文件
<?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="test">
<!-- insert 標(biāo)簽會(huì)被mybatis封裝成一個(gè) statement對(duì)象 -->
<insert id="add">
INSERT INTO TBL_USER (NAME,BIRTH,PASSWORD)VALUES(#{name},#{birth},#{password})
</insert>
</mapper>
- 測(cè)試
private static void insert() throws IOException {
InputStream is = Resources.getResourceAsStream("SqlMapConfig.xml");
SqlSessionFactoryBuilder sb = new SqlSessionFactoryBuilder();
SqlSessionFactory factory = sb.build(is);
//得到了 SqlSession
SqlSession session = factory.openSession();
UserModel u = new UserModel();
u.setBirth(new Date());
u.setPassword("111");
u.setName("test2");
//插入操作
session.insert("test.add",u);
//提交事務(wù)
session.commit();
}
2.Mybatis框架原理
-
框架圖:
流程說(shuō)明:
1.mybatis配置文件,包括Mybatis全局配置文件和Mybatis映射文件厦凤,其中全局配置文件配置了數(shù)據(jù)源鼻吮、事務(wù)等信息;映射文件配置了SQL執(zhí)行相關(guān)的 信息较鼓。
2.mybatis通過(guò)讀取配置文件信息(全局配置文件和映射文件)椎木,構(gòu)造出SqlSessionFactory违柏,即會(huì)話工廠。
3.通過(guò)SqlSessionFactory香椎,可以創(chuàng)建SqlSession即會(huì)話漱竖。Mybatis是通過(guò)SqlSession來(lái)操作數(shù)據(jù)庫(kù)的。
4.SqlSession本身不能直接操作數(shù)據(jù)庫(kù)畜伐,它是通過(guò)底層的Executor執(zhí)行器接口來(lái)操作數(shù)據(jù)庫(kù)的馍惹。Executor接口有兩個(gè)實(shí)現(xiàn)類(lèi)动遭,一個(gè)是普通執(zhí)行器息楔,一個(gè)是緩存執(zhí)行器(默認(rèn))。
5.Executor執(zhí)行器要處理的SQL信息是封裝到一個(gè)底層對(duì)象MappedStatement中银酗。該對(duì)象包括:SQL語(yǔ)句慎框、輸入?yún)?shù)映射信息良狈、輸出結(jié)果集映射信息。其中輸入?yún)?shù)和輸出結(jié)果的映射類(lèi)型包括java的簡(jiǎn)單類(lèi)型笨枯、HashMap集合對(duì)象薪丁、POJO對(duì)象類(lèi)型。
3.Mybtais 的核心對(duì)象API
- Resources 對(duì)象 :通過(guò) 類(lèi)加載器獲取文件數(shù)據(jù)
- SqlSessionFactoryBuilder 對(duì)象: 創(chuàng)建 SqlSessionFactory 對(duì)象實(shí)例
- SqlSessionFactory 對(duì)象: 創(chuàng)建一個(gè) Connection 或者說(shuō) SqlSession 對(duì)象
- SqlSession 對(duì)象:執(zhí)行 sql 命令 以及管理事務(wù) (掌握)馅精,該對(duì)象線程不安全
4.Mybatis全局配置文件
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<environments default="dev">
<!-- environment 該標(biāo)簽用于配置數(shù)據(jù)庫(kù)環(huán)境 -->
<environment id="dev">
<!-- transactionManager 配置事務(wù)管理器 -->
<transactionManager type="JDBC"></transactionManager>
<!-- dataSource 配置數(shù)據(jù)庫(kù)連接信息 -->
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql:///xingxue24"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
<!-- mappers 用于 引用 mapper 映射文件 -->
<mappers>
<mapper resource="com/xingxue/mybatis/mapper/UserMapper.xml"/>
</mappers>
</configuration>
5.Mybatis映射文件
<?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 根標(biāo)簽: namespace 屬性:該屬性的值可以隨便定義窥突,但是取點(diǎn)有意義的,如果要使用mybatis 官方推薦的 動(dòng)態(tài)mapper,該值就不能隨便定義 -->
<mapper namespace="test">
<!-- insert 標(biāo)簽會(huì)被mybatis封裝成一個(gè) statment對(duì)象硫嘶。
id 屬性 :statment 對(duì)象 取個(gè)別名
-->
<insert id="add">
INSERT INTO TBL_USER (NAME,BIRTH,PASSWORD)VALUES(#{name},#{birth},#{password})
</insert>
<delete id="deleteById">
DELETE FROM TBL_USER WHERE ID = #{ID}
</delete>
<update id="update">
UPDATE TBL_USER SET NAME = #{name},PASSWORD=#{password},BIRTH=#{birth} WHERE ID = #{id}
</update>
<!--
resultType 屬性,該屬性只有 select 標(biāo)簽才有梧税,指定查詢(xún)結(jié)果(行)用具體的類(lèi)型來(lái)封裝
-->
<select id="queryById" resultType="com.xingxue.mybatis.model.UserModel">
SELECT ID,NAME,PASSWORD,BIRTH FROM TBL_USER WHERE ID = #{id}
</select>
<select id="queryList" resultType="com.xingxue.mybatis.model.UserModel">
SELECT ID,NAME,PASSWORD,BIRTH FROM TBL_USER
</select>
</mapper>
6.官方推薦使用動(dòng)態(tài)mapper代理技術(shù)
只寫(xiě)接口沦疾,不寫(xiě)實(shí)現(xiàn)
注意:我們使用myabtis自動(dòng)創(chuàng)建mapper代理對(duì)象的方式,不需要開(kāi)發(fā)Mapper接口實(shí)現(xiàn)類(lèi)第队,要滿(mǎn)足以下規(guī)范:
- Mapper.xml映射文件中的namesapce的值要跟mapper接口全路徑一致
- Mapper.xml 映射文件中的 crud標(biāo)簽中的id 要跟Mapper接口定義的方法名一致
- Mapper.xml 映射文件的位置要跟Mapper接口的位置一致 同包下