Mybatis基本映射--SELECT

摘要：概述上一篇针对进行了入门体验，本节将继续介绍基本映射单表查询。本系列文章是基于版本。总结本节实例了基本查询及映射，这些也是实际工作中用的最多的功能，虽然简单，日积月累会构建起我们的知识结构和体系，一步一步来。。。

上一篇针对Mybatis进行了入门体验，本节将继续介绍Mybatis基本映射--单表查询。

本系列文章是基于Mybatis 3.4.6 版本。

针对于上一节，我们对sys_user表结构进行了优化，字段类型更规范了些，这样做更有利于数据库性能，我们参考了一些数据库设计规范，后续抽时间整理分享出来，修改后SQL语句为：

CREATE TABLE `sys_user` (
  `id` bigint(11) unsigned NOT NULL AUTO_INCREMENT COMMENT "主键",
  `user_account` varchar(50) NOT NULL COMMENT "用户账户",
  `user_password` char(32) NOT NULL COMMENT "MD5加密的用户密码",
  `user_email` varchar(20) DEFAULT NULL COMMENT "用户邮箱",
  `user_phone` varchar(20) DEFAULT NULL COMMENT "手机号",
  `created_date` datetime NOT NULL COMMENT "创建时间",
  `modified_date` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT "修改时间",
  `yn` tinyint(1) unsigned NOT NUll DEFAULT 1 COMMENT "是否有效(0无效,1有效)",
  `modified_user` varchar(50) DEFAULT NULL COMMENT "修改人",
  `remark` varchar(500) DEFAULT NULL COMMENT "备注",
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT="用户信息表";

我们的SysUser实体代码如下（使用lombok注解，在类中不必写get/set方法，提高开发效率以及代码更整洁）：

package com.github.dalianghe.model;

import lombok.Getter;
import lombok.Setter;
import lombok.ToString;

import java.util.Date;

@Getter
@Setter
@ToString
public class SysUser {

    private Long id;

    private String userAccount;

    private String userPassword;

    private String userEmail;

    private String userPhone;

    private Date createdDate;

    private Date modifiedDate;

    private Integer yn;

    private String modifiedUser;

    private String remark;

}

Mybatis3.0相比于2.0，支持使用接口调用方法，并且对于多参数需求，支持在方法参数中使用注解@Param设置参数的名字（2.0中需要使用对象或map来传多参数），接口代码如下：

package com.github.dalianghe.mapper;

import com.github.dalianghe.model.SysUser;
import org.apache.ibatis.annotations.Param;

import java.util.List;

public interface SysUserMapper {

    // 返回多值需用List接收
    public List selectAll() throws Exception;
    // 返回单个或0个使用对象接收
    public SysUser selectUserById(Long id) throws Exception;
    // 多参数方法
    public SysUser selectUserByAccountAndPass(@Param("userAccount") String userAccount,
                                              @Param("userPassword") String userPassword) throws Exception;

}

接口类中定义了无参、一个参数和多个参数的查询方法，在mapper配置文件中需定义三个id为方法名的select查询标签。

需注意的是查询SQL返回的结果数量，当返回1个或0个时，使用对象，返回多个时使用List，否则会报错。

定义mapper映射文件，代码如下：

    
    
        
        
        
        
    
    
    
        select id,user_account,user_password,user_email from sys_user
    
    
    
        select id,user_account userAccount,user_password userPassword,user_email userEmail from sys_user
        where id=#{id}
    
    
    
        select id,user_account,user_password,user_email from sys_user
        where user_account=#{userAccount}
        and user_password=#{userPassword}
    

mybatis配置文件代码如下：

编写测试用例对mapper方法进行测试，代码如下：

package com.github.dalianghe;

import com.github.dalianghe.mapper.SysUserMapper;
import com.github.dalianghe.model.SysUser;
import org.apache.ibatis.session.SqlSession;
import org.junit.Test;

import java.util.List;

public class UserMapperTest {

    private static SqlSessionFactory sqlSessionFactory;

    @Before
    public void init(){
        try{
            Reader reader = Resources.getResourceAsReader("mybatis-config.xml");
            sqlSessionFactory = new SqlSessionFactoryBuilder().build(reader);
        }catch (IOException e){
            e.printStackTrace();
        }
    }

    public SqlSession getSqlSession(){
        return sqlSessionFactory.openSession();
    }

    @Test
    public void testSelectAll(){
        SqlSession sqlSession = getSqlSession();
        try{
            SysUserMapper sysUserMapper = sqlSession.getMapper(SysUserMapper.class);
            List users = sysUserMapper.selectAll();
            users.forEach(user -> {
                System.out.println(user.toString());
            });
        }catch (Exception e){
            e.printStackTrace();
        }
    }

    @Test
    public void testSelectUserById(){
        SqlSession sqlSession = getSqlSession();
        try{
            SysUserMapper sysUserMapper = sqlSession.getMapper(SysUserMapper.class);
            SysUser sysUser = sysUserMapper.selectUserById(1L);
            System.out.println(sysUser);
        }catch (Exception e){
            e.printStackTrace();
        }
    }

    @Test
    public void testSelectUserByAccountAndPass(){
        SqlSession sqlSession = getSqlSession();
        try{
            SysUserMapper sysUserMapper = sqlSession.getMapper(SysUserMapper.class);
            SysUser sysUser = sysUserMapper.selectUserByAccountAndPass("admin","123");
            System.out.println(sysUser);
        }catch (Exception e){
            e.printStackTrace();
        }
    }

}

运行测试方法即可。

本节实例了mybatis基本查询及映射，这些也是实际工作中用的最多的功能，虽然简单，日积月累会构建起我们的知识结构和体系，一步一步来。。。

最后创建了qq群方便大家交流，可扫描加入，同时也可加我qq：276420284，共同学习、共同进步，谢谢！