第三节MapStruct翻译--Defining a mapper

第三节MapStruct--Defining a mapper

在这一章节你将学到如何用mapstruct和它的一些必要的操作选项来定义一个bean mapper。

3.1 Basic mappings

创建一个java接口类，使用必要的方法和注解来创建一个简单的mapper，其中要用到org.mapstruct.Mapper包的注解：

例6：

@Mapper
public interface CarMapper {
  @Mappings({
  @Mapping(source = "make", target = "manufacturer"),
  @Mapping(source = "numberOfSeats", target = "seatCount")
  })
  CarDto carToCarDto(Car car);

  @Mapping(source = "name", target = "fullName")
  PersonDto personToPersonDto(Person person);
}

@Mapper注解可以致使MapStruct代码生成器在编译时期创建一个CarMapper接口的实现类。

在生成的实现方法中，会从Car类源中读取所有可读属性字段，复制并绑定到目标类CarDto中。如果等价属性间（类源--目标类）出现字段变量名不同的情况，我们可以使用@Mapper注解来自定义指定。

为了更好的理解MapStruct都做了些什么，可以查看接下来的例子：

例7.MapStruct生成的代码（carToCarDto）

// GENERATED CODE
public class CarMapperImpl implements CarMapper {
  
  @Override
  public CarDto carToCarDto(Car car) {
    if ( car == null ) {
      return null;
    }
    CarDto carDto = new CarDto();
    if ( car.getFeatures() != null ) {
      carDto.setFeatures( new ArrayList<String>( car.getFeatures() ) );
    }
    carDto.setManufacturer( car.getMake() );
    carDto.setSeatCount( car.getNumberOfSeats() );
    carDto.setDriver( personToPersonDto( car.getDriver() ) );
    carDto.setPrice( String.valueOf( car.getPrice() ) );
    if ( car.getCategory() != null ) {
      carDto.setCategory( car.getCategory().toString() );
    }
    carDto.setEngine( engineTtoEngineDto( car.getEngine() ) );
    return carDto;
  }
  
  @Override
  public PersonDto personToPersonDto(Person person) {
  	//...
  }
  
  private EngineDto engineToEngineDto(Engine engine) {
    if ( engine == null ) {
    	return null;
    }
    EngineDto engineDto = new EngineDto();
    engineDto.setHorsePower(engine.getHorsePower());
    engineDto.setFuel(engine.getFuel());
    return engineDto;
  }
}

通常MapStruct的代码生成策略是尽可能多的查看用户的自定义策略。特别是这意味着所有的这些值都将有计划的通过getter/seter方法从源类复制到目标类，而不是通过反射或者其他方式。

从例子中可以发现，所有通过注解指定的映射都被MapStruct作用到了代码生成中。如果映射属性的类型在源和目标实体中是不同的，MapStruct将要么应用自动转换，要么可选地调用/创建另一映射方法。当且仅当源和目标属性是简单的bean属性（即变量类型不是集合或字典类型），MapStruct才会创建一个新映射。

MapStruct映射策略中包括源和目标类型的所有公共属性，也包括在父类上声明的属性。

3.2. Adding custom methods to mappers（在映射器中添加自定义方法）

后面添加