• MyBatis持久层框架
  • 一、课程目标
  • 二、MyBatis简单使用
  • 2.1 简介
  • 2.2 MyBatis的优点
  • 2.3 与传统jdbc的比较
  • 2.4 Mybatis使用基本要素
  • 2.5 Mybatis快速搭建
  • 三、mybatis配置详解
  • mybatis-config .xml 全局配置文件
  • 头文件
  • 根标签configuration
  • properties属性标签
  • setting 设置
  • typeAliases 类型命名
  • typeHandlers 类型处理器
  • objectFactory对象工厂
  • plugins 插件
  • environments环境配置
  • environment数据库环境标签
  • transactionManager事务管理器标签
  • dataSource数据源标签
  • 数据源属性
  • mapper 映射标签


MyBatis持久层框架

一、课程目标

【理解】MyBatis
【掌握】Mybatis的快速搭建
【掌握】Mybatis核心配置

二、MyBatis简单使用

2.1 简介

MyBatis的前身就是iBatis,iBatis本是由Clinton Begin开发,后来捐给Apache基金会,成立了iBatis开源项目。2010年5月该项目由Apahce基金会迁移到了Google Code,并且改名为MyBatis。

MyBatis是一个数据持久层(ORM)框架。把实体类和SQL语句之间建立了映射关系,是一种半自动化的ORM实现。

2.2 MyBatis的优点

1.基于SQL语法,简单易学。

2.能了解底层组装过程。

3.SQL语句封装在配置文件中,便于统一管理与维护,降低了程序的耦合度。

4.程序调试方便。

2.3 与传统jdbc的比较

减少了60%的代码量

最简单的持久化框架

架构级性能增强

SQL代码从程序代码中彻底分离,可重用

增强了项目中的分工

强了移植性

2.4 Mybatis使用基本要素

一、mybatis-config .xml 全局配置文件

二、mapper.xml 核心映射文件

三、SqlSession接口

2.5 Mybatis快速搭建

1、导入相应的jar包

mybatis log4j mysql

2、创建相应的数据库

create table t_user(
	id int primary key auto_increment,
	name varchar(20),
	sal double,
  	birthday date
);
insert into t_user values(1,'鲁智深',200,now());
insert into t_user values(2,'武松',188,now());

3、创建对应实体类

import java.util.Date;
public class User {
    private int id;
    private String name;
    private double sal;
    private Date birthday;
    User()
    User(id,name.sal.birthday)
    getter...
    setter...
    toString()
}

4、书写日志配置文件

# Global logging configuration
log4j.rootLogger=DEBUG, stdout
# MyBatis logging configuration...
log4j.logger.org.mybatis.example.BlogMapper=TRACE
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

5、在src下创建mapper包书写相应的数据库语句配置文件

命名语法:数据库名Dao.xml或者数据库名Mapper.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">
<!--
	namespace唯一表示此名字下的crud语句
 -->
<mapper namespace="user">
    <!--
        id:在此命名空间下唯一标识
        resultType:查询结果的返回类型或者集合的泛型
     -->
    <select id="selectAllUser" resultType="com.yunhe.pojo.User">
        select * from t_user
    </select>


    <select id="selectById" resultType="com.yunhe.pojo.User">
        select * from t_user where id= #{id}
    </select>
    <!--
    <insert id=""></insert>
    <delete id=""></delete>
    <update id=""></update>
    -->
</mapper>

6、在src下书写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="development">
        <environment id="development">
            <!-- 使用jdbc的事务,mybatis进行管理 -->
            <transactionManager type="JDBC" />
            <!-- 使用jdbc的连接池连接数据库 -->
            <!-- 如果配置了<properties resource="db.properties"/> -->
            <!-- value可以使用value="${driver}"的形式进行书写 /> -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url" value="jdbc:mysql://localhost:3306/mydb" />
                <property name="username" value="root" />
                <property name="password" value="root" />
            </dataSource>
        </environment>
    </environments>
    <!-- 映射文件的配置-->
    <mappers>
        <mapper resource="mapper/UserMapper.xml" />
    </mappers>
</configuration>

7、书写工具类将加载配置创建sqlSessionFatory变为单例类

import java.io.IOException;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
    public  class MyBatisUitl {
        private MyBatisUitl(){}
        private static SqlSessionFactory sqlSessionFactory;
        static{
            try {
                sqlSessionFactory = new SqlSessionFactoryBuilder()
                        .build(Resources.getResourceAsStream("mybatis-config.xml"));
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        public static SqlSessionFactory getSqlSessionFactory(){
            return sqlSessionFactory;
        }
}

8、书写测试类获取执行

import com.yunhe.pojo.User;
import com.yunhe.util.MyBatisUitl;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;

import java.util.List;
public class Test {
    public static void main(String[] args) {
        //1、创建SqlSessionFactory对象,也是单例模式的
        SqlSessionFactory factory = MyBatisUitl.getSqlSessionFactory();
        //2、创建SqlSession对象
        SqlSession session = factory.openSession();
        //3、调用session的方法namespace的名字.id
        //List<User> users = session.selectList("user.selectAllUser");
        session.selectList("user.selectById",1);

        //4、打印测试
//        for(User u:users){
//            System.out.println(u);
//        }
        //5、关闭资源
        session.close();
    }
}

三、mybatis配置详解

mybatis-config .xml 全局配置文件

mybatis-config.xml是系统的核心配置文件,包含数据源和事务管理器等设置和属性信息,XML文档结构如下:

mybatis继承baseresultmap mybatis begin_java

头文件

帮助我们进行配置文件的书写与约束

<?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

书写在头标签下用于包裹所有mybatis配置的根标签

<configuration>



</configuration>
properties属性标签

用于加载配置的properties文件读取内容,使配置更加灵活,例如书写数据连接的相应信息

DRIVER=com.mysql.jdbc.Driver
URL=jdbc:mysql://localhost:3306/mydb
USERNAME=root
PASSWORD=root

在配置文件中使用properties标签进行读取,可以在当前页面使用"${key}"的形式直接获取指定value并进行填写

setting 设置

用于设置MyBatis 在运行时的行为方式(通常使用默认值或只修改指定数据值)

<settings>
    <setting name="cacheEnabled" value="true"/>
    <setting name="lazyLoadingEnabled" value="true"/>
    <setting name="multipleResultSetsEnabled" value="true"/>
    <setting name="useColumnLabel" value="true"/>
    <setting name="useGeneratedKeys" value="false"/>
    <setting name="autoMappingBehavior" value="PARTIAL"/>
    <setting name="autoMappingUnknownColumnBehavior" value="WARNING"/>
    <setting name="defaultExecutorType" value="SIMPLE"/>
    <setting name="defaultStatementTimeout" value="30"/>
    <setting name="defaultFetchSize" value="200"/>
    <setting name="safeRowBoundsEnabled" value="false"/>
    <setting name="mapUnderscoreToCamelCase" value="false"/>
    <setting name="localCacheScope" value="SESSION"/>
    <setting name="jdbcTypeForNull" value="OTHER"/>
    <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode,toString"/>
</settings>

设置参数

描述

有效值

默认值

cacheEnabled

该配置影响的所有映射器中配置的缓存的全局开关

true | false

true

lazyLoadingEnabled

延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置fetchType属性来覆盖该项的开关状态

true | false

false

aggressiveLazyLoading

当启用时,对任意延迟属性的调用会使带有延迟加载属性的对象完整加载;反之,每种属性将会按需加载。

true | false

true

multipleResultSetsEnabled

是否允许单一语句返回多结果集(需要兼容驱动)。

true | false

true

useColumnLabel

使用列标签代替列名。不同的驱动在这方面会有不同的表现, 具体可参考相关驱动文档或通过测试这两种不同的模式来观察所用驱动的结果。

true | false

true

useGeneratedKeys

允许 JDBC 支持自动生成主键,需要驱动兼容。 如果设置为 true 则这个设置强制使用自动生成主键,尽管一些驱动不能兼容但仍可正常工作(比如 Derby)。

true | false

False

autoMappingBehavior

指定 MyBatis 应如何自动映射列到字段或属性。 NONE 表示取消自动映射;PARTIAL 只会自动映射没有定义嵌套结果集映射的结果集。 FULL 会自动映射任意复杂的结果集(无论是否嵌套)。

NONE, PARTIAL, FULL

PARTIAL

defaultExecutorType

配置默认的执行器。SIMPLE 就是普通的执行器;REUSE 执行器会重用预处理语句(prepared statements); BATCH 执行器将重用语句并执行批量更新。

SIMPLE REUSE BATCH

SIMPLE

defaultStatementTimeout

设置超时时间,它决定驱动等待数据库响应的秒数。

Any positive integer

Not Set (null)

defaultFetchSize

为驱动程序设置一个提示,以控制获取返回结果的大小。查询设置可以覆盖此参数值。

Any positive integer

Not Set (null)

safeRowBoundsEnabled

允许在嵌套语句中使用分页(RowBounds)。

true | false

False

mapUnderscoreToCamelCase

是否开启自动驼峰命名规则(camel case)映射,即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的类似映射。

true | false

False

localCacheScope

MyBatis 利用本地缓存机制(Local Cache)防止循环引用(circular references)和加速重复嵌套查询。 默认值为 SESSION,这种情况下会缓存一个会话中执行的所有查询。 若设置值为 STATEMENT,本地会话仅用在语句执行上,对相同 SqlSession 的不同调用将不会共享数据。

SESSION | STATEMENT

SESSION

jdbcTypeForNull

当没有为参数提供特定的 JDBC 类型时,为空值指定 JDBC 类型。 某些驱动需要指定列的 JDBC 类型,多数情况直接用一般类型即可,比如 NULL、VARCHAR 或 OTHER。

JdbcType enumeration. Most common are: NULL, VARCHAR and OTHER

OTHER

lazyLoadTriggerMethods

指定哪个对象的方法触发一次延迟加载。

A method name list separated by commas

equals,clone,hashCode,toString

defaultScriptingLanguage

指定动态 SQL 生成的默认语言。

A type alias or fully qualified class name.

org.apache.ibatis.scripting.xmltags.XMLDynamicLanguageDriver

callSettersOnNulls

指定当结果集中值为 null 的时候是否调用映射对象的 setter(map 对象时为 put)方法,这对于有 Map.keySet() 依赖或 null 值初始化的时候是有用的。注意基本类型(int、boolean等)是不能设置成 null 的。

true | false

false

logPrefix

指定 MyBatis 增加到日志名称的前缀。

Any String

Not set

logImpl

指定 MyBatis 所用日志的具体实现,未指定时将自动查找。

SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING

Not set

proxyFactory

指定 Mybatis 创建具有延迟加载能力的对象所用到的代理工具。

CGLIB | JAVASSIST

JAVASSIST (MyBatis 3.3 or above)

typeAliases 类型命名

为指定的类进行别名的命名,这样在书写mapper可以直接使用别名当做类进行使用

<typeAliases>
        <!--为指定的类起别名 默认使用类的名字的小写 也可以使用alias设置指定的别名-->
       <typeAlias type="com.yunhe.pojo.User" alias="user"/>
        <!-- 为指定包下所有的类 使用默认名字作为别名-->
        <package name="com.yunhe.pojo"/>
    </typeAliases>
typeHandlers 类型处理器

MyBatis 在设置预处理语句(PreparedStatement)中的参数或从结果集中取出一个值时, 都会用类型处理器将获取到的值以合适的方式转换成 Java 类型。默认已经提供了默认的类型处理器,可以通过这个属性进行自定义类型处理器的使用,具体可以参考

objectFactory对象工厂

每次 MyBatis 创建结果对象的新实例时,它都会使用一个对象工厂(ObjectFactory)实例来完成实例化工作。 默认的对象工厂需要做的仅仅是实例化目标类,要么通过默认无参构造方法,要么通过存在的参数映射来调用带有参数的构造方法。 如果想覆盖对象工厂的默认行为,可以通过创建自己的对象工厂来实现,具体可以参考

plugins 插件

plugins插件,MyBatis 允许你在映射语句执行过程中的某一点进行拦截调用。默认情况下,MyBatis 允许使用插件来拦截的方法调用包括:

Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
ParameterHandler (getParameterObject, setParameters)
ResultSetHandler (handleResultSets, handleOutputParameters)
StatementHandler (prepare, parameterize, batch, update, query)
这些类中方法的细节可以通过查看每个方法的签名来发现,或者直接查看 MyBatis 发行包中的源代码。 如果你想做的不仅仅是监控方法的调用,那么你最好相当了解要重写的方法的行为。 因为在试图修改或重写已有方法的行为时,很可能会破坏 MyBatis 的核心模块。 这些都是更底层的类和方法,所以使用插件的时候要特别当心。

environments环境配置

1)MyBatis可以配置多种环境,比如开发、测试和生产环境需要有不同的配置

2)每种环境使用一个environment标签进行配置并指定唯一标识符

3)可以通过environments标签中的default属性指定一个环境的标识符来快速的切换环境

4)environment-指定具体环境

<!-- 用于配置mybatis使用的数据库相关的环境 可以配置多个环境 通过default进行切换 -->
    <environments default="development" >
    </environments>
environment数据库环境标签

书写在environments中 拥有id属性指定当前环境的唯一标识 可以用environments defaule属性指向,是环境设置标签的根标签

<environment id="development">
 </environment>
transactionManager事务管理器标签
<transactionManager type="JDBC" />

书写在environment标签中 拥有type属性,值可以书写:

1)JDBC - 这个类型直接全部使用 JDBC 的提交和回滚功能。它依靠使用连接的数据源来管理事务的作用域。

2)MANAGED - 这个类型什么不做 , 它从不提交 、 回滚和关闭连接 。 而是让窗口来管理事务的全部生命周期 。

3)自定义 - 实现TransactionFactory接口,type=全类名/别名

dataSource数据源标签
<dataSource type="POOLED">
  </dataSource

数据源 ,书写在environment中 拥有type属性,值可以书写:

1)UNPOOLED:不使用连接池, UnpooledDataSourceFactory

2)POOLED:使用连接池, PooledDataSourceFactory

3)JNDI: 在EJB 或应用服务器这类容器中查找指定的数据源

4)自定义:实现DataSourceFactory接口,定义数据源的获取方式

数据源属性

根据不同的数据源可以设置不同的属性,但是其中四个属性是必须的

驱动driver、地址url、账号username、密码password根据不同的数据源 属性的名称可能也不一样,但是设置的语法是一样的

<!-- 使用jdbc的连接池连接数据库 -->
            <!-- 如果配置了<properties resource="db.properties"/> -->
            <!-- value可以使用value="${driver}"的形式进行书写 /> -->
            <dataSource type="POOLED">
                <property name="driver" value="${DRIVER}" />
                <property name="url" value="${URL}" />
                <property name="username" value="${USERNAME}" />
                <property name="password" value="${PASSWORD}" />
            </dataSource>
mapper 映射标签

用于在进行配置文件加载过程中对mapper配置文件进行加载,并进行映射

1)用来在mybatis初始化的时候,告诉mybatis需要引入哪些Mapper映射文件

  1. mapper逐个注册SQL映射文件

resource属性:单独引入相应xml配置(可以通过mapper配置中的namespace与id动态执行)

class属性:单独引入mapper接口对象(可以自动扫描与mapper接口名字相同的xml,class与xml同一目录)

package属性:引入指定包下接口对象(可以自动扫描与mapper接口名字相同的xml,class与xml同一目录)