MapStruct中conditionQualifiedByName未生效问题求助

你的问题出在MapStruct无法找到你定义的isStringNotNullOrEmpty判断方法，核心原因是继承链不匹配导致方法不可见。以下是具体修复方案：

原因分析 #

你把标注了@Named("isStringNotNullOrEmpty")的判断方法放在了BaseUpdateEmployeeMapper类中，但你的EmployeeMapper继承的是BaseMapper，两者没有继承关系，MapStruct扫描时无法识别到这个判断方法，因此conditionQualifiedByName配置完全没生效，只执行了qualifiedByName指定的转换方法。

修复方案 #

方案1：调整继承关系（推荐） #

让EmployeeMapper直接继承包含判断方法的BaseUpdateEmployeeMapper，这样MapStruct会自动扫描父类中的@Named方法：

@Mapper
public abstract class EmployeeMapper extends BaseUpdateEmployeeMapper {
    @Mappings({
        @Mapping(source="gender", target="gender", conditionQualifiedByName="isStringNotNullOrEmpty", qualifiedByName="toGender")
    })
    public abstract Target transformSource(Source employee);
}

方案2：通过uses属性引入外部类 #

如果无法修改继承链，在EmployeeMapper的@Mapper注解中添加uses属性，显式告诉MapStruct要使用BaseUpdateEmployeeMapper中的方法：

@Mapper(uses = BaseUpdateEmployeeMapper.class)
public abstract class EmployeeMapper extends BaseMapper {
    @Mappings({
        @Mapping(source="gender", target="gender", conditionQualifiedByName="isStringNotNullOrEmpty", qualifiedByName="toGender")
    })
    public abstract Target transformSource(Source employee);
}

方案3：直接使用SpEL条件表达式 #

不想额外维护@Named方法的话，可以用conditionExpression直接编写SpEL表达式，省去方法定义：

@Mapper
public abstract class EmployeeMapper extends BaseMapper {
    @Mappings({
        @Mapping(source="gender", target="gender", 
            conditionExpression = "java(org.apache.commons.lang3.StringUtils.isNotEmpty(source.getGender()))",
            qualifiedByName="toGender")
    })
    public abstract Target transformSource(Source employee);
}

修复后生成的代码 #

无论用哪种方案，最终生成的实现类都会包含判断逻辑，类似：

@Generated(
    value = "org.mapstruct.ap.MappingProcessor",
    date = "2024-08-12T21:14:39+0530",
    comments = "version: 1.5.5.Final, compiler: javac, environment: Java 11.0.23 (Homebrew)"
)
public class EmployeeMapperImpl extends EmployeeMapper {

    @Override
    public Target transformSource(Source employee) {
        if ( employee == null ) {
            return null;
        }

        Target.Builder target = Target.newBuilder();

        if ( StringUtils.isNotEmpty( employee.getGender() ) ) {
            target.gender( toGender( employee.getGender() ) );
        }

        return target.build();
    }
}

这样就会先执行空值/空串检查，只有符合条件时才调用toGender转换方法。

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