ModelMapper: 简化 Java 对象映射的库

2026-01-14 18:47:37作者：蔡怀权

ModelMapper 是一个智能 Java 对象映射库，它极大地简化了将一个对象转换为另一个对象的过程。该项目可以在以下网址找到：。

什么是 ModelMapper？

ModelMapper 是一个自动化对象映射库，可以自动将一个对象转换为另一个具有不同属性名称或类型的对象。例如，如果你有一个包含数据库记录的对象，并且需要将其转换为用于 API 响应的 DTO（数据传输对象），那么你可以使用 ModelMapper 来自动化这个过程，而无需手动编写转换代码。

ModelMapper 能做什么？

自动对象映射：ModelMapper 可以根据属性名称和类型自动将一个对象转换为另一个对象。
简化的配置：通过简单的 API，您可以轻松地定义自定义映射规则或更改默认行为。
支持多种数据类型：除了基本数据类型之外，ModelMapper 还支持日期、时间和其他复杂类型。
性能优化：ModelMapper 使用高效的缓存机制和最小化反射使用，以获得最佳性能。

ModelMapper 的特点

智能映射：ModelMapper 根据源对象和目标对象之间的属性名称和类型进行智能映射。
简单易用：ModelMapper 提供了一个直观的 API，让您可以轻松地设置自定义映射规则。
高度可配置：您可以使用条件语句、转换器和其他工具来自定义映射行为。
强大的性能：ModelMapper 采用了高效的算法和缓存策略，确保了出色的性能。

示例

下面是一个简单的示例，展示了如何使用 ModelMapper 将一个 User 对象转换为一个 UserDto 对象：

// 创建一个 ModelMapper 实例
ModelMapper modelMapper = new ModelMapper();

// 定义一个转换规则
modelMapper.createTypeMap(User.class, UserDto.class)
    .addMappings(mapper -> mapper.map(user -> user.getEmail(), UserDto::setEmail));

// 创建一个 User 对象
User user = new User();
user.setName("John Doe");
user.setEmail("john.doe@example.com");

// 将 User 对象转换为 UserDto 对象
UserDto userDto = modelMapper.map(user, UserDto.class);

// 输出 UserDto 对象的内容
System.out.println(userDto.getName()); // 输出 "John Doe"
System.out.println(userDto.getEmail()); // 输出 "john.doe@example.com"

在这个示例中，我们首先创建了一个 ModelMapper 实例，然后定义了一个转换规则，该规则将 User 类型的 email 属性映射到 UserDto 类型的 email 方法。接着，我们创建了一个 User 对象，并将其转换为 UserDto 对象。最后，我们输出了 UserDto 对象的内容。