在mapper/mapper配置级别上为映射类别设置nullValueMappingStrategy

Question

MapStruct文档对为NullValueMappingStrategy选择的合理默认值有如下说明。返回默认值：

Bean映射：将返回一个“空”的目标Bean，除了常量和表达式之外，它们将在出现时填充。

基本体：将返回基本体的默认值，例如，布尔值为false，int值为0。

迭代器/数组：将返回一个空的迭代器。

地图：将返回一个空地图。

问题是，我们希望能够在@Mapper级别上指定，例如，Iterables应该具有NullValueMappingStrategy。返回默认值，但不返回原语。这样做的原因是，对于我们的用例来说，空iterable是一个合理的默认值，但对于int来说，0不是一个合理的默认值。我们不希望必须声明，例如：

    @IterableMapping(nullValueMappingStrategy = NullValueMappingStrategy.RETURN_DEFAULT)

对于我们正在映射的每个iterable。

MapStruct是否提供了一种我在文档中找不到的干净方法？

Answer 1

我认为上面这一行实际上是文档中的复制粘贴错误。我想说清楚：NullValueMappingStrategy只适用于映射方法的参数。而不是bean属性。在bean映射方法中，不可能将基元参数定义为源。

然而，可以将非bean定义为bean映射方法的源。就像下面的mapFrom方法一样：

package org.mapstruct.ap.test.bugs._xyz;

import java.util.List;

import org.mapstruct.Mapper;
import org.mapstruct.NullValueMappingStrategy;
import org.mapstruct.factory.Mappers;

@Mapper( nullValueMappingStrategy = NullValueMappingStrategy.RETURN_DEFAULT)
public interface XyzMapper {

    XyzMapper INSTANCE = Mappers.getMapper(XyzMapper.class);

    Target map(Source source);

    Target mapFrom( Integer myInt, List<Integer> myList);

    class Source {

        private int myInt;
        private List<Integer> myList;

        public int getMyInt() {
            return myInt;
        }

        public void setMyInt(int myInt) {
            this.myInt = myInt;
        }

        public List<Integer> getMyList() {
            return myList;
        }

        public void setMyList(List<Integer> myList) {
            this.myList = myList;
        }
    }

    class Target {

        private int myInt;
        private List<Integer> myList;

        public int getMyInt() {
            return myInt;
        }

        public void setMyInt(int myInt) {
            this.myInt = myInt;
        }

        public List<Integer> getMyList() {
            return myList;
        }

        public void setMyList(List<Integer> myList) {
            this.myList = myList;
        }
    }


}

当使用NullValueMappingStrategy.RETURN_DEFAULT时，mapFrom将返回一个空的Target，就像在留档中指定的那样。

应从与NullValueMappingStrategy相关的留档中删除此行：基元：将返回基元的默认值，例如布尔值为false或int值为0。