通用权限系统-Dozer对象转换

Love The Way You Lie 2024-03-17 20:31 122阅读 0赞

## Dozer对象转换 ##

### 介绍 ###

Dozer 是一个 Java Bean 到 Java Bean 的映射器，它可以递归地将数据从一个对象复制到另一个。通常情况下，这些Java Beans将是不同的复杂类型。

Dozer支持简单的属性映射，复杂的类型映射，双向映射，隐式-显式映射，以及递归映射。这包括映射集合属性，这些集合属性也需要在元素层面进行映射。

Dozer是Java Bean到Java Bean映射器，它以递归方式将数据从一个对象复制到另一个对象。 dozer是用来对两个对象之间属性转换的工具，有了这个工具之后，我们将一个对象的所有属性值转给另一个对象时，就不需要再去写重复的调用set和get方法了。dozer其实是对我们熟知的beanutils的封装。

dozer的maven坐标：

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;com.github.dozermapper&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;dozer-core&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;version&gt;6.5.0&lt;/version&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependency&gt;</code></td> 
  </tr> 
 </tbody> 
</table>

为了简化使用方式，dozer还提供了starter，其maven坐标为：

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;com.github.dozermapper&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;dozer-spring-boot-starter&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;version&gt;6.5.0&lt;/version&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependency&gt;</code></td> 
  </tr> 
 </tbody> 
</table>

### Dozer入门案例 ###

第一步：创建maven工程dozer\_demo并配置pom.xml文件

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>&lt;?xml version="1.0" encoding="UTF-8"?&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;project xmlns="http://maven.apache.org/POM/4.0.0"</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;parent&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;spring-boot-starter-parent&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;version&gt;2.2.2.RELEASE&lt;/version&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;relativePath/&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/parent&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;org.pp&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;dozer-demo&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;version&gt;1.0-SNAPSHOT&lt;/version&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;properties&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;maven.compiler.source&gt;8&lt;/maven.compiler.source&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;maven.compiler.target&gt;8&lt;/maven.compiler.target&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;project.build.sourceEncoding&gt;UTF-8&lt;/project.build.sourceEncoding&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/properties&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependencies&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;com.github.dozermapper&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;dozer-spring-boot-starter&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;version&gt;6.5.0&lt;/version&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;junit&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;junit&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;spring-boot-starter-test&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;org.projectlombok&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;lombok&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependencies&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/project&gt;</code></td> 
  </tr> 
 </tbody> 
</table>

第二步：创建UserDTO和UserEntity

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>package org.pp.dto;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import lombok.Data;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>/**</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* TODO</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>*</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* @author ss_419</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* @version 1.0</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* @date 2023/7/9 17:29</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>*/</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@Data</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public class UserDTO { </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String userId;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String userName;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private int userAge;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String address;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String birthday;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>package org.pp.entity;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import lombok.Data;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import java.util.Date;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>/**</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* @author ss_419</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>*/</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@Data</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public class UserEntity { </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String id;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String name;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private int age;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String address;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private Date birthday;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
 </tbody> 
</table>

第三步：在resources/dozer/目录下创建dozer的全局配置文件global.dozer.xml

注：全局配置文件名称可以任意

第四步：在resources/dozer/目录下创建dozer的映射文件biz.dozer.xml

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>&lt;?xml version="1.0" encoding="UTF-8"?&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;mappings xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>xmlns="http://dozermapper.github.io/schema/bean-mapping"</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>xsi:schemaLocation="http://dozermapper.github.io/schema/bean-mapping</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>http://dozermapper.github.io/schema/bean-mapping.xsd"&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;!--描述两个类中属性的对应关系，对于两个类中同名的属性可以不映射--&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;mapping date-format="yyyy-MM-dd"&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;class-a&gt;org.pp.entity.UserEntity&lt;/class-a&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;class-b&gt;org.pp.dto.UserDTO&lt;/class-b&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;a&gt;id&lt;/a&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;b&gt;userId&lt;/b&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;a&gt;name&lt;/a&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;b&gt;userName&lt;/b&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;a&gt;age&lt;/a&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;b&gt;userAge&lt;/b&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/mapping&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;!--</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>可以使用map-id指定映射的标识，在程序中通过此标识来确定使用当前这个映射关系</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>--&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;mapping date-format="yyyy-MM-dd" map-id="user"&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;class-a&gt;org.pp.entity.UserEntity&lt;/class-a&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;class-b&gt;org.pp.dto.UserDTO&lt;/class-b&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;a&gt;id&lt;/a&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;b&gt;userId&lt;/b&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;a&gt;name&lt;/a&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;b&gt;userName&lt;/b&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;a&gt;age&lt;/a&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;b&gt;userAge&lt;/b&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/field&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/mapping&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/mappings&gt;</code></td> 
  </tr> 
 </tbody> 
</table>

注：映射文件名称可以任意

第五步：编写application.yml文件

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>dozer:</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>mappingFiles:</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>- classpath:dozer/global.dozer.xml</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>- classpath:dozer/biz.dozer.xml</code></td> 
  </tr> 
 </tbody> 
</table>

![image][]

第六步：编写启动类DozerApp

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>package org.pp;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.boot.SpringApplication;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.boot.autoconfigure.SpringBootApplication;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>/**</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* @author ss_419</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>*/</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@SpringBootApplication</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public class DozerApp { </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public static void main(String[] args) { </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>SpringApplication.run(DozerApp.class,args);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
 </tbody> 
</table>

第七步：编写单元测试DozerTest

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>package org.pp.test;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import com.github.dozermapper.core.Mapper;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.junit.Test;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.junit.runner.RunWith;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.pp.DozerApp;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.pp.dto.UserDTO;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.pp.entity.UserEntity;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.beans.factory.annotation.Autowired;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.boot.test.context.SpringBootTest;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.test.context.junit4.SpringRunner;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>/**</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* TODO</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>*</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* @author ss_419</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* @version 1.0</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* @date 2023/7/9 17:59</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>*/</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@RunWith(SpringRunner.class)</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@SpringBootTest(classes = DozerApp.class)</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public class DozerTest { </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@Autowired</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private Mapper mapper;// 使用Mapper对象可以完成两个对象之间属性复制</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>/**</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* 原本UserEntity不存在</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>*/</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@Test</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public void testDozer1(){ </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>UserDTO userDTO = new UserDTO();</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserId("100");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserName("panpan");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserAge(24);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setAddress("nj");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setBirthday("1999-04-19");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>// 调用方法进行转换</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>UserEntity user = mapper.map(userDTO, UserEntity.class);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>System.out.println("user = " + user);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>/**</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* 原本UserEntity已经存在，对其进行覆盖参数值</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>*/</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@Test</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public void testDozer2(){ </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>UserDTO userDTO = new UserDTO();</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserId("100");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserName("itcast");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserAge(20);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setAddress("bj");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setBirthday("2010-11-20");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>UserEntity userEntity = new UserEntity();</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userEntity.setId("2000");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>System.out.println("1====&gt; userEntity = " + userEntity);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>mapper.map(userDTO,userEntity);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>System.out.println("2====&gt; userEntity = " + userEntity);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@Test</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public void testDozer3(){ </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>UserDTO userDTO = new UserDTO();</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserId("100");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserName("itcast");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserAge(20);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setAddress("bj");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>UserEntity user = new UserEntity();</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>System.out.println(user);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>// 指定使用配置文件中的映射关系进行映射</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>mapper.map(userDTO,user,"user");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>System.out.println(user);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
 </tbody> 
</table>

### pd-tools-dozer使用 ###

在pd-tools-dozer模块中为了进一步简化操作，封装了一个工具类DozerUtils，其内部使用的就是Mapper对象进行的操作。并且按照Spring Boot starter的规范编写/resources/META-INF/spring.factories文件，内容如下：

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>org.springframework.boot.autoconfigure.EnableAutoConfiguration=\</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>com.itheima.pinda.dozer.DozerAutoConfiguration</code></td> 
  </tr> 
 </tbody> 
</table>

在配置类DozerAutoConfiguration中完成DozerUtils对象的创建，这样其他的程序如果需要使用dozer进行对象转换，只需要引入这个模块的maven坐标并且提供对应的映射文件就可以在程序中直接注入DozerUtils对象进行操作了。

**具体使用过程：**

第一步：创建maven工程myDozerApp并配置pom.xml

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>&lt;?xml version="1.0" encoding="UTF-8"?&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;project xmlns="http://maven.apache.org/POM/4.0.0"</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;parent&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;spring-boot-starter-parent&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;version&gt;2.2.2.RELEASE&lt;/version&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;relativePath/&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/parent&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;org.pp&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;myDozerDemo&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;version&gt;1.0-SNAPSHOT&lt;/version&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;properties&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;maven.compiler.source&gt;8&lt;/maven.compiler.source&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;maven.compiler.target&gt;8&lt;/maven.compiler.target&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;project.build.sourceEncoding&gt;UTF-8&lt;/project.build.sourceEncoding&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/properties&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependencies&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;!--引入我们自己定义的dozer基础模块--&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;com.itheima&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;pd-tools-dozer&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;version&gt;1.0-SNAPSHOT&lt;/version&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;org.projectlombok&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;lombok&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;groupId&gt;org.springframework.boot&lt;/groupId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;artifactId&gt;spring-boot-starter-web&lt;/artifactId&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependency&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/dependencies&gt;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>&lt;/project&gt;</code></td> 
  </tr> 
 </tbody> 
</table>

第二步：创建UserEntity和UserDTO

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>package org.pp.entity;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import lombok.Data;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>/**</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* @author ss_419</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>*/</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@Data</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public class UserEntity { </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private Integer id;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String name;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private int age;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String addr;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
 </tbody> 
</table>

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>package org.pp.dto;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import lombok.Data;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>/**</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>* @author ss_419</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>*/</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@Data</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public class UserDTO { </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private Integer userId;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String userName;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private int userAge;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private String address;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
 </tbody> 
</table>

第三步：创建UserController

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>package org.pp.controller;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import com.itheima.pinda.dozer.DozerUtils;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.pp.dto.UserDTO;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.pp.entity.UserEntity;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.beans.factory.annotation.Autowired;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.web.bind.annotation.GetMapping;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.web.bind.annotation.RequestMapping;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.web.bind.annotation.RestController;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@RestController</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@RequestMapping("/user")</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public class UserController { </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@Autowired</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>private DozerUtils dozerUtils; //在pd-tools-dozer中已经完成了自动配置，可以直接注入</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@GetMapping("/mapper")</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public UserEntity mapper(){ </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>UserDTO userDTO = new UserDTO();</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserId(10);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserName("P_P");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setUserAge(20);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>userDTO.setAddress("njnj");</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>System.out.println("userDTO = " + userDTO);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>UserEntity userEntity = dozerUtils.map(userDTO, UserEntity.class);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>System.out.println("userEntity = " + userEntity);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>return userEntity;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
 </tbody> 
</table>

第四步：创建application.yml

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>server:</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>port: 8080</code></td> 
  </tr> 
 </tbody> 
</table>

第五步：创建启动类

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.boot.SpringApplication;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>import org.springframework.boot.autoconfigure.SpringBootApplication;</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>@SpringBootApplication</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public class MyDozerApplication { </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>public static void main(String[] args) { </code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>SpringApplication.run(MyDozerApplication.class,args);</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>}</code></td> 
  </tr> 
 </tbody> 
</table>

启动项目，访问地址：[http://localhost:8080/user/mapper][http_localhost_8080_user_mapper]

![image][image 1]

注意：由于当前我们创建的UserEntity和UserDTO中的属性完全一致，所以并没有提供映射文件，如果这两个类中的属性存在不一致的情况，需要创建映射文件进行映射，并且还需要在application.yml中配置映射文件的位置，例如：

<table> 
 <tbody> 
  <tr> 
   <td></td> 
   <td><code>dozer:</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>mappingFiles:</code></td> 
  </tr> 
  <tr> 
   <td></td> 
   <td><code>- classpath:dozer/biz.dozer.xml #指定dozer的映射文件位置</code></td> 
  </tr> 
 </tbody> 
</table>

[image]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/d4dc62bfb55b4f8d8da0d3af25469f4d.png
[http_localhost_8080_user_mapper]: http://localhost:8080/user/mapper
[image 1]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/14/5af469ca43c7499dbb13df8b65ec7f55.png