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

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

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

接受调用动作(AcceptCallAction)

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

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

应答动作(ReplyAction)

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

示例

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

先看类图

首先是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方法以后按下【确定】按钮。

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

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

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

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

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

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

添加ReplyAction

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

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

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

用法总结

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

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

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

关于示例

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