StarUML使用說(shuō)明-指導(dǎo)手冊(cè)

原著：Stephen Wong ???????????翻譯：火猴

1.綜述

StarUML是一種生成類(lèi)圖和其他類(lèi)型的統(tǒng)一建模語(yǔ)言(UML)圖表的工具。這是一個(gè)用Java語(yǔ)言描述的創(chuàng)建類(lèi)圖的簡(jiǎn)明手冊(cè)。

StarUML(簡(jiǎn)稱(chēng)SU)，是一種創(chuàng)建UML類(lèi)圖，并能夠自動(dòng)生成Java的“stub code” 的工具。SU也可以做JAVA逆向工程，以產(chǎn)生相應(yīng)的UML圖表。

在本教程中，我們將使用SU設(shè)計(jì)一個(gè)pizza餅。執(zhí)行下列步驟，可以創(chuàng)建如下面所示的UML圖。SU可以生成反映類(lèi)結(jié)構(gòu)的代碼，而不是任何對(duì)象的具體行動(dòng)。因此，在使用SU創(chuàng)建圖表后，你會(huì)為此stub code添加剩余的功能性代碼，填寫(xiě)每種方法本來(lái)應(yīng)該做的事。

?

2.安裝

首先，我們必須先安裝將要使用的軟件。StarUML ，是一個(gè)開(kāi)放源碼軟件， 遵循GPL協(xié)議許可（GNU公共許可證） ，并免費(fèi)提供下載。

3.啟動(dòng)

安裝以后就可以啟動(dòng)該程序。

4.添加新工程

然后，一個(gè)名叫：New Project By Approach的對(duì)話框會(huì)彈出。選擇“Empty Project”并且按下"確定"。這里建議你不要勾選"設(shè)置為默認(rèn)的做法" 復(fù)選框。

5.選擇模塊

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

6.添加模塊

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

7.添加類(lèi)圖

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

8.設(shè)置profile

通過(guò)“Model/Profile...”菜單去設(shè)置工程所需的profile。這決定了工程所使用的規(guī)則和約定。一定要包含"JAVA Porfile"這一項(xiàng)目。

9.保存工程

立即就保存工程，這樣在出現(xiàn)問(wèn)題的時(shí)候，您就不會(huì)丟失信息。

從“File ”菜單，選擇“Save” ，并選擇一個(gè)地方以保存工程。你的StarUML項(xiàng)目現(xiàn)在應(yīng)該看起來(lái)的是這樣的：

10.創(chuàng)造圖表

現(xiàn)在，開(kāi)始真正創(chuàng)造圖表，從默認(rèn)就在屏幕的左邊的“Toolbox”選擇“類(lèi)”圖標(biāo)，然后左鍵單擊diagram窗口的某處。這樣就使用通用名字創(chuàng)造了一個(gè)新的類(lèi)。雙擊，將類(lèi)改名為Circle。

11.添加屬性

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

l??????????? 具體的數(shù)據(jù)類(lèi)型，在屬性面板（右下側(cè)的窗口） ，由雙打字，在"類(lèi)型"時(shí)段。 在窗體右下邊的Properties面板中，找到“Type”輸入框，輸入double作為_(kāi)radius屬性的類(lèi)型。

l??????????? 類(lèi)的內(nèi)部數(shù)據(jù)（域/屬性）都是私有的，因?yàn)樗麄兪菄?yán)格由類(lèi)內(nèi)部使用的。所以，在Properties面板中將_radius設(shè)置為“私有”。

12.繼續(xù)進(jìn)行設(shè)計(jì)

重復(fù)同樣的過(guò)程，添加所謂的名字叫做Rectangle的類(lèi)和double型的私有成員_width和_height。 (下面者段話是使用方面的主意事項(xiàng)，總感覺(jué)翻譯部太好，九原文搬上來(lái)了)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.創(chuàng)造 IShape interface

l??????????? 從toolbox中，選擇“Interface”，并點(diǎn)擊圖表的某處。將其改名為IShape。創(chuàng)建以后，選中它。

l??????????? 在頂部工具欄，選擇 “Stereotype Display” 下拉按鈕，將值改變?yōu)椤癗one”。這將改變以往的圓形形狀，使其變?yōu)槌砷L(zhǎng)方形。

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

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

n????? 可以通過(guò)右擊interface的圖標(biāo)，在彈出菜單中點(diǎn)擊紅色的“Operation”按鈕，然后輸入getArea。

n????? 設(shè)定返回值類(lèi)型。在“Model Explorer”中展開(kāi)IShape節(jié)點(diǎn)，右擊你剛剛創(chuàng)建的getArea方法，并選擇“Add Parameter”。在“Properties”框中，將參數(shù)的名子變?yōu)榭?#xff0c;將“DirectionKind”變?yōu)椤癛ETURN”，將“Type”變?yōu)閐boule。

l??????????? 將IShape和getArea的IsAbstract屬性框打上勾，他們?cè)趫D標(biāo)上的名字將變?yōu)樾斌w。這是UML的標(biāo)準(zhǔn)，表示這是接口或者其他純虛實(shí)體。

14.添加類(lèi)和接口的關(guān)系

l??????????? 可以通過(guò)從toolbox中選擇表示“Realization”的箭頭，并從Circle拖拽向IShape，使Circle實(shí)現(xiàn)接口IShape。重復(fù)同樣的過(guò)程，為Rectangle添加實(shí)現(xiàn)關(guān)系。這是添加了Circle 和 Rectangle對(duì)于IShape接口的實(shí)現(xiàn)關(guān)系。

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

15.添加類(lèi)基于接口的行為

l??????? 由于Circle和Rectangle類(lèi)都實(shí)現(xiàn)了IShape接口，就必須有同樣的行為(方法)。

n??????? 在“Model Explorer”面板中，復(fù)制getArea法(按Ctrl-C或者右鍵點(diǎn)擊并選擇Copy菜單），并粘貼到Circle和Rectangle類(lèi)。

n??????? 這些實(shí)現(xiàn)了的方法在Circle和Rectangle類(lèi)中都不是抽象的，而是具體的。這是因?yàn)樗麄儗?shí)際上是執(zhí)行一些特定行為（例如，為一個(gè)圓形和長(zhǎng)方形分別計(jì)算面積） ，所以不要勾選IsAbstract框。

16.你的圖現(xiàn)在應(yīng)該是這樣的：

17.添加Pizza類(lèi)

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

l??????? 添加返回double類(lèi)型的共有操作getPrice。

18.為Pizza類(lèi)添加IShape 的引用

l??????? 從toolbox中選擇" DirectedAssociation "箭頭，點(diǎn)擊Pizza類(lèi)，并向IShape拖拽 。

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

n??????? 將“End2.Name”一欄改為_(kāi)shape 。這樣就自動(dòng)為Pizza添加一個(gè)名字為_(kāi)shape，使用IShape接口的私有域，的所謂_shape型ishape以pizza餅。

n??????? 將“End2.Visibility”改為私有。

l??????? 為_(kāi)shape創(chuàng)建一個(gè)“獲得者”方法，名字叫做getShape，返回IShape 。這就是創(chuàng)建一個(gè)行為，名字是getShape，返回IShape 。

19.為pizza類(lèi)添加構(gòu)造函數(shù)

l??????? 為Pizza添加構(gòu)造函數(shù)，右擊，在彈出的“Add” 菜單中選擇“Operation”。從這里，增加一個(gè)普通的帶有dboule型price參數(shù)和IShape類(lèi)型shape參數(shù)的操作

l??????? 增加一個(gè)輸入?yún)?shù)，就像之前增加了一個(gè)返回型的輸出參數(shù)一樣，你指定的參數(shù)的名稱(chēng)，如價(jià)格和形狀等，以及適當(dāng)?shù)臄?shù)據(jù)類(lèi)型。

l??????? 為Circle增加一個(gè)帶有double型的radius參數(shù)的構(gòu)造函數(shù)。

l??????? 為Rectangle增加一個(gè)帶有double型width和height參數(shù)的構(gòu)造函數(shù)。

20.你的圖現(xiàn)在應(yīng)該是這樣的：

?

?

21.添加Test_Pizza類(lèi)

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

l??????? 兩個(gè)類(lèi)之間的關(guān)系有多種形式。舉例來(lái)說(shuō)，一個(gè)類(lèi)可以實(shí)例化另一個(gè)類(lèi)，而不是將其作為一個(gè)成員。又或，一類(lèi)的方法可能需要另一個(gè)類(lèi)作為輸入?yún)?shù)，保留一個(gè)引用僅僅是為這個(gè)方法的執(zhí)行。

l??????? 通過(guò)從toolbox中選擇“Dependency”箭頭，從一個(gè)類(lèi)拖向他所以來(lái)的類(lèi)，來(lái)添加不通類(lèi)之間的依賴(lài)關(guān)系。在這個(gè)例子中， Test_Pizza 依賴(lài)于Pizza，Circle和Rectangle類(lèi)，因?yàn)樗鼘?shí)例化了它們。

l??????? 從Properties box選擇name屬性，或者雙擊圖表上的“依賴(lài)線”，可以為依賴(lài)關(guān)系添加標(biāo)簽。特別的是，當(dāng)一類(lèi)實(shí)例化另一個(gè)類(lèi)，我們會(huì)把依賴(lài)線叫做“instantiates”。

l??????? 你可以選中并拖動(dòng)依賴(lài)線的標(biāo)簽，以達(dá)到更美觀的效果。

l??????? 依賴(lài)關(guān)系不會(huì)影響代碼生成。

22.你的圖現(xiàn)在應(yīng)該像本文最開(kāi)始所示。

23.對(duì)你的圖隨意做些修改。

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

24.保存項(xiàng)目

在“File”菜單中，選擇“Save”。 SU的所有資料只有一個(gè)單一的項(xiàng)目文件，所以你目前應(yīng)該只有一個(gè)文件生成。

25.導(dǎo)出

將圖表導(dǎo)出為其他格式，例如圖片等，是非常有用的。您可以通過(guò)選擇“File”菜單的“Export Diagram” ，并且選擇合適的文件類(lèi)型來(lái)執(zhí)行改操作。

26.生成Java stub代碼：

l??????? 點(diǎn)擊主菜單的“Tools->Java”菜單，選擇“Generate Code”。

l??????? 從對(duì)話框中選擇你的模塊(這里可能Model1),點(diǎn)擊“Next”。

l??????? 為了使你的模塊或者圖標(biāo)的所有類(lèi)都生成stub code，選擇“Select All”然后按“Next”。

l??????? 選擇一個(gè)有效的輸出目錄，“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” ，請(qǐng)務(wù)必選中“Generate the Documentation by JavaDoc”，“Generate empty JavaDoc”，所有其他復(fù)選框不選中，“Next”。

l??????? 現(xiàn)在StarUML將從你的圖產(chǎn)生代碼，點(diǎn)擊“Finish”退出對(duì)話框。

l??????? 現(xiàn)在，您可以編輯生成的代碼，以增加應(yīng)用。

27.添加實(shí)現(xiàn)代碼

現(xiàn)在就開(kāi)始定義程序?qū)嶋H做的事情，例如，為你圖標(biāo)中的類(lèi)描述添加實(shí)現(xiàn)代碼。

l??????? 使用DrJava添加代碼，為相關(guān)的類(lèi)，.Java文件添加代碼。 ?代碼會(huì)和你使用HW02是一樣的。（注意：為T(mén)est_Pizza些代碼，最好由DrJava自動(dòng)生成，而非手工在StarUML里面創(chuàng)建。我們這里只是為了說(shuō)明。）

l??????? 記得那IShape的getArea()方法是抽象的，因此沒(méi)有代碼。

l??????? 請(qǐng)您像代碼范例一樣添加注釋。這種注釋是“JavaDoc”風(fēng)格的。 關(guān)于JavaDoc您將會(huì)在隨后學(xué)到更多。

28.逆向工程

StarUML還可以從現(xiàn)有的Java代碼創(chuàng)建一個(gè)類(lèi)圖，這被稱(chēng)為“reverse engineering”，當(dāng)你想從現(xiàn)有的代碼生成圖表，或者你修改了SU生成的代碼，并且想在圖表中反應(yīng)出來(lái)的時(shí)候，逆向工程功能就非常有用了。通過(guò)圖表或者DrJava這樣的文本編輯器去反復(fù)工作的過(guò)程，稱(chēng)作“round-trip engineering”。這也是面向?qū)ο笞兂芍械囊粋€(gè)基本過(guò)程。

l??????? 到主菜單欄中選擇“Tools/Java/Reverse Engineer...”，可以將現(xiàn)有的代碼逆向工程。

l??????? 選擇Java代碼所在的目錄，并點(diǎn)擊“Add”或“Add All”按鈕，將它們包括在逆向工程過(guò)程中，然后單擊“Next” 。

l??????? 選擇你想將類(lèi)加入的模塊，這里可能是“Model1”，然后“Next”。

l??????? 在Option Setup里面：

n??????? 確認(rèn)“public”，“package”，“protected”和“private”是選中的（這是默認(rèn)設(shè)置）。

n??????? 同樣，在默認(rèn)情況下，單選按鈕“Create the field to the Attribute”也是選中的。

n??????? 除非你想SU創(chuàng)建其他東西，例如布局很糟糕的包含所有類(lèi)的圖表，不要選中“Create Overview Diagram”框。

n??????? 當(dāng)你對(duì)選項(xiàng)做了檢查后，點(diǎ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.蘇現(xiàn)在進(jìn)口班，在被選定的文件到你需要的產(chǎn)品型號(hào)，點(diǎn)擊"完成"退出對(duì)話框時(shí)，就完成了。

l??????? SU會(huì)向你的模塊添加導(dǎo)入的類(lèi)，但不是你的圖表。為了將它添加到您的圖，只需要簡(jiǎn)單地從Model Explorer拖動(dòng)它們即可。 創(chuàng)作挑戰(zhàn)賽新人創(chuàng)作獎(jiǎng)勵(lì)來(lái)咯，堅(jiān)持創(chuàng)作打卡瓜分現(xiàn)金大獎(jiǎng)

總結(jié)

以上是生活随笔為你收集整理的StarUML使用说明-指导手册的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。