MapStruct技术疑问：对象属性转字符串及参数名映射问题

咱们来逐个解决你遇到的MapStruct映射问题：

问题1：接收Comment对象返回String的map方法仅返回空字符串，未返回text属性 #

原因 #

MapStruct对于**复杂对象到简单类型（比如String）**的映射，没有默认的自动推断逻辑。它不知道你想要提取Comment的哪个属性作为返回的String，所以默认只会生成创建空String实例的代码，不会主动关联到Comment的text属性。

解决方法 #

在map(Comment comment)方法上添加@Mapping注解，显式指定要映射的源属性和目标（这里目标就是返回的String本身，用.指代整个目标对象）：

@Mapper(componentModel = "spring")
public interface CommentMapper {
    @Mapping(source = "text", target = ".")
    String map(Comment comment);
    
    Comment map(String text);
}

这样MapStruct就会生成从Comment的text属性返回String的代码，替换原来的空String逻辑。

问题2：参数名为text时会给Comment的text赋值，改其他名称则生成空对象 #

原因 #

MapStruct的自动映射依赖名称匹配规则：当你把String类型的参数传入map方法创建Comment时，如果参数名和Comment类的属性名完全一致（比如这里的text），MapStruct会自动识别这种匹配关系，自动生成属性赋值的代码。

如果参数名改成someNameHere，这个名字和Comment的任何属性都不匹配，MapStruct找不到对应的映射关系，就只会完成最基础的对象实例化，不会进行任何属性赋值。

解决方法 #

如果想用非属性名的参数名，同样可以通过@Mapping注解显式指定映射关系：

@Mapper(componentModel = "spring")
public interface CommentMapper {
    String map(Comment comment);
    
    Comment map(String text);
    
    @Mapping(source = "someNameHere", target = "text")
    Comment map(String someNameHere);
}

这样不管参数叫什么名字，MapStruct都会把参数值赋值给Comment的text属性。

内容的提问来源于stack exchange，提问作者Saravana Kumar M