〔转〕shark接口

Shark流程启动过程

 

1)      定位工作流服务器

      Shark.configure("Shark.conf");

      SharkInterface si= Shark.getInstance();

2) 连接工作流服务器

   SharkConnection sc= si. getSharkConnection();

   sc. connect(username, pwd, engineName, scope);

3) 产生流程

       WfProcess wfp = sc.createProcess(pkgId, pDefId);

       在产生流程时,使用的是SharkConnection的对象,该对象中保存了用户信息,用户信息作为产生的流程的requester;

      然后用两个参数:包定义ID和流程定义ID获取流程管理器的ID;

      最后,用该流程管理器来产生流程

4) 启动流程

      wfp.start();

      经过SHARK的几轮跳转,最后的实现在org.enhydra.shark.WfProcessImpl中,实现代码如下:

      //前面有对异常的判断

      //启动时间在后面要用

      startedTime = System.currentTimeMillis();

      //改变状态

         change_state(t,SharkConstants.STATE_OPEN_RUNNING);

         //激活计时器

     this.activateLimitAgent(t);

     //驱动流程

         run(t, null); 

5)断开连接

      disconnect(sc);

      return wfp.key();

 

Shark流程挂起过程

1)      得到执行管理器接口

ExecutionAdministration ea= Shark.getInstance().getAdminInterface()..getExecutionAdministration();

2)    连接工作流服务器

    ea.connect(username, password, enginename, scope);

3) 用流程实例号获取流程

   WfProcess wfp = ea.getProcess(processInsKey);

4) 挂起流程

   wfp.suspend();

    下面是挂起操作的具体分析

    //状态不能是已经挂起

   if (state(t).equals(SharkConstants.STATE_OPEN_NOT_RUNNING_SUSPENDED)) {

         throw new AlreadySuspended("The process is already suspended");

      }

    //运行中的流程才能挂起

      if (state(t).startsWith(SharkConstants.STATEPREFIX_OPEN_NOT_RUNNING)) {

         throw new NotRunning("The process is not in the running state");

      }

      try {

    //改变状态

         change_state(t,SharkConstants.STATE_OPEN_NOT_RUNNING_SUSPENDED);

 

         Iterator it=getActiveActivities(t).iterator();

         while (it.hasNext()) {

            WfActivityInternal act=(WfActivityInternal)it.next();

    //对每个活动都做同样的操作

            if (act.state(t).startsWith(SharkConstants.STATEPREFIX_OPEN)) {

               act.suspend(t);

            }

         }

      }

5) 断开连接

   ea.disconnect();

Shark流程resume过程

1) 得到执行管理器接口

ExecutionAdministration ea= Shark.getInstance().getAdminInterface()..getExecutionAdministration();

2) 连接工作流服务器

 ea.connect(username, password, enginename, scope);

3) 用流程实例号获取流程

 WfProcess wfp = ea.getProcess(processInsKey);

4) resume流程

 wfp.resume();

 下面是resume操作的具体分析

 //没有挂起的流程不能resume

 if (!state(t).equals(SharkConstants.STATE_OPEN_NOT_RUNNING_SUSPENDED)) {

 throw new NotSuspended("The process is not suspended");

 }

 //源代码中的说明: if this is a subflow process of suspended activity, and it is executed as SYNCHRONOUS, do not allow process to resume

 WfRequesterInternal requester=getRequester(t);

 if (requester!=null && (requester instanceof WfActivityInternal)) {

 WfActivityInternal waImpl=(WfActivityInternal)requester;

 if (waImpl.state(t).equals(SharkConstants.STATE_OPEN_NOT_RUNNING_SUSPENDED)) {

 // Determine subflow type

 if (XPDLUtilities.isSubflowSynchronous(SharkUtilities.getActivityDefinition(t,waImpl,getProcessDefinition(t)))) {

 SharkEngineManager.getInstance().getCallbackUtilities().error("Process"+toString()+" - Cannot resume because the requester activity is suspended");

 throw new CannotResume("Cannot resume - The requester activity is suspended");

 }

 }

 }

 //改变状态

 change_state(t, SharkConstants.STATE_OPEN_RUNNING);

 //把所有的活动都resume

 Iterator it=getActiveActivities(t).iterator();

 while (it.hasNext()) {

 WfActivityInternal act=(WfActivityInternal)it.next();

if (act.state(t).equals(SharkConstants.STATE_OPEN_NOT_RUNNING_SUSPENDED)) {

 act.resume(t);

 }

 }

5) 断开连接

 ea.disconnect();

 

shark工作流源代码学习（四）
怎么装载流程定义

上篇文章已经讨论过,流程定义的装载只需要做一次;下面讨论怎么装载的问题。

 

首先给出流程定义的装载的代码,其中的序号对应于后面的解释:

/**
*输入的是流程定义文件名,返回的是流程定义的包ID

*/

public String packageLoad(String xpdlName) throws MyException

    {  

  //(1)返回库管理器

       RepositoryMgr rm = Shark.getInstance().getRepositoryManager();

 //(2)用库管理器得到包ID

       String pkgId = rm.getPackageId(xpdlName);

//(3)得到包管理器

        PackageAdministration pa = Shark.getInstance().getAdminInterface().getPackageAdministration();

       if (!pa.isPackageOpened(pkgId))

       {

           try

           {

//(4)装载流程定义

              pa.openPackage(xpdlName);

           }

           catch (Exception e)

           {

              throw new MyException (e);

           }

       }

       return rm.getPackageId(xpdlName);

    }

 

(1)返回库管理器

该功能实际是通过SharkEngineManger来实现的,如下:

public RepositoryMgr getRepositoryManager () {

      return SharkEngineManager.getInstance().getObjectFactory().createRepositoryManager();

   } 

Shark中RepositoryMgr的实现类是RepositoryManager

(2) 用库管理器得到包ID

  该功能实现时,实现取出SharkUtilities.EXTERNAL_PACKAGES_REPOSITORY下的全部流程定义,再进行文件名的比较.

(3)得到包ID后,余下的事情交由PackageAdministration来完成