目前FoxBPM提供两种连接器:1:连接器,2:选择器,关于连接器,请参考gihub官方(https://github.com/FoxBPM)的foxbpm-connector工程
选择器如下图
下面介绍以上每种选择器的功能:
参考图(请假审批):
首先我们所有连接器都是直接实现FlowConnectorHandler的void execute(ConnectorExecutionContext executionContext) throws Exception;方法,
连接器的调用时机是在org.foxbpm.engine.impl.connector.Connector类的execute方法:
public void execute(ListenerExecutionContext executionContext) throws Exception { try { String classNameObj = packageName + "." + className; Class<?> connectorHandlerClass = Class.forName(classNameObj); FlowConnectorHandler connectorInstance = (FlowConnectorHandler) connectorHandlerClass .newInstance(); FlowNodeExecutionContext flowNodeExecutionContext = (FlowNodeExecutionContext) executionContext; for (ConnectorInputParam connectorParameterInputs : this.getConnectorInputsParam()) { Class<?> ptypes[] = new Class[1]; ptypes[0] = Class.forName(connectorParameterInputs.getDataType()); String parameterInputsId = connectorParameterInputs.getId(); String methodString = SETFUNCTION_PREFFIX + parameterInputsId.substring(0, 1).toUpperCase() + parameterInputsId.substring(1, parameterInputsId.length()); Method m = connectorHandlerClass.getMethod(methodString, ptypes); if (connectorParameterInputs.getExpression() != null) { Object arg[] = new Object[1]; if (!connectorParameterInputs.getExpression().isNullText() && connectorParameterInputs.isExecute()) { arg[0] = connectorParameterInputs.getExpression().getValue( flowNodeExecutionContext); } else { arg[0] = connectorParameterInputs.getExpression().getExpressionText(); } m.invoke(connectorInstance, arg); } } connectorInstance.execute((ConnectorExecutionContext) executionContext); for (ConnectorOutputParam connectorParameterOutputs : this.getConnectorOutputsParam()) { if (!StringUtil.isEmpty(connectorParameterOutputs.getOutputId())) { String parameterOutputsId = connectorParameterOutputs.getOutputId(); String methodString = GETFUNCTION_PREFFIX + parameterOutputsId.substring(0, 1).toUpperCase() + parameterOutputsId.substring(1, parameterOutputsId.length()); Method m = connectorHandlerClass.getMethod(methodString); String variableTarget = connectorParameterOutputs.getVariableTarget(); // Object arg[] = new Object[1]; // arg[0] =Context.getBshInterpreter().eval(scriptString); Object objectValue = m.invoke(connectorInstance); ExpressionMgmt.setVariable(variableTarget, objectValue, flowNodeExecutionContext); } } } catch (Exception e) { throw new FoxBPMConnectorException(e.getMessage(), e); } }
1、连接器的触发时机:
1、活动节点的“进入”,“执行”,“分配”,“离开”等事件,其中“分配”是针对人工任务。
2、整个流程的“启动”,“终止”,“结束”。
3、从代码层次上看:
通过以上事件的public void execute(InterpretableExecutionContext executionContext) 方法来触发连接器,
public void execute(InterpretableExecutionContext executionContext) {
KernelFlowElementsContainerImpl container = getContainer(executionContext);
String eventName = getEventName();
List<KernelListener> kernelListeners = container.getKernelListeners(eventName);
int kernelListenerIndex = executionContext.getKernelListenerIndex();
if (kernelListeners.size() > kernelListenerIndex) {
executionContext.setEventName(eventName);
executionContext.setEventSource(container);
KernelListener listener = kernelListeners.get(kernelListenerIndex);
try {
listener.notify(executionContext);
} catch (RuntimeException e) {
throw e;
} catch (Exception e) {
throw new KernelException("不能执行事件监听 : " + e.getMessage(), e);
}
对于连接器如果出现异常情况,一般从以上调用入口排查。
下面介绍以上每种连接器的功能:
1、Messaging
1)发送邮件
功能描述:根据配置的“主题”,“收件人”,“抄送人”,“正文”发送邮件。
实现参考:
public class SendMail implements FlowConnectorHandler { /** * */ private static final long serialVersionUID = 7217470393022025648L; private java.lang.String to; private java.lang.String title; private java.lang.String cc; private java.lang.String content; public void execute(ConnectorExecutionContext executionContext) throws Exception { // 获取邮件配置 SysMailConfig sysMailConfig = Context.getProcessEngineConfiguration().getSysMailConfig(); MailInfo mailInfoObj = null; for (MailInfo mailInfo : sysMailConfig.getMailInfo()) { if (mailInfo.getMailName().equals(sysMailConfig.getSelected())) { mailInfoObj = mailInfo; } } // 判断邮件配置信息是否为空 if (null == mailInfoObj) { throw new FoxBPMException("系统邮件配置错误请检查流程邮件配置!"); } MailEntity mailEntity = new MailEntity(); mailEntity.setMailName(title); mailEntity.setMailSubject(title); mailEntity.setMailTo(to); mailEntity.setMailCc(cc); mailEntity.setMailBody(content); mailEntity.setCreateTime(new Date()); mailEntity.setCreateUser(Authentication.getAuthenticatedUserId()); MailEngine.getInstance().saveMail(mailEntity); } public void setTo(java.lang.String to) { this.to = to; } public void setTitle(java.lang.String title) { this.title = title; } public void setCc(java.lang.String cc) { this.cc = cc; } public void setContent(java.lang.String content) { this.content = content; } }
实例说明:例如任务分配时需要提示任务处理,这时候可以配置“发送邮件“连接器来通知。
注意:
1、该发送邮件不是立即发送,而是将邮件信息存入数据库foxbpm_mail中,有系统定时任务根据foxbpm_mail表内容来处理发送邮件。
2、该发送邮件是根据foxbpm.cfg.xml中<sysMailConfig selected="FoxBPM邮箱">
<mailInfo mailAddress="kenshin@wisedu.com" mailName="FoxBPM邮箱"
smtpHost="mail.widedu.com.cn" smtpPort="25" userName="kenshin" password="kenshin" />
</sysMailConfig>配置的信息来发送邮件。
3、其中“发件人”,“抄送人”可以使多个(以分号分隔)。
2)自动邮件发送
功能描述:根据配置的“主题”,“正文”自动实现邮件发送(该连接器针对任务分配有效)连接器触发时机选择“分配”。
实现参考:
public class AutoSendMail implements FlowConnectorHandler { /** * */ private static final long serialVersionUID = -4576139954014666005L; private java.lang.String title; private java.lang.String content; public void execute(ConnectorExecutionContext executionContext) throws Exception { // 从上下文拿引擎 ProcessEngineConfigurationImpl peconfig = Context.getProcessEngineConfiguration(); // 获取邮件配置 SysMailConfig sysMailConfig = peconfig.getSysMailConfig(); MailInfo mailInfoObj = null; for (MailInfo mailInfo : sysMailConfig.getMailInfo()) { if (mailInfo.getMailName().equals(sysMailConfig.getSelected())) { mailInfoObj = mailInfo; } } // 判断邮件配置信息是否为空 if (null == mailInfoObj) { throw new FoxBPMException("系统邮件配置错误请检查流程邮件配置!"); } TaskEntity taskEntity = executionContext.getAssignTask(); if (null != taskEntity) { StringBuffer mailTitle = new StringBuffer(); // 如果主题为空 if (StringUtil.isEmpty(StringUtil.trim(title))) { mailTitle.append('[').append(taskEntity.getProcessDefinitionName()).append(']').append(taskEntity.getDescription()).append(" is pending for your approval or handle"); } String taskUrl = "http://www.baidu.com"; if (StringUtil.isEmpty(content)) { content = "<br>Hello,<br>你好,<br><br> " + mailTitle + "<br><br>" + "Please click url to deal with job: <br>请访问此链接地址进入任务:<br> <a href=" + taskUrl + ">" + taskUrl + "</a><br><br>" + "Best Regards!<br>诚挚问候!<br>Note: Please do not reply to this email , This mailbox does not allow incoming messages." + "<br>注意: 本邮件为工作流系统发送,请勿回复。 "; } // 获取用户 IdentityService identityService = peconfig.getIdentityService(); // 判断是否独占任务 UserEntity user = null; if (StringUtil.isNotEmpty(taskEntity.getAssignee())) { user = identityService.getUser(taskEntity.getAssignee()); // 判断用户是否为空 if (null != user) { // 如果用户存在邮件地址即发生邮件 if (StringUtil.isNotEmpty(user.getEmail())) { // 保存邮件实体 saveMail(user.getEmail(), title, content, taskEntity.getId()); } } } else { // 处理共享任务 StringBuffer to = new StringBuffer(); String userId = null; for (IdentityLinkEntity identityLink : taskEntity.getTaskIdentityLinks()) { userId = identityLink.getUserId(); if (StringUtil.isNotEmpty(userId)) { if (!Constant.FOXBPM_ALL_USER.equals(userId)) { user = Authentication.selectUserByUserId(userId); if (null != user) { if (StringUtil.isNotEmpty(user.getEmail())) { to.append(user.getEmail()).append(Constants.COMMA); } } } else { // 处理所有者 List<UserEntity> users = identityService.getUsers(null, null); if (null != users) { for (UserEntity u : users) { if (StringUtil.isNotEmpty(u.getEmail())) { to.append(u.getEmail()).append(Constants.COMMA); } } } } } else { // 获取组下面所有用户 List<UserEntity> users = Authentication.selectUserByGroupIdAndType(identityLink.getGroupId(), identityLink.getGroupType()); if (null != users) { for (UserEntity u : users) { if (StringUtil.isNotEmpty(u.getEmail())) { to.append(u.getEmail()).append(Constants.COMMA); } } } } } if (to.length() > 0) { // 删除最后一个',' to.deleteCharAt(to.length() - 1); // 保存邮件实体 saveMail(to.toString(), title, content, taskEntity.getId()); } } } } /** * 保存邮件 * * @param to * 发给人 * @param title * 主题 * @param mailContent * 邮件内容 * @param taskId * 任务id */ private void saveMail(String to, String mailtitle, String mailContent, String taskId) { // 创建邮件实体 MailEntity mailEntity = new MailEntity(); mailEntity.setMailName(mailtitle); mailEntity.setMailSubject(mailtitle); mailEntity.setMailTo(to); mailEntity.setMailBody(mailContent); mailEntity.setCreateTime(new Date()); mailEntity.setCreateUser(Authentication.getAuthenticatedUserId()); // 调用引擎保存邮件 MailEngine.getInstance().saveMail(mailEntity); } public void setTitle(java.lang.String title) { this.title = title; } public void setContent(java.lang.String content) { this.content = content; } }
实例说明:例如:某用户填写请假申请(2天假期)---》项目主管,这时候就会自动发送邮件通知“项目主管”这个角色下的所有用户来处理。
注意:
1、该自动发邮件,根据任务特性自动获取收件人,任务特性有两种(独占、共享),如果是“独占”那么“收件人”任务处理人,如果是“共享”,那么“收件人”所有共享者,这里可包括(个人,所有人,角色)。
2、只有选择连接事件为“分配”该连接器才有效。
2、WebServices
1)执行一个Web服务
功能描述:根据配置webservice信息,调用webservice接口返回响应结果。
实现参考:
public class WebServiceCall implements FlowConnectorHandler { /** * */ private static final long serialVersionUID = -748190599446833382L; private java.lang.String namespaceURI; private java.lang.String serviceName; private java.lang.String portName; private java.lang.String endpointAddress; private java.lang.String request; private java.lang.String response; public void execute(ConnectorExecutionContext executionContext) throws Exception { if (StringUtil.isEmpty(namespaceURI)) { throw new FoxBPMConnectorException("namespaceURI is null!"); } if (StringUtil.isEmpty(portName)) { throw new FoxBPMConnectorException("portName is null!"); } if (StringUtil.isEmpty(serviceName)) { throw new FoxBPMConnectorException("serviceName is null!"); } if (StringUtil.isEmpty(endpointAddress)) { throw new FoxBPMConnectorException("endpointAddress is null!"); } if (StringUtil.isEmpty(request)) { throw new FoxBPMConnectorException("request is null!"); } QName portQName = new QName(namespaceURI, portName); Service service = Service.create(new QName(namespaceURI, serviceName)); service.addPort(portQName, SOAPBinding.SOAP11HTTP_BINDING, endpointAddress); StreamSource xmlSource = new StreamSource(new StringReader(request)); Dispatch<Source> dispatchSource = service.createDispatch(portQName, Source.class, Service.Mode.MESSAGE); Source source = dispatchSource.invoke(xmlSource); StreamResult result = new StreamResult(new ByteArrayOutputStream()); Transformer trans = TransformerFactory.newInstance().newTransformer(); trans.transform(source, result); ByteArrayOutputStream baos = (ByteArrayOutputStream) result.getOutputStream(); response = new String(baos.toByteArray()); } public void setNamespaceURI(java.lang.String namespaceURI) { this.namespaceURI = namespaceURI; } public void setServiceName(java.lang.String serviceName) { this.serviceName = serviceName; } public void setPortName(java.lang.String portName) { this.portName = portName; } public void setEndpointAddress(java.lang.String endpointAddress) { this.endpointAddress = endpointAddress; } public void setRequest(java.lang.String request) { this.request = request; } public java.lang.String getResponse() { return response; } }
注意:
1、该连接器需要输入参数,而且相关参数必须有值。
2、该链接存在返回值
3、Script
1)Groovy
功能描述:执行Groovy脚本
实现参考:
public class RunGroovyExpression implements FlowConnectorHandler { /** * */ private static final long serialVersionUID = 1923171231930850489L; private java.lang.String expressionText; private java.lang.Object outputObj; public void execute(ConnectorExecutionContext executionContext) throws Exception { if (StringUtil.isNotEmpty(expressionText)) { outputObj = ExpressionMgmt.execute(expressionText, executionContext); } } public void setExpressionText(java.lang.String expressionText) { this.expressionText = expressionText; } public java.lang.Object getOutputObj() { return outputObj; } }
注意:
1、该连接器需要输入参数且存在返回值。
4、Database
1、Generic
1)DatasourceDatabaseQuery
功能描述:执行查询sql并返回结果。
实现参考:
public class DatasourceDatabaseQuery implements FlowConnectorHandler { /** * */ private static final long serialVersionUID = 8595980483313031237L; private java.lang.String sqlText; private java.util.List<java.util.Map<String, Object>> outputObj; public void execute(ConnectorExecutionContext executionContext) throws Exception { if (StringUtil.isEmpty(sqlText)) { throw new FoxBPMConnectorException("sqlText is null!"); } // 只处理查询sql if (StringUtil.trim(sqlText).toLowerCase().startsWith(Constants.SQL_SELECT)) { SqlCommand sqlCommand = new SqlCommand(DBUtils.getConnection()); outputObj = sqlCommand.queryForList(sqlText); } else { // 如果不是select 查询语句 throw new FoxBPMConnectorException("执行无效的查询sql错误,请检查sql语句:" + sqlText); } } public void setSqlText(java.lang.String sqlText) { this.sqlText = sqlText; } public java.util.List<java.util.Map<String, Object>> getOutputObj() { return outputObj; } }
注意:
1、输入的sql语句必须是select的,否则执行会出现异常。
2)JDBCDatabaseQuery
功能描述:根据输入的数据库驱动、url、用户名、密码,执行查询sql并返回结果。
实现参考:
public class JDBCDatabaseQuery implements FlowConnectorHandler { /** * */ private static final long serialVersionUID = 3120408358341797232L; private java.lang.String driverClassName; private java.lang.String url; private java.lang.String username; private java.lang.String password; private java.lang.String sqlText; private java.util.List<java.util.Map<String, Object>> outputObj; public void execute(ConnectorExecutionContext executionContext) throws Exception { if (StringUtil.isEmpty(driverClassName)) { throw new FoxBPMConnectorException("driverClassName is null!"); } if (StringUtil.isEmpty(url)) { throw new FoxBPMConnectorException("url is null!"); } if (StringUtil.isEmpty(username)) { throw new FoxBPMConnectorException("username is null!"); } if (StringUtil.isEmpty(password)) { throw new FoxBPMConnectorException("password is null!"); } if (StringUtil.isEmpty(sqlText)) { throw new FoxBPMConnectorException("sqlText is null!"); } // 只处理查询sql if (StringUtil.trim(sqlText).toLowerCase().startsWith(Constants.SQL_SELECT)) { // 加载驱动 Class.forName(driverClassName); Connection connection = null; try { // 打开一个数据库连接 connection = DriverManager.getConnection(url, username, password); SqlCommand sqlCommand = new SqlCommand(connection); outputObj = sqlCommand.queryForList(sqlText); } finally { if (null != connection) { // 释放连接 connection.close(); } } } else { // 如果不是select 查询语句 throw new FoxBPMConnectorException("执行无效的查询sql错误,请检查sql语句:" + sqlText); } } public void setDriverClassName(java.lang.String driverClassName) { this.driverClassName = driverClassName; } public void setUrl(java.lang.String url) { this.url = url; } public void setUsername(java.lang.String username) { this.username = username; } public void setPassword(java.lang.String password) { this.password = password; } public void setSqlText(java.lang.String sqlText) { this.sqlText = sqlText; } public java.util.List<java.util.Map<String, Object>> getOutputObj() { return outputObj; } }
注意:
1、这里输入驱动必须是系统存在的。
总结:
1、根据以上选择器特性,可以分为两种,无返回值、有返回值,两大类
无返回值:1、2
有返回值:3、4
2、连接器执行时机是有事件触发的,其中对于“自动发送邮件”只有在连接器事件为“分配”才有效
最后,更多关于连接的使用以及配置,具体使用请大家到gihub官方(https://github.com/FoxBPM)下载相关FoxBPM的项目运行。
相关推荐
FoxBPM(6.0版本开始fixflow改名为FoxBPM)是一款开源的基于BPMN2.0标准的工作流引擎,引擎底层直接支持BPMN2.0国际标准, 吸纳了 jBPM3 、 Activiti5、BonitaBPM 等国际开源流程引擎的精髓, 同时提供了强大的中国式流程...
FoxBPM流程设计器 #分支介绍 develop 最新开发版 master 最新稳定版 release-* 发布分支为准备新的产品版本发布做支持 hotfix-* 当产品版本的重大bug需要立即解决的时候,我们从对应版本的标签创建出一个热补丁分支...
ysoserial是一个用于生成利用不安全的Java对象反序列化的有效负载的概念验证工具。它包含一系列在常见Java库中发现的"gadget chains",可以在特定条件下利用执行不安全的反序列化操作的Java应用程序。ysoserial项目最初在2015年AppSecCali会议上提出,包含针对Apache Commons Collections(3.x和4.x版本)、Spring Beans/Core(4.x版本)和Groovy(2.3.x版本)的利用链
1、嵌入式物联网单片机项目开发例程,简单、方便、好用,节省开发时间。 2、代码使用IAR软件开发,当前在CC2530上运行,如果是其他型号芯片,请自行移植。 3、软件下载时,请注意接上硬件,并确认烧录器连接正常。 4、有偿指导v:wulianjishu666; 5、如果接入其他传感器,请查看账号发布的其他资料。 6、单片机与模块的接线,在代码当中均有定义,请自行对照。 7、若硬件有差异,请根据自身情况调整代码,程序仅供参考学习。 8、代码有注释说明,请耐心阅读。 9、例程具有一定专业性,非专业人士请谨慎操作。
YOLO系列算法目标检测数据集,包含标签,可以直接训练模型和验证测试,数据集已经划分好,包含数据集配置文件data.yaml,适用yolov5,yolov8,yolov9,yolov7,yolov10,yolo11算法; 包含两种标签格:yolo格式(txt文件)和voc格式(xml文件),分别保存在两个文件夹中,文件名末尾是部分类别名称; yolo格式:<class> <x_center> <y_center> <width> <height>, 其中: <class> 是目标的类别索引(从0开始)。 <x_center> 和 <y_center> 是目标框中心点的x和y坐标,这些坐标是相对于图像宽度和高度的比例值,范围在0到1之间。 <width> 和 <height> 是目标框的宽度和高度,也是相对于图像宽度和高度的比例值; 【注】可以下拉页面,在资源详情处查看标签具体内容;
**Oracle 10g DBA学习手册:安装Oracle和构建数据库** **目的:** 本章节旨在指导您完成Oracle数据库软件的安装和数据库的创建。您将通过Oracle Universal Installer (OUI)了解软件安装过程,并学习如何利用Database Configuration Assistant (DBCA)创建附加数据库。 **主题概览:** 1. 利用Oracle Universal Installer (OUI)安装软件 2. 利用Database Configuration Assistant (DBCA)创建数据库 **第2章:Oracle软件的安装与数据库构建** **Oracle Universal Installer (OUI)的运用:** Oracle Universal Installer (OUI)是一个图形用户界面(GUI)工具,它允许您查看、安装和卸载机器上的Oracle软件。通过OUI,您可以轻松地管理Oracle软件的安装和维护。 **安装步骤:** 以下是使用OUI安装Oracle软件并创建数据库的具体步骤:
消防验收过程服务--现场记录表.doc
数据库管理\09-10年第1学期数据库期末考试试卷A(改卷参考).doc。内容来源于网络分享,如有侵权请联系我删除。另外如果没有积分的同学需要下载,请私信我。
YOLO系列算法目标检测数据集,包含标签,可以直接训练模型和验证测试,数据集已经划分好,包含数据集配置文件data.yaml,适用yolov5,yolov8,yolov9,yolov7,yolov10,yolo11算法; 包含两种标签格:yolo格式(txt文件)和voc格式(xml文件),分别保存在两个文件夹中,文件名末尾是部分类别名称; yolo格式:<class> <x_center> <y_center> <width> <height>, 其中: <class> 是目标的类别索引(从0开始)。 <x_center> 和 <y_center> 是目标框中心点的x和y坐标,这些坐标是相对于图像宽度和高度的比例值,范围在0到1之间。 <width> 和 <height> 是目标框的宽度和高度,也是相对于图像宽度和高度的比例值; 【注】可以下拉页面,在资源详情处查看标签具体内容;
职业暴露后的处理流程.docx
Java Web开发短消息系统
项目包含完整前后端源码和数据库文件 环境说明: 开发语言:Java 框架:ssm,mybatis JDK版本:JDK1.8 数据库:mysql 5.7 数据库工具:Navicat11 开发软件:eclipse/idea Maven包:Maven3.3 服务器:tomcat7
这是一款可以配置过滤目录及过滤的文件后缀的工具,并且支持多个项目同时输出导出,并过滤指定不需要导出的目录及文件后缀。 导出后将会保留原有的路径,并在新的文件夹中体现。
Matlab领域上传的视频均有对应的完整代码,皆可运行,亲测可用,适合小白; 1、代码压缩包内容 主函数:main.m; 调用函数:其他m文件;无需运行 运行结果效果图; 2、代码运行版本 Matlab 2019b;若运行有误,根据提示修改;若不会,私信博主; 3、运行操作步骤 步骤一:将所有文件放到Matlab的当前文件夹中; 步骤二:双击打开main.m文件; 步骤三:点击运行,等程序运行完得到结果; 4、仿真咨询 如需其他服务,可私信博主; 4.1 博客或资源的完整代码提供 4.2 期刊或参考文献复现 4.3 Matlab程序定制 4.4 科研合作
YOLO算法-挖掘机与火焰数据集-7735张图像带标签-挖掘机.zip
操作系统实验 Ucore lab5
IMG_5950.jpg
竞选报价评分表.docx
java系统,mysql、springboot等框架