MapStruct 基本映射

使用 mapstruct 非常简单。 要创建映射器，需要在接口上使用 org.mapstruct.Msapper 注解。

@Mapper
public interface StudentMapper {...}

现在在接口中创建一个转换方法。

@Mapper
public interface StudentMapper {
   Student getModelFromEntity(StudentEntity student);
}

如果源对象属性和目标对象属性具有相同的名称，则这些属性将自动映射。 如果属性名称不同，请使用 @Mapping 注解，如下所示

@Mapper
public interface StudentMapper {
   @Mapping(target="className", source="classVal")
   Student getModelFromEntity(StudentEntity student);
}

这里 className 是目标对象 Student 中的属性名称，classVal 是源对象 StudentEntity 中的属性名称。

示例

使用以下代码创建 Student.java

Student.java

package com.jiyik.dto;

public class Student {
    private int id;
    private String name;
    private String className;

    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getClassName() {
        return className;
    }
    public void setClassName(String className) {
        this.className = className;
    }
}

使用以下代码创建 StudentEntity.java

StudentEntity.java

package com.jiyik.dto;

public class StudentEntity {
    private int id;
    private String name;
    private String classVal;
    public int getId() {
        return id;
    }
    public void setId(int id) {
        this.id = id;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public String getClassVal() {
        return classVal;
    }
    public void setClassVal(String classVal) {
        this.classVal = classVal;
    }
}

使用以下代码创建 StudentMapper.java

StudentMapper.java

package com.jiyik.mapper;

import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import com.jiyik.dto.Student;
import com.jiyik.dto.StudentEntity;

@Mapper
public interface StudentMapper {
    @Mapping(target="className", source="classVal")
    Student getModelFromEntity(StudentEntity student);

    @Mapping(target="classVal", source="className")
    StudentEntity getEntityFromModel(Student student);
}

使用以下代码创建 StudentMapperTest.java

StudentMapperTest.java

import com.jiyik.dto.Student;
import com.jiyik.dto.StudentEntity;
import com.jiyik.mapper.StudentMapper;
import org.junit.jupiter.api.Test;
import org.mapstruct.factory.Mappers;

import static org.junit.jupiter.api.Assertions.assertEquals;

public class StudentMapperTest {
    private StudentMapper studentMapper = Mappers.getMapper(StudentMapper.class);
    @Test
    public void testEntityToModel() {
        StudentEntity entity = new StudentEntity();
        entity.setClassVal("X");
        entity.setName("John");
        entity.setId(1);
        Student model = studentMapper.getModelFromEntity(entity);
        assertEquals(entity.getClassVal(), model.getClassName());
        assertEquals(entity.getName(), model.getName());
        assertEquals(entity.getId(), model.getId());
    }
    @Test
    public void testModelToEntity() {
        Student model = new Student();
        model.setId(1);
        model.setName("John");
        model.setClassName("X");
        StudentEntity entity = studentMapper.getEntityFromModel(model);
        assertEquals(entity.getClassVal(), model.getClassName());
        assertEquals(entity.getName(), model.getName());
        assertEquals(entity.getId(), model.getId());
    }
}

运行以下命令来测试映射。

$ mvn clean test

执行结果如下