2020-11-26 Mapstruct使用小结

idea插件：mapstruct support

会有提示，贼GB舒服，写expression的时候也可以直接像写代码一样了

---

依赖

<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct</artifactId>
    <version>1.4.1.Final</version>
</dependency>
<!--编译用-->
<dependency>
    <groupId>org.mapstruct</groupId>
    <artifactId>mapstruct-processor</artifactId>
    <version>1.3.0.Final</version>
</dependency>

---

基本用法

• Converter

import cn.mb.en.dao.entity.Person;
import cn.mb.en.vo.PersonVO;
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.Mappings;
import org.mapstruct.factory.Mappers;

import java.util.Arrays;

/**
 * <p>
 *  xx对象转换器
 * </p>
 *
 * @author: guohaibin
 * @createDate: 2020/11/26
 */
@Mapper(imports = {Arrays.class})// 如果@Mapping的expression中引用了外部jar，需要在此引入，否则编译不会自动引入
public interface PersonConverter {

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

    //  实体 -> vo
    @Mappings({
            //  关系映射，类似mapper.xml中的resultMap
            @Mapping(target = "description", source = "desc"),
            @Mapping(target = "tags", expression = "java( Arrays.asList(person.getTags()).subList(0, 2) )")
    })
    PersonVO toPersonVO(Person person);

}

• 实体

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@NoArgsConstructor
@AllArgsConstructor
public class Person {

    private String  name;
    private Integer age;
    private String  sex;
    private String  desc;
    private String[] tags;

}

• vo

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

import java.util.List;

@Data
@NoArgsConstructor
@AllArgsConstructor
public class PersonVO {

    private String  name;
    private Integer age;
    private String  description;
    private List<String> tags;

}

• test

public class Test {

    public static void main(String[] args) {

        Person person = new Person("bb", 24, "男", "牛杯", new String[]{"矮", "穷", "挫"});
        PersonVO personVO = PersonConverter.INSTANCE.toPersonVO(person);
        System.out.println(personVO);

    }

}

---

小结

	以上就是mapstruct的基本用法，复杂的话还需再去看看。
	
注：
	变量名映射填写的是变量名；
	expression中引用方法中对象的某变量，需要像在该方法中一样引用，例：x.getXxx()；
	expression中引用类时需要在@Mapper中添加imports属性，将类手动引入

---

新了解

• List -> List原理

若有x -> y 则 List<x> -> List<y>时，内部是通过循环调用 x -> y方法，因此若需要做映
射，在x -> y上做即可；
若没有x -> y 则 List<x> -> List<y>时，converter会自动创建一个 x -> y的方法，再调用

---

demo