目前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需要立即解决的时候，我们从对应版本的标签创建出一个热补丁分支...
基于springboot+Javaweb的二手图书交易系统源码数据库文档.zip
Linux课程设计.doc
课程考试资源描述 本资源是为应对各类课程考试而精心准备的综合性学习包。它包含了多门学科的考试指南、历年真题、模拟试题以及详细的答案解析。这些资源旨在帮助学生系统复习课程内容，理解考试要点，提高解题技巧，从而在考试中取得优异成绩。 资源中不仅包含了基础的考试资料，还特别加入了考试技巧讲解和备考策略分析。学生可以通过这些资源了解不同题型的解题方法和思路，学会如何在有限的时间内高效答题。此外，还有针对弱项科目和难点的专项训练，帮助学生攻克学习瓶颈。 为了确保资源的时效性和准确性，我们会定期更新考试资料和模拟试题，及时反映最新的考试动态和趋势。同时，也提供了在线交流平台，方便学生之间互相讨论、分享学习心得。 项目源码示例（简化版，Python） 以下是一个简单的Python脚本示例，用于生成包含选择题和答案的模拟试题： python import random # 定义选择题题库 questions = [ {"question": "Python的创始人是谁？", "options": ["A. 林纳斯·托瓦兹", "B. 巴纳姆", "C. 比尔·盖茨", "D.
基于 MySQL+Django 实现校园食堂点餐系统。 主要环境： PowerDesigner MySQL Workbench 8.0 CE Python 3.8 Django 3.2.8 BootStrap 3.3.7 Django-simpleui
基于SpringBoot的同城宠物照看系统源码数据库文档.zip
GEE训练教程
基于springboot+Web的心理健康交流系统源码数据库文档.zip
微信小程序 kotlin 实践微信插件助手, 目前支持抢红包（支持微信最新版本 7.0.0及7.0.3）.zip
N32G45X运放电路检测电压
梦幻西游道人是梦幻西游里面的一个NPC，主要是刷全服最实惠的高级兽决和其他很好用的比较贵的东西，在长安城、傲来国、长寿村中的任意一个场景出现，一般会出现30分钟，不过东西一般都被秒刷。 梦幻西游道人出现时间解析如下： 1.梦幻西游道人出现时间一直都保持着一年出现两次的规律，即2、3月份的元宵节期间来一次，9月份的教师节期间出现一次。 2.云游道人每个整点(0:00至7:00不出现)会在长安城、傲来国、长寿村中的任意一个场景出现,每次出现后停留时间为30分钟。
tables-3.7.0-cp38-cp38-win_amd64.whl
基于springboot旧物回收管理系统源码数据库文档.zip
MariaDB数据库管理系统是MySQL的一个分支，主要由开源社区在维护，采用GPL授权许可 MariaDB的目的是完全兼容MySQL，包括API和命令行，使之能轻松成为MySQL的代替品。在存储引擎方面，使用XtraDB（英语：XtraDB）来代替MySQL的InnoDB。 本文档介绍了MariaDB 10.1的集群部署，至少三台机器做成集群，每台可以同时提供读和写，感兴趣的小伙伴们可以参考一下
内容概要：本文档全面介绍了JavaScript作为一种轻量级的、解释型的语言及其在前端开发中的广泛应用。从JavaScript的基本概念出发，详尽讲解了基础语法（如变量、数据类型、运算符、流程控制）、函数和闭包、对象和原型、DOM操作（如获取、修改、添加和删除元素）、事件处理（如事件监听器、事件对象）、AJAX与Fetch API、ES6+的新特性（如箭头函数、模板字符串、解构赋值）以及前端框架和库（React、Vue、Angular）。除此之外，文章还涉及了代码优化技巧（如减少DOM操作、选择适当的算法和数据结构、使用工具提升代码性能），并对JavaScript的应用场景和发展趋势进行了展望。 适用人群：适用于初学者或具有少量编程经验的学习者，旨在帮助他们系统掌握JavaScript基础知识和前沿技术。 使用场景及目标：通过本教程的学习，读者不仅可以学会基本语法，还能理解并掌握高级概念和技术，如DOM操纵、事件处理机制、异步编程及最新的ECMAScript规范。这不仅有助于改善用户体验、增强网站互动性和响应速度，也能有效提升自身的编码水平和项目开发能力。 其他说明：此文档不仅涵盖了JavaScript的传统功能，还有现代前端技术和最佳实践指导，确保读者能够紧跟行业发展步伐，成为合格甚至优秀的Web开发人员。
该资源内项目源码是个人的课程设计、毕业设计，代码都测试ok，都是运行成功后才上传资源，答辩评审平均分达到96分，放心下载使用！ ## 项目备注 1、该资源内项目代码都经过严格测试运行成功才上传的，请放心下载使用！ 2、本项目适合计算机相关专业(如计科、人工智能、通信工程、自动化、电子信息等)的在校学生、老师或者企业员工下载学习，也适合小白学习进阶，当然也可作为毕设项目、课程设计、作业、项目初期立项演示等。 3、如果基础还行，也可在此代码基础上进行修改，以实现其他功能，也可用于毕设、课设、作业等。 下载后请首先打开README.md文件（如有），仅供学习参考, 切勿用于商业用途。
基于springboot高考志愿智能推荐系统源码数据库文档.zip
经典-FPGA时序约束教程