MapStruct ：丰富映射注释以定义自定义映射器

Question

这是我的上下文：我正在使用 byteBuddy 动态生成一个类，该类根据外部配置将一个对象转换为另一个对象。我遇到了一些问题，我想找到一个替代方案，这就是我发现 MapStruct 的方式。

所以我尝试构建简单的映射器，我想知道是否有可能自定义注释以添加转换功能。例如我想要：

@Mapping(
    source = "mySourceField", 
    sourceType = "String",
    target = "myTargetField",
    targetType = "Integer",
    transformation = {"toInteger", "toSquare"}
),

在映射器实现上我会有类似的东西：

 public TypeDest toSiteCatTag(TypeSrc obj) {

    if ( obj == null ) {

        return null;
    }

    TypeDest objDest = new TypeDest();

    objDest.myTargetField = Formatter.toSquare(
        Formatter.toInteger(obj.mySourceField));

    return objDest;
}

如果有人可以帮助我实现这一目标，我将不胜感激，这将为我节省大量时间。

提前致谢。

Answer 1

如果您的 2 种类型 TypeDest 和 TypeSrc 不是在运行时生成的，即它们是您编译的类，那么您可以实现您想要的。 MapStruct 不能在运行时工作，因为它是一个注解处理器并生成 java 代码。如果存在一些问题，例如您尝试映射不存在的字段或存在不明确的映射方法，那么您将收到编译时错误。

它看起来像：

@Mapper
public interface MyMapper {

    @Mapping(source = "mySourceField", target = "myTargetField", qualifiedByName = "myTransformation")// or you can use a custom @Qualifier annotation with qualifiedBy
    TypeDest toSiteCatTag(TypeSrc obj);

    @Named("myTransformation")// or your custom @Qualifier annotation
    default Integer myCustomTransformation(String obj) {
        return Formatter.toSquare(Formatter.toInteger(obj));
    }
}

有一种方法可以在没有映射器中的自定义方法的情况下执行此操作，但是您需要在某处有一个方法来应用toInteger 然后toSquare 转换。如果您的Formatter 中有签名Integer squaredString(String obj) 的方法。

例如

@Qualifier
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.CLASS)
public @interface SquaredString {}

public class Formatter {

    @SquaredString// you can also use @Named, this is just as an example
    public static Integer squaredString(String obj) {
        return toSquare(toInteger(obj));
    }
    //your other methods are here as well
}

然后您可以在映射器中执行此操作：

@Mapper(uses = { Formatter.class })
public interface MyMapper {

    @Mapping(source = "mySourceField", target = "myTargetField", qualifiedBy = SquaredString.class)
    TypeDest toSiteCatTag(TypeSrc obj);
}

由于使用了qualifedByName / qualified，以上示例仅适用于特定映射。如果您想用不同的方式将String 转换为Integer，那么您可以在您的映射器或Mapper#uses 中的某些类中定义一个带有Integer convertString(String obj) 签名的方法。然后 MapStruct 会将 String 到 Integer 的转换委托给此方法。

您可以在参考文档中找到有关使用限定符 here 进行映射的更多信息，并在 here 中找到有关映射方法解析的更多信息。