【MyBatis框架】Mybatis开发dao方法第二部分

下面来继续讨论mybatis开发Dao的方法

我们前面使用原始的Dao开发方法，发现了许多弊端，我们下面使用mapper代理来写Dao方法。

1.mapper代理方法（程序员只需要mapper接口（相当 于dao接口））

开发人员需要先编写Mapper接口(相当 于dao接口)，需要遵循一些开发规范，mybatis可以自动生成mapper接口实现类代理对象。

[java]  view plain  copy

1. package cn.edu.hpu.mybatis.mapper;  
2.   
3. import cn.edu.hpu.mybatis.PO.User;  
4.   
5. //用户管理的Dao接口  
6. public interface UserMapper {  
7.       
8.     //根据Id查询用户信息  
9.     public User findUserById(int id) throws Exception;  
10.       
11.     //添加用户信息  
12.     public void insertUser(User user) throws Exception;  
13.       
14.     //删除用户信息  
15.     public void deleteUser(int id) throws Exception;  
16.       
17.     //修改用户信息  
18.     public void updateUser(User user) throws Exception;  
19.   
20.   
21.     //根据姓名查找用户  
22.     public List<User> findUserByUserName(String username) throws Exception;  
23. }  

开发人员还要编写mapper.xml映射文件

我们在src同文件夹下的config文件夹下创建mapper包，在包下创建UserMapper.xml文件，内容同之前写过的User.xml文件一样。

[html]  view plain  copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <!DOCTYPE mapper  
3. PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"  
4. "http://mybatis.org/dtd/mybatis-3-mapper.dtd">  
5.   
6. <!-- namespace命名空间，作用就是对sql进行分类化管理，理解sql隔离  
7. 注意:使用mapper代理方法开发，namespace有特殊重要的作用，就是对应的mapper接口地址 -->  
8. <mapper namespace="cn.edu.hpu.mybatis.mapper.UserMapper">  
9.     <!-- 在映射文件中配置很多sql语句 -->  
10.       
11.     <!-- 需求:通过id查询用户表的记录 -->  
12.     <!-- 通过select执行数据库查询，  
13.          id:标示映射文件中的sql，成为Statement的id   
14.          将sql语句封装到mappedStatement对象中，所以将id称为statement的id,  
15.            
16.          parameterType:指定输入参数的类型，  
17.            
18.          #{}标示一个占位符,  
19.            
20.          #{id}其中id表示接收输入参数的名称，如果输入参数是简单类型，那么#{}中的值可以任意(如value)。  
21.            
22.          resultType：指定sql输出结果的映射的java对象类型，  
23.          select指定resultType表示将单条记录映射成java对象-->     
24.     <select id="findUserById" parameterType="int" resultType="cn.edu.hpu.mybatis.PO.User">  
25.       SELECT * FROM USER WHERE id=#{id}  
26.     </select>  
27.       
28.     <!-- ${}:表示拼接sql串，将接收到的参数内容不加任何修饰拼接在sql中。  
29.          使用${}拼接sql，引起sql注入。  
30.          ${}中只能使用value-->  
31.     <select id="findUserByUserName" parameterType="java.lang.String"   
32.             resultType="cn.edu.hpu.mybatis.PO.User">  
33.        select * from user where username like '%${value}%'   
34.     </select>  
35.       
36.     <!-- 添加用户  
37.     parameterType：指定输入参数类型是pojo(包括用户信息)   
38.     #{}中指定POJO的属性名，接收到POJO对象的属性值，mybatis通过OGNL获取对象的属性  
39.     -->  
40.     <insert id="insertUser" parameterType="cn.edu.hpu.mybatis.PO.User">  
41.         <!-- 将插入数据的主键返回，返回到user对象中。  
42.         SELECT_INSERT_ID():得到刚insert进去的主键值，只适用于自增主键   
43.         KeyProperty:将查询到主键值设置到parameterType指定对象的哪个属性。  
44.         order:SELECT LAST_INSERT_ID()执行顺序，相对于insert语句来说它的执行顺序  
45.         -->  
46.         <selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">  
47.             SELECT LAST_INSERT_ID()  
48.         </selectKey>  
49.           
50.         <!-- 使用MySql的UUID来生成主键  
51.         执行过程:  
52.         首先通过uuid()得到主键，将主键设置到user对象的id属性中  
53.         其次在insert执行时，从user对象中取出id属性值   
54.         <selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">  
55.             SELECT uuid()  
56.         </selectKey>  
57.         insert into user(id,birthday,sex,address) value(#{id},#{birthday,jdbcType=DATE},#{sex},#{address})-->  
58.           
59.         insert into user(username,birthday,sex,address) value(#{username},#{birthday,jdbcType=DATE},#{sex},#{address})  
60.     </insert>  
61.       
62.     <!-- 删除用户 -->  
63.     <delete id="deleteUser" parameterType="java.lang.Integer">  
64.         delete from user where id=#{id}  
65.     </delete>  
66.       
67.     <!-- 更新用户   
68.     分析:  
69.     需要传入用户的id，需要传入用户的更新信息.  
70.     parameterType指定user对象，包括id和更新信息(注意:id必须存在)  
71.     #{id}:从输入user对象中获取id属性值-->  
72.     <update id="updateUser" parameterType="cn.edu.hpu.mybatis.PO.User">  
73.         update user set username=#{username},birthday=#{birthday,jdbcType=DATE},sex=#{sex},address=#{address}   
74.         where id=#{id}  
75.     </update>  
76. </mapper>  

别忘记在SqlMapConfig.xml中加载映射文件
<!-- 加载映射文件 -->

[html]  view plain  copy

1. <mappers>  
2.     <mapper resource="mapper/UserMapper.xml"/>  
3. </mappers>  

开发规范:
A、在mapper.xml中namespace等于mapper接口地址
!-- namespace命名空间，作用就是对sql进行分类化管理，理解sql隔离
注意:使用mapper代理方法开发，namespace有特殊重要的作用，就是对应的mapper接口地址 -->
<mapper namespace="cn.edu.hpu.mybatis.mapper.UserMapper">
......
</mapper>

B、mapper.java接口中的方法名和mapper.xml中statement的id一致
public findUserById()
对应
<select id="findUserByUsername" ...

C、mapper.java接口中的方法输入参数类型和mapper.xml中statement的parameterType指定的类型一致。
public findUserById(int id)
对应
<select id="findUserById" parameterType="int" 

D、mapper.java接口中的方法返回值类型和mapper.xml中statement的resultType指定的类型一致。
public User findUserById(int id)
对应
<select id="findUserById" parameterType="int" resultType="cn.edu.hpu.mybatis.PO.User">

遵循这些开发规范，mybatis可以自动生成mapper接口实现类代理对象。

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

[java]  view plain  copy

1. User user=sqlSession.selectOne("test.findUserById",id);  
2. sqlSession.insert("test.insertUser",user);  

mapper.java与mapper.xml互联互助

接下来我们直接根据接口来测试:

[java]  view plain  copy

1. package cn.edu.hpu.mybatis.test;  
2.   
3. import java.io.InputStream;  
4.   
5. import org.apache.ibatis.io.Resources;  
6. import org.apache.ibatis.session.SqlSession;  
7. import org.apache.ibatis.session.SqlSessionFactory;  
8. import org.apache.ibatis.session.SqlSessionFactoryBuilder;  
9. import org.junit.Before;  
10. import org.junit.Test;  
11.   
12.   
13. import cn.edu.hpu.mybatis.PO.User;  
14. import cn.edu.hpu.mybatis.mapper.UserMapper;  
15.   
16.   
17. public class UserMapperTest {  
18.   
19.   
20.     private SqlSessionFactory sqlSessionFactory;  
21.       
22.     //注解Before是在执行本类所有测试方法之前先调用这个方法  
23.     @Before  
24.     public void setup() throws Exception{  
25.         //创建SqlSessionFactory  
26.         String resource="SqlMapConfig.xml";  
27.           
28.         //将配置文件加载成流  
29.         InputStream inputStream = Resources.getResourceAsStream(resource);  
30.         //创建会话工厂，传入mybatis配置文件的信息  
31.         sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);  
32.     }  
33.       
34.     @Test  
35.     public void testFindUserById() throws Exception{  
36.           
37.         SqlSession sqlSession=sqlSessionFactory.openSession();  
38.           
39.         //创建UserMapper代理对象  
40.         UserMapper userMapper=sqlSession.getMapper(UserMapper.class);  
41.           
42.         //调用userMapper的方法  
43.         User user=userMapper.findUserById(1);  
44.           
45.         System.out.println(user.getUsername());  
46.     }  
47. }  

测试testFindUserById()方法，结果:张三

输出日志信息:

[plain]  view plain  copy

1. DEBUG [main] - Logging initialized using 'class org.apache.ibatis.logging.slf4j.Slf4jImpl' adapter.  
2. DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
3. DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
4. DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
5. DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
6. DEBUG [main] - Opening JDBC Connection  
7. DEBUG [main] - Created connection 14069849.  
8. DEBUG [main] - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.Connection@d6b059]  
9. DEBUG [main] - ==>  Preparing: SELECT * FROM USER WHERE id=?   
10. DEBUG [main] - ==> Parameters: 1(Integer)  
11. DEBUG [main] - <==      Total: 1  

这里我们使用mapper代理的方法，不需要方法的实现体就完成了查找方法，是不是很轻松?

其他增删改写的方法与上面差不多，但是，当我们实现利用姓名模糊查询的时候，返回的是List集合的数据，我们要注意:
2.一些问题总结
2.1代理对象内部调用selectOne或selectList

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

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

这些是MyBatis内部自动执行的，是不是很方便？我们可以测试一下是不是这样:
测试方法:

[java]  view plain  copy

1. @Test  
2.     public void testFindUserByUserName() throws Exception{  
3.           
4.         SqlSession sqlSession=sqlSessionFactory.openSession();  
5.           
6.         //创建UserMapper代理对象  
7.         UserMapper userMapper=sqlSession.getMapper(UserMapper.class);  
8.           
9.         //调用userMapper的方法  
10.         List<User> users=userMapper.findUserByName("张三");  
11.           
12.         for (int i = 0; i < users.size(); i++) {  
13.             User user=(User)users.get(i);  
14.             System.out.println(user.getId()+":"+user.getUsername());  
15.         }  
16.     }  

测试结果:
1:张三
4:张三丰

输出日志：

[plain]  view plain  copy

1. DEBUG [main] - Logging initialized using 'class org.apache.ibatis.logging.slf4j.Slf4jImpl' adapter.  
2. DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
3. DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
4. DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
5. DEBUG [main] - PooledDataSource forcefully closed/removed all connections.  
6. DEBUG [main] - Opening JDBC Connection  
7. DEBUG [main] - Created connection 1668655.  
8. DEBUG [main] - Setting autocommit to false on JDBC Connection [com.mysql.jdbc.Connection@19762f]  
9. DEBUG [main] - ==>  Preparing: select * from user where username like '%张三%'   
10. DEBUG [main] - ==> Parameters:   
11. DEBUG [main] - <==      Total: 2  

测试成功，说明MyBatis内部确实是这么做的

我们发现，mapper接口中的参数好像只有一个，Mybatis内部好像也只能自动处理一个参数的mapper方法，那么mapper接口方法参数只能有一个是否影响系统开发？

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

答：
系统 框架中，dao层的代码是被业务层公用的。
即使mapper接口只有一个参数，可以使用包装类型的pojo满足不同的业务方法的需求。

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