TTCN中PTC的运行流程

一些概念

Component（测试组件或者测试成分），TTCN接触下来最频繁的就是MTC（Main Test Component,主测试组件），在执行测试用例前，需要首先创建一个MTC，在testcase运行过程中，只能有唯一的MTC。如果没有指明testcase需要runs on在某个Component，系统默认的component就是MTC。在testcase代码中，不能控制MTC的建立与停止。

非主测试组件的测试组件叫PTC（ParallelTest Component, 并行测试组件）, PTC是由testcase控制的，最后由系统销毁。testcase可以执行create，start，stop等操作 。

简单说，一个PTC就可以理解为TTCN模拟出来的一台远程主机的进程。通过它，模拟出其他主机实现并行测试。而测试组件之间，通过通信端口实现通信。

一个简单的例子

这个testcase中，简单执行：

telnet_IPworks();
//check if every port configuration is right
startClient(tsp_ptcClientName0);  //在这里启动名为tsp_ptcClientName0的PTC
startClient(tsp_ptcClientName1);
startClient(tsp_ptcClientName2);
startClient(tsp_ptcClientName3);
startClient(tsp_ptcClientName4);

startClient(tsp_ptcClientName11);
…
sendCommand_byPTC("date ",tsp_ptcClientName11,2.2);

PCT和startClient的实现（common/CLI/CLI_Function.ttcn.linux）：

//定义了接下来需要使用的PTC，类似C中的结构体概念
	type component PTC_CT
    	{
        	port TELNETasp_PT telnet_client_port; //与ipwork测试系统接口通信的端口
        	port ProcePort managePort; //与mtc通讯的端口

        	var BatchCommand tcv_batchCommand;

       	 	//if tcv_bcheckBatchResp== true ,check BatchCommad's Response from SUT ,or not
        	var boolean tcv_bcheckBatchResp := true;
    	}

	function startClient(charstring p_ClientName) runs on MTC_CT
    	{
        	//initial PTC
		//如果没有初始化PTC的列表，则根据ipwork.cfg中定义的tsp_ptcClientName*名，初始化若干PTC备用

        	if(tcv_isPTCInitial == false)       	 	
                {
		// PTC_CT.create(tsp_ptcClientName0)建立一个名为tsp_ptcClientName0的PTC，但不启动
            		ptcClientName[0]:= PTC_CT.create(tsp_ptcClientName0);
            		ptcClientName[1]:= PTC_CT.create(tsp_ptcClientName1);
            		ptcClientName[2]:= PTC_CT.create(tsp_ptcClientName2);
            		ptcClientName[3]:= PTC_CT.create(tsp_ptcClientName3);
           		ptcClientName[4]:= PTC_CT.create(tsp_ptcClientName4);
            		ptcClientName[5]:= PTC_CT.create(tsp_ptcClientName5);
            		ptcClientName[6]:= PTC_CT.create(tsp_ptcClientName6);
            		ptcClientName[7]:= PTC_CT.create(tsp_ptcClientName7);
           		ptcClientName[8]:= PTC_CT.create(tsp_ptcClientName8);
            		ptcClientName[9]:= PTC_CT.create(tsp_ptcClientName9);
            		ptcClientName[10]:= PTC_CT.create(tsp_ptcClientName10);
           		ptcClientName[11]:= PTC_CT.create(tsp_ptcClientName11);
            		tcv_isPTCInitial := true; //have been intialed
        	}
		
		//获取名为p_ClientName的PTC引用p_ptcClient
        	var PTC_CT p_ptcClient := getCurrentPTC(p_ClientName);
log(getCurrentPTC(p_ClientName));
		
		//如果p_ptcClient已经停止运行
        	if(false == p_ptcClient.running)
        	{
			//利用map，将测试组件p_ptcClient映射到ipwork测试系统接口上,system是测试系统的组件引用
         		map(p_ptcClient:telnet_client_port,system:telnet_client_port);   
			//connect直接把p_ptcClient的端口managePort连接到mtc的managePort端口，
//这样建立一条双工的通信关系
          		connect(p_ptcClient:managePort,mtc:managePort);
			//启动PTC引用p_ptcClient，启动后执行CliSimulator()
          		p_ptcClient.start(CliSimulator());
          		pause(1.0);
       		 }        
        	 //sendCommand_byPTC("ipwcli",p_ClientName,0.2);
        	 //sendCommand_byPTC(tsp_user_admin,p_ClientName,0.2);
        	 //sendCommand_byPTC(tsp_adminpassword,p_ClientName,1.2);
}

startClient首先检查PCT的存储容器ptcClientName是否被初始化，如果没有，则根据配置文件ipwork.cfg中设定的名字，create（两个概念，这里只是create，而不start）若干PCT引用填入ptcClientName备用。然后，根据参数p_ClientName获取相应的PCT引用。

随后，调用p_ptcClient.running检测，p_ptcClient是否在运行（running运行在一个测试部件上检查另一个测试部件是否运行，这里实在mtc上检查p_ptcClient）。如果没有运行，则依次执行map和connect，map为p_ptcClient与ipwork之间建立映射 ，connect为mtc和p_ptcClient建立一个双工的通信关系，即mtc的输出口指向p_ptcClient的输入口，p_ptcClient的输出口指向mtc的输入口。然后，执行p_ptcClient.start启动PTC，PTC启动后执行的就是start的参数CliSimulator()，如同pthread_create或者exec执行线程或进程函数一样。

我们已经启动了新的PTC，那么看看p_ptcClient的CliSimulator()里面究竟执行了那些东西：

function CliSimulator() runs on PTC_CT
{
      var charstring command := "";
      var charstring result := "";
      var charstring keyWords := "";
      timer t := 5.0;
      alt
      {
	//根据模板signature sig_Command(inout charstring p_Command)，等待另一个测试组
//件的调用请求，远程调用时传入的参数p_Command将被赋予command。这里的managePort就是
//之前mtc与p_ptcClient建立关联的端口，那么这里就是等待mtc的调用
[]managePort.getcall(sig_Command:{?}) -> param(command)
            	{
			//根据mtc的command，telnet_client_port 即之前map建立的p_ptcClient与
//ipwork建立的关联, telnet_client_port.send(command)将把mtc传来的command转发//给ipwork
                	telnet_client_port.send(command);                  	
repeat;
            	}

            	//Batch command operation
        []managePort.getcall(sig_BatchCommand:{?,?,?}) -param(tcv_batchCommand,keyWords,tcv_bcheckBatchResp)
            	{
                	var integer number := sizeof(tcv_batchCommand);
                	for(var integer i:=0;i<number;i:=i+1)
                	{
                    		telnet_client_port.send(tcv_batchCommand[i]);
                   		if(tcv_bcheckBatchResp == true)
                    		{
                        		t.start;    //启动计时器
                        		alt
                       	 	{
						//接收到回复
                            			[]telnet_client_port.receive(charstring:?) -> value result;                              		{
                                			
							//返回值与keyword比较
result := regexp(result,"*("&keyWords&")*",0);                                	t.stop;  //关闭计时器
							//错误结果
                                			if(result == "")
                                			{
                                    				log(tcv_batchCommand[i]," fail");
                                   				setverdict(fail);   //设置测试失败
                                    				stop;      //停止当前component                	     
                                			}
                                			else if(result == keyWords)
                                			{
                                    				log("Execute command:",tcv_batchCommand[i]," success");
                               			 }

                            			}
                            			[]t.timeout       //超时
                                		{
                                    			log("Time out ,don't receive Response from SUT.fail");
                                    			setverdict(fail);
                                    			stop;
                            			}
                        	}
                        
                        	telnet_client_port.clear;
                        
                    	}
                }
		//调用sig_sendBatchcommandFinished，不等待，直接执行下一步

                managePort.call(sig_sendBatchcommandFinished:{},nowait);                
repeat;
                
            }
            []telnet_client_port.receive(charstring:?) -> value result
            {
                managePort.call(sig_Command:{result},nowait);
                repeat;    
            }
            []telnet_client_port.receive
            {
                repeat;
            }
            
        }
 }

这里的alt是可选步，如同一个switch的消息循环，每个case选项或是等待远程过程调用请求，或是等待接受数据，如果有请求或者数据传输，程序就会跳进对应的case,，这里主要关心[]managePort.getcall(sig_Command:{?}) ->param(command)

getcall等待远程的call，managePort就是之前mtc与p_ptcClient建立关联的端口，那么这里就是等待mtc的call调用，根据module CLI_Signature中定义的函数原型signature sig_Command(inout charstring p_Command)，mtc远程call时传入的参数p_Command将被赋予command，telnet_client_port 即之前map建立的p_ptcClient与ipwork建立的关联, telnet_client_port.send(command)将把mtc传来的command转发给ipwork。这样就完成了，从mtc传送命令交由模拟的PTC转发给ipwork测试系统接口的过程。下面的[]managePort.getcall(sig_BatchCommand也大体类似，只是将一串命令打包执行。

最后看下mtc中如何调用p_ptcClient的方法 ，使用sendCommand_byPTC("date ",tsp_ptcClientName11,2.2)，它的作用就是通过名为tsp_ptcClientName11的PTC发送date给ipwork：

function sendCommand_byPTC(charstring p_Command,charstring p_ClientName,float p_pause) runs on MTC_CT
{
        var PTC_CT p_ptcClient;
        p_ptcClient := getCurrentPTC(p_ClientName);   //获取名为p_ClientName的PTC引用
	//调用managePort通信的远程方法，方法模板sig_Command，传入参数p_Command
        managePort.call(sig_Command:{p_Command},nowait) to p_ptcClient;
        pause(p_pause);
}

这里首先获取了获取名为p_ClientName的PTC引用，然后利用managePort调用远程方法（也就是mtc与p_ptcClient关联的端口），这里的远程方法会到p_ptcClient中去找模板为sig_Command的方法，也就是之前提到的CliSimulator()中相关内容。