從壹開始微服務 [ DDD ] 之八 ║剪不斷理還亂的 值物件和Dto

daqianmen發表於2021-09-09

正文

緣起

哈嘍大家週四好,時間是過的真快,這幾天一直忙著在公司的專案,然後帶帶新人,眼看這周要過去了,還是要抽出時間學習學習,這些天看到群裡的小夥伴也都在忙著新學習,還是很開心的,至少當時的初衷已經達到了,一起學習一起進步嘛,哪怕是對現在或者是對以後的工作有一丟丟的幫助,也是不枉此時的努力,哈哈夜裡寫文章總是容易多想,好啦,廢話不多說,上次我們們說到了《》,今天本來應該接著寫 領域命令 了,在設計的領域命令的時候,發現了值物件的存在,對 領域模型 和 檢視模型 有著剪不斷理還亂的困擾,所以我就暫時單寫一篇了,既是對上一篇的補充,又是對領域命令的鋪墊,好啦,馬上開始今天的說明吧~~

還是老規矩,每篇文章先給大家一個小問題,先思考下,然後有助於理解本文:

問題:我們在領域模型 Student 中,有一個戶籍的值物件(為啥叫戶籍,下邊會說到),然後我們也有一個學生的檢視模型 StudentViewModel ,那麼問題來了,我們在 StudentViewModel 中,如何去定義這個戶籍的檢視模型呢,然後又是如何傳給領域模型 Student 呢?

1、不寫這戶籍一塊,直接在業務邏輯裡,手動賦值給 Student 領域模型

圖片描述

    public class StudentViewModel
    {

        [Required(ErrorMessage = "The Name is Required")]
        [MinLength(2)]
        [MaxLength(100)]
        [DisplayName("Name")]        public string Name { get; set; }        //... 等等其他,只是學生的個人資訊,不涉及戶籍地址
    }

圖片描述

2、和領域模型一樣,也寫一個物件,甚至直接就用領域模型中的 Address 值物件

圖片描述

    public class StudentViewModel
    {
        [Key]        public Guid Id { get; set; }

        [Required(ErrorMessage = "The Name is Required")]
        [MinLength(2)]
        [MaxLength(100)]
        [DisplayName("Name")]        public string Name { get; set; }        //... 等等其他的資訊  

        //這個就是在領域模型Student中使用的,戶籍值物件
        public Address Address { get; set; } 
 
    }

圖片描述

3、把 Address 屬性拆開,一個一個的放在檢視模型 StudentViewModel 中

圖片描述

    public class StudentViewModel
    {
        [Key]        public Guid Id { get; set; }

        [Required(ErrorMessage = "The Name is Required")]
        [MinLength(2)]
        [MaxLength(100)]
        [DisplayName("Name")]        public string Name { get; set; }        //...  等等其他學生資訊,比如手機號,郵箱等

        /// <summary>
        /// 城市        /// </summary>
        public string City { get;  set; }

        /// <summary>
        /// 區縣        /// </summary>
        public string County { get;  set; }        /// <summary>
        /// 街道        /// </summary>
        public string Street { get;  set; }
    }

圖片描述

或許你還有其他啥辦法,要是有感覺更好的,或者更正確的,千萬要評論留言喲,只不過這三種辦法是我親身實驗的,這裡大家先思考一下,希望看完本文你會有一些自己的想法。

 

零、今天實現藍色的部分

圖片描述

 

 一、建立 Student 的新增模組

 話說上次我們們是把領域模型(包括實體和值物件)透過EFCore儲存到了資料庫,然後也查詢出來了相應的學習資訊,(這裡注意下,學習的戶籍資訊還沒有取出來),這裡說一下為什麼是戶籍地址資訊,

上篇文章中,有小夥伴還是對這個不是很理解,一直想著要一定和資料庫對應上,比如說,為啥叫地址,那如果學生有多個地址咋辦;再比如,這樣修改學生資訊,值物件就會發生變化呀,這樣就不能滿足值物件不可變的特性;等等諸如此類的疑問,這裡說一下:

1、值物件其實就是一個值,它和Name、Phone、Email等等一模一樣,只不過它是一個物件,複雜了一些,有了自己的內部結構,所以說,值物件是沒有狀態的,沒有唯一標識(多個學生叫張三 == 兩個學生一個地址),是內部不可變性,就比如我們修改一個學校省份,需要將整個值物件都修改,這和修改Name是一樣的。

2、值物件是一個領域中孕育出來的概念,千萬不要事事都要和資料庫,資料模型,扯上關係,如果想要一個會員多個地址,那這個時候地址就是一個實體,甚至是一個聚合了,比如物流地址,這也就是我為什麼要把這個Address稱之為 戶籍 的原因了,從領域出發,而不要再和資料模型資料庫表相提並論了。

那我們們就先新增學生的 Create 模組

1、在 StudentController 中新增 Create Action

圖片描述

        // GET: Student/Create        // 頁面
        public ActionResult Create()
        {            return View();
        }        // POST: Student/Create        // 方法        [HttpPost]
        [ValidateAntiForgeryToken]        public ActionResult Create(StudentViewModel studentViewModel)
        {            try
            {                // 檢視模型驗證
                if (!ModelState.IsValid)                    return View(studentViewModel);                // 執行新增方法                _studentAppService.Register(studentViewModel);

                ViewBag.Sucesso = "Student Registered!";                return View(studentViewModel);
            }            catch(Exception e)
            {                return View(e.Message);
            }
        }

圖片描述

這個時候大家肯定都已經很熟悉了,而且 Service 層注入什麼的,相信大家已經得心應手了,這裡都不細說了。

 

2、建立 Create View頁面

圖片描述

@model Christ3D.Application.ViewModels.StudentViewModel
@{
    ViewData["Title"] = "Register new Student";
}<h2>@ViewData["Title"]</h2>
<form asp-action="Create">
    <div class="form-horizontal">
        <hr />
        @* Replacing classic Validation Summary to Custom ViewComponent as TagHelper *@        <vc:summary />
        <div class="form-group">
            <label asp-for="Name" class="col-md-2 control-label"></label>
            <div class="col-md-10">
                <input asp-for="Name" class="form-control" />
                <span asp-validation-for="Name" class="text-danger"></span>
            </div>
        </div>
        <div class="form-group">
            <label asp-for="Email" class="col-md-2 control-label"></label>
            <div class="col-md-10">
                <input asp-for="Email" class="form-control" />
                <span asp-validation-for="Email" class="text-danger"></span>
            </div>
        </div>
        <div class="form-group">
            <label asp-for="Phone" class="col-md-2 control-label"></label>
            <div class="col-md-10">
                <input asp-for="Phone" class="form-control" />
                <span asp-validation-for="Phone" class="text-danger"></span>
            </div>
        </div>
        <div class="form-group">
            <label asp-for="BirthDate" class="col-md-2 control-label"></label>
            <div class="col-md-10">
                <input asp-for="BirthDate" class="form-control" />
                <span asp-validation-for="BirthDate" class="text-danger"></span>
            </div>
        </div>
        <div class="form-group">
            <div class="col-md-offset-2 col-md-10">
                <input type="submit" value="Create" class="btn btn-success" />
                <a asp-action="Index" class="btn btn-info">Back to List</a>
            </div>
        </div>
    </div>
</form>

圖片描述

圖片描述

 

這些都是 AspNetCore.Mvc.ViewFeature 的模型命令還有驗證等,相比以前的模型,已經有很大的改善了,這個可以自己試試,很簡單,直接往下走,重頭戲來了。

這個時候,如果我們新增資訊儲存的話,一定會發現一個問題,就是戶籍資訊到底如何傳入呢,上邊說的三種辦法到底該選擇哪一種呢,下邊我們們一一來實驗下。

 

二、如何把值物件新增到檢視模型

 這個時候肯定會有小夥伴說,為什麼一定要把值物件放到檢視模型中,就比如文章的第一個方法,我就不放進去,我從頁面內獲取到Country、Province、City等等後,然後再傳到領域模型不就行了,真的麼?

1、手動賦值的方法

 假設我們已經從前臺頁面內獲取到了戶籍資訊,然後我們就會這麼做

圖片描述

  public ActionResult Create(StudentViewModel studentViewModel,string country,string provice,string city,string street)
        {                // 檢視模型驗證
                if (!ModelState.IsValid)                    return View(studentViewModel);                //這個時候還需要對戶籍資訊進行驗證判斷                //比如字串不能數字,字元啥的                // 執行新增方法,把戶籍資訊傳遞過去                
                _studentAppService.Register(studentViewModel,country,  provice,  city,  street);
                ViewBag.Sucesso = "Student Registered!";                return View(studentViewModel);

        }

圖片描述

Stop!相信我,你肯定不會這麼做的,當然,偶爾偶爾我們會這麼接受一個引數,也偶會會這麼寫,可是這麼寫肯定是不行的,且不說不是DDD領域驅動設計思想,就連OOP思想也沒有發揮起來,所以方法一直接pass。

這個時候我們開始思考,至少需要把戶籍資訊放到檢視模型 StudentViewMode 中吧,嗯看著文章開頭的第二個方法就特別好!物件是吧,這個可是真是的OOP思想,全部用物件接收引數,然後把資料傳如到倉儲的Add()方法中,這樣就直接儲存了嘛,多好呀!想想的心動,那就開始吧,一個小坑正在慢慢變大。

 

2、用物件的方法將值物件新增到檢視模型中

聽著很拗口,說白了,就是文章開頭的第二種方法,領域模型和檢視模型,共用一個 值物件。然後我們修改下 view 頁面,用來傳遞引數。

圖片描述

        <div class="form-group">
            <label asp-for="BirthDate" class="col-md-2 control-label"></label>
            <div class="col-md-10">
                <input asp-for="BirthDate" class="form-control" />
                <span asp-validation-for="BirthDate" class="text-danger"></span>
            </div>
        </div>

        <div class="form-group">
            <label asp-for="Address.County" class="col-md-2 control-label"></label>
            <div class="col-md-10">
                <input asp-for="Address.County" class="form-control" />
                <span asp-validation-for="Address.County" class="text-danger"></span>
            </div>
        </div>
        <div class="form-group">
            <label asp-for="Address.Province" class="col-md-2 control-label"></label>
            <div class="col-md-10">
                <input asp-for="Address.Province" class="form-control" />
                <span asp-validation-for="Address.Province" class="text-danger"></span>
            </div>
        </div>
        <div class="form-group">
            <label asp-for="Address.City" class="col-md-2 control-label"></label>
            <div class="col-md-10">
                <input asp-for="Address.City" class="form-control" />
                <span asp-validation-for="Address.City" class="text-danger"></span>
            </div>
        </div>

圖片描述

這個時候,我們一定很歡喜,然後點選提交,發現,無論怎麼提交都不會在

  public ActionResult Create(StudentViewModel studentViewModel)

中獲取到我們需要的戶籍資訊,天哪!這是啥情況,當然是獲取不到的,因為 Address 是一個值物件,具有不可變性,它的 set 都是私有的,不能被賦值,不信請看

圖片描述

這個時候怎麼辦,聰明的你肯定能想到一個方法,既然值物件不行,它內部不可變,不能賦值,那我就自己在檢視模型中,再寫一個 AddressViweModel 不就行啦,然後可以進行set操作,想到這裡還是很激動,趕緊試試,這就看看能不能獲取到值。

 

圖片描述

 

 很不錯,已經把內容獲取到了,然後透過檢視物件傳到Add() 方法,很成功的達到了目的。

 圖片描述

看來這個方法也是可以的,只不過有一個小問題就是,這裡需要多了一個類來實現,如果我不想用類接受,而且是直接用屬性呢?那就是第三種辦法了,請繼續往下看。

 

3、用屬性欄位來講戶籍資訊放到檢視模型中

就是文章開頭的第三種辦法,這樣的:

圖片描述

 public class StudentViewModel
    {
        
        [Required(ErrorMessage = "The Name is Required")]
        [MinLength(2)]
        [MaxLength(100)]
        [DisplayName("Name")]        public string Name { get; set; }        
        //... 其他

        /// <summary>
        /// 省份        /// </summary>
        [Required(ErrorMessage = "The Province is Required")]
        [DisplayName("Province")]        public string Province { get; set; }        /// <summary>
        /// 城市        /// </summary>
        public string City { get; set; }        /// <summary>
        /// 區縣        /// </summary>
        public string County { get; set; }        /// <summary>
        /// 街道        /// </summary>
        public string Street { get; set; }
    }

圖片描述

然後再修改下頁面裡的呼叫情況,直接用呼叫屬性

圖片描述

 <div class="form-group">
     <label asp-for="Province" class="col-md-2 control-label"></label>
     <div class="col-md-10">
         <input asp-for="Province" class="form-control" />
         <span asp-validation-for="Province" class="text-danger"></span>
     </div>
 </div>

圖片描述

這個時候,我們滿懷開心的執行專案的時候,發現,index頁面的戶籍資訊沒有了,也就是說 Student -> StudentViewModel 的時候,透過 Automapper 沒有成功。

 

然後我們提交的時候,發現後端雖然能接受到資料,

圖片描述

 

可是在轉換到 Student 的時候失敗了:

 圖片描述

 

 這裡顯示的是,我們無法對其進行轉換,因為在檢視模型中,沒有匹配到 Student 的 Address 值物件資訊,不要慌,下邊我們會說這個問題。

 

三、Automapper實現複雜物件的轉換

 為了解決上一個問題,我研究了下 Automapper 官網,發現,這種複雜複製,需要進行手動配置,其實也是很簡單,只需要建立匹配屬性即可
 注意,在第二種方法中是不需要配置的,因為第二種方法,兩個模型結構幾乎一模一樣,這第三種方法,結構已經變了,一個是物件,一個僅僅是一個屬性值。

1、複雜領域模型轉換到檢視模型

圖片描述

 /// <summary>
 /// 配置建構函式,用來建立關係對映 /// </summary>
 public DomainToViewModelMappingProfile()
 {
     CreateMap<Student, StudentViewModel>()
         .ForMember(d => d.County, o => o.MapFrom(s => s.Address.County))
         .ForMember(d => d.Province, o => o.MapFrom(s => s.Address.Province))
         .ForMember(d => d.City, o => o.MapFrom(s => s.Address.City))
         .ForMember(d => d.Street, o => o.MapFrom(s => s.Address.Street))
         ;

  
 }

圖片描述

 這個時候,我們看Index頁面,戶籍資訊也出來了

圖片描述

 

 

2、檢視模型轉換到複雜領域模型

圖片描述

 public ViewModelToDomainMappingProfile()
 {
     //手動進行配置
     CreateMap<StudentViewModel, Student>()
      .ForPath(d => d.Address.Province, o => o.MapFrom(s => s.Province))
      .ForPath(d => d.Address.City, o => o.MapFrom(s => s.City))
      .ForPath(d => d.Address.County, o => o.MapFrom(s => s.County))
      .ForPath(d => d.Address.Street, o => o.MapFrom(s => s.Street))
      ;

 }

圖片描述

這裡將 Student 中的戶籍資訊,一一匹配到檢視模型中的屬性。

 然後我們測試資料,不僅僅可以把資料獲取到,還可以成功的轉換過去:

圖片描述

 

最後首頁檢視驗證資訊,以及新增上了,完成。

圖片描述

 

四、結語

 今天呢,是補充了上一把的坑,一共提供了三個辦法,當然其實第一種也不算是方法,主要是後兩者,不知道大家是否能看的懂,然後更傾向於哪一種:

2、不用配置 Automapper 對映資訊,只需要新建一個一樣的戶籍值物件的檢視模型 —— 戶籍檢視模型即可,因為結構相同,所以不需要手動配置對映,就能達到目的。

3、只需要一個檢視模型即可控制,在某些情況下,我們不方便使用巢狀的複雜檢視模型,只需要配置下對映檔案即可達到目的。

 今天,也為下一篇做準備,怎麼說呢,大家發現,現在我們能正確的新增進去了,但是如果我們要進行驗證該怎麼辦?比如說,我們要判斷學校不能小於14歲,手機號格式,郵箱格式等等,

當然,你可以說,我會用前端js校驗,也可以後端獲取到,if 判斷,都是可以的,

不過我個人感覺,後端校驗還是很需要的,我採用 FluentValidation 進行後端校驗,並且融入到 領域命令 中,那如何實現呢,下次再見咯~~~

 

五、GitHub & Gitee

 

原文出處:https://www.cnblogs.com/laozhang-is-phi/p/9962759.html  

來自 “ ITPUB部落格 ” ,連結:http://blog.itpub.net/1727/viewspace-2817394/,如需轉載,請註明出處,否則將追究法律責任。

相關文章