Tamper 使用与详解

一、安装指南

Tamper 的安装非常简单，您可以通过 Maven 仓库来添加依赖。以下是在 Maven 项目中添加 Tamper 依赖的配置：

<dependency>
    <groupId>com.alibaba.tamper</groupId>
    <artifactId>tamper</artifactId>
    <version>1.0.3</version>
</dependency>

在 Eclipse 中导入 Maven 项目时，可以使用以下命令：

mvn eclipse:eclipse

构建项目时，使用以下命令：

mvn clean package

运行测试用例时，使用以下命令：

mvn test

二、项目使用说明

Tamper 是一款用于处理 Bean/Map 属性复制映射的工具，支持递归和集合等深度映射。它适用于以下几种场景：

1. Model 和 DO（数据对象）的转化。
2. Model 和 VO（视图对象）的转化。
3. Model 和 DTO（数据传输对象）的转化。
4. Form 数据到 Bean 的转化。

Tamper 解决了 BeanUtils 和 BeanCopier 在使用上的局限性，如只能针对同名属性的拷贝。同时，它具有性能优势，并支持类型之间的转换器和插件扩展。

三、项目API使用文档

以下是一些使用 Tamper 的示例：

示例1：自定义映射规则，处理 Bean/Map Bean/Map

步骤1：定义映射配置

<bean-mappings>
    <bean-mapping batch="true" srcClass="com.agapple.mapping.object.SrcMappingObject" targetClass="com.agapple.mapping.object.TargetMappingObject" reversable="true">
        <field-mapping srcName="intValue" targetName="intValue" />
        <field-mapping targetName="integerValue" script="src.intValue + src.integerValue" />
        <field-mapping srcName="start" targetName="start" />
        <field-mapping srcName="name" targetName="targetName" />
        <field-mapping srcName="mapping" targetName="mapping" mapping="true" />
    </bean-mapping>
</bean-mappings>

步骤2：执行映射

public BeanMapping srcMapping = BeanMapping.create(SrcMappingObject.class, TargetMappingObject.class);
public BeanMapping targetMapping = BeanMapping.create(TargetMappingObject.class, SrcMappingObject.class);

@Test
public void testBeanToBean_ok() {
    SrcMappingObject srcRef = new SrcMappingObject();
    srcRef.setIntegerValue(1);
    srcRef.setIntValue(1);
    srcRef.setName("ljh");
    srcRef.setStart(true);

    TargetMappingObject targetRef = new TargetMappingObject();
    srcMapping.mapping(srcRef, targetRef);

    SrcMappingObject newSrcRef = new SrcMappingObject();
    targetMapping.mapping(targetRef, newSrcRef);
}

示例2：类似于 BeanUtils/BeanCopier，根据同名属性进行自动映射

public BeanCopy srcCopy = BeanCopy.create(SrcMappingObject.class, TargetMappingObject.class);
public BeanCopy targetCopy = BeanCopy.create(TargetMappingObject.class, SrcMappingObject.class);

@Test
public void testBeanToBean_ok() {
    SrcMappingObject srcRef = new SrcMappingObject();
    srcRef.setIntegerValue(1);
    srcRef.setIntValue(1);
    srcRef.setName("ljh");
    srcRef.setStart(true);

    TargetMappingObject targetRef = new TargetMappingObject();
    srcCopy.copy(srcRef, targetRef);

    SrcMappingObject newSrcRef = new SrcMappingObject();
    targetCopy.copy(targetRef, newSrcRef);
}

示例3：类似于 BeanUtils，处理 Map Bean/Map

public BeanMap beanMap = BeanMap.create(SrcMappingObject.class);

@Test
public void testDescribe_Populate_ok() {
    SrcMappingObject srcRef = new SrcMappingObject();
    srcRef.setIntegerValue(1);
    srcRef.setIntValue(1);
    srcRef.setName("ljh");
    srcRef.setStart(true);

    Map map = beanMap.describe(srcRef);

    SrcMappingObject newSrcRef = new SrcMappingObject();
    beanMap.populate(newSrcRef, map);
}

示例4：Mapping API 定义映射

BeanMappingBuilder builder = new BeanMappingBuilder() {
    protected void configure() {
        mapping(HashMap.class, HashMap.class).batch(false).reversable(true).keys("src", "target");
        fields(srcField("one"), targetField("oneOther")).convertor("convertor").defaultValue("ljh");
        fields(srcField("two").clazz(String.class), targetField("twoOther")).script("1+2").convertor(StringToCommon.class);
        fields(srcField("three").clazz(ArrayList.class), targetField("threeOther").clazz(HashSet.class)).recursiveMapping(true);
    }
};

BeanMapping mapping = new BeanMapping(builder);
mapping.mapping(src, dest); // 使用

四、项目安装方式

请参考上述的 Maven 依赖配置进行项目的安装。在您的项目中添加对应的依赖后，即可使用 Tamper 进行属性复制映射操作。