mybatis开发dao得方法

SqlSession使用范围

SqlSessionFactoryBuilder
通过SqlSessionFactoryBuilder创建会话工厂SqlSessionFactory
将SqlSessionFactoryBuilder当成一个工具类使用即可，不需要使用单例管理SqlSessionFactoryBuilder。
在需要创建SqlSessionFactory时候，只需要new一次SqlSessionFactoryBuilder即可。
SqlSessionFactory
通过SqlSessionFactory创建SqlSession，使用单例模式管理sqlSessionFactory（工厂一旦创建，使用一个实例）。
将来mybatis和spring整合后，使用单例模式管理sqlSessionFactory。
SqlSession
SqlSession是一个面向用户（程序员）的接口。
SqlSession中提供了很多操作数据库的方法：如：selectOne(返回单个对象)、selectList（返回单个或多个对象）、。
SqlSession是线程不安全的，在SqlSesion实现类中除了有接口中的方法（操作数据库的方法）还有数据域属性。
SqlSession最佳应用场合在方法体内，定义成局部变量使用。

原始dao开发方法（程序员需要写dao接口和dao实现类）

思路
程序员需要写dao接口和dao实现类。
需要向dao实现类中注入SqlSessionFactory，在方法体内通过SqlSessionFactory创建SqlSession
dao接口

package cn.itcast.mybatis.dao;

import java.util.List;

import cn.itcast.mybatis.po.User;

/*
 * 用户管理
 * */
public interface UserDao {

    //根据id查询用户信息
    public User findUserById(int id) throws Exception;
        
    //根据用户名列查询用户列表
    public List findUserByName(String name) throws Exception;
        
    //添加用户信息
    public void insertUser(User user) throws Exception;
        
    //删除用户信息
    public void deleteUser(int id) throws Exception;
}

dao实现类

package cn.itcast.mybatis.dao;

import java.util.List;

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

import cn.itcast.mybatis.po.User;

public class UserDaoImpl implements UserDao {
    
    //需要向dao实现类中注入SqlSessionFactory
    //这里通过构造方法注入
    private SqlSessionFactory sqlSessionFactory;
    public UserDaoImpl(SqlSessionFactory sqlSessionFactory) {
        this.sqlSessionFactory = sqlSessionFactory;
    }
    

    @Override
    public User findUserById(int id) throws Exception {
        // TODO 自动生成的方法存根
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        User user = sqlSession.selectOne("test.findUserById", id);
        
        //释放资源
        sqlSession.close();
        
        return user;
        
    }

    @Override
    public List findUserByName(String name) throws Exception {
        // TODO 自动生成的方法存根
        
        return null;
    }

    @Override
    public void insertUser(User user) throws Exception {
        // TODO 自动生成的方法存根
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        sqlSession.insert("test.insertUser",user);
        
        //提交事务
        sqlSession.commit();
        
        //释放资源
        sqlSession.close();
        
        

    }

    @Override
    public void deleteUser(int id) throws Exception {
        // TODO 自动生成的方法存根

        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        sqlSession.delete("test.deleteUser",id);
        
        //提交事务
        sqlSession.commit();
        
        //释放资源
        sqlSession.close();
        
    }

}

测试代码

package cn.itcast.mybatis.dao;

import static org.junit.Assert.*;

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.itcast.mybatis.po.User;

public class UserDaoImplTest {
    
    private SqlSessionFactory sqlSessionFactory;

    //此方法是在执行testFindUserById之前执行
    @Before
    public void setUp() throws Exception{
        //创建sqlSessionFactory
        
        
        //mybatis配置文件
        String resource = "SqlMapConfig.xml";
                
        //得到配置问价流
        InputStream inputStream = Resources.getResourceAsStream(resource);
                
        //创建会话工厂,传入mybatis的配置文件信息
        sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
    }
    
    @Test
    public void testFindUserById() throws Exception {
        //创建UserDao的对象
        UserDao userDao = new UserDaoImpl(sqlSessionFactory);
        
        //调用UserDao的方法
        User user = userDao.findUserById(1);
        
        System.out.println(user);
    }

}

总结原始dao开发问题

1、dao接口实现类方法中存在大量模板方法，设想能否将这些代码提取出来，大大减轻程序员的工作量。

2、调用sqlsession方法时将statement的id硬编码了

3、调用sqlsession方法时传入的变量，由于sqlsession方法使用泛型，即使变量类型传入错误，在编译阶段也不报错，不利于程序员开发。

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

思路

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

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

开发规范

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

mapper.java接口中的方法名和mapper.xml中statement的id一致
mapper.java接口中的方法输入参数类型和mapper.xml中statement的parameterType指定的类型一致
mapper.java接口中的方法返回值类型和mapper.xml中statement的resultType指定的类型一致。

mapper.xml

mapper.java

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

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

在SqlMapConfig.xml中加载mapper.xml

测试

package cn.itcast.mybatis.mapper;

import static org.junit.Assert.*;

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.itcast.mybatis.po.User;

public class UserMapperTest {

    private SqlSessionFactory sqlSessionFactory;
    
    @Before
    public void setUp() throws Exception{
        //创建sqlSessionFactory
        
        
        //mybatis配置文件
        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的对象,mybatis自动生成mapper代理对对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
                
        //调用UserMapper的方法
        User user = userMapper.findUserById(1);
                
        System.out.println(user);
        
    }

}

总结

代理对象内部调用selectOne或selectList

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

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

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

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

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

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

SqlMapConfig.xml

mybatis的全局配置文件SqlMapConfig.xml，配置内容如下：

properties（属性）
settings（全局配置参数）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境集合属性对象）
    environment（环境子属性对象）
          transactionManager（事务管理）
          dataSource（数据源）
mappers（映射器）

属性properties

需求：
将数据库连接参数单独配置在db.properties中，只需要在SqlMapConfig.xml中加载db.properties的属性值。
在SqlMapConfig.xml中就不需要对数据库连接参数硬编码。

将数据库连接参数只配置在db.properties中，原因：方便对参数进行统一管理，其它xml可以引用该db.properties。

jdbc.driver=com.mysql.jdbc.Driver

jdbc.url=jdbc:mysql://localhost:3306/mybatis

jdbc.username=root

jdbc.password=suntong

在sqlMapConfig.xml加载属性文件：

properties特性：

注意： MyBatis 将按照下面的顺序来加载属性：

在 properties 元素体内定义的属性首先被读取。

然后会读取properties 元素中resource或 url 加载的属性，它会覆盖已读取的同名属性。

最后读取parameterType传递的属性，它会覆盖已读取的同名属性。

建议：

不要在properties元素体内添加任何属性值，只将属性值定义在properties文件中。

在properties文件中定义属性名要有一定的特殊性，如：XXXXX.XXXXX.XXXX

settings全局参数配置

mybatis框架在运行时可以调整一些运行参数。
比如：开启二级缓存、开启延迟加载。。

全局参数将会影响mybatis的运行行为。

详细参见“学习资料/mybatis-settings.xlsx”文件

typeAliases（别名）

需求

在mapper.xml中，定义很多的statement，statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。

如果在指定类型时输入类型全路径，不方便进行开发，可以针对parameterType或resultType指定的类型定义一些别名，在mapper.xml中通过别名定义，方便开发。

mybatis默认支持别名
自定义别名

单个别名定义

引用
UserMapper.xml

结果

批量别名定义

还是可以

想选中多个包得自己一条一条的弄

不同包下有同名文件

改变包的调用顺序

照错不误

类型处理器typeHandlers

mybatis中通过typeHandlers完成jdbc类型和java类型的转换。

通常情况下，mybatis提供的类型处理器满足日常需要，不需要自定义.

mybatis支持类型处理器：

objectFactory（对象工厂）
plugins（插件）
一般不用

mappers映射配置

加载单个映射文件

通过mapper接口加载单个映射文件

SqlMapConfig.xml

没问题

批量加载多个mapper

输入映射

通过parameterType指定输入参数的类型，类型可以是简单类型、hashmap、pojo的包装类型

传递pojo的包装对象

需求
完成用户信息的综合查询，需要传入查询条件很复杂（可能包括用户信息、其它信息，比如商品、订单的）
定义包装类型pojo
针对上边需求，建议使用自定义的包装类型的pojo。
在包装类型的pojo中将复杂的查询条件包装进去。

UserQueryVo.java

package cn.itcast.mybatis.po;


/*
 * 用户的包装类型
 * 
 * Vo:视图对象
 * Po：持久层对象
 * Pojo：自定义的简单的bean对象
 * */
public class UserQueryVo {

    //在这里包装所需要的查询条件
    
    
    //用户查询条件
    private UserCustom userCustome;

    /**
     * @return userCustome
     */
    public UserCustom getUserCustome() {
        return userCustome;
    }

    /**
     * @param userCustome 要设置的 userCustome
     */
    public void setUserCustome(UserCustom userCustome) {
        this.userCustome = userCustome;
    }
    
    
    //可以包装其他的查询条件，订单、商品
    
}

用户扩展类
UserCustom.java

package cn.itcast.mybatis.po;


/*
 * 用户的扩展类
 * */
public class UserCustom extends User{

    //在这里可以扩展用户信息
    
    
    
}

mapper.xml
在UserMapper.xml中定义用户信息综合查询（查询条件复杂，通过高级查询进行复杂关联查询）。
UserMapper.xml

mapper.java
UserMapper

//用户信息的综合查询
    public List findUserList(UserQueryVo userQueryVo) throws Exception;

测试代码

//用户信息的综合查询
    @Test
    public void testFindUserList() throws Exception {
        
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        //创建UserMapper的对象,mybatis自动生成mapper代理对对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
                
        //创建包装类型，设置查询条件
        UserQueryVo userQueryVo = new UserQueryVo();
        UserCustom userCustom = new UserCustom();
        userCustom.setSex("1");
        userCustom.setUsername("张三丰");
        userQueryVo.setUserCustome(userCustom);
        
        //调用UserMapper的方法
        List list = userMapper.findUserList(userQueryVo);
                
        System.out.println(list);
        
    }

输出映射

resultType

使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。
如果查询出来的列名和pojo中的属性名全部不一致，没有创建pojo对象。
只要查询出来的列名和pojo中的属性有一个一致，就会创建pojo对象。

输出简单类型

需求
用户信息的综合查询列表总数，通过查询总数和上边用户综合查询列表才可以实现分页。
mapper.xml

mapper.java

//用户信息的综合查询总数
    public int findUserCount(UserQueryVo userQueryVo) throws Exception;

测试代码

//用户信息的综合查询总数
        @Test
        public void testFindUserCount() throws Exception {
            
            SqlSession sqlSession = sqlSessionFactory.openSession();
            
            //创建UserMapper的对象,mybatis自动生成mapper代理对对象
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
                    
            //创建包装类型，设置查询条件
            UserQueryVo userQueryVo = new UserQueryVo();
            UserCustom userCustom = new UserCustom();
            userCustom.setSex("1");
            userCustom.setUsername("张三丰");
            userQueryVo.setUserCustome(userCustom);
            
            //调用UserMapper的方法
            int count = userMapper.findUserCount(userQueryVo);
                    
            System.out.println(count);
            
        }

小结
查询出来的结果集只有一行且一列，可以使用简单类型进行输出映射

输出pojo对象和pojo列表

不管是输出的pojo单个对象还是一个列表（list中包括pojo），在mapper.xml中resultType指定的类型是一样的。
在mapper.java指定的方法返回值类型不一样：

输出单个pojo对象，方法返回值是单个对象类型

输出pojo对象list，方法返回值是List

生成的动态代理对象中是根据mapper方法的返回值类型确定是调用selectOne(返回单个对象调用)还是selectList返回集合对象调用）

resultMap

mybatis中使用resultMap完成高级输出结果映射。

resultMap使用方法
如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。

定义resultMap

使用resultMap作为statement的输出映射类型

将下边的sql使用User完成映射

SELECT id id_,username username_ FROM USER WHERE id=#{value}

User类中属性名和上边查询列名不一致。

定义resultMap

使用resultMap作为statement的输出映射类型

mapper.java

//根据id查询用户信息，使用resultMap输出
    public User findUserByIdResultMap(int i) throws Exception;

测试

@Test
        public void testFindUserByIdResultMap() throws Exception {
            
            SqlSession sqlSession = sqlSessionFactory.openSession();
            
            //创建UserMapper的对象,mybatis自动生成mapper代理对对象
            UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
                    
            //调用UserMapper的方法
            User user = userMapper.findUserByIdResultMap(1);
                    
            System.out.println(user);
            
        }

小结

使用resultType进行输出映射，只有查询出来的列名和pojo中的属性名一致，该列才可以映射成功。
如果查询出来的列名和pojo的属性名不一致，通过定义一个resultMap对列名和pojo属性名之间作一个映射关系。

动态sql

什么是动态sql

mybatis核心对sql语句进行灵活操作，通过表达式进行判断，对sql进行灵活拼接、组装。

需求

用户信息综合查询列表和用户信息查询列表总数这两个statement的定义使用动态sql。

对查询条件进行判断，如果输入参数不为空才进行查询条件拼接。

mapper.xml

测试代码

//用户信息的综合查询
    @Test
    public void testFindUserList() throws Exception {
        
        SqlSession sqlSession = sqlSessionFactory.openSession();
        
        //创建UserMapper的对象,mybatis自动生成mapper代理对对象
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
                
        //创建包装类型，设置查询条件
        UserQueryVo userQueryVo = new UserQueryVo();
        UserCustom userCustom = new UserCustom();
        
        //由于使用了动态sql，如果不设置某个值，条件不会拼接在sql中
        //userCustom.setSex("1");
        userCustom.setUsername("张三丰");
        userQueryVo.setUserCustome(userCustom);
        
        //调用UserMapper的方法
        List list = userMapper.findUserList(userQueryVo);
                
        System.out.println(list);
        
    }

sql片段

需求
将上边实现的动态sql判断代码块抽取出来，组成一个sql片段。其它的statement中就可以引用sql片段。
方便程序员进行开发。
定义sql片段


    
            
                
                    and user.sex = #{userCustom.sex}
                
                
                
                    and user.username LIKE '%${userCustom.username}%'

引用sql片段
在mapper.xml中定义的statement中引用sql片段：

02 mybatis开发

mybatis开发dao得方法

SqlMapConfig.xml

输入映射

输出映射

动态sql