Spring Boot 中映射的最佳实践

php中文网 2024-10-15 12:36:15

在 spring boot 应用程序中决定将 dto 映射到实体（反之亦然）的最佳实践时，需要考虑几个关键因素：简单性、可维护性、性能和可测试性。每种方法都有其优点，因此最佳实践取决于您的项目要求。以下是不同方法以及何时使用它们的详细信息：

1. 使用 > 等库（大型项目首选）

mapstruct 是一个编译时代码生成器，可自动执行 dto 和实体之间的映射过程。
最适合： 拥有许多 dto 和实体并且希望避免重复的手动映射代码的大型项目。
为什么 mapstruct 是一个不错的选择：

性能：因为它在编译时生成映射代码，所以与运行时解决方案相比非常高效。类型安全：如果映射不正确或丢失，则会出现编译时错误，从而减少运行时失败的机会。可维护性：它为您生成所有样板代码，减少重复。自定义映射支持：您可以轻松地为复杂字段定义自定义映射（例如，不同的字段名称、嵌套对象）。

何时使用 mapstruct：

当您有许多 dto 和实体要映射时。

当性能是一个问题时（因为它是编译时生成的）。

当您想要减少样板代码但保持对映射的控制时。

293591553657

@mapper(componentmodel = "spring")
public interface clientmapper extends basemapper<clientdto user> {
    // mapstruct will automatically inherit the methods from basemapper
}
</clientdto>

@mapper(componentmodel = "spring")
public interface sentimentmapper extends basemapper<sentimentdto product> {
    // inherits from basemapper
}
</sentimentdto>

您应该按如下方式组织文件：

src
 └── main
     └── java
         └── com
             └── yourapp
                 ├── mapper                # package for mappers
                 │    ├── basemapper.java  # abstract base mapper
                 │    ├── clientmapper.java # client-specific mapper
                 │    └── sentimentmapper.java # sentiment-specific mapper

示例：如何在服务中使用映射器

package com.yourapp.service;

import com.yourapp.dto.userdto;
import com.yourapp.entity.user;
import com.yourapp.mapper.usermapper;
import org.springframework.stereotype.service;

@service
public class clientservice {

    private final clientmapper clientmapper;

    // constructor injection (preferred method)
    public userservice(clientmapper clientmapper) {
        this.clientmapper = clientmapper;
    }

    // method to convert client entity to clientdto
    public clientdto getclientdto(client client) {
        return clientmapper.todto(client);
    }

    // method to convert clientdto to client entity
    public user createclientfromdto(clientdto clientdto) {
        return clientmapper.toentity(clientdto);
    }
}

2. 使用 > 等库（用于快速动态映射）

modelmapper 在运行时动态映射 dto 和实体之间的字段。
最适合：快速设置，尤其是在原型设计中或当您不想为许多字段手动编写映射逻辑时。
为什么选择 modelmapper：

易于设置： 需要很少的设置，并且适用于简单的用例。

动态映射：非常适合实体和 dto 具有相似结构且您不想编写单独的映射方法的情况。

示例：

        modelmapper modelmapper = new modelmapper();
        clientdto clientdto = modelmapper.map(client, clientdto.class);
        client client = modelmapper.map(clientdto, client.class);

何时使用 modelmapper：

当项目规模较小或中等，并且您不想编写单独的映射器时。

当您的 dto 和实体的结构非常相似并且不需要太多自定义时。

3. 手动映射（最适合小型项目或特定案例）

手动映射涉及您自己编写转换代码，通常使用简单的 getter/setter 调用。
最适合：小型项目、简单映射，或者当您需要完全控制映射过程的各个方面时。
为什么手动映射是一个不错的选择：

简单映射：如果您只有几个 dto 和实体，手动映射可以直接且易于实现。

完全控制：您可以完全控制映射的完成方式，这在映射过程中进行复杂逻辑或数据转换时非常有用。

示例：

public class ClientMapper {
    public ClientDTO toDto(Client client) {
        ClientDTO clientDTO = new ClientDTO();
        clientDTO.setEmail(client.getEmail());
        return clientDTO;
    }

    public User toEntity(ClientDTO clientDTO) {
        Client client = new User();
        client.setEmail(clientDTO.getEmail());
        return client;
    }
}

何时使用手动映射：