【MyBatis】| MyBatis查询语句专题（接口中方法的返回值类型专栏）

柔情只为你懂 2024-03-30 15:03 73阅读 0赞

**目录**

一：MyBatis查询语句专题

1. 返回Car对象

2. 返回List<Car>

3. 返回Map

4. 返回List<Map>

5. 返回Map<String,Map>

6. resultMap结果映射

7. 返回总记录条数

--------------------

## 一：MyBatis查询语句专题 ##

> **前期准备：**
> 
> 模块名：mybatis-008-select
> 
> 打包⽅式：jar
> 
> 引⼊依赖：mysql驱动依赖、mybatis依赖、logback依赖、junit依赖。
> 
> 引⼊配置⽂件：jdbc.properties、mybatis-config.xml、logback.xml
> 
> 创建pojo类：com.bjpowernode.mybatis.pojo.Car
> 
> 创建Mapper接⼝：com.bjpowernode.mybatis.mapper.CarMapper
> 
> 创建Mapper接⼝对应的映射⽂件：com/powernode/mybatis/mapper/CarMapper.xml
> 
> 创建单元测试：com.bjpowernode.mybatis.test.CarMapperTest
> 
> 拷⻉⼯具类：com.bjpowernode.mybatis.utils.SqlSessionUtils

![4c351d804dbc48b081306708b5bde9d5.png][]

#### 1. 返回Car对象 ####

> 查询结果，返回的对象是一个Car对象！

三兄弟之一：CarMapper接口，编写方法

> 在接口中定义抽象方法，通过id查询，返回的是一个Car对象

package com.bjpowernode.mybatis.mapper;
    
    import com.bjpowernode.mybatis.pojo.Car;
    
    public interface CarMapper {
        // 根据id进行查询，返回的是Car
        Car selectById(Long id);
    }

三兄弟之二：CarMapper.xml文件，编写sql语句

> ①namespace指定的一定是接口的包名，select的id一定是方法的方法名！
> 
> ②select \* from t\_car where id = \#\{id\};这样查询肯定会有问题，前面已经接触过，除了id和brand字段，其它字段都为空；因为数据库表中的字段名与Car对象的字段名不相同！
> 
> ③怎么解决？
> 
> 使用as对字段进行重名，或者使用settings标签的name属性设置为mapUnderscoreToCamelCase，value设置为true开启驼峰命名规则！

<?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">
    
    <mapper namespace="com.bjpowernode.mybatis.mapper.CarMapper">
        <select id="selectById" resultType="Car">
            
            select
                id,
                car_num as carNum,
                brand,
                guide_price as guidePrice,
                produce_time as produceTime,
                car_type as carType
            from  t_car where id = #{id};
        </select>
    </mapper>

三兄弟之三：CarMappeTest类，用来编写测试类

package com.bjpowernode.mybatis.test;
    
    import com.bjpowernode.mybatis.mapper.CarMapper;
    import com.bjpowernode.mybatis.pojo.Car;
    import com.bjpowernode.mybatis.utils.SqlSessionUtil;
    import org.apache.ibatis.session.SqlSession;
    import org.junit.Test;
    
    public class CarMapperTest {
        @Test
        public void testSelectById(){
            SqlSession sqlSession = SqlSessionUtil.openSession();
            CarMapper mapper = sqlSession.getMapper(CarMapper.class);
            Car car = mapper.selectById(1L);
            System.out.println(car);
            sqlSession.close();
        }
    }

####  ####

#### 2. 返回List<Car> ####

> 查询结果，返回的对象是多个Car对象，这就需要一个List集合进行存储！

三兄弟之一：CarMapper接口，编写方法

> 在接口中定义抽象方法，查询所有的Car，返回的是多个Car对象，使用List集合接收。
> 
> 注：或者进行模糊查询，返回的也是多个Car对象。
> 
> 注：如果明知道返回的是多个对象，但是就用一个POJO类Car来接收，会报TooManyResultsException异常：表示期望的结果是返回一条数据，但是实际的SQL语句在执行的时候，返回的记录不是一条、是多条。
> 
> 注：如果知道返回的数据是一个Car对象，但是我们用一个List集合进行接收，这是没问题的

package com.bjpowernode.mybatis.mapper;
    
    import com.bjpowernode.mybatis.pojo.Car;
    
    public interface CarMapper {
        // 获取所有的Car，返回一个List集合
        List<Car> selectAll();
    }

三兄弟之二：CarMapper.xml文件，编写sql语句

> 没有where查询条件，查询的是所有数据库表中的结果

<?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">
    
    <mapper namespace="com.bjpowernode.mybatis.mapper.CarMapper">
        <select id="selectById" resultType="Car">
            select
                id,
                car_num as carNum,
                brand,
                guide_price as guidePrice,
                produce_time as produceTime,
                car_type as carType
            from  t_car;
        </select>
    </mapper>

三兄弟之三：CarMappeTest类，用来编写测试类

> 查询所有，返回的是一个List集合，遍历这个集合打印即可

package com.bjpowernode.mybatis.test;
    
    import com.bjpowernode.mybatis.mapper.CarMapper;
    import com.bjpowernode.mybatis.pojo.Car;
    import com.bjpowernode.mybatis.utils.SqlSessionUtil;
    import org.apache.ibatis.session.SqlSession;
    import org.junit.Test;
    
    public class CarMapperTest {
        @Test
        public void testSelectAll(){
            SqlSession sqlSession = SqlSessionUtil.openSession();
            CarMapper mapper = sqlSession.getMapper(CarMapper.class);
            List<Car> cars = mapper.selectAll();
            cars.forEach(car -> System.out.println(car));
            sqlSession.close();
        }
    }

#### 3. 返回Map ####

> （1）当返回的数据，没有合适的实体类对应的话，可以采⽤Map集合接收；**数据库中的字段名做key，数据库中的字段值做value。**
> 
> （2）查询如果可以保证只有⼀条数据，则返回⼀个Map集合即可。 例如：

![52054b5bd9b349c2b30aae21f07535fa.png][]

三兄弟之一：CarMapper接口，编写方法

> 根据id进行查询返回的是一个Map集合，Map集合的key肯定是一个String类型；Map集合的value肯定是一个Object，因为具体的类型都不相同。

package com.bjpowernode.mybatis.mapper;
    
    public interface CarMapper {
        // 根据id返回汽车信息，将汽车信息放到Map集合
        Map<String, Object> selectByIdReturnMap(Long id);
    }

三兄弟之二：CarMapper.xml文件，编写sql语句

> 注：这里主要就是resultType属性的值怎么写？
> 
> 使用Map集合进行接收，所以就使用：java.util.Map，当然也可以使用MyBatis内置的别名map。

<?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">
    
    <mapper namespace="com.bjpowernode.mybatis.mapper.CarMapper">
        <select id="selectByIdReturnMap" resultType="map">
            select *  from  t_car where id = #{id};
        </select>
    </mapper>

三兄弟之三：CarMappeTest类，用来编写测试类

package com.bjpowernode.mybatis.test;
    
    import com.bjpowernode.mybatis.mapper.CarMapper;
    import com.bjpowernode.mybatis.pojo.Car;
    import com.bjpowernode.mybatis.utils.SqlSessionUtil;
    import org.apache.ibatis.session.SqlSession;
    import org.junit.Test;
    
    public class CarMapperTest {
        @Test
        public void testSelectByIdReturnMap(){
            SqlSession sqlSession = SqlSessionUtil.openSession();
            CarMapper mapper = sqlSession.getMapper(CarMapper.class);
            Map<String, Object> map = mapper.selectByIdReturnMap(1L);
            System.out.println(map);
            sqlSession.close();
        }
    }

执行结果：

![afb11a90c0d74b9ab2e8be333e6585e7.png][]

#### 4. 返回List<Map> ####

> 如果返回的数据，**没有合适的实体类对应，并且查询结果条数⼤于等于1条数据，则可以返回⼀个存储Map集合的List集合：List<Map>**，实际上就等同于List<Car>。

![f00ced6f28934cb3892eab412a3ccc58.png][]

三兄弟之一：CarMapper接口，编写方法

> 上面是查询返回一条结果，使用Map集合接收即可；现在是查询所有，返回的是一个存放Map集合的List集合。

package com.bjpowernode.mybatis.mapper;
    
    public interface CarMapper {
        // 查询所有的Car信息，返回的是一个存放Map集合的List集合
        List<Map<String,Object>> selectAllReturnListMap();
    }

三兄弟之二：CarMapper.xml文件，编写sql语句

> 注：这里主要就是resultType属性的值还是填写List集合的里面元素Map集合

<?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">
    
    <mapper namespace="com.bjpowernode.mybatis.mapper.CarMapper">
        <select id="selectAllReturnListMap" resultType="map">
            select *  from  t_car;
        </select>
    </mapper>

三兄弟之三：CarMappeTest类，用来编写测试类

package com.bjpowernode.mybatis.test;
    
    import com.bjpowernode.mybatis.mapper.CarMapper;
    import com.bjpowernode.mybatis.pojo.Car;
    import com.bjpowernode.mybatis.utils.SqlSessionUtil;
    import org.apache.ibatis.session.SqlSession;
    import org.junit.Test;
    
    public class CarMapperTest {
        @Test
        public void testSelectAllReturnListMap(){
            SqlSession sqlSession = SqlSessionUtil.openSession();
            CarMapper mapper = sqlSession.getMapper(CarMapper.class);
            List<Map<String, Object>> maps = mapper.selectAllReturnListMap();
            maps.forEach(map-> System.out.println(map));
            sqlSession.close();
        }
    }

#### 5. 返回Map<String,Map> ####

> 返回List<Map>的时候，取数据并不好取，假如取id是3的元素，需要遍历整个集合；所以我们可以返回一个大Map集合的方式：Map<String,Map>；**拿Car的id做key，Map集合做value，以后取出对应的Map集合时更⽅便。**

![1c6f8a4e3b7547efa26529652642c18a.png][]

三兄弟之一：CarMapper接口，编写方法

> ①上面的方式，如果取出某个数据，需要遍历整个集合，所以我们采用另一种方式存储：
> 
> 拿Car的id做key，Map集合做value，再放到一个大Map集合当中！
> 
> ②**使用这种方式需要一个注解：@MapKey("id")，表示将每个数据查询结果的id作为整个大Map集合的key**

package com.bjpowernode.mybatis.mapper;
    
    public interface CarMapper {
        // 查询所有的Car，返回一个大Map集合
        @MapKey("id") 
        Map<Long,Map<String,Object>> selectAllReturnMapMap();
    }

三兄弟之二：CarMapper.xml文件，编写sql语句

> 注：这里resultType属性的值还是填写大Map集合的里面元素小Map集合

<?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">
    
    <mapper namespace="com.bjpowernode.mybatis.mapper.CarMapper">
        <select id="selectAllReturnMapMap" resultType="map">
            select *  from  t_car;
        </select>
    </mapper>

三兄弟之三：CarMappeTest类，用来编写测试类

> 注：取出来的数据就是查询出所有的数据放到一个大Map集合当中

package com.bjpowernode.mybatis.test;
    
    import com.bjpowernode.mybatis.mapper.CarMapper;
    import com.bjpowernode.mybatis.pojo.Car;
    import com.bjpowernode.mybatis.utils.SqlSessionUtil;
    import org.apache.ibatis.session.SqlSession;
    import org.junit.Test;
    
    public class CarMapperTest {
        @Test
        @Test
        public void testSelectAllReturnMapMap(){
            SqlSession sqlSession = SqlSessionUtil.openSession();
            CarMapper mapper = sqlSession.getMapper(CarMapper.class);
            Map<Long, Map<String, Object>> doubleMap = mapper.selectAllReturnMapMap();
            System.out.println(doubleMap);
            sqlSession.close();
        }
    }

执行结果：

![f4e5324664b841139749e92381e99504.png][]

#### 6. resultMap结果映射 ####

> **查询结果的列名和java对象的属性名对应不上怎么办？**
> 
> ①第⼀种⽅式：as 给列起别名，前面一直在用的方法。
> 
> ②第⼆种⽅式：使⽤resultMap进⾏结果映射。
> 
> ③第三种⽅式：是否开启驼峰命名⾃动映射。

**（1）使⽤resultMap进⾏结果映射**

三兄弟之一：CarMapper接口，编写方法

package com.bjpowernode.mybatis.mapper;
    
    import com.bjpowernode.mybatis.pojo.Car;
    import org.apache.ibatis.annotations.MapKey;
    import java.util.*;
    
    public interface CarMapper {
        // 查询所有的Car信息，使用resultMap标签进行结果映射
        List<Car> selectAllByResultMap(); 
    }

三兄弟之二：CarMapper.xml文件，编写sql语句

> ①前面都是使用as进行重命名，并且需要把每个字段都写出来，比较麻烦。
> 
> ②现在专门定义一个结果映射，在这个结果映射当中指定数据库表的字段名和Java类的属性名的对应关系。
> 
> ③**结果映射resultMap有两个参数：**
> 
> 一个参数是id，指定resultMap的唯一标识，这个id将来在select标签中的resultMap属性当中使用（注意：不在是resultType属性了）。
> 
> 一个参数是type，用来指定POJO类的类名。
> 
> ④**在resultMap下还有一个子标签result：**
> 
> 首先对于有主键的需要配一个id，使用id标签，不是必须的，但可以增加效率。
> 
> 然后下面**使用result子标签的property属性和column属性分别指定POJO类的属性名和数据库表中的字段表之间的映射关系。**
> 
> ⑤也可以给当前标签配置上javaType和jdbcType属性，非必须要，但是可以增加效率，因为减少了MyBatis自动推断。
> 
> ⑥select标签使用了resultMap属性，原来的resultType属性就不需要指定了。

<?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">
    
    <mapper namespace="com.bjpowernode.mybatis.mapper.CarMapper">
        
        <resultMap id="CarResultMap" type="car">
            
            <id property="id" column="id" />
    
            
            <result property="carNum" column="car_num" />
            
            
            <result property="guidePrice" column="guide_price" />
            <result property="produceTime" column="produce_time" />
            
            <result property="carType" column="car_type" javaType="string" jdbcType="VARCHAR" />
        </resultMap>
        
        <select id="selectAllByResultMap" resultMap="CarResultMap">
            select * from t_car;
        </select>
    </mapper>

三兄弟之三：CarMappeTest类，用来编写测试类

package com.bjpowernode.mybatis.test;
    
    import com.bjpowernode.mybatis.mapper.CarMapper;
    import com.bjpowernode.mybatis.pojo.Car;
    import com.bjpowernode.mybatis.utils.SqlSessionUtil;
    import org.apache.ibatis.session.SqlSession;
    import org.junit.Test;
    
    import java.util.List;
    import java.util.Map;
    
    public class CarMapperTest {
        @Test
        public void testSelectAllByResultMap(){
            SqlSession sqlSession = SqlSessionUtil.openSession();
            CarMapper mapper = sqlSession.getMapper(CarMapper.class);
            List<Car> cars = mapper.selectAllByResultMap();
            cars.forEach(car -> System.out.println(car));
            sqlSession.close();
        }
    }

**（2）是否开启驼峰命名⾃动映射（配置settings）**

> **前提：属性名遵循Java的命名规范，数据库表的列名遵循SQL的命名规范。**
> 
> ①Java命名规范：⾸字⺟⼩写，后⾯每个单词⾸字⺟⼤写，遵循驼峰命名⽅式。
> 
> ②SQL命名规范：全部⼩写，单词之间采⽤下划线分割。
> 
> ⽐如以下的对应关系：

![1c6accff013546c6aeeeb69078dd0219.png][]

> 如何启⽤该功能，在核心配置文件mybatis-config.xml中进⾏配置：

<settings>
     <setting name="mapUnderscoreToCamelCase" value="true"/>
    </settings>

三兄弟之一：CarMapper接口，编写方法

package com.bjpowernode.mybatis.mapper;
    
    import com.bjpowernode.mybatis.pojo.Car;
    import org.apache.ibatis.annotations.MapKey;
    import java.util.*;
    
    public interface CarMapper {
        // 查询所有Car，启⽤驼峰命名⾃动映射
        List<Car> selectAllByMapUnderscoreToCamelCase();
    }

三兄弟之二：CarMapper.xml文件，编写sql语句

<?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">
    
    <mapper namespace="com.bjpowernode.mybatis.mapper.CarMapper">
        <select id="selectAllByMapUnderscoreToCamelCase" resultType="car">
            select * from t_car;
        </select>
    </mapper>

三兄弟之三：CarMappeTest类，用来编写测试类

package com.bjpowernode.mybatis.test;
    
    import com.bjpowernode.mybatis.mapper.CarMapper;
    import com.bjpowernode.mybatis.pojo.Car;
    import com.bjpowernode.mybatis.utils.SqlSessionUtil;
    import org.apache.ibatis.session.SqlSession;
    import org.junit.Test;
    
    import java.util.List;
    import java.util.Map;
    
    public class CarMapperTest {
        @Test
        public void testSelectAllByMapUnderscoreToCamelCase(){
            SqlSession sqlSession = SqlSessionUtil.openSession();
            CarMapper mapper = sqlSession.getMapper(CarMapper.class);
            List<Car> cars = mapper.selectAllByMapUnderscoreToCamelCase();
            cars.forEach(car -> System.out.println(car));
            sqlSession.close();
        }
    }

#### 7. 返回总记录条数 ####

> 需求：查询总记录条数，使用count函数！

三兄弟之一：CarMapper接口，编写方法

> 方法的返回类型定义成Long或者Integer都可以，这里就使用Long

package com.bjpowernode.mybatis.mapper;
    
    import com.bjpowernode.mybatis.pojo.Car;
    import org.apache.ibatis.annotations.MapKey;
    import java.util.*;
    
    public interface CarMapper {
        // 获取总记录条数
        Long selectTotal();
    }

三兄弟之二：CarMapper.xml文件，编写sql语句

> 注：前面我们返回的类型是Long，所以这里resultType的指定类型也是long（别名）

<?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">
    
    <mapper namespace="com.bjpowernode.mybatis.mapper.CarMapper">
        <select id="selectTotal" resultType="long">
            select count(*) from t_car;
        </select>
    </mapper>

三兄弟之三：CarMappeTest类，用来编写测试类

package com.bjpowernode.mybatis.test;
    
    import com.bjpowernode.mybatis.mapper.CarMapper;
    import com.bjpowernode.mybatis.pojo.Car;
    import com.bjpowernode.mybatis.utils.SqlSessionUtil;
    import org.apache.ibatis.session.SqlSession;
    import org.junit.Test;
    
    import java.util.List;
    import java.util.Map;
    
    public class CarMapperTest {
       @Test
        public void testSelectTotal(){
            SqlSession sqlSession = SqlSessionUtil.openSession();
            CarMapper mapper = sqlSession.getMapper(CarMapper.class);
            Long total = mapper.selectTotal();
            System.out.println("总记录条数"+total);
            sqlSession.close();
        }
    }

[4c351d804dbc48b081306708b5bde9d5.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/ae3e0e14602a4946852e0e54c9016351.png
[52054b5bd9b349c2b30aae21f07535fa.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/ecdab9703c274a68a9e6c77760794bf8.png
[afb11a90c0d74b9ab2e8be333e6585e7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/5f1fcd1aa2454f7bba1f0612894efa51.png
[f00ced6f28934cb3892eab412a3ccc58.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/6515e273a43c42a680be9482c3dba4ef.png
[1c6f8a4e3b7547efa26529652642c18a.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/a6ff532ff1664dca9fd9eba815ab4786.png
[f4e5324664b841139749e92381e99504.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/87ffc22e1eac46dc8149ce07679c4a45.png
[1c6accff013546c6aeeeb69078dd0219.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/ea9cc1dae02b4a688ff582145c7af102.png