org.enhydra.shark.SharkEngineManager
SharkEngineManager是shark引擎的控制室,它在shark引擎内部使用,shark引擎的所有管理器都是由它产生的。
SharkEngineManager使用了singleton模式,保证整个系统只有一个它的instance
// the one and only instance of this class
private static SharkEngineManager engineManager;
static SharkEngineManager getInstance () {
if (engineManager==null) {
engineManager=new SharkEngineManager();
}
return engineManager;
}
SharkEngineManager的所有get()方法的作用都是返回初始化时实例化的管理器,这些管理器也是singleton的,这样通过一个类,实现了无限个类的singleton模式,这在我们平常的系统中可以借鉴。
当系统启动时,将调用Shark.conf()进行系统的配置,配置时将调用SharkEngineManager的init (Properties properties)方法,该方法示例如下:
void init (Properties properties) {
String objectFactoryClassName=properties.getProperty
("ObjectFactoryClassName",
"org.enhydra.shark.SharkObjectFactory");
String amClassName =properties.getProperty
("AssignmentManagerClassName");
…………
}
如上所示,首先从properties中读ObjectFactoryClassName,如果有,则使用配置文件中的;如果没有,则用org.enhydra.shark.SharkObjectFactory。AssignmentManagerClassName也是从配置文件中读的。
Init()的下一步是用读到的配置或用缺省的配置将各管理器实例化,在后面运行时直接取用,如下:
try {
callbackUtilities=(CallbackUtil)cl.loadClass(cbuClassName).newInstance();
callbackUtilities.setProperties(properties);
objectFactory =(SharkObjectFactory)cl.loadClass(objectFactoryClassName).newInstance();
toolAgentManager = (ToolAgentManager) cl.loadClass(tamClassName).newInstance();
xmlInterface=new XMLInterfaceForJDK13();
} catch (Throwable ex) {
throw new Error("Problems instantiating core managers");
}
当然了,这里返回的都是接口,所以,我们可以方便的扩展它,只要写自己的类继承这些接口,然后在配置文件中进行配置,就可以不动它的代码而达到扩展的目的。
/**
*输入的是流程定义文件名,返回的是流程定义的包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来完成
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();