Golang領(lǐng)域模型-實(shí)體

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

實(shí)體是什么

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

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

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

實(shí)體是可變的储矩,是變性,每個(gè)用戶(hù)實(shí)體都有自己的唯一性褂乍,我們用id來(lái)進(jìn)行區(qū)分持隧。值對(duì)象是不變的,是共性逃片,實(shí)體都有相同的值對(duì)象屡拨,例如國(guó)家等信息。我們以此區(qū)分好實(shí)體與值對(duì)象褥实。

為什么使用實(shí)體

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

實(shí)體

唯一標(biāo)識(shí)

在實(shí)體的設(shè)計(jì)早期怎棱,我們將關(guān)注點(diǎn)都放在了實(shí)體的身份唯一性哩俭、屬性、行為上拳恋。同時(shí)還應(yīng)該關(guān)注對(duì)實(shí)體的查詢(xún)和創(chuàng)建凡资,我們首先要考慮實(shí)體的本質(zhì)特征,特別是實(shí)體的唯一標(biāo)識(shí)符谬运,它是一個(gè)關(guān)系節(jié)點(diǎn)隙赁。比如用戶(hù)這個(gè)實(shí)體username是不是唯一標(biāo)識(shí),如果不是唯一梆暖,是不是可以通過(guò)username去查找伞访。

實(shí)踐

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

  1. 所有的entity都必須繼承freedom.Entity 接口, 這里為實(shí)體注入了領(lǐng)域事件和運(yùn)行時(shí)的Worker對(duì)象。
  2. 所有的entity都必須重寫(xiě)Identity() string 方法轰驳。
  3. 實(shí)體可以選擇的繼承PO或者DTO厚掷,PO是通過(guò)腳手架生成的表模型屬性和Get/Set方法。
type Entity interface {
    //發(fā)布領(lǐng)域事件
    DomainEvent(string,interface{},...map[string]string)
    //唯一ID
    Identity() string
    //獲取請(qǐng)求運(yùn)行時(shí)對(duì)象
    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 (
    //熱銷(xiāo)
    GoodsHotTag = "HOT"
    //新品
    GoodsNewTag  = "NEW"
    GoodsNoneTag = "NONE"
)

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

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

// CutStock 扣庫(kù)存
func (g *Goods) CutStock(num int) error {
    if num > g.Stock {
        return errors.New("庫(kù)存不足")
    }
    g.AddStock(-num) //po對(duì)象的方法冒黑,增加庫(kù)存
    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對(duì)象的方法,設(shè)置tag
    return nil
}

用戶(hù)實(shí)體

package entity

import (
    "errors"
    "strconv"

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

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

// 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對(duì)象的方法抡爹,可以設(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í)體基類(lèi)接口
    po.Order  //繼承持久化的訂單模型,包含了訂單的列和屬性方法
    Details []*po.OrderDetail  //定義訂單商品詳情成員變量芒划,一個(gè)訂單包含多個(gè)商品
}

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

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

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

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

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

目錄

  • golang領(lǐng)域模型-開(kāi)篇
  • golang領(lǐng)域模型-六邊形架構(gòu)
  • golang領(lǐng)域模型-實(shí)體
  • golang領(lǐng)域模型-資源庫(kù)
  • golang領(lǐng)域模型-依賴(lài)倒置
  • 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)注公眾號(hào)《從菜鳥(niǎo)到大佬》泵殴,發(fā)送消息“加群”或“領(lǐng)域模型”涮帘,加入DDD交流群,一起切磋DDD與代碼的藝術(shù)笑诅!

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末焚辅,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子苟鸯,更是在濱河造成了極大的恐慌同蜻,老刑警劉巖,帶你破解...
    沈念sama閱讀 211,290評(píng)論 6 491
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件早处,死亡現(xiàn)場(chǎng)離奇詭異湾蔓,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)砌梆,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,107評(píng)論 2 385
  • 文/潘曉璐 我一進(jìn)店門(mén)默责,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人咸包,你說(shuō)我怎么就攤上這事桃序。” “怎么了烂瘫?”我有些...
    開(kāi)封第一講書(shū)人閱讀 156,872評(píng)論 0 347
  • 文/不壞的土叔 我叫張陵媒熊,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我坟比,道長(zhǎng)芦鳍,這世上最難降的妖魔是什么? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 56,415評(píng)論 1 283
  • 正文 為了忘掉前任葛账,我火速辦了婚禮柠衅,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘籍琳。我一直安慰自己菲宴,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 65,453評(píng)論 6 385
  • 文/花漫 我一把揭開(kāi)白布趋急。 她就那樣靜靜地躺著喝峦,像睡著了一般。 火紅的嫁衣襯著肌膚如雪宣谈。 梳的紋絲不亂的頭發(fā)上愈犹,一...
    開(kāi)封第一講書(shū)人閱讀 49,784評(píng)論 1 290
  • 那天键科,我揣著相機(jī)與錄音闻丑,去河邊找鬼漩怎。 笑死,一個(gè)胖子當(dāng)著我的面吹牛嗦嗡,可吹牛的內(nèi)容都是我干的勋锤。 我是一名探鬼主播,決...
    沈念sama閱讀 38,927評(píng)論 3 406
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼侥祭,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼叁执!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起矮冬,我...
    開(kāi)封第一講書(shū)人閱讀 37,691評(píng)論 0 266
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤谈宛,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后胎署,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體吆录,經(jīng)...
    沈念sama閱讀 44,137評(píng)論 1 303
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,472評(píng)論 2 326
  • 正文 我和宋清朗相戀三年琼牧,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了恢筝。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,622評(píng)論 1 340
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡巨坊,死狀恐怖撬槽,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情趾撵,我是刑警寧澤侄柔,帶...
    沈念sama閱讀 34,289評(píng)論 4 329
  • 正文 年R本政府宣布,位于F島的核電站占调,受9級(jí)特大地震影響勋拟,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜妈候,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,887評(píng)論 3 312
  • 文/蒙蒙 一敢靡、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧苦银,春花似錦啸胧、人聲如沸。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 30,741評(píng)論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至想括,卻和暖如春陷谱,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 31,977評(píng)論 1 265
  • 我被黑心中介騙來(lái)泰國(guó)打工烟逊, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留渣窜,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 46,316評(píng)論 2 360
  • 正文 我出身青樓宪躯,卻偏偏與公主長(zhǎng)得像乔宿,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子访雪,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 43,490評(píng)論 2 348