概述

Dozer 是什么?

Dozer 是 Java Bean 到 Java Bean 的映射器，他以递归的方式将数据从一个对象复制到另一个对象。

它支持简单的属性映射，复杂类型映射，双向映射，隐式显式的映射，以及递归映射，使用该映射器可以很方便的在项目中进行 pojo、do、vo 之间的转换。

它支持三种映射方式：注解、API、XML。

它是开源的，遵从 Apache 2.0 协议。
 

使用

安装

---

Maven

如果你的项目使用 maven，添加以下依赖到你的 pom.xml 即可：

<dependency><groupId>net.sf.dozer</groupId><artifactId>dozer</artifactId><version>${dozer.version}</version>
</dependency>

---

导入 jar 包

如果不使用 Maven，那么需要引入 Dozer 的 jar 包以及其依赖的第三方 jar 包。

• Dozer
• Dozer 依赖的第三方 jar 包

---

 

入门

创建两个 Java Bean 类：

public class User {private String name;private Integer age;private Date birthday;// 省略 setter 和 getter 方法
}

public class UserApiDestinationObject {private String name;private String age;public String birthday;// 重写 toString 方法，方便测试@Overridepublic String toString() {return "UserApiDestinationObject{" +"name='" + name + '\'' +", age='" + age + '\'' +", birthday='" + birthday + '\'' +'}';}// 省略 getter、setter 方法
}

测试：

@Test
public void apiTest() {Mapper mapper = new DozerBeanMapper();User user = new User();user.setName("sid10t.");user.setAge(3);user.setBirthday(new Date());UserApiDestinationObject destinationObject = mapper.map(user, UserApiDestinationObject.class);System.out.println(destinationObject);
}

输出：

UserApiDestinationObject{name='sid10t.', age='3', birthday='Tue Mar 08 10:56:02 CST 2022'}

此时，Dozer 自动完成 User 类到 ApiUserDestination 类的映射。这是 Dozer 的默认映射方式——隐式映射，Dozer 自动的将两个实体类的相同属性名的属性进行映射。如果两个属性的属性名相同，但是类型不同，Dozer 会按照默认的转换规则进行类型的转换，而且不同修饰符的属性也能正常进行映射。

注意：

两个 Java Bean 类都是需要 get 和 set 方法的，上述省略不代表不需要，不然是无法进行映射的；

如果运行时报了这个异常：java.lang.NoClassDefFoundError: org/slf4j/LoggerFactory，则需要导入 slf4j 的 jar 包：

<dependency><groupId>org.slf4j</groupId><artifactId>slf4j-api</artifactId><version>1.7.22</version>
</dependency>

 

XML 映射

有时候两个 bean 的属性名并不完全相同，这时候通过 Dozer 的隐式映射并不能满足我们的实际需求，这时候就可以通过 Dozer 的另一种映射方式——显示映射进行映射。通过显示映射的方法需要我们自己创建一个 xml 的映射文件来指定两个类的映射关系。这些 xml 配置文件将在运行时由 Dozer 引擎使用。

下面演示 Dozer 的显示映射方式：

新建 UserXmlDestinationObject 类：

public class UserXmlDestinationObject {private String username;private String age;public String dateOfBirth;// 省略 setter 和 getter 方法// 省略 toString 方法
}

在 resource 目录下新建 userMapping.xml 文件，xml 中的配置信息如下：

<?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.nethttp://dozer.sourceforge.net/schema/beanmapping.xsd"><!--全局配置，配置日期的映射格式--><configuration><date-format>yyyy-MM-dd HH:mm:ss</date-format></configuration><mapping wildcard="true"><class-a>User</class-a><class-b>UserXmlDestinationObject</class-b><field><a>name</a><b>username</b></field><field><a>birthday</a><b>dateOfBirth</b></field></mapping></mappings>

一个 mappings 元素包含多个 mapping 元素，每个 mapping 元素都有类映射声明和字段的映射关系。wildcard 属性默认值为 true，这意味着 Dozer 将会尝试映射两个类的每个字段，当该属性设置为 false 时，Dozer 将仅映射显示定义的字段。也可以在 filed 下的 <a> 或者 <b> 节点下添加配置信息，如：<a date-fomat="MM/dd/yyyy HH:mm">，此时字段的配置信息优先级别高于全局配置。

测试：

@Test
public void xmlTest(){List myMappingFiles = new ArrayList();myMappingFiles.add("userMapping.xml");DozerBeanMapper mapper = new DozerBeanMapper();mapper.setMappingFiles(myMappingFiles);User user = new User();user.setName("sid10t.");user.setAge(3);user.setBirthday(new Date());UserXmlDestinationObject destinationObject = mapper.map(user, UserXmlDestinationObject.class);System.out.println(destinationObject);
}

输出：

//<mapping wildcard="true">
UserXmlDestinationObject{username='sid10t.', age='3', dateOfBirth='2022-03-08 12:54:14'}//<mapping wildcard="false">
UserXmlDestinationObject{username='sid10t.', age='null', dateOfBirth='2022-03-08 12:57:09'}

 

注解映射

从版本 5.3.2 开始，Dozer 也开始提供注解支持，使用注解的明显原因是避免在映射代码中复制字段和方法名称，注解可以放在映射类的属性上，从而减少代码量。但是有些情况应该减少使用注解，甚至无法使用注解，如：

• 你正在映射类时，这些类不在你的控制下，但在库中提供；
• 映射类非常复杂，而且需要许多配置；

新建 UserAnnotationsObject 类：

public class UserAnnotationsObject {@Mapping("name")public String username;private String age;@Mapping("birthday")private String dateOfBirth;// 省略 getter、setter 方法// 省略 toString 方法
}

注意：dozer 是双向映射的，无论使用 xml 或者 注解的方式进行映射，都只需要配置一个类的映射关系就行。

测试：

@Test
public void annotationsTest(){DozerBeanMapper mapper = new DozerBeanMapper();User user = new User();user.setName("sid10t.");user.setAge(3);user.setBirthday(new Date());UserAnnotationsObject destinationObject = mapper.map(user, UserAnnotationsObject.class);System.out.println(destinationObject);
}

输出：

UserAnnotationsObject{username='sid10t.', age='3', dateOfBirth='Tue Mar 08 13:03:37 CST 2022'}

通过注解的方式，User 类中的 “name” 属性将映射到 UserAnnotationsObject 类中的 username 属性，不用担心 private 修饰符，Dozer 将会自动处理。目前 Dozer 只提供 @Mapping 这一个注解，后续版本可能会添加新的注解，至于现在，你可以混合 api 方式、xml 方式、注解方式进行类的映射。

注意：对于实际应用程序，建议不要在每次映射对象时创建一个新的 Mapper 实例，而是重新使用上次创建的 Mapper 实例，可以把 Mapper 封装成单例模式使用。
 

SpringBoot 集成

自从 6.2.0 版本之后，Dozer 提供了 dozer-spring-boot-starter 用于 Spring Boot 的集成，如果使用 Maven 构建的项目，只需要在 pom.xml 文件中引入如下依赖：

<dependency><groupId>com.github.dozermapper</groupId><artifactId>dozer-spring-boot-starter</artifactId><version>{dozer-version}</version>
</dependency>

新建 DozerMapperConfig 配置类：

@Configuration
public class DozerMapperConfig {@Beanpublic DozerBeanMapperFactoryBean dozerMapper(@Value("classpath:mapping/*.xml") Resource[] resources) throws IOException {DozerBeanMapperFactoryBean dozerBeanMapperFactoryBean = new DozerBeanMapperFactoryBean();dozerBeanMapperFactoryBean.setMappingFiles(resources);return dozerBeanMapperFactoryBean;}}

把 DozerBeanMapperFactoryBean 注入到 IOC 容器中，就能优雅的使用 Dozer 啦，如：

@SpringBootTest
@RunWith(SpringRunner.class)
public class DozerTest {@Autowiredprivate Mapper mapper;@Testpublic void dozerForSbTest(){User user = new User();user.setName("hxy");user.setAge(123);user.setBirthday(new Date());UserXmlDestinationObject destinationObject = mapper.map(user, UserXmlDestinationObject.class);System.out.println(destinationObject);}
}

 

结语

感谢你能看到这里，但是很遗憾的告诉你，Dozer 已经停更了，所以本文也只是简单的介绍了一下，因为项目用到了，就简单的记录一下；

Dozer 项目当前不再维护了，并且将来很大可能被弃用，然后新用户不建议使用了，老用户也推荐大家迁移到 MapStruct 和 ModelMapper 等类库上面去。

参考：

• Dozer - 码农教程
• Dozer 使用小结 - 静默虚空