EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction

大多数情况下,开发者实现的功能都是被其他模块调用的,如果是对C/C++理解地比较深的读者,应该会知道参数和返回值的传递机制。


UML也提供了这方面的功能,这就是今天的话题:接受调用动作和应答动作。


接受调用动作(AcceptCallAction)


AcceptCallAction是一个接受事件的动作,该动作代表一个同步调用请求的接受。除了一般的参数以外,这个动作产生一个输出,这个输出为ReplyAction提供返回信息,以便把控制返还给调用者。


这个动作是用于同步调用的,如果它被用来处理一个异步调用,则随后的应答动作将会不起作用。


应答动作(ReplyAction)


ReplyAction是一个动作,接受一个返回值集合和一个从AcceptCallAction传过来的返回信息。应答动作把上述信息返回给前面调用的调用者,完成整个调用的执行。



示例


我们还是以解一元二次方程为例说明,这次以更接近于实际开发的方式展现出来。


先看类图

EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction

EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction


首先是Solution类,是一元二次方程的解,我们知道一元二次方程的解有三种情况:两个解,一个解,无解。这里用DoubleSolution,SingleSolution,NullSolution来表现。


接下来就是Calculator类,它有一个方法solveEquation。solveEquation的原型为:


Solution* solveEquation(double a, double b, double c);


这次就以solveEquation为例说明AcceptCallAction和ReplyAction的用法。


添加活动图


右键点击【Project Browser】中的Calculator节点打开上下文菜单,选择【Add】-【Add Diagram...】以后选择添加名为solveEquation的活动图。


添加AcceptCallAction


从工具栏拖动Action图标到活动图并选择AcceptCall以后,双击得到的AcceptCallAction图形打开属性对话框。


打开General属性页,修改名称为solveEquationEntry。


打 开Tiggers属性页,Name栏中输入solveEquation,选择Type为Call。接下来点击Specification栏右侧的 【...】按钮以后,在【Select Operation】对话框中选择Calculator类的solveEquation方法以后按下【确定】按钮。


EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction


按下下图中【Save】按钮以后,按下【确定】按钮。


EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction


右键打开活动图中的AcceptCallAction的上下文菜单,选择【New Child Element】-【ActionPin】,增加a,b,c三个输出引脚。


注:比较理想的状态应该是选择了Trigger以后自动生成a,b,c三个引脚,但是作者还没有找到方法,所以先手动添加。请高手指导。


经过以上的操作,【Project Browser】中的AcceptCallAction节点变成下面这样。

EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction

EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction

拖动returnInfomation引脚到活动图中的AcceptCallAction,并调整引脚位置以后,活动图中的AcceptCallAciton变成下面这样。


EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction


a,b,c对应solveEquation的参数,returnInformation下一步转送给ReplyAction。


添加ReplyAction


从工具栏拖动Action图标到活动图并选择Reply以后,修改名称为Solution。

右键单击AcceptCallAction打开上下文菜单,选择【New Child Element】-【ActionPin】,设定名称为空,Type为Solution*。


从【Project Browser】中的ReplyAction节点拖动returnInfomation引脚到活动图中的ReplyAction,并调整引脚位置以后,活动图中的ReplyAciton变成下面这样。


EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction


用法总结


补齐其他的处理以后,得到如下的活动图·。


EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction


在这个例子中,solveEquationEntry动作代表一个同步调用请求的接受。除了一般的参数a,b,c以外,这个动作产生一个输出returnInformation,这个输出为ReplyAction提供返回信息,以便把控制返还给调用者。


ReplySolution动作接受返回值Solution*和从AcceptCallAction传过来的returnInformation返回信息并把上述信息返回给前面调用的调用者,完成整个调用的执行。


关于示例


虽然作者多方努力,还是没有找到有关于AcceptCallAction,ReplyAction的有意义的参考示例。这里的例子可以说是作者根据自己的理解尝试着画出的。算是抛砖引玉吧。


以上就是今天的文章,如果它能给您带来些许收获,欢迎点赞并推荐给您的朋友!
阅读更多更新文章,请扫描下面二维码,关注公众号【面向对象思考】!
EA&UML日拱一卒-活动图::AcceptCallAction和ReplyAction