usecase(用例)是一个uml中非常重要的概念,在使用uml的整个软件开发过程中,usecase处于一个中心地位。
那么,到底什么是usecase呢?在uml的文档中,usecase的定义是:在不展现一个系统或子系统内部结构的情况下,对系统或子系统的某个连贯的功能单元的定义和描述。有点拗口,对吧?其实usecase就是对系统功能的描述而已,不过一个usecase描述的是整个系统功能的一部分,这一部分一定要是在逻辑上相对完整的功能流程。(唔?usecase也没什么特别的嘛!怎么这玩意儿会在开发中处于一个中心地位呢?)在使用uml的开发过程中,需求是用usecase来表达的,界面是在usecase的辅助下设计的,很多类是根据usecase来发现的,测试实例是根据usecase来生成的,包括整个开发的管理和任务分配,也是依据usecase来组织的。啊,usecase,简直太重要了!好了,usecase就吹到这儿,具体的使用还要在实践中去体会,“运用之妙,存乎一心”也!
对于每个actor来说,他都要使用系统的某项功能,所以我们识别和分析usecase是,要对于每个actor来逐个进行。对于todouser,我们可以轻易的识别出两个usecase:addtask和removetask。todouser主动使用这两个usecase所描述的系统功能,所以在我们的usecase图上,todouser和这两个usecase的关系是用从todouser发出的箭来表示的。对于filesystem,我们识别出的也是同样的两个usecase,不过这次箭头从usecase指向filesystem,表示filesystem是被动的。
usecase可以用很多方式来描述,我们可以用自然语言(英语,汉语,随您的便),可以用形式化语言(哇!太酷了吧!),也可以用各种图示。在uml中,通常用两种图来描述usecase,它们就是顺序图(sequencediagram)和协作图(collaborationdiagram)
usecase由以下元素组成:
名称
简单描述
事件流
关系
活动图和状态图
usecase图
特殊需求
前条件
后条件
一、谈谈对usecase有关术语翻译的看法。
笔者认为“用例”是目前较好的译法,这个词可能来源于大家熟知的“测试用例”。有人认为把usecase翻译成“用例”是错误的,理由是:“‘例’是被列举出来以说明某种情况的个别事物,usecase是对一项系统功能使用情况的普遍适应的描述,而不是对个别actor或者在个别条件下使用这项功能才适应,它也不是通过举例的方式来描述的”,所以不能叫作“用例”。此种说法不尽全面,而且有些牵强(先不管它正确与否),其实usecase到底是个别的,还是群体的(普遍适应),取决于我们的视点。虽然对于单个的scenario来说,usecase是多个情节的叠加,是一个整体的复合概念,但是我们知道,一个系统的功能必定是可数的、有限的,而每一个功能都可以表示为一个usecase,所以在观察系统提供的所有功能需求的集合这个层面上,usecase又是一个一个可数的个体(“椭圆”),每一个都代表了不同的用户目标,适用于个别的actor和个别特定的前置条件。同一个事物既是个体的又是整体的,这种现象并不足怪,例如在uml对象-类-类元关系中,通常对象是类的实例,而类又是类元的实例,对类元来说,类、接口、子系统、usecase等等就是一个个个体的概念,类既是其对象实例的集合又是其类元集合的个别元素。可见,把usecase的“case”译成“例”并没有错。
有的地方把usecase翻译成“用况”,即“使用的情况”之意,意思的确不错(usecase的另一种说法是“使用的方式”)!可我总感觉这个词比较突兀、拗口,类似的还有“用案”,把scenario叫作“案况”,大概这些词读起来不太符合大家的习惯(类似地,既然可以叫“用况”,为什么不能叫“用情”呢?),所以现在“用例”的叫法还是越来越多了。
其实“用例”这个译法还有个附带的好处,通过它我们很容易把原本就存在紧密联系的usecase和testcase(testcase来自于对scenario的分析,而scenario是用例的一次执行)从中文名称上也方便地统一起来。不过,这里我们需要做一个小小的改进。中文的“测试用例”到底是指testcase(带定语的名词词组)呢,还是指对用例进行测试(testingtheusecases,动宾词组)呢?显然这两者不易分辨,而且若“用例”和“测试用例”两个词同时出现在一啰个句子或一段话中,常常会让人感觉嗦和便扭。为了消除歧义,干脆以后把testcase都叫做“测例”,这样不但比以前的叫法更加简洁明了,而且无论字面上还是语义上都很贴切。当然,用例和测例是不同层面的“例”。
现在市面上actor也有多种译法,常见的包括“参与者、执行者、主角”等等。“参与者、执行者”的问题主要是不准确。首先,“参与者”通常让大家马上想到的词是participant,而且请注意,一个用例的真正参与者决不是只有外部的actor,它们必然还包括系统本身及其内部的各种元素。“执行者”的问题与此类似:一个用例的真正执行者应该是系统本身!因此严格地讲这样译是错误的,兴许叫作“外部参与者”、“外部执行者”才更为恰当。“主角”的译法同样存在着矛盾。如果把actor叫作“主角”,那么primaryactor就应该叫作“主主角”了。看来actor的译法中是不能含有“主”的,那么就剩下“角”了,而uml已经有了一个专门术语role(角色),我们又不能把actor直接叫作“角色”。
目前看来,把actor意译成“使用者”是比较妥当的。在大多数情况下actor的的确确就是用户(确切地说是系统用户所扮演的一种角色),所以我们可以用“使用者”这个词从字面上与“用户”(user)进行区分,但同时又保持两者语义上的联系。我们还可以把为系统服务的supporting/secondaryactor(见下文)叫做“被使用者”(为了简化可以省略“被”字)或“辅使用者”。除了指系统的用户之外,“使用者”还有另一层含义,即actor是usecase的使用者(或被使用者),这种关系在uml用例图上应该可视化地表示为它们之间的连线(关联)。这样解释不但说的通,而且更便于不熟悉软件技术的业务人员理解。
当然,我们也不排除将来会找到“usecase”、“actor”等术语更好的译法。
二、usecase的来历
ivarjacobson在1967年定义爱立信axe系统的够架时开始书写使用场境usagescenarios。
二十世纪八十年代中期jacobson花了很多精力来思考过去十多年的工作方法。他造了一个术语anvendningsfall,大意是“使用情况”(situationofusage)或用况(usagecase)。但当用英文出版的时候,他发现“useagecase”在英语里说不通,所以写作用例“usecase”
三、创建usecase的原则
用例是短文
用例可以是一个场景,包括动作和互交。
用例可以是一组场景,描述不同场景下的行为。这种书写格式可以在任何时候描述有变体的行为,例如黑盒需求,业务流程,系统设计说明。
用例里不要有系统设计
用例里不要有界面设计
用例里不要有特性列表
用例里不要有测试
用例应该描述行为需求
用例的主场景不要超过九步。可以在适当的层次上得到子目标和移除设计说明。
用例的最大价值不在于主场景,而是在于备选行为。主场景可能只占用例长度的四分之一到十分之一。
四、usecase事件流
usecase具有一个基本事件流(可称为"理想路径")、多个例外流,包括:
基本变化
特殊情况
处理错误情况的异常事件流
五、usecase说明书
usecase说明书应包括以下内容:
功能描述
可用性
可靠性
性能
可支持性
设计约束
六、usecases将做成多大?
试图决定usecase的大小是一个很有趣的话题,处理这件事的一个方法是将usecase的大小跟它的意图和范围关联起来,对于一个真正大的范围来说,一个usecase并不要在一个系统中处理那么多,但这些系统都用于同一商业领域,称为businessusecase,它把整个公司看作一个黑盒和actor关于公司目标的说明。这些businessusecase的场景不允许假定任何公司内部的结构,一个客户将向公司下一个定单而不是客户服务部门。
对于系统发展而言,usecase的范围限制一个单一的系统,这是usecases最通常的形式,我们称之为systemusecase,它把整个系统看作是一个黑盒,它不指定任何内部结构并且仅受限于问题域的语言描述。
usecases的另一范围是设计子系统和系统内部组件的,称为implementationusecases,它把组件看作一个黑盒,并且这些actors是区分它的成员。例如:可能会用implementationusecases去说明应用系统中email组件的需求。
给出了这些分类,关于usecase的大小话题变得容易了,设计这些项的范围来调整整个大小。帮助系统设计者,每个usecase只描述没有大的分支的行为的单个线索。违背这个规定,usecase看起来通常是不准确的或含糊的,作为测试说明的资源和参考,它也是很难使用的。
七、usecases的说明
usecases的好处是一些情节能用不同程度的正规化的文字说明。每个情节涉及usecases中单一的途径,细节是条件组。
不正规的文本描述也能使用,不过当条件较多和可能失败的情况下它们很难跟随下去。开始试图理解需求时,不正规的叙述风格也是非常有用的,然而随着usecases的进展,使用更加正规的机制去说明usecases才是有用的。
下面是客户对usecase“下定单”的粗略概略:
“确定客户,找出需要的并且仓库里还有的物品并检查客户信用额是否够用”
结构化叙述的格式已经被证明是非常有效的。这个格式所做的事是描述每一个情节的行为者:目标语句对顺序的叙述。在这个顺序中,每一个行为者:目标的语句对都假设前一个的目标是成功的,右面是一个简单的范例:
usecases认为我们正在设计的系统是一个单一的黑盒,根本没有任何内部结构被记录下来,并且它被认为是一个情节产生的目的及对应单一的行为者(actor)。这些usecases没有表示任何关于系统内部的东东,只是表示系统将达到什么样的目标及由什么(人或其它系统)操作和负责。
八、usecases使需求有利于回顾
usecases已经得到越来越广泛的应用,它与其它需求捕获技术相比,它成功的原因在于:
1usecases把系统当作一个黑盒
2usecase使在需求中看到实现的决定变得更加容易
最后一点源于第一点的补充,一个usecase没有指定任何这些需求相关的系统的内部结构,所以说,如果这个usecase中陈述了"提交改变到定单数据库"、"显示结果到web页面"等的话,那么内部结构是显而易见的,并造成对设计的潜在约束。
为什么这些需求不指定内部结构的原因是,说明的内部结构给设计者带来了额外的约束,没有这些约束设计者们能更自由地建立一个正确实现客观可见行为的系统,并存在出现突破方案的可能性。
九、usecases的图形符号
这里是usecases的图形符号描述,uml中一个单一的"stick-man"符号标示角色(actor),用椭圆标示usecases,如
(图一)所示。这些图对于你想看到usecases之间如何关联的"大图"和获得系统上下文的大体描述来说是非常重要的。
usecases图没有显示不同的场景,它们的意图是显示角色和usecases之间的关系。所以usecases图需求用结构化叙述文本来补充。uml提供一些可供选择的图来显示不同的场景,这些常规的图形有交互图、活动图、顺序图、状态图等(本文暂不讨论这些图)。使用这些图的主要缺点是它们不象文本一样是紧密的,但它们能用于给出usecase的整体感觉。
十、usecase的评价标准
是否每个usecase都包括至少一个actor?
是否每个usecase都独立于其他usecase?
是否每个usecase都有一个简单的行为或事件流?
是否每个usecase都有一个唯一的、直观的、可扩展的名称,使它不至于在后期被混淆。
用户是否容易理解usecase的名称和描述。
十一、usecase模型的评价标准
usecase模型显示系统中的usecase与actor及其相互关系。其评价标准有:
usecase模型是可理解的吗?
通过对usecase模型的研究是否能对系统功能有一个清晰的概念。
所有的actor都定义了吗?所有的功能需求都满足了吗?
usecase模型是否存在多余的行为。
从模型到usecase包的划分是否是恰当的。
十二、使用usecase的误区
由于具有简单的图形符号、易理解的自然语言说明书,usecase在文档系统和软件需求领域成为一项越来越受欢迎的技术。usecase对开发小组极具吸引力,即使小组成员对正式的需求文档没有经验,但这些简单性却具有欺骗性,即使项目小组在开始使用usecase时没有任何麻烦,当他们将其应用于大项目时常常会遇到许多同样的问题。
1使用usecase十大误区
1.系统的boundary没有定义或经常改变;
2.从系统观点而不是actor观点来定义usecase;
3.actor的名称不一致;
4.usecase定义过多;
5.usecase和actor之间的关系象蜘蛛网一样错综复杂;
6.usecase的说明太长;
7.usecase的说明不清楚;
8.usecase没有正确的描述功能需求;
9.用户无法理解usecase;
10.usecase无法正常结束。
2如何避免以上问题
清楚的确定系统的boundary.
简单来说,系统的boundary就像一个加了标签的盒子,actor在盒子外,而usecase在盒子内。我们称之为系统的这个盒子究竟是什么呢?一个计算机系统?一个应用系统?或一个完整的企业?…usecase可以用来合理地描述任意系统。但一次只能用来描述一个系统,在一个系统中恰当定义的actor和usecase用于另一个不同的系统中就会出现错误。
使用标准模板书写usecase说明书
usecase图形符号已经被标准化并作为对象管理小组uml的一部分,但自然语言的usecase说明书还没有被标准化。为了成功书写usecase说明书,我们需要一个标准模板来保证usecase的一致性。
关注actor的真正目的,从actor的观点而不是系统观点来命名usecase
面向usecase的需求与传统的功能性系统需求之间最显著的区别在于actor,以面向usecase的观点,系统存在是由于actors要通过该系统实现某些目标,actor与系统进行交互来实现其目标,我们将这些交互行为定义为usecase。
不要将usecase说明书与用户接口设计相混淆
现在有一种很流行的观点:由于usecase是actors与系统之间的交互,所以将所有的用户接口设计图放在usecase说明书中是一个好办法。初看时,这的确很有用,因为它将在说明书中描述的actor/系统之间的交互行为以图的形式表示出来,非常直观。但是这样做的负面影响却远远大于其好处,用户接口设计可能会随着时间而改变,我们不应该让系统需求依赖于用户接口设计,相反地,用户接口设计应该满足usecase需求。如果我们将用户接口设计置于usecase说明书中,当需求需要被认可和定为基线时,很自然地,这些设计元素可能仍然在改变,这就使得用户接口设计成为不完整的、不正确的和/或不一致的。
将用户接口设计置于usecase说明书还会出现另一个问题,为了在usecase之间和接口之间建立一对一的通信,我们会选择反映用户接口的usecase块而不是反映用户目标的usecase块,这样,为了表达一个完整的用户目标,我们使用交互usecase关系,将不同的、基于用户接口的usecase联接起来,结果在usecase模型中,我们得到了一幅类似蜘蛛网的关系图。实际上,这副图是用户接口说明图,虽然它在系统文档中是很重要的一部分,但他属于用户接口设计文档,而不是usecase需求文档。
实现用户接口和usecase交互之间的松散耦合
松散耦合是比较合适的,低逼真度的用户接口图有助于理解usecase,但要注意不要过度的将基本交互与用户界面机制相连,用户界面很有可能会改变。在功能说明书中,要注意actor做些什么(如"提交请求")而不是交互是怎样完成的(如"双击提交按钮")。
不要在usecase和用户接口之间建立通信
试图在usecase和用户接口之间建立通信可能会存在潜在的、不正确的功能操作。usecase不仅与只能访问某个接口的actor相联,而且与那些能够更新该接口的actors相连(这可能是例外流),结果就造成了不正确的功能操作。我们应该在基于实际用户目标和功能操作的基础上拆分usecase,而不是在基于用户接口的基础上组合usecase,只有这样才能得到正确的usecase模型。
回顾usecase模型和usecase说明书,如果你不能防止所有的误区,你应该尽早认识问题并确定问题
这个观点并不是什么新东西,有关代码检查的经典算法已有大约25年历史了,但怎样将其应用于usecase呢?首先,回顾usecase模型,回顾一下usecase的简单说明(usecase名称、目标、简单描述)。这项工作应在绘制草图时尽早执行,并在写详细的usecase说明书之前完成。接着是回顾usecase草图,保证图是正确的,并且详细的usecase说明书是完整的。最后是正式回顾最终的usecase图和usecase说明书。
我们发现这种三阶段式回顾比单一的"宇宙大爆炸"式回顾有效,在我们花大量的时间写说明书之前,usecase图中存在的许多实质性问题可以被发现,这种方法减少了当需求改变时需要做的重复工作。
十三、usecases应用当中的复杂性和危险
主要行为者(actor)和usecase之间没有连结
一些情况下,从usecase中取值的行为者(actor)和积极参与这个usecase的行为者(actor)之间没有清晰的连结。如:财务主管能成为“发票确认”的行为者(actor),但他未必是创建发票的人。这不是什么问题,这个usecase仍然是正确的,它正说明行为者取值和设计的系统的范围外的usecase发生的初始化之间的关系。主要行为者是有用的,因为这个人扮演的角色是当你说明usecase时需要跟他说的人。
情节步骤不需要连续
情节中步骤顺序的情况是没问题的,这里有一些机制去突出可能的并行步骤。在uml中活动图是首选的机制,通过非正式地看usecase的情节你可以注意到可能的平行步骤;可以看usecase内一些邻近的步骤;也可以有相同的行为者(actor)对步骤负责。之前我们举过的例子里,确认数量和确认信用额可能是平行的。有时候在usecase的说明文档中标记这些可能的平行步骤是有用的。
usecases的大小
当开始做usecases的时候有个很显然的危险就是它要么有很多步骤要么就很少步骤。如果在usecase中有超过15个步骤,它可能包含一些实现明细。如果它只有非常少的步骤则检查它的目标是否是达到一个没有很多分支的活动的单一线索。
较少的人类行为者(actor)
如果usecase有较少的人类行为者,而大多数行为者是其它系统,通常的做法是修改这个usecase。寻找系统必须做出反映或公认的事件胜过会见这些行为者。
需求捕获和系统复杂性
总而言之,这些情节捕获到系统复杂度的同时行为者:目标语句对容许大的系统以相对压缩的格式说明。usecase的格式的作用是用户和开发者能标志出行为者,然后确认这些行为者工作职责对应(或不对应)的目标,代替一个大的很难读的功能规格说明书。
仅仅这样,用户和开发者就有足够的兴趣进而研究那些情节的细节。
系统不仅仅有应得的功能性需求
一些usecases并没有捕获所有的客观需求,仅仅是捕获了系统怎么用的那些功能性需求。然而还有许多方面的需求需要去捕获的。其中有的非功能性需求使用关联以至于也能隶属于个别的usecase,如性能需求和系统容量的需求。另外的一些不是关联的而是要单独地去捕获,它们是以下的需求:
·系统范围
·系统用户的目标
·用户界面原型
·一般规则
·约束
·算法
运行时期和建立时期的需求比较
一个重要的因数要记住,就是系统的赞助者是大过用户团体的。系统中有许多的风险承担者,usecases仅仅捕获其中一些风险承担者的需要,具体说,usecases仅仅捕获系统运行时期的需求而忽略做为系统开发组织的风险承担者的需求,开发组织最有兴趣的是对建立时期需求的描述。
运行时期需求包括:系统范围、用户组织对产品的期望和目标、usecases、其它非功能性需求。
建立时期需求包括:减少开发成本、较少的变更处理、现存组件的重用。
建立时期的需求可以部分的由usecases把握。但许多方面是需要由开发组织的处理的。
·项目范围和目标:项目必须提交什么。(和系统范围的区别是它提交的是所有项目的东西)
·增长性和变更请求:这些可以在捕获为常规usecases格式中的“changecases”
·开发负责人的约束:包括标准、习惯、工具、品质度量标准、品质保证原则、及品质保证的习惯。
十四、usecases的适用性
usecases首先用于需要响应客观事件的系统。它们能用于提供了一个有很容易理解的目标的清楚的行为者的环境。当结果不可定义或不清晰时不能用usecases。意思是如果目标成功或目标失败不能有一个明确的定义,那么usecases不能用来捕获需求。
然而说到这,现在大部分对象方法都使用usecases。因为usecases被证明是捕获需求的非常有效的机制。
十五、小结
usecase是系统提供的功能块,换句话来说usecase演示了人们如何使用系统。通过usecase观察系统,能够将系统实现与系统目标分开,有助于了解最重要的部分╠╠满足用户要求和期望,而不会沉浸于实现细节。通过usecase用户可以看到系统提供的功能,先确定系统范围再深入开展项目工作。