<think>我们正在讨论MapStruct的使用，特别是如何实现
两个对象之间
相同属性的映射和
赋值。用户明确要求使用MapStruct的示例。根据引用[2]，MapStruct是一款在编译期生成映射代码的工具，通过注解方式实现，性能接近原生代码。用户需求：提供MapStruct的使用示例，实现
两个对象之间
相同属性的映射和
赋值。步骤：1.添加依赖（Maven为例）2.定义映射接口（使用@Mapper注解）3.编写映射方法（接口中声明方法，MapStruct会自动生成实现）4.使用映射器示例对象（参考引用[3]）：Source
类：有name和age属性Target
类：有name和address属性（注意：address在Source中没有，所以只映射
相同的name属性）注意：属性名称
相同时会自动映射。如果属性名称不同，需要使用@Mapping注解指定。这里我们按照用户需求，只处理
相同属性（name）的映射，忽略不同的属性（age和address）。但是引用中提到了目标对象中有
两个字段与源对象不同，这里我们假设不同是指属性名
相同但
类型不同？但用户问题中要求的是
相同属性的自动
赋值，所以我们先以属性名
相同的自动映射为例。示例代码：</think>
### MapStruct实现对象属性映射的步骤及示例
使用MapStruct实现对象间**
相同属性自动
赋值**的步骤如下：
#### 1. 添加依赖（Maven项目）
```xml
<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>
```
#### 2. 定义源对象与目标对象
```
java
// 源对象
public class SourceUser {
private String name;
private Integer age;
// getter/setter省略
}
// 目标对象
public class TargetUser {
private String name; // 与SourceUser同名属性
private String address; // 额外属性（不参与自动映射）
// getter/setter省略
}
```
#### 3. 创建映射接口
通过`@Mapper`注解声明映射规则：
```
java
import org.mapstruct.Mapper;
import org.mapstruct.factory.Mappers;
@Mapper
public interface UserMapper {
// 获取映射器实例
UserMapper INSTANCE = Mappers.getMapper(UserMapper.class);
// 自动映射同名属性（name）
TargetUser toTarget(SourceUser source);
}
```
#### 4. 执行属性映射
```
java
public class Main {
public static void main(String[] args) {
SourceUser source = new SourceUser();
source.setName("张三");
source.setAge(30);
TargetUser target = UserMapper.INSTANCE.toTarget(source);
System.out.println(target.getName()); // 输出"张三"（自动映射）
System.out.println(target.getAddress()); // 输出null（未映射属性）
}
}
```
#### ✅ 关键特性说明
1. **自动映射同名属性**：
- 若属性名
相同（如`name`），MapStruct在**编译期**自动生成
赋值代码。
-
类似Spring的`BeanUtils`但更高效，无运行时反射开销[^2]。
2. **差异化属性处理**：
- 若需映射名称不同的属性（如`SourceUser.phone` → `TargetUser.mobile`），可通过`@Mapping`注解配置：
```
java
@Mapper
public interface UserMapper {
@Mapping(source = "phone", target = "mobile")
TargetUser toTarget(SourceUser source);
}
```
3. **性能优势**：
- 生成的代码为原生getter/setter，性能接近手写代码，显著优于反射方案[^2]。
---
### 深入应用场景
1. **嵌套对象映射**：
```
java
public class SourceOrder {
private SourceUser user; // 嵌套对象
}
@Mapper
public interface OrderMapper {
// 自动递归映射嵌套对象
TargetOrder toTarget(SourceOrder source);
}
```
2. **集合
类型映射**：
```
java
// 自动映射List中所有对象的同名属性
List<TargetUser> toTargetList(List<SourceUser> sourceList);
```
---
### 对比其他映射工具
| 工具 | 映射方式 | 性能 | 自定义灵活性 |
|--------------|---------------|----------|------------|
| MapStruct | 编译期生成代码 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| BeanUtils | 运行时反射 | ⭐⭐ | ⭐ |
| ModelMapper | 运行时反射 | ⭐⭐⭐ | ⭐⭐⭐ |
> **提示**：当对象属性高度差异化时，MapStruct的注解配置方式能保持代码简洁性[^1]。
---
### 典型问题解决方法
**问题：目标对象有额外属性（如`address`）如何保留原
值？**
```
java
@Mapper
public interface UserMapper {
// 忽略源对象中不存在的属性，避免覆盖目标对象
值
@Mapping(target = "address", ignore = true)
TargetUser toTarget(SourceUser source);
}
```
执行后：
- `name`从源对象复制
- `address`保持调用前的原始
值
本文介绍两种在Java中实现对象复制的方法：通过反射遍历源对象字段并将其值设置到目标对象对应字段的方法。这两种方法均考虑了字段类型的匹配，并通过反射机制实现了灵活的属性赋值。
扫一扫
7356
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
