StarUML使用說明-指導手冊

1.綜述

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

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

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

2.安裝

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”。

l            具體的資料類型，在屬性面闆（右下側的視窗） ，由雙打字，在"類型"時段。 在窗體右下邊的Properties面闆中，找到“Type”輸入框，輸入double作為_radius屬性的類型。

l            類的内部資料（域/屬性）都是私有的，因為他們是嚴格由類内部使用的。是以，在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

l            從toolbox中，選擇“Interface”，并點選圖表的某處。将其改名為IShape。建立以後，選中它。

l            在頂部工具欄，選擇 “Stereotype Display” 下拉按鈕，将值改變為“None”。這将改變以往的圓形形狀，使其變為成長方形。

還是在頂部工具欄，取消選中" Suppress Operations "。這将使我們能夠看到接口所擁有的方法。

l            向IShape 接口添加傳回值為double的getArea方法。

n      可以通過右擊interface的圖示，在彈出菜單中點選紅色的“Operation”按鈕，然後輸入getArea。

n      設定傳回值類型。在“Model Explorer”中展開IShape節點，右擊你剛剛建立的getArea方法，并選擇“Add Parameter”。在“Properties”框中，将參數的名子變為空，将“DirectionKind”變為“RETURN”，将“Type”變為dboule。

l            将IShape和getArea的IsAbstract屬性框打上勾，他們在圖示上的名字将變為斜體。這是UML的标準，表示這是接口或者其他純虛實體。

14.添加類和接口的關系

l            可以通過從toolbox中選擇表示“Realization”的箭頭，并從Circle拖拽向IShape，使Circle實作接口IShape。重複同樣的過程，為Rectangle添加實作關系。這是添加了Circle 和 Rectangle對于IShape接口的實作關系。

n      如果想使連接配接線表現為直角的方式，右擊連接配接線，并選擇" Format/Line Style/Rectilinear"菜單。你通過這種方式，使箭頭重疊在一起，可以使你的圖看起來更整潔。

15.添加類基于接口的行為

l        由于Circle和Rectangle類都實作了IShape接口，就必須有同樣的行為(方法)。

n        在“Model Explorer”面闆中，複制getArea法(按Ctrl-C或者右鍵點選并選擇Copy菜單），并粘貼到Circle和Rectangle類。

n        這些實作了的方法在Circle和Rectangle類中都不是抽象的，而是具體的。這是因為他們實際上是執行一些特定行為（例如，為一個圓形和長方形分别計算面積） ，是以不要勾選IsAbstract框。

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

17.添加Pizza類

l        向Pizza添加double型的私有域_price。

l        添加傳回double類型的共有操作getPrice。

18.為Pizza類添加IShape 的引用

l        從toolbox中選擇" DirectedAssociation "箭頭，點選Pizza類，并向IShape拖拽 。

n        選中箭頭，在右邊的“Properties”框上，将name一欄改為“has-a”，“End1.Aggregation” 一欄改為“AGGREGATE”(這個圖示說明Pizza和shape對象是“聚合“的關系)。

n        将“End2.Name”一欄改為_shape 。這樣就自動為Pizza添加一個名字為_shape，使用IShape接口的私有域，的所謂_shape型ishape以pizza餅。

n        将“End2.Visibility”改為私有。

l        為_shape建立一個“獲得者”方法，名字叫做getShape，傳回IShape 。這就是建立一個行為，名字是getShape，傳回IShape 。

19.為pizza類添加構造函數

l        為Pizza添加構造函數，右擊，在彈出的“Add” 菜單中選擇“Operation”。從這裡，增加一個普通的帶有dboule型price參數和IShape類型shape參數的操作

l        增加一個輸入參數，就像之前增加了一個傳回型的輸出參數一樣，你指定的參數的名稱，如價格和形狀等，以及适當的資料類型。

l        為Circle增加一個帶有double型的radius參數的構造函數。

l        為Rectangle增加一個帶有double型width和height參數的構造函數。

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

21.添加Test_Pizza類

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

l        兩個類之間的關系有多種形式。舉例來說，一個類可以執行個體化另一個類，而不是将其作為一個成員。又或，一類的方法可能需要另一個類作為輸入參數，保留一個引用僅僅是為這個方法的執行。

l        通過從toolbox中選擇“Dependency”箭頭，從一個類拖向他是以來的類，來添加不通類之間的依賴關系。在這個例子中，Test_Pizza 依賴于Pizza，Circle和Rectangle類，因為它執行個體化了它們。

l        從Properties box選擇name屬性，或者輕按兩下圖表上的“依賴線”，可以為依賴關系添加标簽。特别的是，當一類執行個體化另一個類，我們會把依賴線叫做“instantiates”。

l        你可以選中并拖動依賴線的标簽，以達到更美觀的效果。

l        依賴關系不會影響代碼生成。

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

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

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

24.儲存項目

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

25.導出

将圖表導出為其他格式，例如圖檔等，是非常有用的。您可以通過選擇“File”菜單的“Export Diagram” ，并且選擇合适的檔案類型來執行改操作。

26.生成Java stub代碼：

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

l        從對話框中選擇你的子產品(這裡可能Model1),點選“Next”。

l        為了使你的子產品或者圖示的所有類都生成stub code，選擇“Select All”然後按“Next”。

l        選擇一個有效的輸出目錄，“Next”。

l        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”。

l        現在StarUML将從你的圖産生代碼，點選“Finish”退出對話框。

l        現在，您可以編輯生成的代碼，以增加應用。

27.添加實作代碼

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

l        使用DrJava添加代碼，為相關的類，.Java檔案添加代碼。  代碼會和你使用HW02是一樣的。（注意：為Test_Pizza些代碼，最好由DrJava自動生成，而非手工在StarUML裡面建立。我們這裡隻是為了說明。）

l        記得那IShape的getArea()方法是抽象的，是以沒有代碼。

l        請您像代碼範例一樣添加注釋。這種注釋是“JavaDoc”風格的。 關于JavaDoc您将會在随後學到更多。

28.逆向工程

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

l        到主菜單欄中選擇“Tools/Java/Reverse Engineer...”，可以将現有的代碼逆向工程。

l        選擇Java代碼所在的目錄，并點選“Add”或“Add All”按鈕，将它們包括在逆向工程過程中，然後單擊“Next” 。

l        選擇你想将類加入的子產品，這裡可能是“Model1”，然後“Next”。

l        在Option Setup裡面：

n        确認“public”，“package”，“protected”和“private”是選中的（這是預設設定）。

n        同樣，在預設情況下，單選按鈕“Create the field to the Attribute”也是選中的。

n        除非你想SU建立其他東西，例如布局很糟糕的包含所有類的圖表，不要選中“Create Overview Diagram”框。

n        當你對選項做了檢查後，點選“Run”。

n        SU will now import the classes in the selected files into your model.   Click "Finish" to exit the dialog when it is complete.蘇現在進口班，在被標明的檔案到你需要的産品型号，點選"完成"退出對話框時，就完成了。

l        SU會向你的子產品添加導入的類，但不是你的圖表。為了将它添加到您的圖，隻需要簡單地從Model Explorer拖動它們即可。

QQ：519841366

本頁版權歸作者和部落格園所有，歡迎轉載，但未經作者同意必須保留此段聲明，

且在文章頁面明顯位置給出原文連結，否則保留追究法律責任的權利