starUml使用

1.   綜述：

StarUML 是一種生成類圖和其他類型的統一建模語言(UML) 圖表的工具。這是一個用Java 語言描述的創建類圖的簡明手冊。

StarUML( 簡稱SU) ，是一種創建UML 類圖，並能夠自動生成Java 的“stub code ” 的工具。SU 也可以做JAVA 逆向工程，以產生相應的UML 圖表。

在本教程中，我們將使用SU 設計一個pizza 餅。執行下列步驟，可以創建如下面所示的UML 圖。SU 可以生成反映類結構的代碼，而不是任何對象的具體行動。因此，在使用SU 創建圖表後，你會爲此stub code 添加剩餘的功能性代碼，填寫每種方法本來應該做的事。

2.   安裝：

首先，我們必須先安裝將要使用的軟件。StarUML ，是一個開放源碼軟件， 遵循GPL 協議 許可（GNU 公共許可證） ，並免費提供下載。

3.   啓動

安裝以後就可以啓動該程序。

4.   添加新工程

然後，一個名叫：New Project By Approach 的對話框會彈出。選擇“Empty Project ”並且按下" 確定" 。這裏建議你不要勾選" 設置爲默認的做法" 複選框。

5.   選擇模塊

在右邊的“ Model Explorer ”框中選定“ Untitled ”模塊。

6.   添加模塊

通過“Model ”主菜單，或右擊選定的模型，可以" Add/Design Model "

7.   添加類圖

通過“Model ”主菜單，或右擊選定模型，可以“Add Diagram/Class Diagram ”：

 

8.   設置 profile

通過“Model/Profile... ”菜單去設置工程所需的profile 。這決定了工程所使用的規則和約定。一定要包含"JAVA Porfile" 這一項目。

9.   保存工程

立即就保存工程，這樣在出現問題的時候，您就不會丟失信息。

從“File ”菜單，選擇“Save ” ，並選擇一個地方以保存工程。你的StarUML 項目現在應該看起來的是這樣的：

10.          創造圖表

現在，開始真正創造圖表，從默認就在屏幕的左邊的“Toolbox” 選擇“類” 圖標，然後左鍵單擊diagram 窗口的某處。這樣就使用通用名字創造了一個新的類。雙擊，將類改名爲Circle 。

11.          添加屬性

右擊圖中的目標，在彈出菜單中選擇“Add ”中的“Attribute ”( 被標示爲綠色) ，爲其添加一個屬性( 或者域) ，填入期望的名字“_radius ”。

• 具體的數據類型，在屬性面板（右下側的窗口） ，由雙打字，在" 類型" 時段。 在窗體右下邊的Properties 面板中，找到“Type ”輸入框，輸入double 作爲_radius 屬性的類型。
• 類的內部數據（域/ 屬性）都是私有的，因爲他們是嚴格由類內部使用的。所以，在Properties 面板中將_radius 設置爲“私有”。

12.          繼續進行設計

重複同樣的過程，添加所謂的名字叫做Rectangle 的類和double 型的私有成員_width 和_height 。 ( 下面者段話是使用方面的主意事項，總感覺翻譯部太好，九原文搬上來了)You may notice using the "Model Explorer" on the right is faster to add these, but do however note that adding the classes and interfaces themselves in this toolbox (instead of using the toolbox on the left and clicking on the palette to create the object) will not create the objects in the diagram.

13.          創造 IShape interface

• 從toolbox 中，選擇“Interface ”，並點擊圖表的某處。將其改名爲IShape 。創建以後，選中它。
• 在頂部工具欄，選擇 “Stereotype Display ” 下拉按鈕，將值改變爲“None ”。這將改變以往的圓形形狀，使其變爲成長方形。
• 還是在頂部工具欄，取消選中" Suppress Operations " 。這將使我們能夠看到接口所擁有的方法。

•  向IShape 接口添加返回值爲double 的getArea 方法。
• 可以通過右擊interface 的圖標，在彈出菜單中點擊紅色的“Operation ”按鈕，然後輸入getArea 。
• 設定返回值類型。在“Model Explorer ”中展開IShape 節點，右擊你剛剛創建的getArea 方法，並選擇“Add Parameter ”。在“Properties ”框中，將參數的名子變爲空，將“DirectionKind ”變爲“RETURN ”，將“Type ”變爲dboule 。
• 將IShape 和getArea 的IsAbstract 屬性框打上勾，他們在圖標上的名字將變爲斜體。這是UML 的標準，表示這是接口或者其他純虛實體。

14.          添加類和接口的關係

• 可以通過從toolbox 中選擇表示“Realization ”的箭頭，並從Circle 拖拽向IShape ，使Circle 實現接口IShape 。重複同樣的過程，爲Rectangle 添加實現關係。這是添加了Circle 和 Rectangle 對於IShape 接口的實現關係。
• 如果想使連接線表現爲直角的方式，右擊連接線，並選擇" Format/Line Style/Rectilinear" 菜單。你通過這種方式，使箭頭重疊在一起，可以使你的圖看起來更整潔。

15.          添加類基於接口的行爲

• 由於Circle 和Rectangle 類都實現了IShape 接口，就必須有同樣的行爲( 方法) 。
• 在“Model Explorer ”面板中，複製getArea 法( 按Ctrl-C 或者右鍵點擊並選擇Copy 菜單），並粘貼到Circle 和Rectangle 類。
• 這些實現了的方法在Circle 和Rectangle 類中都不是抽象的，而是具體的。這是因爲他們實際上是執行一些特定行爲（例如，爲一個圓形和長方形分別計算面積） ，所以不要勾選IsAbstract 框。

16.          你的圖現在應該是這樣的：

 

17.          添加 Pizza 類

• 向Pizza 添加double 型的私有域_price 。
• 添加返回double 類型的共有操作getPrice 。

18.          爲 Pizza 類添加 IShape 的引用

• 從toolbox 中選擇" DirectedAssociation " 箭頭，點擊Pizza 類，並向IShape 拖拽 。
• 選中箭頭，在右邊的“Properties ”框上，將name 一欄改爲“has-a ”，“End1.Aggregation ” 一欄改爲“AGGREGATE ”( 這個圖示說明Pizza 和shape 對象是“聚合“的關係) 。
• 將“End2.Name ”一欄改爲_shape 。這樣就自動爲Pizza 添加一個名字爲_shape ，使用IShape 接口的私有域，的所謂_shape 型ishape 以pizza 餅。
• 將“End2.Visibility ”改爲私有。
• 爲_shape 創建一個“獲得者”方法，名字叫做getShape ，返回IShape 。這就是創建一個行爲，名字是getShape ，返回IShape 。

19.          爲 pizza 類添加構造函數

• 爲Pizza 添加構造函數，右擊，在彈出的“Add ” 菜單中選擇“Operation ”。從這裏，增加一個普通的帶有dboule 型price 參數和IShape 類型shape 參數的操作
• 增加一個輸入參數，就像之前增加了一個返回型的輸出參數一樣，你指定的參數的名稱，如價格和形狀等，以及適當的數據類型。
•  爲Circle 增加一個帶有double 型的radius 參數的構造函數。
• 爲Rectangle 增加一個帶有double 型width 和height 參數的構造函數。

20.          你的圖現在應該是這樣的：

21.          添加 Test_Pizza 類

爲了說明UML 類圖更多的功能，又增加了一個叫做“Test_Pizza ”的類，它用作測試目的，並使用到Pizza 和IShape 類。

• 兩個類之間的關係有多種形式。舉例來說，一個類可以實例化另一個類，而不是將其作爲一個成員。又或，一類的方法可能需要另一個類作爲輸入參數，保留一個引用僅僅是爲這個方法的執行。
• 通過從toolbox 中選擇“Dependency ”箭頭，從一個類拖向他所以來的類，來添加不通類之間的依賴關係。在這個例子中， Test_Pizza 依賴於Pizza ，Circle 和Rectangle 類，因爲它實例化了它們。
• 從Properties box 選擇name 屬性，或者雙擊圖表上的“依賴線”，可以爲依賴關係添加標籤。特別的是，當一類實例化另一個類，我們會把依賴線叫做“instantiates ”。
• 你可以選中並拖動依賴線的標籤，以達到更美觀的效果。
• 依賴關係不會影響代碼生成。

22.          你的圖現在應該像本文最開始所示。

23.          對你的圖隨意做些修改。

你還可以拖動你的類圖，並且使箭頭以不通的方式展示( 使箭頭顯示爲直線，選擇一個箭頭，右擊它，彈出菜單中選擇“Line Style ”，並選擇“Rectilinear ” ) 。你一定要體驗這個工具，並去了解它。

24.          保存項目

在“File ”菜單中，選擇“Save ”。 SU 的所有資料只有一個單一的項目文件，所以你目前應該只有一個文件生成。

25.          導出

將圖表導出爲其他格式，例如圖片等，是非常有用的。您可以通過選擇“File ”菜單的“Export Diagram ” ，並且選擇合適的文件類型來執行改操作。

26.          生成 Java stub 代碼：

• 點擊主菜單的“Tools->Java ”菜單，選擇“Generate Code ”。

• 從對話框中選擇你的模塊( 這裏可能Model1), 點擊“Next ”。
•  爲了使你的模塊或者圖標的所有類都生成stub code ，選擇“Select All ”然後按“Next ”。
• 選擇一個有效的輸出目錄，“Next ”。
• In the "Options Setup", be sure to check both "Generate the Documentation by JavaDoc" and "Generate empty JavaDoc".  All other checkboxes should be unchecked.  Then press "Next". 在“Options Setup ” ，請務必選中“Generate the Documentation by JavaDoc ”，“Generate empty JavaDoc ”，所有其他複選框不選中，“Next ”。
• 現在StarUML 將從你的圖產生代碼，點擊“Finish ”退出對話框。
•  現在，您可以編輯生成的代碼，以增加應用。

27.          添加實現代碼

現在就開始定義程序實際做的事情，例如，爲你圖標中的類描述添加實現代碼。

• 使用DrJava 添加代碼，爲相關的類，.Java 文件添加代碼。   代碼會和你使用HW02 是一樣的。（注意：爲Test_Pizza 些代碼，最好由DrJava 自動生成，而非手工在StarUML 裏面創建。我們這裏只是爲了說明。）
• 記得那IShape 的getArea() 方法是抽象的，因此沒有代碼。
• 請您像代碼範例一樣添加註釋。這種註釋是“JavaDoc ”風格的。 關於JavaDoc 您將會在隨後學到更多。

28.          逆向工程

StarUML 還可以從現有的Java 代碼創建一個類圖，這被稱爲“reverse engineering ”，當你想從現有的代碼生成圖表，或者你修改了SU 生成的代碼，並且想在圖表中反應出來的時候，逆向工程功能就非常有用了。通過圖表或者DrJava 這樣的文本編輯器去反覆工作的過程，稱作“round-trip engineering ”。這也是面向對象變成中的一個基本過程。

• 到主菜單欄中選擇“Tools/Java/Reverse Engineer... ”，可以將現有的代碼逆向工程。
• 選擇Java 代碼所在的目錄，並點擊“Add ”或“Add All ”按鈕，將它們包括在逆向工程過程中，然後單擊“Next ” 。
• 選擇你想將類加入的模塊，這裏可能是“Model1 ”，然後“Next ”。
• 在Option Setup 裏面：
• 確認“public ”，“package ”，“protected ”和“private ”是選中的（這是默認設置）。
• 同樣，在默認情況下，單選按鈕“Create the field to the Attribute ”也是選中的。
• 除非你想SU 創建其他東西，例如佈局很糟糕的包含所有類的圖表，不要選中“Create Overview Diagram ”框。
• 當你對選項做了檢查後，點擊“Run ”。
• SU will now import the classes in the selected files into your model.   Click "Finish" to exit the dialog when it is complete. 蘇現在進口班，在被選定的文件到你需要的產品型號，點擊" 完成" 退出對話框時，就完成了。
• SU 會向你的模塊添加導入的類，但不是你的圖表。爲了將它添加到您的圖，只需要簡單地從Model Explorer 拖動它們即可。