如何在 Spring JPA 中将 Optional<Entity> 转换为 Optional<EntityDTO>？

Question

我是 Spring 的新手，虽然我可以将域实体转换为 List<Entity>，但我无法将它们正确转换为 Optional<Entity>。我在存储库和服务中有以下方法：

EmployeeRepository：

@Query(value = "SELECT ...")
Optional<Employee> findByUuid(@Param(value = "uuid") final UUID uuid);

员工服务：

@Override
@LogExecution
@Transactional(readOnly = true)
public Optional<EmployeeDTO> findByUuid(UUID uuid) {
    Optional<Employee> employee = employeeRepository.findByUuid(uuid);
        return employee
                .stream()
                .map(EmployeeDTO::new)
                // .orElse(null);
                //.findFirst(); /// ??? 
    }

我的问题：

1.我应该如何正确地将Optional<Employee>转换为Optional<EmployeeDTO>？

2. Spring JPA 是否收集SELECT 子句中的字段，并在服务方法中通过匹配它们的名称将它们映射到对应的DTO？如果是这样，它是否保持命名，例如数据库表和域模型类中的employee_name 到employeeName？

Answer 1

employeeRepository#findByUuid 的输出即Optional<Employee> 和方法输出类型Optional<EmployeeDTO> 之间发生的映射是1:1，所以没有Stream（调用stream()）这里涉及到。

您只需将Employee 的字段正确映射到EmployeeDTO。处理从employeeRepository#findByUuid 返回的Optional 实际上为空的情况可以留在可选的后续链上。不需要orElse 或findFirst 调用。

假设以下类都具有全参数构造函数和 getter：

class Employee {
    private final long id;
    private final String firstName;
    private final String lastName;
}

class EmployeeDTO {
    private final long id;
    private final String name;
    private final String surname;
}

...您可以执行此操作。除了找到从Employee 的字段创建EmployeeDTO 的方法之外，别无其他。如果返回了从employeeRepository 返回的Optional，则不会发生映射并返回一个空的Optional。

@Override
@LogExecution
@Transactional(readOnly = true)
public Optional<EmployeeDTO> findByUuid(UUID uuid) {
    return employeeRepository
        .findByUuid(uuid)                             // Optional<Employee>
        .map(emp -> new EmployeeDTO(                  // Optional<EmployeeDTO>
                 emp.getId(),                         // .. id -> id
                 emp.getFirstName(),                  // .. firstName -> name
                 emp.getLastName()));                 // .. lastName -> surname
}

注意：对于Employee -> EmployeeDTO 映射，我建议选择以下之一：

• 在EmployeeDTO 中创建一个接受Employee 的构造函数，允许与.map(EmployeeDTO::new) 进行映射（缺点：创建依赖项）。
• 只需使用 getter/setter 进行映射。
• 使用映射框架，例如 MapStruct 或任何其他。

Answer 2

有多种选项可将您的实体映射到 DTO。

1. 使用投影：您的存储库可以使用投影直接返回 DTO。如果您根本不需要实体，这可能是最佳选择。你可以在这里找到关于投影的一切https://docs.spring.io/spring-data/jpa/docs/current/reference/html/#projections
2. 使用像 mapstruct 或 modelmapper 这样的库来生成映射代码
3. 向 DTO 添加构造函数或静态工厂方法。像

class EmployeeDTO {
   // fields here ...
   public static EmployeeDTO ofEntity(Employee entity) {
     var dto = new EmployeeDTO();
     // set fields
     return dto;
   }
}

并在您的服务中致电employee.map(EmployeeDTO::ofEntity)。