Java領(lǐng)域模型（POJO / Entity / VO/ DTO / BO）

一、為什么需要領(lǐng)域模型？

在Java開(kāi)發(fā)中，數(shù)據(jù)在不同場(chǎng)景（如數(shù)據(jù)庫(kù)交互、前后端傳輸、前端展示、業(yè)務(wù)處理）中承擔(dān)的角色不同：

• 數(shù)據(jù)庫(kù)存儲(chǔ)需要與表結(jié)構(gòu)嚴(yán)格對(duì)應(yīng)；
• 前后端傳輸需要精簡(jiǎn)敏感信息；
• 前端展示需要格式化數(shù)據(jù)；
• 業(yè)務(wù)處理需要組合多源數(shù)據(jù)。

領(lǐng)域模型的作用：通過(guò)“給數(shù)據(jù)貼標(biāo)簽”，明確數(shù)據(jù)在不同階段的職責(zé)，避免混亂（如直接用數(shù)據(jù)庫(kù)實(shí)體返回給前端可能暴露密碼等敏感字段）。

二、核心領(lǐng)域模型對(duì)比總表

三、分模型詳解（附示例）

1. POJO（最基礎(chǔ)的“裸數(shù)據(jù)”）

• 全稱：Plain Old Java Object（普通老式Java對(duì)象）
• 核心定位：不依賴任何框架、無(wú)特殊約束的基礎(chǔ)Java類，僅包含屬性、get/set方法和構(gòu)造方法。
• 本質(zhì)：所有領(lǐng)域模型的“最小單元”——Entity、DTO、VO等本質(zhì)上都是POJO的“特殊形態(tài)”（增加了場(chǎng)景約束）。

示例代碼：

// 純POJO，無(wú)任何注解/繼承，僅存數(shù)據(jù)
public class UserPojo {
    private Long id;
    private String name;
    private Integer age;
    // 必須有：無(wú)參構(gòu)造、get/set方法
    public UserPojo() {}
    // get/set省略
}

關(guān)鍵特點(diǎn)：

• 不繼承任何特定類（如Serializable可選，非必須）；
• 不實(shí)現(xiàn)任何框架接口（如MyBatis的BaseMapper）；
• 僅用于承載數(shù)據(jù)，無(wú)業(yè)務(wù)邏輯方法。

2. Entity（數(shù)據(jù)庫(kù)的“鏡像”）

• 全稱：實(shí)體類（無(wú)縮寫(xiě)，強(qiáng)調(diào)“與數(shù)據(jù)庫(kù)關(guān)聯(lián)”）
• 核心定位：與數(shù)據(jù)庫(kù)表一一映射的實(shí)體，是“數(shù)據(jù)庫(kù)數(shù)據(jù)在Java中的化身”。
• 核心場(chǎng)景：通過(guò)MyBatis、JPA等ORM框架操作數(shù)據(jù)庫(kù)（查詢、新增、修改）。

示例代碼：

// 與數(shù)據(jù)庫(kù)user表嚴(yán)格映射
@TableName("user") // MyBatis注解：指定對(duì)應(yīng)表名
public class UserEntity {
    @TableId(type = IdType.AUTO) // 主鍵+自增策略
    private Long id; // 對(duì)應(yīng)表中id字段（bigint類型）
    @TableField("username") // 字段名與表一致（若相同可省略）
    private String username; // 對(duì)應(yīng)表中username字段（varchar）
    private String password; // 對(duì)應(yīng)表中password字段（敏感字段，需加密存儲(chǔ)）
    @TableField(value = "create_time", fill = FieldFill.INSERT)
    private LocalDateTime createTime; // 對(duì)應(yīng)表中create_time字段（datetime）
    // 無(wú)參構(gòu)造、get/set方法
}

關(guān)鍵特點(diǎn)：

• 字段名、類型與數(shù)據(jù)庫(kù)表字段完全一致（含主鍵、索引、自增等配置）；
• 帶有ORM框架注解（如@TableName、@Id），明確與數(shù)據(jù)庫(kù)的映射關(guān)系；
• 包含數(shù)據(jù)庫(kù)層面的屬性（如createTime、updateTime），但無(wú)業(yè)務(wù)邏輯。

3. DTO（數(shù)據(jù)傳輸?shù)?ldquo;快遞盒”）

• 全稱：Data Transfer Object（數(shù)據(jù)傳輸對(duì)象）
• 核心定位：專門(mén)用于數(shù)據(jù)傳輸的載體，解決“傳輸效率”和“數(shù)據(jù)安全”問(wèn)題。
• 核心場(chǎng)景：
  • 前端→后端：接收前端提交的參數(shù)（如登錄、表單提交）；
  • 服務(wù)間調(diào)用：微服務(wù)A向微服務(wù)B傳遞數(shù)據(jù)（僅傳必要字段）。

示例1：接收前端登錄參數(shù)

// 前端登錄時(shí)傳遞的參數(shù)（僅包含必要字段）
public class LoginDTO {
    @NotBlank(message = "用戶名不能為空") // 可加參數(shù)校驗(yàn)注解
    private String username;
    @NotBlank(message = "密碼不能為空")
    private String password;
    // get/set方法
}

示例2：服務(wù)間傳輸用戶簡(jiǎn)信息

// 微服務(wù)間傳輸?shù)挠脩魯?shù)據(jù)（屏蔽敏感字段）
public class UserSimpleDTO {
    private Long id;
    private String username; // 僅傳用戶名，不含password
    private String role; // 僅傳必要的角色信息
    // get/set方法
}

關(guān)鍵特點(diǎn)：

• 字段按需設(shè)計(jì)（僅包含傳輸所需的字段，避免冗余）；
• 可包含參數(shù)校驗(yàn)注解（如@NotBlank），用于前端傳參校驗(yàn)；
• 不包含數(shù)據(jù)庫(kù)相關(guān)字段（如createTime），與數(shù)據(jù)庫(kù)解耦。

4. VO（前端展示的“展示板”）

• 全稱：Value Object（值對(duì)象）
• 核心定位：專門(mén)為前端展示準(zhǔn)備的數(shù)據(jù)，是“后端給前端的最終數(shù)據(jù)包裝”。
• 核心場(chǎng)景：后端接口返回給前端的數(shù)據(jù)（如頁(yè)面列表、詳情頁(yè)展示）。

示例代碼：

// 前端用戶列表頁(yè)展示的數(shù)據(jù)（組合多表字段+格式化）
public class UserListVO {
    private Long userId; // 前端習(xí)慣用userId，而非id
    private String username; // 用戶名（來(lái)自UserEntity）
    private String roleName; // 角色名稱（來(lái)自RoleEntity，UserEntity中無(wú)此字段）
    private String createTimeStr; // 格式化后的時(shí)間（如"2024-05-01"，前端直接展示）
    // get/set方法
}

關(guān)鍵特點(diǎn)：

• 字段名可貼合前端習(xí)慣（如userId而非id）；
• 可組合多個(gè)Entity的字段（如用戶信息+角色信息）；
• 包含格式化后的字段（如日期轉(zhuǎn)字符串），減輕前端處理成本；
• 絕對(duì)不含敏感字段（如password絕不會(huì)出現(xiàn)在VO中）。

5. BO（業(yè)務(wù)處理的“計(jì)算器”）

• 全稱：Business Object（業(yè)務(wù)對(duì)象）
• 核心定位：服務(wù)層（Service）內(nèi)部使用的“業(yè)務(wù)數(shù)據(jù)載體”，包含業(yè)務(wù)邏輯處理結(jié)果。
• 核心場(chǎng)景：復(fù)雜業(yè)務(wù)計(jì)算（如訂單金額計(jì)算、用戶積分統(tǒng)計(jì)）。

示例代碼：

// 訂單業(yè)務(wù)處理的BO（包含業(yè)務(wù)計(jì)算邏輯）
public class OrderBO {
    // 基礎(chǔ)數(shù)據(jù)（來(lái)自Entity）
    private OrderEntity order; // 訂單基本信息
    private List<OrderItemEntity> items; // 訂單項(xiàng)列表
    // 業(yè)務(wù)計(jì)算結(jié)果（非數(shù)據(jù)庫(kù)字段）
    private BigDecimal totalAmount; // 總金額（計(jì)算：sum(單價(jià)×數(shù)量)）
    private BigDecimal discountAmount; // 折扣金額（根據(jù)會(huì)員等級(jí)計(jì)算）
    private BigDecimal payAmount; // 實(shí)付金額（totalAmount - discountAmount）
    // 業(yè)務(wù)方法：計(jì)算金額（包含核心業(yè)務(wù)邏輯）
    public void calculateAmount(UserEntity user) {
        // 1. 計(jì)算總金額
        this.totalAmount = items.stream()
                .map(item -> item.getPrice().multiply(new BigDecimal(item.getQuantity())))
                .reduce(BigDecimal.ZERO, BigDecimal::add);
        // 2. 計(jì)算折扣（會(huì)員等級(jí)越高，折扣越大）
        this.discountAmount = calculateDiscount(user.getVipLevel(), totalAmount);
        // 3. 計(jì)算實(shí)付金額
        this.payAmount = totalAmount.subtract(discountAmount);
    }
    // 私有輔助方法（業(yè)務(wù)邏輯細(xì)節(jié)）
    private BigDecimal calculateDiscount(Integer vipLevel, BigDecimal total) {
        if (vipLevel >= 3) return total.multiply(new BigDecimal("0.1")); // 10%折扣
        if (vipLevel >= 2) return total.multiply(new BigDecimal("0.05")); // 5%折扣
        return BigDecimal.ZERO;
    }
    // get/set方法
}

關(guān)鍵特點(diǎn)：

• 可組合多個(gè)Entity或DTO的數(shù)據(jù)（如訂單+訂單項(xiàng)+用戶信息）；
• 包含業(yè)務(wù)計(jì)算結(jié)果（非數(shù)據(jù)庫(kù)存儲(chǔ)的臨時(shí)字段）；
• 有業(yè)務(wù)邏輯方法（如calculateAmount），是“業(yè)務(wù)邏輯的載體”；
• 僅在服務(wù)層內(nèi)部使用，不暴露給前端或其他服務(wù)。

四、場(chǎng)景串聯(lián)：一個(gè)流程看懂所有模型

以“用戶查詢訂單詳情”為例，看各模型如何配合：

1. 數(shù)據(jù)庫(kù)查詢：通過(guò)OrderEntity和OrderItemEntity從數(shù)據(jù)庫(kù)獲取原始訂單數(shù)據(jù)；
2. 業(yè)務(wù)處理：在Service層用OrderBO組合上述Entity，計(jì)算totalAmount、discountAmount等業(yè)務(wù)數(shù)據(jù)；
3. 傳輸準(zhǔn)備：若需要調(diào)用“用戶服務(wù)”獲取會(huì)員信息，用UserSimpleDTO傳輸精簡(jiǎn)的用戶數(shù)據(jù)；
4. 前端展示：將OrderBO中的核心信息（過(guò)濾敏感字段、格式化日期）封裝到OrderDetailVO，返回給前端展示。

整個(gè)過(guò)程中，POJO是所有模型的基礎(chǔ)（上述模型均符合POJO的基本結(jié)構(gòu)）。

五、核心原則總結(jié)

1. 各司其職：
   • 數(shù)據(jù)庫(kù)交互用Entity，傳輸數(shù)據(jù)用DTO，展示用VO，業(yè)務(wù)處理用BO，避免混用（如禁止用Entity直接返回給前端）。
2. 按需設(shè)計(jì)：
   • 簡(jiǎn)單項(xiàng)目可簡(jiǎn)化（如只用Entity+DTO），復(fù)雜項(xiàng)目必須嚴(yán)格區(qū)分（如電商系統(tǒng)的訂單模塊）。
3. 轉(zhuǎn)換工具：
   • 用MapStruct、BeanUtils等工具實(shí)現(xiàn)模型間轉(zhuǎn)換（如Entity→BO、BO→VO），減少重復(fù)代碼。

到此這篇關(guān)于Java領(lǐng)域模型示例詳解的文章就介紹到這了,更多相關(guān)java領(lǐng)域模型內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論