欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

MapStruct实体间转换的简单用法

程序员文章站 2023-12-22 08:27:52
摘要: 在实际项目中,我们经常需要将po转dto、dto转po等一些实体间的转换。比较出名的有beanutil 和modelmapper等,它们使用简单,但是在稍显复杂的业...

摘要: 在实际项目中,我们经常需要将po转dto、dto转po等一些实体间的转换。比较出名的有beanutil 和modelmapper等,它们使用简单,但是在稍显复杂的业务场景下力不从心。mapstruct这个插件可以用来处理domin实体类与model类的属性映射,可配置性强。

建立maven项目

mapstruct需要醒目构建工具(如maven)支持,如果项目结构不标准,可能无法生成对应的转换类。这里我使用maven构建工程。

<properties>
<org.mapstruct.version>1.2.0.cr1</org.mapstruct.version>
</properties>

mapstruct是一个一直在进步的工具,后面的版本不断改进之前版本的不足,修复之前版本的bug,使用的时候最好最新的稳定版。

<dependencies>
  <dependency>
    <groupid>org.mapstruct</groupid>
    <artifactid>mapstruct-jdk8</artifactid>
    <version>${org.mapstruct.version}</version>
  </dependency>
</dependencies>

需要引入的依赖包,可以看到使用到了java8,最新版甚至已经支持了java9。当然这不以为着你必须使用java8,java版本高于java6都是可以的。

<build>
  <plugins>
    <plugin>
<groupid>org.apache.maven.plugins</groupid>
      <artifactid>maven-compiler-plugin</artifactid>
      <version>3.5.1</version>
      <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <annotationprocessorpaths>
          <path>
  <groupid>org.mapstruct</groupid>
            <artifactid>mapstruct-processor</artifactid>
        <version>${org.mapstruct.version}</version>
          </path>
        </annotationprocessorpaths>
      </configuration>
    </plugin>
  </plugins>
</build>

maven插件必不可少,格式也是固定的。

简单示例

有一个实体类-用户user

public class user {
  private int id;
  private string name;
  private boolean married;
// setters, getters, tostring
}

有一个实体类-雇员employee,雇员也是用户,只是比用户多一个属性-职位position

public class employee {
  private int id;
  private string name;
  private string position;
  private boolean married;
// setters, getters, tostring
}

在具体业务场景下,需要user 对象转换为employee对象,有时候需要employee对象转换为user对象。

使用mapstrut的话,需要写一个接口:

@mapper
public interface usermapper {
  usermapper instance = mappers.getmapper(usermapper.class);
  employee usertoemployee(user user);
  user employeetouser(employee employee);
}

运行示例

首先需要mvn compile,自动生成转换代码。生成的代码放在target/annotations下面。大致代码如下:

import com.training.mapstrut.model.employee;
import com.training.mapstrut.model.user;
import javax.annotation.generated;
@generated(
  value = "org.mapstruct.ap.mappingprocessor",
  date = "2017-08-26t17:08:23+0800",
  comments = "version: 1.2.0.cr1, compiler: javac, environment: java 1.8.0_92 (oracle corporation)"
)
public class usermapperimpl implements usermapper {
  @override
  public employee usertoemployee(user user) {
    if ( user == null ) {
      return null;
    }
    employee employee = new employee();
    employee.setid( user.getid() );
    employee.setname( user.getname() );
    employee.setmarried( user.ismarried() );
    return employee;
  }
  @override
  public user employeetouser(employee employee) {
    if ( employee == null ) {
      return null;
    }
    user user = new user();
    user.setid( employee.getid() );
    user.setname( employee.getname() );
    user.setmarried( employee.ismarried() );
    return user;
  }
}

简单的写个测试类实验一下。

public class apptest{
  @test
  public void apptest(){
    user user = new user();
    user.setid(125);
    user.setname("chao");
    user.setmarried(false);
    employee e = usermapper.instance.usertoemployee(user);
    system.out.println(e);
    assert.assertfalse(e.ismarried());
  }
}

结果输出:

employee [id=125, name=chao, position=null, married=false]

效果不错,需要转换的字段都准确无误,不过有人要吐糟了,这样的用法比beanutil 复杂多了,还只是达到相同的效果。这种简单的转化确实不需要mapstruct,它要做的是更为复杂的业务场景。

mapstruct问题

1.mapstruct转换不准确。

mapstruct一直在更新,一些特性在旧版本中无法识别,在使用的时候最要使用比较新的版本。

2.在eclipse下,需要m2e plug-in的支持,如果eclipse中没有集成,需要去eclipse marketplace中下载安装,有时候还需要指定下面的配置在pom.xml的properties中,以启用annotation processing
<m2e.apt.activation>jdt_apt</m2e.apt.activation>

3.在eclipse下,maven compile提示nothing to compile - all classes are up to date,你可以试一下在golds中填写clean install compile

4.maven 编译的时候,必须使用jdk,不能使用jre,且版本要高于jdk6.

5.在eclipse中,确定已经生成了*mapperimpl.java,但是运行时报错classnotfoundexception: cannot find implementation for com...*mapper
在项目上右键 – > properties – > java compiler – > annotation processing (enable 所有项) – > factory path (enable) – > add external jars – > 选择mapstruct-processor-*.jar(大概在计算机的目录.m2\repository\org\mapstruct\mapstruct-processor) – > ok

总结

以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,谢谢大家对的支持。如果你想了解更多相关内容请查看下面相关链接

上一篇:

下一篇: