在 JPA 中将查询结果映射到自定义对象VO/DTO主要有以下几种方式。结合你项目中的实际情况同时使用了 JPA 和 MyBatis-Plus我按推荐度从高到低列出一、接口投影Interface Projection—— 你最熟悉的方式这是你已经在用的方式适合只读查询。javapublic interface DrivingRecordVO { String getVin(); Date getTime(); String getField(); }Repository 中直接返回javaQuery(value SELECT vin, time, field FROM driving_record, nativeQuery true) ListDrivingRecordVO findRecords();优点零配置JPA 自动映射。缺点只能读不能写需要 getter 命名与 SQL 列名匹配。二、类投影Class-based DTO Projection使用普通 POJO 类带构造方法或 setter更灵活。方式一使用构造方法推荐javaData AllArgsConstructor public class DrivingRecordDTO { private String vin; private Date time; private String field; }RepositoryjavaQuery(SELECT new com.seazon.cloud.pojo.vo.DrivingRecordDTO(a.vin, a.time, b.field) FROM DrivingRecord a LEFT JOIN BEntity b ON a.vin b.vin) ListDrivingRecordDTO findRecords();注意必须用JPQL不是原生 SQL且 DTO 必须有对应的全参构造方法。方式二使用 setter 映射原生 SQLjavaData public class DrivingRecordDTO { private String vin; private Date time; private String field; // 有默认无参构造即可JPA 通过 setter 赋值 }RepositoryjavaQuery(value SELECT vin, time, field FROM driving_record, nativeQuery true) ListDrivingRecordDTO findRecords();要求DTO 有无参构造 setter 方法且 setter 名称与列名对应。三、使用SqlResultSetMappingNamedNativeQuery这是 JPA 规范的原生方式适合复杂映射。实体类上定义javaEntity NamedNativeQuery( name DrivingRecord.findRecords, query SELECT vin, time, field FROM driving_record, resultSetMapping DrivingRecordDTOMapping ) SqlResultSetMapping( name DrivingRecordDTOMapping, classes ConstructorResult( targetClass DrivingRecordDTO.class, columns { ColumnResult(name vin, type String.class), ColumnResult(name time, type Date.class), ColumnResult(name field, type String.class) } ) ) public class DrivingRecord { // ... }Repository 通过Query的name引用javaQuery(name DrivingRecord.findRecords, nativeQuery true) ListDrivingRecordDTO findRecords();四、使用Tuple手动转换适合需要动态处理结果的场景。javaQuery(value SELECT vin, time, field FROM driving_record, nativeQuery true) ListTuple findRecordsAsTuple();Service 中手动转换javaListDrivingRecordDTO result tuples.stream() .map(t - new DrivingRecordDTO( t.get(vin, String.class), t.get(time, Date.class), t.get(field, String.class) )) .collect(Collectors.toList());五、使用 MyBatis-Plus你已引入强烈推荐既然你的项目中同时有 JPA 和 MyBatis-Plus复杂查询尤其涉及窗口函数、多表关联直接用 MyBatis-Plus 最方便。javaMapper public interface DrivingRecordMapper extends BaseMapperDrivingRecord { Select(SELECT vin, time, field FROM driving_record) ListDrivingRecordDTO findRecords(); }MyBatis-Plus 会自动将查询结果的列名映射到 DTO 的字段通过 setter 或构造方法。六、总结对比方式适用场景优缺点接口投影简单只读查询最简单但扩展性差类投影JPQL 构造JPQL 查询类型安全支持复杂构造类投影原生 SQL setter原生 SQL灵活但需要注意命名匹配SqlResultSetMapping复杂映射、多表关联最标准但配置繁琐Tuple 手动转换动态字段最灵活但代码冗长MyBatis-Plus复杂查询、原生 SQL最简单与你项目契合度高七、根据你场景的推荐你的场景推荐方式简单查询1-2 张表接口投影方式一JPQL 查询类投影 构造方法方式二复杂 SQL窗口函数、多表关联MyBatis-Plus方式五需要动态字段返回Tuple 手动转换方式四最省事的选择既然你的项目已经引入了 MyBatis-Plus建议将涉及复杂 SQL 的查询全部交由 MyBatis-Plus 处理直接返回你定义的 VO/DTO 对象。这样 JPA 只负责简单的 CRUD两种框架各司其职互不干扰。
在 JPA 中将查询结果映射到自定义对象VO/DTO主要有以下几种方式。结合你项目中的实际情况同时使用了 JPA 和 MyBatis-Plus我按推荐度从高到低列出一、接口投影Interface Projection—— 你最熟悉的方式这是你已经在用的方式适合只读查询。javapublic interface DrivingRecordVO { String getVin(); Date getTime(); String getField(); }Repository 中直接返回javaQuery(value SELECT vin, time, field FROM driving_record, nativeQuery true) ListDrivingRecordVO findRecords();优点零配置JPA 自动映射。缺点只能读不能写需要 getter 命名与 SQL 列名匹配。二、类投影Class-based DTO Projection使用普通 POJO 类带构造方法或 setter更灵活。方式一使用构造方法推荐javaData AllArgsConstructor public class DrivingRecordDTO { private String vin; private Date time; private String field; }RepositoryjavaQuery(SELECT new com.seazon.cloud.pojo.vo.DrivingRecordDTO(a.vin, a.time, b.field) FROM DrivingRecord a LEFT JOIN BEntity b ON a.vin b.vin) ListDrivingRecordDTO findRecords();注意必须用JPQL不是原生 SQL且 DTO 必须有对应的全参构造方法。方式二使用 setter 映射原生 SQLjavaData public class DrivingRecordDTO { private String vin; private Date time; private String field; // 有默认无参构造即可JPA 通过 setter 赋值 }RepositoryjavaQuery(value SELECT vin, time, field FROM driving_record, nativeQuery true) ListDrivingRecordDTO findRecords();要求DTO 有无参构造 setter 方法且 setter 名称与列名对应。三、使用SqlResultSetMappingNamedNativeQuery这是 JPA 规范的原生方式适合复杂映射。实体类上定义javaEntity NamedNativeQuery( name DrivingRecord.findRecords, query SELECT vin, time, field FROM driving_record, resultSetMapping DrivingRecordDTOMapping ) SqlResultSetMapping( name DrivingRecordDTOMapping, classes ConstructorResult( targetClass DrivingRecordDTO.class, columns { ColumnResult(name vin, type String.class), ColumnResult(name time, type Date.class), ColumnResult(name field, type String.class) } ) ) public class DrivingRecord { // ... }Repository 通过Query的name引用javaQuery(name DrivingRecord.findRecords, nativeQuery true) ListDrivingRecordDTO findRecords();四、使用Tuple手动转换适合需要动态处理结果的场景。javaQuery(value SELECT vin, time, field FROM driving_record, nativeQuery true) ListTuple findRecordsAsTuple();Service 中手动转换javaListDrivingRecordDTO result tuples.stream() .map(t - new DrivingRecordDTO( t.get(vin, String.class), t.get(time, Date.class), t.get(field, String.class) )) .collect(Collectors.toList());五、使用 MyBatis-Plus你已引入强烈推荐既然你的项目中同时有 JPA 和 MyBatis-Plus复杂查询尤其涉及窗口函数、多表关联直接用 MyBatis-Plus 最方便。javaMapper public interface DrivingRecordMapper extends BaseMapperDrivingRecord { Select(SELECT vin, time, field FROM driving_record) ListDrivingRecordDTO findRecords(); }MyBatis-Plus 会自动将查询结果的列名映射到 DTO 的字段通过 setter 或构造方法。六、总结对比方式适用场景优缺点接口投影简单只读查询最简单但扩展性差类投影JPQL 构造JPQL 查询类型安全支持复杂构造类投影原生 SQL setter原生 SQL灵活但需要注意命名匹配SqlResultSetMapping复杂映射、多表关联最标准但配置繁琐Tuple 手动转换动态字段最灵活但代码冗长MyBatis-Plus复杂查询、原生 SQL最简单与你项目契合度高七、根据你场景的推荐你的场景推荐方式简单查询1-2 张表接口投影方式一JPQL 查询类投影 构造方法方式二复杂 SQL窗口函数、多表关联MyBatis-Plus方式五需要动态字段返回Tuple 手动转换方式四最省事的选择既然你的项目已经引入了 MyBatis-Plus建议将涉及复杂 SQL 的查询全部交由 MyBatis-Plus 处理直接返回你定义的 VO/DTO 对象。这样 JPA 只负责简单的 CRUD两种框架各司其职互不干扰。
