Java REST服务中ORM接口到API实体类的对象映射方案咨询

首先，Dozer并不是不能处理这种场景，它生成空对象的原因是默认无法自动关联接口的x()方法和Target类的getX()/setX()方法。下面先讲怎么用Dozer解决，再给你几个更轻量的替代方案：

一、用Dozer实现正确映射 #

你需要通过自定义映射配置来明确接口方法和目标类属性的对应关系：

1. 编写XML映射配置文件
   创建dozer-mapping.xml，指定Source接口的x()方法对应Target的x属性：

   <?xml version="1.0" encoding="UTF-8"?>
   <mappings xmlns="http://dozer.sourceforge.net"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:schemaLocation="http://dozer.sourceforge.net
             http://dozer.sourceforge.net/schema/beanmapping.xsd">
       <mapping>
           <class-a>your.package.Source</class-a>
           <class-b>your.package.Target</class-b>
           <field>
               <a>x()</a>
               <b>x</b>
           </field>
       </mapping>
   </mappings>
   

2. 初始化Dozer时加载该配置
   在代码中配置DozerBeanMapper加载自定义映射：

   List<String> mappingFiles = Collections.singletonList("dozer-mapping.xml");
   DozerBeanMapper mapper = new DozerBeanMapper(mappingFiles);
   
   // 执行映射
   Source sourceEntity = ...; // ORM生成的Source实现类实例
   Target targetDto = mapper.map(sourceEntity, Target.class);
   

这样Dozer就能正确识别方法与属性的关联，完成数据映射。

二、更轻量的替代方案 #

如果觉得Dozer的配置繁琐或者依赖过重，这些轻量库更适合你的场景：

1. MapStruct（编译时生成代码，性能最优） #

MapStruct是编译时生成映射实现的工具，没有运行时反射开销，性能极佳，且对接口到类的映射支持很好。

• 添加Maven依赖：

  <dependency>
      <groupId>org.mapstruct</groupId>
      <artifactId>mapstruct</artifactId>
      <version>1.5.5.Final</version>
  </dependency>
  <dependency>
      <groupId>org.mapstruct</groupId>
      <artifactId>mapstruct-processor</artifactId>
      <version>1.5.5.Final</version>
      <scope>provided</scope>
  </dependency>
  

• 定义映射接口：

  @Mapper
  public interface SourceTargetMapper {
      SourceTargetMapper INSTANCE = Mappers.getMapper(SourceTargetMapper.class);
      
      // MapStruct会自动识别Source的x()方法和Target的setX()方法
      Target sourceToTarget(Source source);
  }
  

• 使用方式：

  Source source = ...;
  Target target = SourceTargetMapper.INSTANCE.sourceToTarget(source);
  

2. ModelMapper（运行时自动映射，配置简单） #

ModelMapper是运行时映射库，能自动识别方法与属性的命名对应关系，几乎不需要额外配置。

• 添加Maven依赖：

  <dependency>
      <groupId>org.modelmapper</groupId>
      <artifactId>modelmapper</artifactId>
      <version>3.1.1</version>
  </dependency>
  

• 直接使用：

  ModelMapper modelMapper = new ModelMapper();
  Source source = ...;
  Target target = modelMapper.map(source, Target.class);
  

如果自动映射不生效，可以调整匹配策略：

modelMapper.getConfiguration()
           .setMatchingStrategy(MatchingStrategies.STANDARD);

3. 手动映射（零依赖，最轻量化） #

如果你的模型结构简单，手动映射其实是最直接的方案，没有任何第三方依赖，维护成本也低：

public class TargetConverter {
    public static Target convert(Source source) {
        Target target = new Target();
        target.setX(source.x());
        return target;
    }
}

使用时直接调用：

Target target = TargetConverter.convert(source);

总结 #

• 如果你已经在使用Dozer，通过自定义XML配置就能解决问题；
• 追求性能和简洁性，优先选MapStruct；
• 想要零配置快速实现，ModelMapper是不错的选择；
• 模型简单的话，手动映射最省心。

内容的提问来源于stack exchange，提问作者kdr