MyBatis初探

简介

MyBatis是一款支持定制化SQL、存储过程以及高级映射的优秀的持久层框架。它几乎避免了所有的JDBC代码和手动设置参数以及获取结果集。MyBatis 可以对配置和原生Map使用简单的 XML 或注解，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录。详见MyBatis中文网页

---

1. 何为高级映射？
   ORM
2. 持久层的概念
   指J2EE开发中的5层架构（表示层、控制\中介层、领域层、持久层、数据源层），持久层主要是为对象-关系数据库之间提供企业级的映射服务

MyBatis-config.xml配置说明

xml配置文件的属性目录如下：

• configuration 配置

  • properties 属性
  • settings 设置
  • typeAliases 类型命名
  • typeHandlers 类型处理器
  • objectFactory 对象工厂
  • plugins 插件
  • environments 环境
    
    • environment 环境变量
      
      • transactionManager 事务管理器
      • dataSource 数据源
  • databaseIdProvider 数据库厂商标识
  • mappers 映射器

  必须按照顺序来配置，否则xml配置文件保存时编译不通过。

properties 配置属性，可引入外部配置文件（如数据源配置）
settings 配置参数，如cacheEnabled、useGeneratedKeys
typeAliases 配置别名，这样在全局配置文件（xml配置、映射器配置）中均可以使用别名，最常用的就是全路径（完全限定名fully qualified name）的别名，
typeHandlers 自定义对非标准数据库字段类型的处理，将数据库字段转换成java类型
objectFactory MyBatis在创建结果对象的实例时，总是通过ObjectFactory（对象工厂）实例来完成。默认的对象工厂仅仅实例化目标类，通过该配置可自定义
plugins 自定义拦截插件，在映射语句执行过程中的某一点进行拦截
environments 环境参数，可以配置适应多种环境，这种机制有助于将 SQL 映射应用于多种数据库之中， 现实情况下有多种理由需要这么做。例如，开发、测试和生产环境需要有不同的配置；或者共享相同 Schema 的多个生产数据库， 想使用相同的 SQL 映射。许多类似的用例。 但是每一个数据库都对应一个SqlSessionFactory
transactionManager 在 MyBatis 中有两种类型的事务管理器（也就是 type=”[JDBC|MANAGED]”）(JDBC直接使用jdbc管理事务，MANAGED完全交由容器来管理，如J2EE应用服务器上下文、Spring容器等)
dataSource 数据库连接配置，有三种内建的数据源类型（也就是 type=”[UNPOOLED|POOLED|JNDI]”）
mappers 映射器配置，引入某个配置文件的位置，具体映射器配置见后文

附带一个测试项目的配置

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

    <!-- 属性文件配置 -->
    <properties resource="myBatis_test/data/config.properties">
        <property name="username" value="system" />
        <property name="password" value="system" />
    </properties>

    <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="defaultExecutorType" value="SIMPLE" />
        <setting name="defaultStatementTimeout" value="25" />
        <setting name="defaultFetchSize" value="100" />
        <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>


    <typeAliases>
        <package name="myBatis_test.bean" />
        <package name="myBatis_test.pojo" />
        <!-- 上句将包下所有的pojo类统一转换为同类名的别名，如：
        <typeAlias alias="AlertVo" type="myBatis_test.pojo.AlertVo" /> 
        -->
    </typeAliases>

    <plugins>
        <plugin interceptor="myBatis_test.plugins.MyPlugin">
            <property name="someProperty" value="100" />
        </plugin>
    </plugins>

    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC" />
            <dataSource type="POOLED">
                <property name="driver" value="${driverClass}" />
                <property name="url" value="${jdbcUrl}" />
                <property name="username" value="${user}" />
                <property name="password" value="${password}" />
            </dataSource>
        </environment>
    </environments>

    <mappers>
        <mapper resource="myBatis_test/data/testMapper.xml" />
    </mappers>
</configuration>

映射器xml配置

Mapper xml是映射的核心，也是构建MyBatis强大映射威力的基础，列举出它的顶级元素（按照应该被定义的顺序）：

• cache – 给定命名空间的缓存配置。
• cache-ref – 其他命名空间缓存配置的引用。
• resultMap – 是最复杂也是最强大的元素，用来描述如何从数据库结果集中来加载对象。
• parameterMap – 已废弃！老式风格的参数映射。内联参数是首选,这个元素可能在将来被移除，这里不会记录。
• sql – 可被其他语句引用的可重用语句块。
• insert – 映射插入语句
• update – 映射更新语句
• delete – 映射删除语句
• select – 映射查询语句

主要介绍resultMap，以一个案例入手，查询某张表，不要返回list实体集合，要求返回Map实体（value为bean实例，key为bean的id）。
这时候就要求定义一个resultMap，封装bean实例作为其map的value类型，beanid为其key类型，然后将这个resultMap设置为查询返回的resultMap值，上代码：

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

<!-- 命名空间，MyBatis强制要求声明，方便动态代理声明代理接口 -->
 <mapper namespace="myBatis_test.data.IMapper">
    <!-- 测试sql -->
    <select id="testMapper1" parameterType="int" resultType="AlertVo">
    <!-- resultType="hashmap" mybatis内置了java类型的别名（大小写不敏感）， 直接返回HashMap集合 -->
        select * from t_alert where id=#{id}
    </select>

    <!-- AlarmProcessTool模块SQL -->
    <resultMap id="allDevMap" type="DeviceBean">
        <id property="key_v" column="key_v" javaType="String"/>
        <result property="id" column="id"/>
        <result property="corpId" column="corpid"/>
        <result property="ip" column="ip"/>
        <result property="name" column="name"/>
        <result property="fetchIp" column="ip_fetch"/>
        <result property="showName" column="showname"/>
    </resultMap>
    <select id="queryAllDevices" resultMap="allDevMap" parameterType="map">
        select  
        cast(concat(ip,'&amp;',ip_fetch) as char) as key_v,  
        <!-- xml对&符号做了预定义，使用&amp;代替&符号 -->
        id, 
        corpid, 
        ip, 
        name, 
        ip_fetch,    
        showname
        from t_device
    </select>

</mapper>

此时，若要查询获得Map实体，通过动态代理的接口类直接调用接口方法查找不太好实现，但直接使用SqlSession.selectMap(String statement, Object parameter, String mapKey)方法方便，上代码：

SqlSession session = null;
        try {
            String resource = "myBatis_test/data/mybatis-config.xml";
            InputStream inputStream;
            inputStream = Resources.getResourceAsStream(resource);
            fac = new SqlSessionFactoryBuilder().build(inputStream);
            // 开启session
            session = fac.openSession();
            //因查找返回的map<String,DeviceBean>实体类，在接口中声明后，声明的接口中没有传递mapkey的参数列，采用直接调用xml配置列的语句，可实现返回map实体类的方法。
            Map<String, DeviceBean> map = session.selectMap("queryAllDevices", null,"key_v");
            int i=1;
            for(Entry<String, DeviceBean> e : map.entrySet()) {
                System.out.println(i++ +"   value："+e.getValue().getFetchIp()+"  key值："+e.getKey());
            }
        } catch (Exception e){
            e.printStackTrace();
        } finally {
            // 关闭session
            session.close();
        }