前言： 實(shí)體具有業(yè)務(wù)屬性、業(yè)務(wù)邏輯和業(yè)務(wù)行為，是是實(shí)實(shí)在在的業(yè)務(wù)對象。在事件風(fēng)暴中，我們可以根據(jù)命令、操作與事件將業(yè)務(wù)上緊密結(jié)合在一起的多個實(shí)體與值對象進(jìn)行聚合形成聚合根。

實(shí)體是什么

雖然數(shù)據(jù)庫的設(shè)計(jì)占據(jù)了主導(dǎo)地位（這個是沒錯的），但開發(fā)者也不應(yīng)該只關(guān)注數(shù)據(jù)，而且要關(guān)注模型。數(shù)據(jù)+行為= 模型，實(shí)體就是含有領(lǐng)域概念的模型。它是一個唯一的東西，在相當(dāng)長的時間里數(shù)據(jù)狀態(tài)在持續(xù)地變化，并且一定有唯一鍵，這區(qū)別于值對象。注意的是如果非要用表結(jié)構(gòu)里的一條含有主鍵的數(shù)據(jù)去理解實(shí)體也是可以的，但不少情況下可能是有多個表或者k/v數(shù)據(jù)來組成的一個實(shí)體。

實(shí)體、值對象與數(shù)據(jù)模型示例

實(shí)體、值對象與數(shù)據(jù)模型示例

實(shí)體是可變的，是變性，每個用戶實(shí)體都有自己的唯一性，我們用id來進(jìn)行區(qū)分。值對象是不變的，是共性，實(shí)體都有相同的值對象，例如國家等信息。我們以此區(qū)分好實(shí)體與值對象。

為什么使用實(shí)體

如果開發(fā)者設(shè)計(jì)系統(tǒng)時，并沒有建模而是直接開始設(shè)計(jì)表結(jié)構(gòu)和它的CRUD，其實(shí)這也算是建模的一種，但這種方式僅僅能應(yīng)對簡單的模型。這樣的操作當(dāng)更復(fù)雜的業(yè)務(wù)和更復(fù)雜的模型出現(xiàn)后是駕馭不了的。假設(shè)我們做10平米的臥室設(shè)計(jì)，那么簡單的量一下桌椅床就ok。但如果我們設(shè)計(jì)一個200平米的化學(xué)實(shí)驗(yàn)室的時候，這個簡單的擺放可能搞不好會導(dǎo)致爆炸吧~

實(shí)體

唯一標(biāo)識

在實(shí)體的設(shè)計(jì)早期，我們將關(guān)注點(diǎn)都放在了實(shí)體的身份唯一性、屬性、行為上。同時還應(yīng)該關(guān)注對實(shí)體的查詢和創(chuàng)建，我們首先要考慮實(shí)體的本質(zhì)特征，特別是實(shí)體的唯一標(biāo)識符，它是一個關(guān)系節(jié)點(diǎn)。比如用戶這個實(shí)體username是不是唯一標(biāo)識，如果不是唯一，是不是可以通過username去查找。

實(shí)踐

https://github.com/8treenet/freedom/tree/master/example/fshop/domain/entity

1. 所有的entity都必須繼承freedom.Entity 接口, 這里為實(shí)體注入了領(lǐng)域事件和運(yùn)行時的Worker對象。
2. 所有的entity都必須重寫Identity() string 方法。
3. 實(shí)體可以選擇的繼承PO或者DTO，PO是通過腳手架生成的表模型屬性和Get/Set方法。

type Entity interface {
    //發(fā)布領(lǐng)域事件
    DomainEvent(string,interface{},...map[string]string)
    //唯一ID
    Identity() string
    //獲取請求運(yùn)行時對象
    GetWorker() Worker
    SetProducer(string)
    Marshal() []byte
}

商品的屬性和行為

商品實(shí)體

package entity

import (
    "errors"
    "strconv"

    "github.com/8treenet/freedom"
    "github.com/8treenet/freedom/example/fshop/domain/po"
)

const (
    //熱銷
    GoodsHotTag = "HOT"
    //新品
    GoodsNewTag  = "NEW"
    GoodsNoneTag = "NONE"
)

// 商品實(shí)體
type Goods struct {
    freedom.Entity //繼承實(shí)體基類接口
    po.Goods //繼承持久化的商品模型，包含了商品的列和屬性方法
}

// Identity 唯一
func (g *Goods) Identity() string {
    return strconv.Itoa(g.Id)
}

// CutStock 扣庫存
func (g *Goods) CutStock(num int) error {
    if num > g.Stock {
        return errors.New("庫存不足")
    }
    g.AddStock(-num) //po對象的方法，增加庫存
    return nil
}

// MarkedTag 為商品打tag
func (g *Goods) MarkedTag(tag string) error {
    if tag != GoodsHotTag && tag != GoodsNewTag && tag != GoodsNoneTag {
        return errors.New("Tag doesn't exist")
    }
    g.SetTag(tag) //po對象的方法，設(shè)置tag
    return nil
}

用戶實(shí)體

package entity

import (
    "errors"
    "strconv"

    "github.com/8treenet/freedom"
    "github.com/8treenet/freedom/example/fshop/domain/po"
)

// 用戶實(shí)體
type User struct {
    freedom.Entity //繼承實(shí)體基類接口
    po.User  //繼承持久化的用戶模型，包含了用戶的列和屬性方法
}

// Identity 唯一
func (u *User) Identity() string {
    return strconv.Itoa(u.Id)
}

// ChangePassword 修改密碼
func (u *User) ChangePassword(newPassword, oldPassword string) error {
       //判斷舊密碼是否正確
    if u.Password != oldPassword {
        return errors.New("Password error")
    }
    u.SetPassword(newPassword) //po對象的方法，可以設(shè)置密碼
    return nil
}

訂單實(shí)體

package entity

import (
    "github.com/8treenet/freedom"
    "github.com/8treenet/freedom/example/fshop/domain/po"
)

const (
    OrderStatusPAID       = "PAID" //付款
    OrderStatusNonPayment = "NON_PAYMENT" //未付款
    OrderStatusShipment   = "SHIPMENT" //發(fā)貨
)

// 訂單實(shí)體
type Order struct {
    freedom.Entity //繼承實(shí)體基類接口
    po.Order  //繼承持久化的訂單模型，包含了訂單的列和屬性方法
    Details []*po.OrderDetail  //定義訂單商品詳情成員變量，一個訂單包含多個商品
}

// Identity 唯一
func (o *Order) Identity() string {
    return o.OrderNo
}

// AddOrderDetal 增加訂單詳情
func (o *Order) AddOrderDetal(detal *po.OrderDetail) {
    o.Details = append(o.Details, detal) //增加訂單詳情，repository會做持久化處理
}

// Pay 付款
func (o *Order) Pay() {
    o.SetStatus(OrderStatusPAID) //po對象的方法，設(shè)置狀態(tài)
}

// Shipment 發(fā)貨
func (o *Order) Shipment() {
    o.SetStatus(OrderStatusShipment) //po對象的方法，設(shè)置狀態(tài)
}

// IsPay 是否支付
func (o *Order) IsPay() bool {
        //判斷是否付款
    if o.Status != OrderStatusPAID {
        return false
    }
    return true
}

目錄

• golang領(lǐng)域模型-開篇
• golang領(lǐng)域模型-六邊形架構(gòu)
• golang領(lǐng)域模型-實(shí)體
• golang領(lǐng)域模型-資源庫
• golang領(lǐng)域模型-依賴倒置
• golang領(lǐng)域模型-聚合根
• golang領(lǐng)域模型-CQRS
• golang領(lǐng)域模型-領(lǐng)域事件

項(xiàng)目代碼 https://github.com/8treenet/freedom/tree/master/example/fshop

PS：關(guān)注公眾號《從菜鳥到大佬》，發(fā)送消息“加群”或“領(lǐng)域模型”，加入DDD交流群，一起切磋DDD與代碼的藝術(shù)！