Mybatis学习笔记之一（环境搭建和入门案例介绍）

一、Mybatis概述

1.1 Mybatis介绍

　　MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。

　　MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。

　　Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。

1.2 JDBC操作数据库

【JDBC】操作步骤

　　1、加载数据库驱动

　　2、创建并获取数据库链接

　　3、创建jdbc statement对象

　　4、设置sql语句

　　5、设置sql语句中的参数(使用preparedStatement)

　　6、通过statement执行sql并获取结果

　　7、对sql执行结果进行解析处理

　　8、释放资源(resultSet、preparedstatement、connection)

【编写一个JDBC程序】

public static void main(String[] args) {
    Connection connection = null;
    PreparedStatement preparedStatement = null;
    ResultSet resultSet = null;

    try {
        // 加载数据库驱动
        Class.forName("com.mysql.jdbc.Driver");

        // 通过驱动管理类获取数据库链接
        connection = DriverManager.getConnection("jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8", "root", "admin");
        // 定义sql语句 ?表示占位符
        String sql = "select * from user where username = ?";
        // 获取预处理statement
        preparedStatement = connection.prepareStatement(sql);
        // 设置参数，第一个参数为sql语句中参数的序号（从1开始），第二个参数为设置的参数值
        preparedStatement.setString(1, "kevin");
        // 向数据库发出sql执行查询，查询出结果集
        resultSet = preparedStatement.executeQuery();
        // 遍历查询结果集
        while (resultSet.next()) {
            System.out.println(resultSet.getString("id") + "  " + resultSet.getString("username"));
        }
    } catch (Exception e) {
        e.printStackTrace();
    } finally {
        // 释放资源
        if (resultSet != null) {
            try {
                resultSet.close();
            } catch (SQLException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            }
        }
        if (preparedStatement != null) {
            try {
                preparedStatement.close();
            } catch (SQLException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            }
        }
        if (connection != null) {
            try {
                connection.close();
            } catch (SQLException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            }
        }
    }
}

【JDBC问题总结如下】

　　● 数据库连接创建、释放频繁造成系统资源浪费，从而影响系统性能。如果使用数据库连接池可解决此问题。

　　● Sql语句在代码中硬编码，造成代码不易维护，实际应用中sql变化的可能较大，sql变动需要改变java代码。

　　● 使用preparedStatement向占有位符号传参数存在硬编码，因为sql语句的where条件不一定，可能多也可能少，修改sql还要修改代码，系统不易维护。

　　● 对结果集解析存在硬编码（查询列名），sql变化导致解析代码变化，系统不易维护，如果能将数据库记录封装成pojo对象解析比较方便。

1.3 Mybatis架构

● mybatis配置

　　SqlMapConfig.xml，此文件作为mybatis的全局配置文件，配置了mybatis的运行环境等信息。

　　mapper.xml文件即sql映射文件，文件中配置了操作数据库的sql语句。此文件需要在SqlMapConfig.xml中加载。

● 通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂

● 由会话工厂创建sqlSession即会话，操作数据库需要通过sqlSession进行。

● mybatis底层自定义了Executor执行器接口操作数据库，Executor接口有两个实现，一个是基本执行器、一个是缓存执行器。

● Mapped Statement也是mybatis一个底层封装对象，它包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个Mapped Statement对象，sql的id即是Mapped statement的id。

● Mapped Statement对sql执行输入参数进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。

● Mapped Statement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。

 

二、Mybatis入门案例

2.1 Mybatis下载

mybatis的代码由github.com管理，下载网址：https://github.com/mybatis/mybatis-3/releases

下载完成解压后文件目录如下：

　　mybatis-3.2.7.jar mybatis的核心包

　　lib文件夹 mybatis的依赖包所在

　　mybatis-3.2.7.pdf mybatis使用手册

2.2 环境搭建

【导入jar包（包括核心jar包、依赖包、数据库驱动包）】

【创建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>
    
    <properties resource="log4j.properties"/> 
    <!-- 起别名 包以及包下所有的子包 -->
    <typeAliases>
        <!-- <typeAlias type="com.kevin.entity.User" alias="User"/> -->
        <package name="com.kevin.entity"/>
    </typeAliases>

    <!-- 和spring整合后 environments配置将废除 -->
    <environments default="development">
        <environment id="development">
            <!-- 使用jdbc事务管理 -->
            <transactionManager type="JDBC" />
            <!-- 数据库连接池 -->
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.jdbc.Driver" />
                <property name="url"
                    value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8" />
                <property name="username" value="root" />
                <property name="password" value="admin" />
            </dataSource>
        </environment>
    </environments>
</configuration>

　　SqlMapConfig.xml是mybatis的核心配置文件，配置文件内容为数据源、事务管理。

【编写一个User类】 

package com.kevin.entity;

import java.io.Serializable;
import java.util.Date;

public class User implements Serializable {
    /**
     * 创建一个简单的bean
     */
    private static final long serialVersionUID = 1L;
    private Integer id;
    private String username;// 用户姓名
    private String sex;// 性别
    private Date birthday;// 生日
    private String address;// 地址


    public Integer getId() {
        return id;
    }
    public void setId(Integer id) {
        this.id = id;
    }
    public String getUsername() {
        return username;
    }
    public void setUsername(String username) {
        this.username = username;
    }
    public String getSex() {
        return sex;
    }
    public void setSex(String sex) {
        this.sex = sex;
    }
    public Date getBirthday() {
        return birthday;
    }
    public void setBirthday(Date birthday) {
        this.birthday = birthday;
    }
    public String getAddress() {
        return address;
    }
    public void setAddress(String address) {
        this.address = address;
    }
    @Override
    public String toString() {
        return "User [id=" + id + ", username=" + username + ", sex=" + sex
                + ", birthday=" + birthday + ", address=" + address + "]";
    }

}

【创建sql映射文件User.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：命名空间，用于隔离sql -->

<mapper namespace="user">

</mapper>

【在SqlMapConfig.xml中加载映射文件】

    <mappers>
        <!-- <mapper resource="sqlmap/User.xml"/> -->
        <!-- <mapper class="com.kevin.mapper.UserMapper"/> -->
        <package name="com.kevin.mapper"/>
        
    </mappers>

2.3 在Mybatis中实现CRUD操作

【根据id查询用户】

在User.xml中添加select标签，编写sql：

    <!-- 通过id查询一个用户 -->
    <select id="findUserById" parameterType="Integer" resultType="User">
        select * from user  where id = #{v}
    </select>

创建一个测试类编写测试代码：

    /**
     * 根据用户id查询
     * @throws Exception
     */
    @Test
    public void test() throws Exception{
        //加载核心配置文件
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        //创建SqlSessionFactory
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        //创建SqlSession
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        //执行sql语句
        User user = sqlSession.selectOne("user.findUserById", 10);
        
        System.out.println(user);
    
    }

【根据用户名称进行模糊查询】

在User.xml中添加select标签，编写sql：

<select id="findUserByName" parameterType="String" resultType="com.kevin.entity.User">
         select * from user where username like "%"#{va}"%"
     </select>

或者

<select id="findUserByName" parameterType="String" resultType="com.kevin.entity.User">
         select * from user where username like '%${value}%'
     </select>

编写测试代码：

    /**
     * 根据用户名称模糊查询
     * @throws IOException 
     */
    @Test
    public void test2() throws Exception{
        //加载核心配置文件
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        //创建sqlsessionfactory
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        //创建sqlsession
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        //执行sql语句
        List<User> users = sqlSession.selectList("user.findUserByName","五");
        for (User user : users) {
            System.out.println(user);
        }
    }

小结：区分#{ }和${ }

　　#{}表示一个占位符号，通过#{}可以实现preparedStatement向占位符中设置值，自动进行java类型和jdbc类型转换。#{}可以有效防止sql注入。 #{}可以接收简单类型值或pojo属性值。 如果parameterType传输单个简单类型值，#{}括号中可以是value或其它名称。

　　${}表示拼接sql串，通过${}可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换， ${}可以接收简单类型值或pojo属性值，如果parameterType传输单个简单类型值，${}括号中只能是value。

parameterType和resultType

　　parameterType：指定输入参数类型，mybatis通过ognl从输入对象中获取参数值拼接在sql中。

　　resultType：指定输出结果类型，mybatis将sql查询结果的一行记录数据映射为resultType指定类型的对象。如果有多条数据，则分别进行映射，并把对象放到容器List中

selectOne和selectList

　　selectOne查询一条记录，如果使用selectOne查询多条记录则抛出异常：

　　selectList可以查询一条或多条记录。

【添加用户】

在User.xml中添加insert标签，编写sql：

     <!-- 添加用户 -->
     <insert id="insertUser" parameterType="com.kevin.entity.User">
         <selectKey keyProperty="id" resultType="Integer" order="AFTER">
             select LAST_INSERT_ID()
         </selectKey>
         insert into user(username,birthday,address,sex) 
         values(#{username},#{birthday},#{address},#{sex})
     </insert>

　　其中，LAST_INSERT_ID( )是mysql的函数，返回auto_increment自增列新记录id值。

　　如果自增主键形式为uuid，可使用如下配置：

    <selectKey keyColumn="id" keyProperty="id" order="BEFORE"
        resultType="string">
        SELECT LAST_INSERT_ID()
    </selectKey>

编写测试代码：

    /**
     * 保存用户
     */
    @Test
    public void test3() throws Exception{
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        User user = new User();
        user.setUsername("Michael");
        user.setBirthday(new Date());
        user.setAddress("China");
        user.setSex("Male");        
        sqlSession.insert("user.insertUser",user);
        sqlSession.commit();
        
        //获取最新保存用户的id
        System.out.println(user.getId());
    }

【更新用户】

在User.xml中添加update标签，编写sql：

     <!-- 更新用户 -->
     <update id="updateUserById" parameterType="com.kevin.entity.User">
         update user
         set username = #{username},sex = #{sex},birthday = #{birthday},address = #{address}
         where id = #{id}
     </update>

编写测试代码：

/**
     * 更新用户
     * @throws Exception 
     */
    @Test
    public void test4() throws Exception{
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        User user = new User();
        user.setId(24);
        user.setUsername("Michel");
        user.setBirthday(new Date());
        user.setAddress("America");        
        user.setSex("Female");
        sqlSession.update("user.updateUserById", user);
        sqlSession.commit();
    }

【删除用户】

在User.xml中添加delete标签，编写sql：

     <!-- 删除用户 -->
     <delete id="deleteUserById" parameterType="Integer">
         delete from user where id = #{id}
     </delete>

编写测试代码：

    /**
     * 删除用户
     * @throws Exception 
     */
    @Test
    public void test5() throws Exception{
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        sqlSession.delete("user.deleteUserById", 27);
        sqlSession.commit();
    }

三、Mybatis框架优势（面试常考）

3.1 Mybatis解决了使用JDBC编程产生的问题

　　● 数据库连接创建、释放频繁造成系统资源浪费从而影响系统性能，如果使用数据库连接池可解决此问题。

解决：在SqlMapConfig.xml中配置数据连接池，使用连接池管理数据库链接。

　　● Sql语句写在代码中造成代码不易维护，实际应用sql变化的可能较大，sql变动需要改变java代码。

解决：将Sql语句配置在XXXXmapper.xml文件中与java代码分离。

　　● 向sql语句传参数麻烦，因为sql语句的where条件不一定，可能多也可能少，占位符需要和参数一一对应。

解决：Mybatis自动将java对象映射至sql语句，通过statement中的parameterType定义输入参数的类型。

　　● 对结果集解析麻烦，sql变化导致解析代码变化，且解析前需要遍历，如果能将数据库记录封装成pojo对象解析比较方便。

解决：Mybatis自动将sql执行结果映射至java对象，通过statement中的resultType定义输出结果的类型。

3.2 Mybatis与Hibernate有哪些不同

　　● Mybatis和hibernate不同，它不完全是一个ORM框架，因为MyBatis需要程序员自己编写Sql语句。mybatis可以通过XML或注解方式灵活配置要运行的sql语句，并将java对象和sql语句映射生成最终执行的sql，最后将sql执行的结果再映射生成java对象。

　　● Mybatis学习门槛低，简单易学，程序员直接编写原生态sql，可严格控制sql执行性能，灵活度高，非常适合对关系数据模型要求不高的软件开发，例如互联网软件、企业运营类软件等，因为这类软件需求变化频繁，一但需求变化要求成果输出迅速。但是灵活的前提是mybatis无法做到数据库无关性，如果需要实现支持多种数据库的软件则需要自定义多套sql映射文件，工作量大。

　　● Hibernate对象/关系映射能力强，数据库无关性好，对于关系模型要求高的软件（例如需求固定的定制化软件）如果用hibernate开发可以节省很多代码，提高效率。但是Hibernate的学习门槛高，要精通门槛更高，而且怎么设计O/R映射，在性能和对象模型之间如何权衡，以及怎样用好Hibernate需要具有很强的经验和能力才行。

　　总之，按照用户的需求在有限的资源环境下只要能做出维护性、扩展性良好的软件架构都是好架构，所以框架只有适合才是最好。 

 

 

四、原始Dao开发方法

　　使用MyBatis开发Dao，通常有两个方法，即原始Dao开发方法和Mapper动态代理开发方法。

【SqlSession】

　　SqlSession中封装了对数据库的操作，如：查询、插入、更新、删除等。

　　SqlSession通过SqlSessionFactory创建。

　　SqlSessionFactory是通过SqlSessionFactoryBuilder进行创建。

【SqlSessionFactoryBuilder】

　　SqlSessionFactoryBuilder用于创建SqlSessionFacoty，SqlSessionFacoty一旦创建完成就不需要SqlSessionFactoryBuilder了，因为SqlSession是通过SqlSessionFactory创建的。所以可以将SqlSessionFactoryBuilder当成一个工具类使用，最佳使用范围是方法范围即方法体内局部变量。

【SqlSessionFactory】

　　SqlSessionFactory是一个接口，接口中定义了openSession的不同重载方法，SqlSessionFactory的最佳使用范围是整个应用运行期间，一旦创建后可以重复使用，通常以单例模式管理SqlSessionFactory。

【SqlSession】

　　SqlSession是一个面向用户的接口，sqlSession中定义了数据库操作方法。

　　每个线程都应该有它自己的SqlSession实例。SqlSession的实例不能共享使用，它也是线程不安全的。因此最佳的范围是请求或方法范围。绝对不能将SqlSession实例的引用放在一个类的静态字段或实例字段中。

　　原始Dao开发方法需要编写Dao类和Dao实现类

4.1 编写映射文件如下

<?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：命名空间，用于隔离sql，还有一个很重要的作用，后面会讲 -->

<mapper namespace="com.kevin.mapper.UserMapper">
    <!-- 通过id查询一个用户 -->
    <select id="findUserById" parameterType="Integer" resultType="User">
        select * from user  where id = #{v}
    </select>
    
    <!-- 根据用户名称模糊查询
        #{} 占位符  ？ == ''
        ${} 字符串拼接   '% %'
     -->
     <select id="findUserByName" parameterType="String" resultType="com.kevin.entity.User">
         select * from user where username like "%"#{va}"%"
     </select>
     
     <!-- 添加用户 -->
     <!-- selectKey 标签实现主键返回 -->
     <!-- keyColumn:主键对应的表中的哪一列 -->
     <!-- keyProperty：主键对应的pojo中的哪一个属性 -->
     <!-- order：设置在执行insert语句前执行查询id的sql，孩纸在执行insert语句之后执行查询id的sql -->
     <!-- resultType：设置返回的id的类型 -->
     <insert id="insertUser" parameterType="com.kevin.entity.User">
         <selectKey keyProperty="id" resultType="Integer" order="AFTER">
             select LAST_INSERT_ID()
         </selectKey>
         insert into user(username,birthday,address,sex) 
         values(#{username},#{birthday},#{address},#{sex})
     </insert>
     
     <!-- 更新用户 -->
     <update id="updateUserById" parameterType="com.kevin.entity.User">
         update user
         set username = #{username},sex = #{sex},birthday = #{birthday},address = #{address}
         where id = #{id}
     </update>
     
     <!-- 删除用户 -->
     <delete id="deleteUserById" parameterType="Integer">
         delete from user where id = #{id}
     </delete>
    
</mapper>

4.2 Dao接口

package com.kevin.dao;

import com.kevin.entity.User;

public interface UserDao {
    
    public User selectUserById(Integer id);

}

4.3 Dao接口实现类

package com.kevin.dao.impl;

import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;

import com.kevin.dao.UserDao;
import com.kevin.entity.User;

public class UserDaoImpl implements UserDao {
    
    private SqlSessionFactory sqlSessionFactory;
    //注入SQLSessionFactory对象
    public UserDaoImpl(SqlSessionFactory sqlSessionFactory) {
        this.sqlSessionFactory = sqlSessionFactory;
    }
    //根据id查询客户
    public User selectUserById(Integer id){
        SqlSession sqlSession = sqlSessionFactory.openSession();
        return sqlSession.selectOne("user.findUserById", id);
    }
    

}

4.4 Dao测试

package com.kevin.junit;

import java.io.InputStream;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Before;
import org.junit.Test;

import com.kevin.dao.UserDao;
import com.kevin.dao.impl.UserDaoImpl;
import com.kevin.entity.User;

public class MybatisTestdao {
    
    private SqlSessionFactory sqlSessionFactory;
    @Before
    public void Before() throws Exception{
        //加载核心配置文件
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        //创建sqlsessionfactory
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
    }
    
    @Test
    public void test(){
        
        UserDao userDao = new UserDaoImpl(sqlSessionFactory);
        User user = userDao.selectUserById(30);
        System.out.println(user);
    }

}

4.5 产生的问题

　　● Dao方法体存在重复代码：通过SqlSessionFactory创建SqlSession，调用SqlSession的数据库操作方法

　　● 调用sqlSession的数据库操作方法需要指定statement的id，这里存在硬编码，不得于开发维护。

 

五、Mapper动态代理方式

5.1 开发规范

　　Mapper接口开发方法只需要程序员编写Mapper接口（相当于Dao接口），由Mybatis框架根据接口定义创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法。

Mapper接口开发需要遵循以下规范：

　　● Mapper.xml文件中的namespace与mapper接口的类路径相同。

　　● Mapper接口方法名和Mapper.xml中定义的每个statement的id相同

　　● Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql 的parameterType的类型相同

　　● Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同

5.2 创建UserMapper.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：命名空间，用于隔离sql，还有一个很重要的作用，后面会讲 -->

<mapper namespace="com.kevin.mapper.UserMapper">
    <!-- 通过id查询一个用户 -->
    <select id="findUserById" parameterType="Integer" resultType="User">
        select * from user  where id = #{v}
    </select>
    
    <!-- 根据用户名称模糊查询
        #{} 占位符  ？ == ''
        ${} 字符串拼接   '% %'
     -->
     <select id="findUserByName" parameterType="String" resultType="User">
         select * from user where username like "%"#{va}"%"
     </select>
     
     <!-- 添加用户 -->
     <insert id="insertUser" parameterType="User">
         <selectKey keyProperty="id" resultType="Integer" order="AFTER">
             select LAST_INSERT_ID()
         </selectKey>
         insert into user(username,birthday,address,sex) 
         values(#{username},#{birthday},#{address},#{sex})
     </insert>
     
     <!-- 更新用户 -->
     <update id="updateUserById" parameterType="User">
         update user
         set username = #{username},sex = #{sex},birthday = #{birthday},address = #{address}
         where id = #{id}
     </update>
     
     <!-- 删除用户 -->
     <delete id="deleteUserById" parameterType="Integer">
         delete from user where id = #{id}
     </delete>
    
</mapper>

5.3 创建UserMapper接口文件

package com.kevin.mapper;

import java.util.List;

import com.kevin.entity.User;

public interface UserMapper {
    
    /**
     * 遵循四个原则
     * 接口方法名和user.xml文件id值相同
     * 接口返回值和user.xml文件返回值相同
     * 接口入参类型和user.xml文件入参类型相同
     * 命名空间进行绑定
     */
    
    public User findUserById(Integer id);
    
    public List<User> findUserByName(String username);
    
    public void insertUser(User user);
    
    public void updateUserById(User user);
    
    public void deleteUserById(Integer id);

}

5.4 加载UserMapper配置文件

在SqlMapConfig.xml文件中进行如下配置：

    <mappers>
        <!-- <mapper resource="sqlmap/User.xml"/> -->
        <!-- <mapper class="com.kevin.mapper.UserMapper"/> -->
        <package name="com.kevin.mapper"/>
        
    </mappers>

5.5 编写测试类

package com.kevin.junit;

import java.io.InputStream;
import java.util.Date;
import java.util.List;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;

import com.kevin.entity.User;
import com.kevin.mapper.UserMapper;

public class MybatisMapper {
    
    /**
     * 测试mapper接口方式
     * @throws Exception 
     */
    //根据用户id查询
    @Test
    public void findUserById() throws Exception{
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        User user = userMapper.findUserById(30);
        System.out.println(user);
    }
    
    //根据用户名称查询
    @Test
    public void findUserByName() throws Exception{
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        List<User> users = userMapper.findUserByName("王");
        for (User user : users) {
            System.out.println(user);
        }
    }
    
    //添加用户
    @Test
    public void insertUser() throws Exception{
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        User user = new User();
        user.setUsername("Kevin");
        user.setAddress("China");
        user.setBirthday(new Date());
        user.setSex("Male");
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        userMapper.insertUser(user);
        sqlSession.commit();
    }
    
    //更新用户
    @Test
    public void updateUserById() throws Exception {
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        User user = new User();
        user.setId(25);
        user.setUsername("Jackson");
        user.setAddress("British");
        user.setBirthday(new Date());
        user.setSex("Male");
        userMapper.updateUserById(user);
        sqlSession.commit();

    }
    
    //删除用户
    @Test
    public void deleteUserById() throws Exception {
        String resource = "SqlMapConfig.xml";
        InputStream in = Resources.getResourceAsStream(resource);
        SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        userMapper.deleteUserById(32);
        sqlSession.commit();

    }

}

5.6 小结

selectOne和selectList

　　动态代理对象调用sqlSession.selectOne()和sqlSession.selectList()是根据mapper接口方法的返回值决定，如果返回list则调用selectList方法，如果返回单个对象则调用selectOne方法。

 

namespace

　　mybatis官方推荐使用mapper代理方法开发mapper接口，程序员不用编写mapper接口实现类，使用mapper代理方法时，输入参数可以使用pojo包装对象或map对象，保证dao的通用性。

六、SqlMapConfig.xml配置文件详解

6.1 配置内容

SqlMapConfig.xml中配置的内容和顺序如下：（其中黑体部分是需要重点掌握，其余已经废弃不用或不常用）

　　properties（属性）

　　settings（全局配置参数）

　　typeAliases（类型别名）

　　typeHandlers（类型处理器）

　　objectFactory（对象工厂）

　　plugins（插件）

　　environments（环境集合属性对象）

　　environment（环境子属性对象）

　　transactionManager（事务管理）

　　dataSource（数据源）

　　mappers（映射器）

6.2 typeAliases（类型别名）

别名	映射的类型
_byte	byte
_long	long
_short	short
_int	int
_integer	int
_double	double
_float	float
_boolean	boolean
string	String
byte	Byte
long	Long
short	Short
int	Integer
integer	Integer
double	Double
float	Float
boolean	Boolean
date	Date
decimal	BigDecimal
bigdecimal	BigDecimal
map	Map

6.3 自定义别名

    <typeAliases>
        <!-- <typeAlias type="com.kevin.entity.User" alias="User"/> -->
        <package name="com.kevin.entity"/>
    </typeAliases>

6.4 mappers映射器

 Mapper配置的几种方法：

    <mappers>
        <!-- <mapper resource="sqlmap/User.xml"/> -->
        <!-- <mapper class="com.kevin.mapper.UserMapper"/> -->
        <package name="com.kevin.mapper"/>
        
    </mappers>

● <mapper resource=" " />

使用相对于类路径的资源（现在的使用方式）

如：<mapper resource="sqlmap/User.xml" />

● <mapper class=" " />

使用mapper接口类路径

如：<mapper class="com.kevin.mapper.UserMapper"/>

注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

● <package name=""/>

注册指定包下的所有mapper接口

如：<package name="com.kevin.mapper"/>

注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。