java bean 對象屬性複製框架BeanMapping-01-入門案例

項目簡介

Bean-Mapping 用於 java 對象屬性賦值。

項目中經常需要將一個對象的屬性，賦值到另一個對象中。

常見的工具有很多，但都多少不夠簡潔，要麼不夠強大。

特性

• 支持對象屬性的淺拷貝

變更日誌

變更日誌

快速開始

準備

JDK1.8 及其以上版本

Maven 3.X 及其以上版本

maven 項目依賴

<dependency>
    <groupId>com.github.houbb</groupId>
    <artifactId>bean-mapping-core</artifactId>
    <version>0.0.1</version>
</dependency>

核心類說明

BeanUtil

提供一個簡單的靜態方法 copyProperties。

/**
 * 複製屬性
 * 將 source 中的賦值給 target 中名稱相同，且可以賦值的類型中去。類似於 spring 的 BeanUtils。
 * @param source 原始對象
 * @param target 目標對象
 */
public static void copyProperties(final Object source, Object target)

測試代碼參考

詳情參見 bean-mapping-test 模塊下的測試代碼。

示例代碼

對象的定義

• BaseSource.java & BaseTarget.java

其中 BaseSource 對象和 BaseTarget 對象的屬性是相同的。

public class BaseSource {

    /**
     * 名稱
     */
    private String name;

    /**
     * 年齡
     */
    private int age;

    /**
     * 生日
     */
    private Date birthday;

    /**
     * 字符串列表
     */
    private List<String> stringList;
    
    //getter & setter
}

屬性賦值測試案例

我們構建 BaseSource 的屬性，然後調用

BeanUtil.copyProperties(baseSource, baseTarget);

類似於 spring BeanUtils 和 Apache BeanUtils，並驗證結果符合我們的預期。

    /**
     * 基礎測試
     */
    @Test
    public void baseTest() {
        BaseSource baseSource = buildBaseSource();
        BaseTarget baseTarget = new BaseTarget();
        BeanUtil.copyProperties(baseSource, baseTarget);

        // 斷言賦值後的屬性和原來相同
        Assertions.assertEquals(baseSource.getAge(), baseTarget.getAge());
        Assertions.assertEquals(baseSource.getName(), baseTarget.getName());
        Assertions.assertEquals(baseSource.getBirthday(), baseTarget.getBirthday());
        Assertions.assertEquals(baseSource.getStringList(), baseTarget.getStringList());
    }

    /**
     * 構建用戶信息
     * @return 用戶
     */
    private BaseSource buildBaseSource() {
        BaseSource baseSource = new BaseSource();
        baseSource.setAge(10);
        baseSource.setName("映射測試");
        baseSource.setBirthday(new Date());
        baseSource.setStringList(Arrays.asList("1", "2"));
        return baseSource;
    }