自定义编写 MySQL 语句 SELECT * 及返回对象用 MySQL 表映射类接收值为空的定位及处理

在实际的开发过程中，维护老代码并增加新功能是常见的任务。这篇文章将探讨在维护过程中遇到的一个问题：在对应的表中添加新字段后，表映射实体类中新增的字段因命名不符合驼峰命名规则，导致查询结果值为空的问题。

一、问题背景

在维护老代码的过程中，我们需要在 MySQL 表中增加一个新字段，并在对应的 Java 实体类中添加相应的字段。然而，使用自定义 SQL 语句（如 SELECT *）进行查询时，发现新添加的字段值为 null。以下是问题的具体描述：

在 MySQL 表中增加了一个字段 cooperate_type。
在 Java 实体类中增加了对应的字段，但命名不符合驼峰命名规则，命名为 cooperateWayType。
使用自定义注解的 SQL 查询语句 SELECT *。
查询结果中 cooperateWayType 字段的值为 null。

二、问题定位

问题出现在自定义的 SQL 查询语句与实体类字段命名不符合驼峰命名规则的情况下。具体来说，MyBatis 或其他 ORM 框架在进行结果映射时，会自动将下划线命名转换为驼峰命名。但如果实体类中的字段命名不符合这个规则，则会导致映射失败，查询结果为空。

示例代码
假设我们的 MySQL 表结构如下：

CREATE TABLE orders (
    id INT PRIMARY KEY,
    order_number VARCHAR(50),
    cooperate_type VARCHAR(50)
);

对应的 Java 实体类如下：

public class Order {
    private Integer id;
    private String orderNumber;
    private String cooperateWayType; // 不符合驼峰命名规则
}

自定义的 SQL 查询语句如下：

@Select("SELECT * FROM orders")
List<Order> findAllOrders();

三、解决方案

为了确保查询结果能够正确映射到 Java 实体类中，我们需要确保实体类字段的命名符合驼峰命名规则。具体的解决方案如下：

1. 修改实体类字段命名
将实体类字段命名改为符合驼峰命名规则：

public class Order {
    private Integer id;
    private String orderNumber;
    private String cooperateType; // 修改为符合驼峰命名规则
}

2. 使用 @Results 注解手动映射字段
如果不能修改实体类字段命名，可以使用 MyBatis 的 @Results 注解手动映射字段：

@Select("SELECT * FROM orders")
@Results({
    @Result(property = "id", column = "id"),
    @Result(property = "orderNumber", column = "order_number"),
    @Result(property = "cooperateWayType", column = "cooperate_type")
})
List<Order> findAllOrders();

四、完整示例

以下是一个完整的示例，展示了如何正确映射查询结果到 Java 实体类：

1. MySQL 表结构

CREATE TABLE orders (
    id INT PRIMARY KEY,
    order_number VARCHAR(50),
    cooperate_type VARCHAR(50)
);

2. Java 实体类

public class Order {
    private Integer id;
    private String orderNumber;
    private String cooperateType; // 修改为符合驼峰命名规则
    // 或者使用原始命名 cooperateWayType 并在查询中进行手动映射
}

3. 自定义 SQL 查询语句和映射
如果使用符合驼峰命名规则的字段：

@Select("SELECT * FROM orders")
List<Order> findAllOrders();

如果使用手动映射：

@Select("SELECT * FROM orders")
@Results({
    @Result(property = "id", column = "id"),
    @Result(property = "orderNumber", column = "order_number"),
    @Result(property = "cooperateWayType", column = "cooperate_type")
})
List<Order> findAllOrders();