如何在查询返回中不映射实体部分属性？按需映射父类属性方案

嘿，针对你提出的两个数据库映射问题，我结合日常开发中常用的ORM框架（比如JPA/Hibernate、MyBatis）给你梳理下实用的解决方案：

不同ORM框架的实现思路略有不同，这里分场景给你说明：

• JPA/Hibernate 场景

  • 方法1：用@Transient标记临时属性
    如果实体里有一些不需要持久化到数据库、也不需要从查询结果映射的临时属性，直接给属性加@Transient注解就行。框架会自动忽略这个字段的映射：

    @Entity
    public class User {
        @Id
        private Long id;
        private String username;
        @Transient // 这个属性不会和数据库列关联，查询结果也不会映射它
        private String tempVerificationCode;
    }
    

  • 方法2：构造器投影筛选字段
    如果查询时只需要实体的部分字段，可以用实体的构造器来指定要加载的属性，这样查询结果只会映射构造器里的字段，其他属性会是默认值：

    // 实体里要有对应的构造器
    public User(Long id, String username) {
        this.id = id;
        this.username = username;
    }
    // JPQL查询
    String jpql = "SELECT new com.example.User(u.id, u.username) FROM User u";
    List<User> users = entityManager.createQuery(jpql, User.class).getResultList();
    

  • 方法3：用DTO完全解耦
    要是不想碰实体类，直接创建一个只包含需要属性的DTO类，查询时直接映射到DTO，彻底避开实体的多余属性：

    public class UserSimpleDTO {
        private Long id;
        private String username;
        // 对应查询字段的构造器
        public UserSimpleDTO(Long id, String username) {
            this.id = id;
            this.username = username;
        }
        // getter/setter
    }
    // 查询
    String jpql = "SELECT new com.example.UserSimpleDTO(u.id, u.username) FROM User u";
    List<UserSimpleDTO> dtos = entityManager.createQuery(jpql, UserSimpleDTO.class).getResultList();
    

• MyBatis 场景

  • 方法1：自定义ResultMap时忽略字段
    在XML的resultMap里只配置你需要映射的字段，没写的字段自然不会被映射：

    <resultMap id="UserSimpleMap" type="com.example.User">
        <id property="id" column="id"/>
        <result property="username" column="username"/>
        <!-- 不配置tempVerificationCode的映射，查询结果不会给这个属性赋值 -->
    </resultMap>
    

  • 方法2：注解方式指定映射字段
    在Mapper接口的方法上用@Results注解手动指定要映射的字段，同样忽略不需要的：

    @Select("SELECT id, username FROM user")
    @Results({
        @Result(property = "id", column = "id"),
        @Result(property = "username", column = "username")
    })
    List<User> getSimpleUsers();
    

当然可以！完全不用为每个查询单独创建实体，核心思路是用投影（Projection）或者继承复用来减少重复代码，这里给你几个常用方案：

• 方案1：Spring Data JPA 接口投影（推荐）
  先定义一个包含通用基础属性的父接口，然后每个查询的投影接口继承它，只扩展需要的运算结果属性。这种方式不用写实体或DTO，直接用接口映射：

  // 父接口：存放所有查询都需要的通用属性
  public interface BaseUserProjection {
      Long getId();
      String getUsername();
  }
  // 子接口：针对某个查询，新增运算结果属性（比如计算年龄）
  public interface UserWithAgeProjection extends BaseUserProjection {
      // 用@Value注解写SpEL表达式计算年龄（假设数据库有birth_date列）
      @Value("#{T(java.time.LocalDate).now().getYear() - target.birthDate.getYear()}")
      Integer getAge();
  }
  // Repository直接返回投影接口
  public interface UserRepository extends JpaRepository<User, Long> {
      List<UserWithAgeProjection> findByUsernameContaining(String keyword);
  }
  

  这样所有查询都可以复用父接口的通用属性，只需要在子接口里添加当前查询特有的运算字段，非常高效。

• 方案2：DTO父类继承
  创建一个包含通用属性的父DTO，每个查询的子DTO继承它，只添加需要的运算结果字段：

  // 父DTO：通用基础属性
  public class BaseUserDTO {
      private Long id;
      private String username;
      // 构造器、getter/setter
      public BaseUserDTO(Long id, String username) {
          this.id = id;
          this.username = username;
      }
  }
  // 子DTO：新增运算结果属性（比如年龄）
  public class UserWithAgeDTO extends BaseUserDTO {
      private Integer age;
      // 构造器继承父类属性，加上新增的age
      public UserWithAgeDTO(Long id, String username, Integer age) {
          super(id, username);
          this.age = age;
      }
      // getter/setter
  }
  // 查询时直接映射到子DTO
  String jpql = "SELECT new com.example.UserWithAgeDTO(u.id, u.username, " +
                "YEAR(CURRENT_DATE) - YEAR(u.birthDate)) FROM User u";
  List<UserWithAgeDTO> dtos = entityManager.createQuery(jpql, UserWithAgeDTO.class).getResultList();
  

  这种方式通过继承复用父类的通用属性，每个查询只需要处理新增的运算字段，避免重复写相同的属性。

• 方案3：MyBatis ResultMap 继承
  用MyBatis的话，可以定义一个通用的父resultMap，然后每个查询的子resultMap继承它，只添加运算结果的映射：

  <!-- 父ResultMap：通用属性映射 -->
  <resultMap id="BaseUserMap" type="com.example.BaseUserDTO">
      <id property="id" column="id"/>
      <result property="username" column="username"/>
  </resultMap>
  <!-- 子ResultMap：继承父映射，新增运算结果属性 -->
  <resultMap id="UserWithAgeMap" type="com.example.UserWithAgeDTO" extends="BaseUserMap">
      <result property="age" column="calculated_age"/> <!-- calculated_age是查询的运算列名 -->
  </resultMap>
  <!-- 查询语句 -->
  <select id="getUsersWithAge" resultMap="UserWithAgeMap">
      SELECT id, username, YEAR(NOW()) - YEAR(birth_date) AS calculated_age FROM user
  </select>
  

  这样每个查询的ResultMap只需要关注新增的运算字段，复用父类的通用映射，减少重复配置。

内容的提问来源于stack exchange，提问作者João Pedro Oliveira Souza