2. 概述

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

在本章中详细说明了 KingbaseES 对 MyBatis的支持情况，以及使用时应该注意的问题。

本章内容主要是基于 MyBatis 3 及后续版本支持情况的详细描述。

3. MyBatis配置说明

Mybatis的jar包可以从官方网站下载，Mybatis所使用的JDBC包kingbase8-8.6.0.jar位于$KINGBASE_HOME/Interface/jdbc目录下。使用时将Mybatis包和JDBC包导入到项目的Libraries中并定义相关配置项即可。

定义Mybatis配置文件，根据用户选择，更改一下配置文件。

1. 在config.xml中配置JDBC的驱动信息参数，数据库服务器信息参数和登陆用户信息参数。当然，这些参数也可以根据用户应用需求， 单独生成property文件，针对不用的应用场景，导入不同的属性文件。这里以property为例说明下config.xml的配置使用。

在property 中增加如下声明：

jdbc.driverClassName=com.kingbase8.Driver
jdbc.url=jdbc:kingbase8://localhost:54321/TEST
jdbc.username=登录名
jdbc.password=登录密码

在config.xml 中增加如下声明：

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

1. 在mapper.xml中，主要是配置SQL映射关系，根据用户的需求，自定义映射关系。这里以一个简单的配置为例。

在mapper.xml 中增加如下声明：

<mapper namespace="com.test.interfaces.MybatisDao">
    <update id="dropTable">
        DROP TABLE IF EXISTS ${sql} CASCADE
    </update>
    <update id="createNewTableMap" parameterType="java.util.HashMap">
        ${sql}
    </update>

    <resultMap id="NumTableMap" type="NumEntity">
        <result column="id" property="userId" />
        <result column="age" property="userAge" />
        <result column="name" property="userName" />
        <result column="wage" property="userWage" />
        <result column="cost" property="userCost" />
    </resultMap>

    <select id="selectNumTable" resultMap="NumTableMap">
        select * from t_num
    </select>
    <select id="selectNumTableByID" parameterType="int"
    resultMap="NumTableMap">
        select * from t_num where id=#{value}
    </select>
    <select id="selectNumTableByAge" parameterType="int"
    resultMap="NumTableMap">
        select * from t_num where age=#{value}
    </select>
    <select id="selectNumTableByName" parameterType="string"
    resultMap="NumTableMap">
        select * from t_num where name=#{value}
    </select>
    <insert id="insertNumTable" parameterType="NumEntity"
    keyProperty="userId">
        insert into t_num(id,age,name,wage,cost)
            values(#{userId},#{userAge},#{userName},#{userWage},#{userCost})
    </insert>
    <update id="updateNumTableById" parameterType="NumEntity" >
        update t_num set age=#{userAge},name=#{userName},wage=#{userWage},
            cost=#{userCost}where id=#{userId}
    </update>
    <delete id="deleteNumTableById" parameterType="int">
        delete from t_num where id=#{value}
    </delete>
    <delete id="deleteNumTable">
        delete from t_num
    </delete>
</mapper>

至此，MyBatis的属性文件和映射文件的配置工作已经完成，接下来是来完成Java中对应的接口和实例的开发工作。示例如下：

1. 在Java中读取property和config属性，配置到sqlSessionFactory：

@BeforeClass
public static void setUpClass() throws Exception {
    InputStream fis = null;
    InputStream inputStream = null;
    try {
        /* 创建一个 sqlSessionFactory */
        Properties prop = new Properties();
        fis = Resources.getResourceAsStream("propertty");
        prop.load(fis);
        inputStream = Resources.getResourceAsStream("MyConfig.xml");
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream,
        "development", prop);
    } catch(Exception e) {
        e.printStackTrace();
    }
}

1. 在Java中配置mapper.xml对应的namespace，为Interface类型：

public interface MybatisDao {
    int createNewTableMap(Map<String, Object> param);
    int dropTable(Map<String, Object> param);
    /*
     * new number table
     */
    public List<NumEntity> selectNumTable();
    public NumEntity selectNumTableByID(int id);
    public List<NumEntity> selectNumTableByAge(int age);
    public List<NumEntity> selectNumTableByName(String name);
    public void insertNumTable(NumEntity user);
    public void updateNumTableById(NumEntity user);
    public void deleteNumTableById(int id);
    public void deleteNumTable();
}

1. 在Java中进行表的查询操作：

public void testNumTable() {
    SqlSession session = sqlSessionFactory.openSession();
    int i = 1;
    try {
        MybatisDao userOperation = session.getMapper(MybatisDao.class);
        List<NumEntity> users = userOperation.selectNumTable();
        for (NumEntity user : users) {
            System.out.println(user);
            Assert.assertEquals(i, user.getId());
            Assert.assertEquals(AGE+i, user.getUserAge());
            Assert.assertEquals(name[i], user.getUserName());
            Assert.assertEquals("yes",WAGE+(double)(i*100)/(double)(3.0),
            user.getUserWage(),0.000001);
            Assert.assertEquals("yes",COST+(double)(i*100)/(double)(3.0),
            user.getUserCost(),0.01);
            i++;
        }
    } finally {
        session.close();
    }
}

1. 在Java中进行表的插入操作：

public void testInsertNumTable() {
    int i = 1 ;
    SqlSession session = sqlSessionFactory.openSession();
    try {
        MybatisDao userOperation = session.getMapper(MybatisDao.class);
        NumEntity user = new NumEntity();
        name[1] = "张三";
        name[2] = "李四";
        name[3] = "王五";
        name[4] = "赵二";
        name[5] = "小北";
        name[6] = "小东";
        name[7] = "小西";
        name[8] = "小南";
        name[9] = "小明";
        for (i=1;i<10;i++) {
            user.setId(i);
            user.setUserAge(AGE+i);
            user.setUserName(name[i]);
            user.setUserWage(WAGE+(double)(i*100)/(double)(3.0));
            user.setUserCost(COST+(double)(i*100)/(double)(3.0));
            userOperation.insertNumTable(user);
            session.commit();
            System.out.println(user);
        }
    } finally {
        session.close();
    }
}

1. 在Java中进行表的更新操作：

public void testUpdateNumTable() {
    int i = 1 ;
    SqlSession session = sqlSessionFactory.openSession();
    try {
        MybatisDao userOperation = session.getMapper(MybatisDao.class);
        NumEntity user = new NumEntity();
        /* 更新一行新的数据id=1 */
        user = userOperation.selectNumTableByID(1);
        user.setUserAge(AGE+i);
        user.setUserName(name[0]);
        user.setUserWage(WAGE+(double)(i*100)/(double)(3.0));
        user.setUserCost(COST+(double)(i*100)/(double)(3.0));
        userOperation.updateNumTableById(user);
        session.commit();
    } finally {
        session.close();
    }
}

1. 在Java中进行表的删除操作：

public void testDeleteNumTable() {
    int i = 1 ;
    SqlSession session = sqlSessionFactory.openSession();

    try {
        MybatisDao userOperation = session.getMapper(MybatisDao.class);
        userOperation.deleteNumTable();
        session.commit();
    } finally {
        session.close();
    }
}

到这里为止，在Java中对数据库的表操作就完成了，这里只是简单的示例，可能实际的应用场景的业务逻辑比较复杂，SQL的语句也比较复杂，但是MyBatis的使用精髓就是这些，可以在这些基础上去实现丰富的应用。