mybatis由浅入深day01_5.3 Mapper动态代理方法

　　5.3 Mapper动态代理方法（程序员只需要写mapper接口（相当于dao接口））

　　　　5.3.1 实现原理（mapper代理开发规范）

程序员还需要编写mapper.xml映射文件

程序员编写mapper接口（相当于Dao接口）需要遵循一些开发规范，mybatis可以自动生成mapper接口实现类代理对象。

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

1、在mapper.xml中namespace等于mapper接口地址

2、mapper.java接口中的方法名和mapper.xml中statement的id一致

3、mapper.java接口中的方法输入参数类型和mapper.xml中statement的parameterType指定的类型一致。

4、mapper.java接口中的方法返回值类型和mapper.xml中statement的resultType指定的类型一致。

总结：

以上开发规范主要是对下边的代码进行统一生成：

User user = sqlSession.selectOne("test.findUserById", id);

sqlSession.insert("test.insertUser", user);

。。。。

　　　　5.3.2 mapper.java

　　　　5.3.3 mapper.xml

定义mapper映射文件UserMapper.xml（内容同Users.xml），需要修改namespace的值为 UserMapper接口路径。将UserMapper.xml放在classpath 下mapper目录 下。

　　　　5.3.4 在SqlMapConfig.xml中加载mapper.xml

　　　　5.3.5 测试

　　　　5.3.6 补充完整：

接口定义有如下特点：

1、Mapper接口方法名和Mapper.xml中定义的statement的id相同

2、Mapper接口方法的输入参数类型和mapper.xml中定义的statement的parameterType的类型相同

3、Mapper接口方法的输出参数类型和mapper.xml中定义的statement的resultType的类型相同

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进行分类化管理，用于隔离sql语句
    注意：使用mapper代理方法开发，namespace有特殊重要的作用，namespace等于mapper接口地址-->
<mapper namespace="cn.itcast.mybatis.mapper.UserMapper">
    <!-- 在 映射文件中配置很多sql语句 -->
    <!-- 需求：通过id查询用户表的记录 -->
    <!-- 通过 select执行数据库查询
        id：标识 映射文件中的 sql
        将sql语句封装到mappedStatement对象中，所以将id称为statement的id
        parameterType：指定输入 参数的类型，这里指定int型
        #{}表示一个占位符号
        #{id}：其中的id表示接收输入的参数，参数名称就是id，如果输入 参数是简单类型，#{}中的参数名可以任意，可以value或其它名称

        resultType：指定sql输出结果 的所映射的java对象类型，select指定resultType表示将单条记录映射成的java对象。-->
     <select id="findUserById" parameterType="int" resultType="cn.itcast.mybatis.po.User">
         SELECT * FROM USER WHERE id=#{value}
     </select>

     <!-- 模拟用户名称模糊查询用户信息
         resultType：指定就是单条记录所映射的java对象类型
         ${}:表示拼接sql串，将接收到参数的内容不加任何修饰拼接在sql中。
        使用${}拼接sql，引起 sql注入
        ${value}：接收输入 参数的内容，如果传入类型是简单类型，${}中只能使用value
      -->
     <select id="findUserByName" parameterType="java.lang.String" resultType="cn.itcast.mybatis.po.User">
         SELECT * FROM USER WHERE USERNAME LIKE '%${value}%'
     </select>

     <!-- 添加用户
        parameterType：指定输入 参数类型是pojo（包括 用户信息）
        #{}中指定pojo的属性名，接收到pojo对象的属性值，mybatis通过OGNL获取对象的属性值
        不用写id，自增的
    -->
    <insert id="insertUser" parameterType="cn.itcast.mybatis.po.User">
        <!--
            将插入数据的主键返回，返回到user对象中

            SELECT LAST_INSERT_ID()：得到刚insert进去记录的主键值，只适用于自增主键

            keyProperty：将查询到主键值设置到parameterType指定的对象的哪个属性
            order：SELECT LAST_INSERT_ID()执行顺序，相对于insert语句来说它的执行顺序
            resultType：指定SELECT LAST_INSERT_ID()的结果类型
         -->
         <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
             SELECT LAST_INSERT_ID()
         </selectKey>
        insert into user(username,birthday,sex,address) value(#{username},#{birthday},#{sex},#{address})

        <!--
            使用mysql的uuid（）生成主键
            执行过程：
            首先通过uuid()得到主键，将主键设置到user对象的id属性中
            其次在insert执行时，从user对象中取出id属性值
         -->
        <!--  <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">
            SELECT uuid()
        </selectKey>
        insert into user(id,username,birthday,sex,address) value(#{id},#{username},#{birthday},#{sex},#{address}) -->
    </insert>

    <!-- 删除用户
        根据id删除用户，需要输入id值
     -->
     <delete id="deleteUser" parameterType="java.lang.Integer">
         delete from user where id=#{id}
     </delete>

     <!-- 根据id更新用户
     分析：
        需要传入用户的id
        需要传入用户的更新信息
        parameterType指定user对象，包括 id和更新信息，注意：id必须存在
        #{id}：从输入 user对象中获取id属性值
      -->
      <update id="updateUser" parameterType="cn.itcast.mybatis.po.User">
          update user set username=#{username},birthday=#{birthday},sex=#{sex},address=#{address}
          where id=#{id}
      </update>
</mapper>

UserMapperTest.java

import java.io.IOException;
import java.io.InputStream;
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.Before;
import org.junit.Test;

import cn.itcast.mybatis.po.User;

public class UserMapperTest {

    SqlSessionFactory sqlSessionFactory;

    @Before
    public void setUp() throws IOException {
        //创建SqlSessionFactory

        // mybatis配置文件
        String resource = "SqlMapConfig.xml";

        // 得到配置文件流
        InputStream inputStream = Resources.getResourceAsStream(resource);

        // 创建回话工厂，传入mybatis的配置文件信息
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    }

    @Test
    public void testFindUserById() {

        SqlSession sqlSession = sqlSessionFactory.openSession();

        //创建UserMapper对象,mybatis自动生成mapper代理对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

        //调用userMapper的方法
        User user = userMapper.findUserById(29);
        System.out.println(user);
    }

    @Test
    public void testFindUserByName() {

        SqlSession sqlSession = sqlSessionFactory.openSession();

        //创建UserMapper对象,mybatis自动生成mapper代理对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

        //调用userMapper的方法
        List<User> list = userMapper.findUserByName("小明");
        sqlSession.close();
        System.out.println(list);
    }

    @Test
    public void testDeleteUser() {

        SqlSession sqlSession = sqlSessionFactory.openSession();

        //创建UserMapper对象,mybatis自动生成mapper代理对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

        //调用userMapper的方法
        userMapper.deleteUser(24);
        sqlSession.commit();
        sqlSession.close();
    }
}

　　　　5.3.7 一些问题总结

　　　　　　5.3.7.1 代理对象内部调用selectOne或selectList

如果mapper方法返回单个pojo对象（非集合对象），代理对象内部通过selectOne查询数据库。

如果mapper方法返回集合对象，代理对象内部通过selectList查询数据库。

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

　　　　　　5.3.7.2 mapper接口方法参数只能有一个是否影响系统开发

mapper接口方法参数只能有一个，系统是否不利于扩展维护。

系统框架中，dao层的代码是被业务层公用的。

即使mapper接口只有一个参数，可以使用包装类型的pojo满足不同的业务方法的需求。

注意：持久层方法的参数可以包装类型、map。。。，service方法中建议不要使用包装类型（不利于业务层的可扩展）。

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