重磅,MapStruct 1.5 发布,这次终于支持Map转为Bean了!

>>强大,10k+点赞的 SpringBoot 后台管理系统竟然出了详细教程!

本月三号,MapStruct 1.5.0 Final发布,本次正式版距离上次正式版发布已经过去了快7年(上个正式版发布于2015年11月),此次发布除了修复了110多个bug外,还有以下新特性值得关注:

  • 支持了Map<String,?>bean的转换
  • 支持更加完备的条件转换(Conditional mapping)
  • 支持子类之间的转换(Support for subclass mapping)

1. 新增MapJava bean的转换(Mapping from Map to Bean)

如果我们有以下Java Bean

public class Customer {
    private Long id;
    private String name;
    //getters and setter omitted for brevity
}

相应的MapStruct代码如下:

@Mapper
public interface CustomerMapper {
    @Mapping(target = "name", source = "customerName")
    Customer toCustomer(Map<String, String> map);
}

那最终会生成类似如下的转换代码:

// GENERATED CODE
public class CustomerMapperImpl implements CustomerMapper {
 
    @Override
    public Customer toCustomer(Map<String, String> map) {
        // ...
        if ( map.containsKey( "id" ) ) {
            customer.setId( Integer.parseInt( map.get( "id" ) ) );
        }
        if ( map.containsKey( "customerName" ) ) {
            customer.setName( source.get( "customerName" ) );
        }
        // ...
    }
}

不过需要注意,待转换的Mapkey必须是String类型的,否则,转换代码会跳过这个key

2. 更加完备的条件转换( Conditional Mapping

1.5.0 Final版本之前,如果Java bean中含有hasXXX或者isXXX的这类方法(XXXbean中的属性名),则MapStruct生成的代码中则会调用这类方法来判断是否在转换后的bean中是否包含原来的属性,但是遗憾的是,大多数情况下,我们并不能直接修改原bean的代码。基于此,1.5.0 Final版本引入了org.mapstruct.Condition注解来实现条件转换。例如我们有如下转换代码:

@Mapper
public interface CarMapper {
 
    CarDto carToCarDto(Car car);
 
    @Condition
    default boolean isNotEmpty(String value) {
        return value != null && !value.isEmpty();
    }
}

Map Struct 1.5.0 Final生成的代码是:

// GENERATED CODE
public class CarMapperImpl implements CarMapper {
 
    @Override
    public CarDto carToCarDto(Car car) {
        if ( car == null ) {
            return null;
        }
        CarDto carDto = new CarDto();
        if ( isNotEmpty( car.getOwner() ) ) {
            carDto.setOwner( car.getOwner() );
        }
        // Mapping of other properties
        return carDto;
    }
}

org.mapstruct.Condition除了作用到整个bean外还可以修饰具体的属性值,实现bean属性维度的条件转换。

3. 增加对子类转换的支持(Subclass Mapping)

假如有父类Fruit和两个子类AppleBanana,在新特性的支持下我们的转换代码可以写的更加简洁:

@Mapper
public interface FruitMapper {

    @SubclassMapping( source = AppleDto.classtarget = Apple.class )
    @SubclassMappingsource 
= BananaDto.classtarget = Banana.class )
    Fruit mapFruitDto source )
;
}

如果Fruit是抽象类或者是接口,则会报编译错误。

推荐

Java面试题宝典

技术内卷群,一起来学习!!

重磅,MapStruct 1.5 发布,这次终于支持Map转为Bean了!

PS:因为公众号平台更改了推送规则,如果不想错过内容,记得读完点一下“在看”,加个“星标”,这样每次新文章推送才会第一时间出现在你的订阅列表里。“在看”支持我们吧!

原文始发于微信公众号(Java知音):重磅,MapStruct 1.5 发布,这次终于支持Map转为Bean了!