MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code,并且改名为MyBatis 。2013年11月迁移到Github。是一个基于Java的持久层框架。Mybatis 提供的持久层框架包括SQL Maps和Data Access Objects(DAOs)
1.第一个 mybatis 小程序
-
创建一个 maven 工程
- 配置 pom 文件 ,导包
<dependencies>
<!-- 配置 mybatis 核心依赖 -->
<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>
<!-- 导入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 标签会被mybatis封装成一个 statement对象 -->
<insert id="add">
INSERT INTO TBL_USER (NAME,BIRTH,PASSWORD)VALUES(#{name},#{birth},#{password})
</insert>
</mapper>
- 测试
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);
//提交事务
session.commit();
}
2.Mybatis框架原理
-
框架图:
流程说明:
1.mybatis配置文件,包括Mybatis全局配置文件和Mybatis映射文件,其中全局配置文件配置了数据源、事务等信息;映射文件配置了SQL执行相关的 信息。
2.mybatis通过读取配置文件信息(全局配置文件和映射文件),构造出SqlSessionFactory,即会话工厂。
3.通过SqlSessionFactory,可以创建SqlSession即会话。Mybatis是通过SqlSession来操作数据库的。
4.SqlSession本身不能直接操作数据库,它是通过底层的Executor执行器接口来操作数据库的。Executor接口有两个实现类,一个是普通执行器,一个是缓存执行器(默认)。
5.Executor执行器要处理的SQL信息是封装到一个底层对象MappedStatement中。该对象包括:SQL语句、输入参数映射信息、输出结果集映射信息。其中输入参数和输出结果的映射类型包括java的简单类型、HashMap集合对象、POJO对象类型。
3.Mybtais 的核心对象API
- Resources 对象 :通过 类加载器获取文件数据
- SqlSessionFactoryBuilder 对象: 创建 SqlSessionFactory 对象实例
- SqlSessionFactory 对象: 创建一个 Connection 或者说 SqlSession 对象
- SqlSession 对象:执行 sql 命令 以及管理事务 (掌握),该对象线程不安全
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 该标签用于配置数据库环境 -->
<environment id="dev">
<!-- transactionManager 配置事务管理器 -->
<transactionManager type="JDBC"></transactionManager>
<!-- dataSource 配置数据库连接信息 -->
<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 根标签: namespace 属性:该属性的值可以随便定义,但是取点有意义的,如果要使用mybatis 官方推荐的 动态mapper,该值就不能随便定义 -->
<mapper namespace="test">
<!-- insert 标签会被mybatis封装成一个 statment对象。
id 属性 :statment 对象 取个别名
-->
<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 标签才有,指定查询结果(行)用具体的类型来封装
-->
<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.官方推荐使用动态mapper代理技术
只写接口,不写实现
注意:我们使用myabtis自动创建mapper代理对象的方式,不需要开发Mapper接口实现类,要满足以下规范:
- Mapper.xml映射文件中的namesapce的值要跟mapper接口全路径一致
- Mapper.xml 映射文件中的 crud标签中的id 要跟Mapper接口定义的方法名一致
- Mapper.xml 映射文件的位置要跟Mapper接口的位置一致 同包下