Visual Studio 2010_塑模化應用程式講座

最近筆者有對公司內部上一些(UML塑模設計 使用 VS 2010) 的相關課程，課程中筆者介紹UML的基本概念與Use Case Diagram基本的Notation使用方式，課後將一些資料再進行整理一下成此篇文章。

在使用Visual Studio 2010進行塑模設計時，有時會以UML類別圖來產生程式碼，且再進行反向工程時會使用現有程式碼進行塑模的建立，以方便檢視現有架構。但這些功能並不是內建在Visual Studio 2010中，必須安裝Visual Studio 2010 Feature Pack2才可以。

在安裝了Visual Studio 2010 Feature Pack2主要是使我們可以進行：

  1. 從 UML 類別圖 產生 程式碼 (Generate Code)。
  2. 從 程式碼 產生 UML 類別圖。
  3. 可匯入經由 XMI 2.1的格式所匯出的UML 類別圖、循序圖 和 使用者案例圖。
  4. 建立和檢視從工作項目到模型項目的連結。
  5. 開始支援為 ASP.NET Web、C 及 C++ 專案產生相依性圖形。
  6. 可以建立和驗證 C 與 C++ 程式碼的圖層圖表。
  7. 可以撰寫自訂程式碼以建立、修改和驗證圖層圖表。

安裝完成Visual Studio 2010 Feature Pack 2之後我們便可以將分析完成的UML Class Diagram使用『Generate Code』產生程式碼，為演示這樣的一個塑模的設計流程，我們以一個簡單的Shopping網站為例。範例中會使用一些簡單的OOA & OOD的分析方法。

在進行塑模設計之前我們先來看一下這個Shpooing網站的Scenario (情境)：

顧客至Shopping網站購物，首先會瀏覽型錄，決定商品後放入購物車，結帳，並填寫送貨單，包含送貨地址、收件人等資訊，始完成訂購。

接著：

(依照上方情境畫出Shopping 的Use Case)

image

一般來說使用OOA找出Domain物件的分析方式就是直接在Use Case裡找出所謂的『名詞』物件，此又俗稱名詞分析法，這是一個比較簡單的方式。

在顧客Shopping的情節(Scenario)中，我們可以找出會有『顧客』、『購物車』、『商品』、『交易紀錄』、『送貨單』、 『送貨地址』、 『收件人』等名詞(物件)。

分析的方法：在Use Case中顧客會瀏覽型錄，確定商品後會放入購物車中，瀏覽型錄不一定會購買，放入購物車為顧客會執行的一個動作，所以購物車為一個物件，而在購物車的物件當中應該會有一個”放入購物車”的作業(Operation)，且傳入”商品”物件。在情節當中找出屬於子類型的名詞(屬性)，通常不會一次全找出，有些一定會存在的如：顧客一定會有姓名等資訊。

先找出所謂的領域模型，其實就是一種初步的類別圖，又可稱為Domain Class Diagram。也為一種Conceptual Modeling。
再重複一次：在Scenario中出現的名詞、詞組通常都會是在Conceptual Modeling淺在的類別／物件或屬性。當然，這時候我們通常會再過濾掉一些不必要的名詞 (如:同義詞、補助詞) 等等。接著找出所謂的後選類別，並考慮其中的連結關係(Association)，要包括多重性(如：一對多、多對一、多對多..等關係)

此時，根據候選類別可以找出如下的Domain Class Diagram，此時為概念性Conceptual Modeling所以還未具備任何屬性：

image

接著我們再繼續檢視類別的完整性，補足遺漏的類別。文件中規範的條件或限制一併考慮進來。決定名詞項目為類別或是屬性。通常之前收集到的名詞項目均被定義為獨立的類別，但有時它可能是依附在某個類別下的屬性。然而，除非能夠確定該名詞項目所代表的只是一個數值或字串，否則最好還是將該名詞項目當成類別。

進一步檢視的結果：剛才的『送貨地址』、 『收件人』應為『送貨單』類別的屬性，而顧客應該要有姓名等資訊。推導出循序圖(Sequence Diagram)，物件間作業的關係，完成合理的流程。

回到前面敘述之Scenario，顧客瀏覽商品，將商品置入購物車並結帳填寫送貨單等，這是一連串的動作與流程。使用Sequence Diagram我們便可輕易的推導出各個物件需要實作什麼作業(Operation/Method)以便可以完成一連串的工作。一般來說不只一個流程，因此在實際的分析方式會By功能來進行分析，這有許多不同的角度，也要視實際計統需求而定，從Use Case的角度來說，可說就是該Use Case的參與者會進行的動作。

因此顧客購物的Sequnce Diagram結果如下：

image

經由Sequence Diagram進一步檢視的結果，我們發現各個物件會需要哪些(Operation/Method)，比如：商品會需要GetGoodsName()、購物籃會有InsertGood()等方法等等，因此此時類別圖變會成如下：

image

現在可以開使產生程式碼。在安裝了Visual Studio 2010 Feature Pack 2後，在UML Class Diagram途中按下滑鼠右鍵會有 [Generate Code]選項：

image

接著先使用預設的Class類別方式，如下圖：

image

此時Visual Studio 2010會建立一個GenerateCodeModelingTestProject的Library專案，包含UML Class Diagram的程式碼框架，如下圖，這時可以由Program撰寫所需要的程式碼。

image

如上範例展示了以Visual Studio 2010進行塑模設計的方法，下次有機會筆者再介紹更深入的部分，謝謝各位。

留言

張貼留言

這個網誌中的熱門文章

什麼是 gRPC ？

圖片
圖片取自： https://grpc.io/docs/guides/ gRPC 是什麼？能吃嗎？ 在安裝了 .NET Core 3.0 之後，眼尖的朋友應該會發現，在新增 ASP.NET Core 網頁類型專案裡，會看見一個 gRPC Service 類型的專案，其實它也不是什麼很新的東西，早在十多年前 Google 就使用這樣的 RPC 協定進行一些大量的可靠性微服務的存取，聽到這，難道現有的 Web API 不可靠嗎？其實不是的，它主要用在移動設備等提供高效簡單且跨平台的通訊與熱插拔的驗證機制。 gRPC 的運作原理 gRPC 顧名思義，是種基於 RPC 的通訊協定，不同於 Web API 走的傳統 HTTP 基礎協定，它有點像是 Socket ，但應該說是基於 Socket， 或精確地來說它是基於 HTTP/2 的協定 ，gRPC 是種協議緩衝協定，它必須事先定義 IDL (Interface Definition Language) 描述檔，看到 IDL 對於一些熟悉 COM／DCOM 的朋友一定非常的熟悉，對！沒錯！就是類似的東西！但，這邊的 IDL 是用一種副檔名為 .proto 檔案來是先定義在分散式環境中，要傳輸的序列化結構資訊，當然它也可以跟 JSON 一起使用。 也就是說，要使用 gRPC 您必須先定義 .proto 協議，然後透過 Compile 的支援，編譯成特定語言框架。而很高興的是，C# 也支援了，然而其實根據官方的資料顯示，C# 應該在 .NET Core 2.1 開始就支援了，只是到了 .NET Core 3.0 才有樣版的支援。 而使用 gRPC 的協議緩衝區的服務可以做到 Stub 的機制，也就是說，它就像是許多 RPC 一樣，Client 在呼叫 Server 端時，其實是對 Stub 進行叫用，Stub 在這就像個緩衝區一般，但更細部的說，應該是一個遠程服務的替身，這應該又讓許多熟悉 COM／RPC 通訊的朋友覺得熟悉了起來，是的！沒有錯。 在 .NET Core 3.0 裡使用 gRPC 目前支援 .proto 擴展為 gRPC 協議緩衝區的編譯器只有 .NET Core 了 ， 根據 Github 上的說明 .NET Framework 4.5+ 以上或 Mono 4+ 以上也可支援，而 gRPC 也完全的跨平台。要在 .
閱讀完整內容

什麼是 gRPC（二）- 來撰寫第一個 Hello World 吧！

圖片
前言 上一篇 什麼是 gRPC ，筆者大致介紹了 gRPC Service 的基本概念，這一次，我們就來小試一下身手，撰寫一個 Hello World （迷之音：嘗試新技術時，總是得先來一個 Hello World ～我不想違背這良好傳統阿阿阿阿） 使用環境 Visual Studio 2019 .NET Core 3.0.100-preview3-010431 開始進行 撰寫 gRPC 除了先準備好基礎環境、選定一種 作業系統／ 程式語言 Language 外、（Framework／SDK／Runtime）等環境備妥後，就可以開始撰寫， (1). 開始撰寫 gRPC 第一步就是先定義 .proto 協議了 上一篇筆者提到，gRPC 的 Server 與 Client 必須使用相同的協議才可進行溝通，一般來說，你應該使用 protoc.exe 編譯器先行編譯過 greet.proto 協議檔，並產出 C# 程式碼檔案後才可繼續，而在 Visual Studio 2019 裡，拜 MSBuild 之賜，已經有人預先寫好 .Target 檔案了 （什麼是 MSBuild ？什麼是附檔名 .Target 檔案可參考： MSBuild .targets 檔案 ） 筆者先撰寫一個 SayHelloWorld 方法如下： 在協議裡，除了在 service Class 撰寫要公開存取的方法外， 必須在提供『傳入訊息型態』、『回傳訊息型態』 ，這邊我先定義兩個 message，一個是『 HelloMyFirstgRPC 』、另一個是『 HelloMyReply 』 在撰寫 proto 協議檔時，建議先決定 message 回傳型態與傳入的型態，那麼 Visual Studio 2019 會有 InteillSense 的完整支援。不得不說 Visual Studio 2019 在 .proto 協議編輯上的支援已經算不錯了。 注意： 一般來說，Visual Studio 2019 會在背景裡自動編譯 .proto 協議檔案，但始有可能不會有任何提示，所以您也可以自行使用命令列工具進行手動編譯，如下圖，若編譯失敗會出現錯誤訊息，如下圖顯示 return 關鍵字錯誤： protoc.exe 編譯器 & 相關 MSBuild Tools 會隨著 NuGet 套件在 Vis
閱讀完整內容

常見的程式碼壞味道（Code Smell or Bad Smell）

圖片
常見的程式碼壞味道（Code Smell or Bad Smell） 圖片取自：https://www.slideshare.net/ElMahdiBenzekri/art-of-refactoring-code-smells-and-microservices-antipatterns 前言 究竟重複的程式碼要不要共用它？傳統的軟體開發上，重複的程式碼幾乎被視為罪惡的來源，但是它真的有多可怕？ 常見的 Code Smells The Dispensable （一些可有可無的） Lazy Class (冗員類別） 如果一個類很少使用它會增加代碼庫的複雜性，從而阻礙開發。這樣的類可能是不必要的，它的功能可以成為另一個類的一部分。 Data Class (只有資料的類別） 一個類別只有包含『資料』未包含Methods，也就是說並未包含行為，不具行為模式的類別代表該『實例』容易被【其他類別所操控】。 Duplicate Code (重複的程式碼) 如描述，這也是上次有分享在我的 FB 社團 軟體開發之路［德國資深架構師給新手的建議］ 中有產生非常熱烈討論，這在社團朋友提醒下想起 Refactor 重構一書裡曾提過 rule of three 法則， 這個法則的定義是這樣的，有時部分程式碼重複其實是允許的（不是說重複一定是是被允許的）而是在某些 Context 情境下，該程式碼有一段時間不會衍伸別的功能 或 需求一段時間不會異動、且如要將它 DRY 會產生的『複雜度』或『花費時間』遠高於預估的時間 或 不值得在目前這個專案的節骨眼上花費這個時間來做這件事，加上它 DRY 產生的複雜度偶後產生的維護成本【遠高於】不 DRY 的情況下的維護本，那麼，在這個時候，這個異動頻率【極低】的程式碼就不需要花費這個時間來 DRY 了！！ 因為重點在於，重構是需要『成本』的。(迷之音：DRY 是種抽象化阿~😎) 這讓我想起之前，大約在 2016 年左右，在 101 的樓上某金融業客戶，曾經做過一個專案，這個專案就是因為客戶 DMZ 環境的因素，我讓內網的 Webside 與 DMZ 的網站保留了部分重複的程式碼，因為這段程式碼終年不需要異動，我也懶得花這個時間，而我居然也忘了這記件事情了.. 哈哈 Orz 不過原歸正傳，我個人還是認為，其實適當
閱讀完整內容