【MyBatis框架】Mybatis开发dao方法第二部分
下面来继续讨论mybatis开发Dao的方法
我们前面使用原始的Dao开发方法，发现了许多弊端，我们下面使用mapper代理来写Dao方法。
1.mapper代理方法（程序员只需要mapper接口（相当 于dao接口））
开发人员需要先编写Mapper接口(相当 于dao接口)，需要遵循一些开发规范，mybatis可以自动生成mapper接口实现类代理对象。
package cn.edu.hpu.mybatis.mapper;
import cn.edu.hpu.mybatis.PO.User;
//用户管理的Dao接口
public interface UserMapper {
//根据Id查询用户信息
public User findUserById(int id) throws Exception;
//添加用户信息
public void insertUser(User user) throws Exception;
//删除用户信息
public void deleteUser(int id) throws Exception;
//修改用户信息
public void updateUser(User user) throws Exception;
//根据姓名查找用户
public List<User> findUserByUserName(String username) throws Exception;
}
开发人员还要编写mapper.xml映射文件
我们在src同文件夹下的config文件夹下创建mapper包，在包下创建UserMapper.xml文件，内容同之前写过的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进行分类化管理，理解sql隔离
注意:使用mapper代理方法开发，namespace有特殊重要的作用，就是对应的mapper接口地址 -->
<mapper namespace="cn.edu.hpu.mybatis.mapper.UserMapper">
<!-- 在映射文件中配置很多sql语句 -->
<!-- 需求:通过id查询用户表的记录 -->
<!-- 通过select执行数据库查询，
id:标示映射文件中的sql，成为Statement的id
将sql语句封装到mappedStatement对象中，所以将id称为statement的id,
parameterType:指定输入参数的类型，
#{}标示一个占位符,
#{id}其中id表示接收输入参数的名称，如果输入参数是简单类型，那么#{}中的值可以任意(如value)。
resultType：指定sql输出结果的映射的java对象类型，
select指定resultType表示将单条记录映射成java对象-->
<select id="findUserById" parameterType="int" resultType="cn.edu.hpu.mybatis.PO.User">
SELECT * FROM USER WHERE id=#{id}
</select>
<!-- ${}:表示拼接sql串，将接收到的参数内容不加任何修饰拼接在sql中。
使用${}拼接sql，引起sql注入。
${}中只能使用value-->
<select id="findUserByUserName" parameterType="java.lang.String"
resultType="cn.edu.hpu.mybatis.PO.User">
select * from user where username like '%${value}%'
</select>
<!-- 添加用户
parameterType：指定输入参数类型是pojo(包括用户信息)
#{}中指定POJO的属性名，接收到POJO对象的属性值，mybatis通过OGNL获取对象的属性
-->
<insert id="insertUser" parameterType="cn.edu.hpu.mybatis.PO.User">
<!-- 将插入数据的主键返回，返回到user对象中。
SELECT_INSERT_ID():得到刚insert进去的主键值，只适用于自增主键
KeyProperty:将查询到主键值设置到parameterType指定对象的哪个属性。
order:SELECT LAST_INSERT_ID()执行顺序，相对于insert语句来说它的执行顺序
-->
<selectKey keyProperty="id" order="AFTER" resultType="java.lang.Integer">
SELECT LAST_INSERT_ID()
</selectKey>
<!-- 使用MySql的UUID来生成主键
执行过程:
首先通过uuid()得到主键，将主键设置到user对象的id属性中
其次在insert执行时，从user对象中取出id属性值
<selectKey keyProperty="id" order="BEFORE" resultType="java.lang.String">
SELECT uuid()
</selectKey>
insert into user(id,birthday,sex,address) value(#{id},#{birthday,jdbcType=DATE},#{sex},#{address})-->
insert into user(username,birthday,sex,address) value(#{username},#{birthday,jdbcType=DATE},#{sex},#{address})
</insert>
<!-- 删除用户 -->
<delete id="deleteUser" parameterType="java.lang.Integer">
delete from user where id=#{id}
</delete>
<!-- 更新用户
分析:
需要传入用户的id，需要传入用户的更新信息.
parameterType指定user对象，包括id和更新信息(注意:id必须存在)
#{id}:从输入user对象中获取id属性值-->
<update id="updateUser" parameterType="cn.edu.hpu.mybatis.PO.User">
update user set username=#{username},birthday=#{birthday,jdbcType=DATE},sex=#{sex},address=#{address}
where id=#{id}
</update>
</mapper>
别忘记在SqlMapConfig.xml中加载映射文件
<!-- 加载映射文件 -->
<mappers> <mapper resource="mapper/UserMapper.xml"/> </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接口实现类代理对象。
总结：
以上开发规范主要是对下边的代码进行统一生成：
User user=sqlSession.selectOne("test.findUserById",id);
sqlSession.insert("test.insertUser",user);
mapper.java与mapper.xml互联互助
接下来我们直接根据接口来测试:
package cn.edu.hpu.mybatis.test;
import java.io.InputStream;
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.edu.hpu.mybatis.PO.User;
import cn.edu.hpu.mybatis.mapper.UserMapper;
public class UserMapperTest {
private SqlSessionFactory sqlSessionFactory;
//注解Before是在执行本类所有测试方法之前先调用这个方法
@Before
public void setup() throws Exception{
//创建SqlSessionFactory
String resource="SqlMapConfig.xml";
//将配置文件加载成流
InputStream inputStream = Resources.getResourceAsStream(resource);
//创建会话工厂，传入mybatis配置文件的信息
sqlSessionFactory=new SqlSessionFactoryBuilder().build(inputStream);
}
@Test
public void testFindUserById() throws Exception{
SqlSession sqlSession=sqlSessionFactory.openSession();
//创建UserMapper代理对象
UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
//调用userMapper的方法
User user=userMapper.findUserById(1);
System.out.println(user.getUsername());
}
}
这里我们使用mapper代理的方法，不需要方法的实现体就完成了查找方法，是不是很轻松?
其他增删改写的方法与上面差不多，但是，当我们实现利用姓名模糊查询的时候，返回的是List集合的数据，我们要注意:
2.一些问题总结
2.1代理对象内部调用selectOne或selectList
如果mapper方法返回单个pojo对象（非集合对象），代理对象内部通过selectOne查询数据库。
如果mapper方法返回集合对象，代理对象内部通过selectList查询数据库。
这些是MyBatis内部自动执行的，是不是很方便？我们可以测试一下是不是这样:
测试方法:
@Test
public void testFindUserByUserName() throws Exception{
SqlSession sqlSession=sqlSessionFactory.openSession();
//创建UserMapper代理对象
UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
//调用userMapper的方法
List<User> users=userMapper.findUserByName("张三");
for (int i = 0; i < users.size(); i++) {
User user=(User)users.get(i);
System.out.println(user.getId()+":"+user.getUsername());
}
}
测试成功，说明MyBatis内部确实是这么做的
我们发现，mapper接口中的参数好像只有一个，Mybatis内部好像也只能自动处理一个参数的mapper方法，那么mapper接口方法参数只能有一个是否影响系统开发？
问:mapper接口方法参数只能有一个，系统是否不利于扩展维护。
答：
系统 框架中，dao层的代码是被业务层公用的。
即使mapper接口只有一个参数，可以使用包装类型的pojo满足不同的业务方法的需求。
注意：持久层方法的参数可以包装类型、map。。。，service方法中建议不要使用包装类型（不利于业务层的可扩展）。