MapStruct

       一般java web开发的程序员，都有一个共同的体会，接受请求参数都会使用一个vo类，这个vo类里封装了所有需要接受的参数，然后对参数进行业务逻辑处理，处理完后会持久化处理，通常每个业务表都会对应一个bean类，然后就需要将vo对象转化为bean对象再持久化，这个过程中，就需要new bean对象，给bean对象里的每个属性赋值；请求处理完，还需要有返回，通常返回也会封装一个vo类，所以也需要new一个vo对象，将需要返回的数据封装在这个vo对象里，这个是比较麻烦的。

        使用MapStruct可以快速帮你解决vo->bean,bean->vo的转换工作，使得代码更加简洁。

       这里使用JDK8，idea来编写程序，maven解决依赖，先在pom文件引入依赖：

    1.2.0.Final




  	
        org.mapstruct
        mapstruct-jdk8
        ${org.mapstruct.version}
    
      
          org.mapstruct
          mapstruct-processor
          ${org.mapstruct.version}
      



    
        
            org.apache.maven.plugins
            maven-compiler-plugin
            3.5.1
            
                1.8
                1.8
                
                    
                        org.mapstruct
                        mapstruct-processor
                        ${org.mapstruct.version}
                    
                
            
        
    

下面看java代码，先定义一个接口或者抽象类

@Mapper
public interface CarMapper {
	
	CarMapper INSTANCE = Mappers.getMapper(CarMapper.class);
	
	CarDto carToCarDto(Car car);

	@Mappings({
			@Mapping(source = "numberOfSeats", target = "seatCount")
	})
	CarDto carToCarDtoSpecial(Car car);
}

public class Car {
	
    private String make;
    private int numberOfSeats;
    private CarType type;
    private Date createTime;
    
    //getter and setter...
}

public class CarDto {
	
	private String make;
    private int seatCount;
    private String type;

    private String date;
    
    //getter and setter...
}

首先我们看mapstruct生成carToCarDto方法

public CarDto carToCarDto(Car car) {
        if ( car == null ) {
            return null;
        }

        CarDto carDto = new CarDto();

        carDto.setMake( car.getMake() );
        if ( car.getType() != null ) {
            carDto.setType( car.getType().name() );
        }

        return carDto;
    }

按照默认情况来说，mapstruct是根据两个对象里相同名称的属性名来进行赋值的，上面可以看出Car和CarDto有make和type两个属性名称是相同的，所以会将Car对象的两个属性值分别赋值给CarDto对象，当然也可以根据指定的属性来进行赋值。

carToCarDtoSpecial方法就是可以解决上面这个问题的，下面是mapstruct生成的源码

public CarDto carToCarDtoSpecial(Car car) {
        if ( car == null ) {
            return null;
        }

        CarDto carDto = new CarDto();

        carDto.setSeatCount( car.getNumberOfSeats() ); //A处
        carDto.setMake( car.getMake() );
        if ( car.getType() != null ) {
            carDto.setType( car.getType().name() );
        }

        return carDto;
    }

源码多了A处，因为我们指定了注解

@Mapping(source = "numberOfSeats", target = "seatCount")

就是告诉mapstruct，Car的numberOfSeats属性值映射到CarDto的seatCount的属性值。

使用mapstruct来转换Car和CarDto是非常简单的

CarDto carDto = CarMapper.INSTANCE.carToCarDto(car);
		

CarDto carDto1 = CarMapper.INSTANCE.carToCarDtoSpecial(car);

所以就两行代码就针对两种情况，使用非常简洁。

上面只是一个Car对象转换到一个CarDto，mapstruct还可以将多个对象作为入参，转换到一个返回对象里。