staruml指导手册.docx
《staruml指导手册.docx》由会员分享,可在线阅读,更多相关《staruml指导手册.docx(13页珍藏版)》请在冰点文库上搜索。
![staruml指导手册.docx](https://file1.bingdoc.com/fileroot1/2023-6/14/d5b17603-e5dc-4993-a807-e7c7b9797e8a/d5b17603-e5dc-4993-a807-e7c7b9797e8a1.gif)
staruml指导手册
staruml指导手册
指导手册
原著:
StephenWong翻译:
火猴1.
StarUML是一种生成类图和其他类型的统一建模语言(UML)图表的工具。
这是一个用Java语言描述的创建类图的简明手册。
StarUML(简称SU),是一种创建UML类图,并能够自动生成Java的“stubcode”的工具。
SU也可以做JAVA逆向工程,以产生相应的UML图表。
在本教程中,我们将使用SU设计一个pizza饼。
执行下列步骤,可以创建如下
面所示的UML图。
SU可以生成反映类结构的代码,而不是任何对象的具体行动。
因
此,在使用SU创建图表后,你会为此stubcode添加剩余的功能性代码,填写每种
方法本来应该做的事。
1
2.
首先,我们必须先安装将要使用的软件。
StarUML,是一个开放源码软件,遵
循GPL协议许可(GNU公共许可证),并免费提供下载。
3.
安装以后就可以启动该程序。
4.
然后,一个名叫:
NewProjectByApproach的对话框会弹出。
选择“EmptyProject”
并且按下"确定"。
这里建议你不要勾选"设置为默认的做法"复选框。
2
5.
在右边的“ModelExplorer”框中选定“Untitled”模块。
6.
通过“Model”主菜单,或右击选定的模型,可以"Add/DesignModel"
7.
通过“Model”主菜单,或右击选定模型,可以“AddDiagram/ClassDiagram”:
3
8.profile
通过“Model/Profile...”菜单去设置工程所需的profile。
这决定了工程所使
用的规则和约定。
一定要包含"JAVAPorfile"这一项目。
4
9.
立即就保存工程,这样在出现问题的时候,您就不会丢失信息。
从“File”菜单,选择“Save”,并选择一个地方以保存工程。
你的StarUML
项目现在应该看起来的是这样的:
10.
现在,开始真正创造图表,从默认就在屏幕的左边的“Toolbox”选择“类”
图标,然后左键单击diagram窗口的某处。
这样就使用通用名字创造了一个新的
类。
双击,将类改名为Circle。
11.
右击图中的目标,在弹出菜单中选择“Add”中的“Attribute”(被标示为绿
色),为其添加一个属性(或者域),填入期望的名字“_radius”。
5
具体的数据类型,在属性面板(右下侧的窗口),由双打字,在"类型"时段。
在窗体右下边的Properties面板中,找到“Type”输入框,输入double作
为_radius属性的类型。
类的内部数据(域/属性)都是私有的,因为他们是严格由类内部使用的。
所
以,在Properties面板中将_radius设置为“私有”。
12.
重复同样的过程,添加所谓的名字叫做Rectangle的类和double型的私有成员_width和_height。
(下面者段话是使用方面的主意事项,总感觉翻译部太好,
九原文搬上来了)Youmaynoticeusingthe"ModelExplorer"ontherightis
fastertoaddthese,butdohowevernotethataddingtheclassesand
interfacesthemselvesinthistoolbox(insteadofusingthetoolboxon
theleftandclickingonthepalettetocreatetheobject)willnotcreate
theobjectsinthediagram.
13.IShapeinterface
从toolbox中,选择“Interface”,并点击图表的某处。
将其改名为IShape。
创建以后,选中它。
在顶部工具栏,选择“StereotypeDisplay”下拉按钮,将值改变为“None”。
这将改变以往的圆形形状,使其变为成长方形。
还是在顶部工具栏,取消选中"SuppressOperations"。
这将使我们能够看
到接口所拥有的方法。
6
向IShape接口添加返回值为double的getArea方法。
可以通过右击interface的图标,在弹出菜单中点击红色的“Operation”
按钮,然后输入getArea。
设定返回值类型。
在“ModelExplorer”中展开IShape节点,右击你刚
刚创建的getArea方法,并选择“AddParameter”。
在“Properties”
框中,将参数的名子变为空,将“DirectionKind”变为“RETURN”,将
“Type”变为dboule。
将IShape和getArea的IsAbstract属性框打上勾,他们在图标上的名字将
变为斜体。
这是UML的标准,表示这是接口或者其他纯虚实体。
14.
可以通过从toolbox中选择表示“Realization”的箭头,并从Circle拖拽向IShape,使Circle实现接口IShape。
重复同样的过程,为Rectangle添加实现关系。
这是添加了Circle和Rectangle对于IShape接口的实现关系。
如果想使连接线表现为直角的方式,右击连接线,并选择"Format/Line
Style/Rectilinear"菜单。
你通过这种方式,使箭头重叠在一起,可以使
你的图看起来更整洁。
7
15.
由于Circle和Rectangle类都实现了IShape接口,就必须有同样的行为(方法)。
在“ModelExplorer”面板中,复制getArea法(按Ctrl-C或者右键点击并
选择Copy菜单),并粘贴到Circle和Rectangle类。
这些实现了的方法在Circle和Rectangle类中都不是抽象的,而是具体的。
这是因为他们实际上是执行一些特定行为(例如,为一个圆形和长方形分别
计算面积),所以不要勾选IsAbstract框。
16.
17.Pizza
向Pizza添加double型的私有域_price。
添加返回double类型的共有操作getPrice。
8
18.PizzaIShape
从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.
9
21.Test_Pizza
为了说明UML类图更多的功能,又增加了一个叫做“Test_Pizza”的类,它
用作测试目的,并使用到Pizza和IShape类。
两个类之间的关系有多种形式。
举例来说,一个类可以实例化另一个类,而不是
将其作为一个成员。
又或,一类的方法可能需要另一个类作为输入参数,保留一
个引用仅仅是为这个方法的执行。
通过从toolbox中选择“Dependency”箭头,从一个类拖向他所以来的类,来添
加不通类之间的依赖关系。
在这个例子中,Test_Pizza依赖于Pizza,Circle
和Rectangle类,因为它实例化了它们。
从Propertiesbox选择name属性,或者双击图表上的“依赖线”,可以为依赖
关系添加标签。
特别的是,当一类实例化另一个类,我们会把依赖线叫做
“instantiates”。
你可以选中并拖动依赖线的标签,以达到更美观的效果。
依赖关系不会影响代码生成。
22.23.
你还可以拖动你的类图,并且使箭头以不通的方式展示(使箭头显示为直线,
选择一个箭头,右击它,弹出菜单中选择“LineStyle”,并选择“Rectilinear”)。
你一定要体验这个工具,并去了解它。
24.
在“File”菜单中,选择“Save”。
SU的所有资料只有一个单一的项目文
件,所以你目前应该只有一个文件生成。
25.
将图表导出为其他格式,例如图片等,是非常有用的。
您可以通过选择“File”
菜单的“ExportDiagram”,并且选择合适的文件类型来执行改操作。
10
26.Javastub
点击主菜单的“Tools->Java”菜单,选择“GenerateCode”。
从对话框中选择你的模块(这里可能Model1),点击“Next”。
为了使你的模块或者图标的所有类都生成stubcode,选择“SelectAll”然后
按“Next”。
选择一个有效的输出目录,“Next”。
Inthe"OptionsSetup",besuretocheckboth"GeneratetheDocumentation
byJavaDoc"and"GenerateemptyJavaDoc".Allothercheckboxesshouldbe
unchecked.Thenpress"Next".在“OptionsSetup”,请务必选中“Generate
theDocumentationbyJavaDoc”,“GenerateemptyJavaDoc”,所有其他复
选框不选中,“Next”。
现在StarUML将从你的图产生代码,点击“Finish”退出对话框。
现在,您可以编辑生成的代码,以增加应用。
27.
现在就开始定义程序实际做的事情,例如,为你图标中的类描述添加实现代
码。
使用DrJava添加代码,为相关的类,.Java文件添加代码。
代码会和你使用HW02
是一样的。
(注意:
为Test_Pizza些代码,最好由DrJava自动生成,而非手工
在StarUML里面创建。
我们这里只是为了说明。
)
记得那IShape的getArea()方法是抽象的,因此没有代码。
请您像代码范例一样添加注释。
这种注释是“JavaDoc”风格的。
关于JavaDoc
您将会在随后学到更多。
11
28.
StarUML还可以从现有的Java代码创建一个类图,这被称为“reverse
engineering”,当你想从现有的代码生成图表,或者你修改了SU生成的代码,
并且想在图表中反应出来的时候,逆向工程功能就非常有用了。
通过图表或者
DrJava这样的文本编辑器去反复工作的过程,称作“round-tripengineering”。
这也是面向对象变成中的一个基本过程。
到主菜单栏中选择“Tools/Java/ReverseEngineer...”,可以将现有的代码逆
向工程。
选择Java代码所在的目录,并点击“Add”或“AddAll”按钮,将它们包括在逆
向工程过程中,然后单击“Next”。
选择你想将类加入的模块,这里可能是“Model1”,然后“Next”。
在OptionSetup里面:
确认“public”,“package”,“protected”和“private”是选中的(这
是默认设置)。
同样,在默认情况下,单选按钮“CreatethefieldtotheAttribute”也
是选中的。
除非你想SU创建其他东西,例如布局很糟糕的包含所有类的图表,不要选中
“CreateOverviewDiagram”框。
当你对选项做了检查后,点击“Run”。
SUwillnowimporttheclassesintheselectedfilesintoyour
model.Click"Finish"toexitthedialogwhenitiscomplete.苏现
在进口班,在被选定的文件到你需要的产品型号,点击"完成"退出对话框时,
就完成了。
SU会向你的模块添加导入的类,但不是你的图表。
为了将它添加到您的图,只需
要简单地从ModelExplorer拖动它们即可。
12