在先前的博客中提到了有关ProcessEngineConfiguration创建,但并没有详细的解释,主要创建的几个方法,那么这篇博客就来谈一谈有关ProcessEngineConfiguration一些创建操作。
ProcessEngineConfiguration类
该类代表一个Activiti流程引擎的配置,提供了一系列静态方法,用来读取和解析相应的配置文件,并返回ProcessEngineConfiguration的实例。下面来介绍一下有关创建实例的方法。
public static ProcessEngineConfiguration createProcessEngineConfigurationFromResourceDefault() {
return createProcessEngineConfigurationFromResource("activiti.cfg.xml", "processEngineConfiguration");
}
正如源码所示,该方法默认读取classpath下面的activiti.cfg.xml配置文件,启动并获取名称为processEngineConfiguration的bean的实例,然后解析XML后就由spring来实例完成。
public static ProcessEngineConfiguration createProcessEngineConfigurationFromResource(String resource) {
return createProcessEngineConfigurationFromResource(resource, "processEngineConfiguration");
}
正如源码所示,该方法默认读取classpath下面指定名称的XML配置文件,关键在于传入的String类型的resource参数,跟上面类似,指定的bean的id名称为processEngineConfiguration
public static ProcessEngineConfiguration createProcessEngineConfigurationFromResource(String resource, String beanName) {
return BeansConfigurationHelper.parseProcessEngineConfigurationFromResource(resource, beanName);
}
正如源码所示,读取我们自己命名的XML文件,并且bean的名称也可以由我们自己指定。例如我创建一个名称为my-activiti2.xml,里面的内容如下
<span style="font-family:Comic Sans MS;font-size:18px;"><?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
<!-- 配置自定义属性 -->
<bean id="processEngineConfiguration" class="org.crazyit.activiti.MyConfiguration">
<property name="jdbcUrl" value="jdbc:mysql://localhost:3306/activiti" />
<property name="jdbcDriver" value="com.mysql.jdbc.Driver" />
<property name="jdbcUsername" value="root" />
<property name="jdbcPassword" value="" />
<property name="databaseSchemaUpdate" value="drop-create"></property>
<property name="userName" value="crazyit"></property>
</bean>
</beans>
</span>
public static ProcessEngineConfiguration createProcessEngineConfigurationFromInputStream(InputStream inputStream, String beanName) {
return BeansConfigurationHelper.parseProcessEngineConfigurationFromInputStream(inputStream, beanName);
}
正如源码所示,xml文件以一种输入流的形式进行输入,后面的参数就不再讲解了,不同点就是xml的读取方式变为了输入流的形式,如下
<span style="font-family:Comic Sans MS;font-size:18px;">package org.crazyit.activiti;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;
import java.util.Map;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngineConfiguration;
import org.activiti.engine.ProcessEngines;
public class CreateInputStream {
public static void main(String[] args) throws Exception {
File file = new File("resource/input-stream.xml");
// 得到文件输入流
InputStream fis = new FileInputStream(file);
// 使用createProcessEngineConfigurationFromInputStream方法创建ProcessEngineConfiguration
ProcessEngineConfiguration config = ProcessEngineConfiguration
.createProcessEngineConfigurationFromInputStream(fis);
}
}</span>
public static ProcessEngineConfiguration createStandaloneProcessEngineConfiguration() {
return new StandaloneProcessEngineConfiguration();
}
正如源码所示,这个方法过于简单,就是直接通过new来创建对象,关于数据库的一系列操作,还得通过代码手动来赋值,如下所示
<span style="font-family:Comic Sans MS;font-size:18px;">@Test
public void createTable(){
ProcessEngineConfiguration configuration = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();
//定义连接mysql数据库
configuration.setJdbcDriver("com.mysql.jdbc.Driver");
configuration.setJdbcUrl("jdbc:mysql://localhost:3306/activiti?createDatabaseIfNotExist=true&useUnicode=true&characterEncoding=utf8");
configuration.setJdbcUsername("root");
configuration.setJdbcPassword("");
/**
* public static final String DB_SCHEMA_UPDATE_FALSE = "false";操作activiti23张表的时候,如果表不存在,就抛出异常,不能自动创建23张表
public static final String DB_SCHEMA_UPDATE_CREATE_DROP = "create-drop";每次操作,都会先删除表,再创建表
public static final String DB_SCHEMA_UPDATE_TRUE = "true";如果表不存在,就创建表,如果表存在,就直接操作
*/
configuration.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
//activiti核心对象(流程引擎)
ProcessEngine processEngine = configuration.buildProcessEngine();
System.out.println("processEngine:"+processEngine);
}</span>
ProcessEngineConfiguration类的结构图
正如上图所示,ProcessEngineConfiguration是全部配置类的父类,有一个ProcessEngineConfigurationImpl子类,ProcessEngineConfigurationImpl下面有三个直接的子类,其中ProcessEngineConfiguration和ProcessEngineConfigurationImpl都是抽象类
了解了ProcessEngineConfiguration类的结构后,我们也可以自定义属于我们自己的引擎配置,只要继承抽象类ProcessEngineConfigurationImpl即可,如下所示
<span style="font-family:Comic Sans MS;font-size:18px;">package org.crazyit.activiti;
import java.util.ArrayList;
import java.util.Collection;
import java.util.List;
import org.activiti.engine.impl.cfg.ProcessEngineConfigurationImpl;
import org.activiti.engine.impl.interceptor.CommandContextInterceptor;
import org.activiti.engine.impl.interceptor.CommandInterceptor;
public class MyConfiguration extends ProcessEngineConfigurationImpl {
public MyConfiguration() {
// 做自定义设置
}
//测试属性,需要在processEngineConfiguration注入
private String userName;
public void setUserName(String userName) {
this.userName = userName;
}
public String getUserName() {
return this.userName;
}
//返回命令拦截器集合
protected Collection<? extends CommandInterceptor> getDefaultCommandInterceptorsTxRequired() {
List<CommandInterceptor> defaultCommandInterceptorsTxRequired = new ArrayList<CommandInterceptor>();
//定义一个拦截器,该拦截器为系统内置拦截器,用于执行SQL脚本
defaultCommandInterceptorsTxRequired.add(new CommandContextInterceptor(commandContextFactory, this));
return defaultCommandInterceptorsTxRequired;
}
//返回命令拦截器集合
protected Collection<? extends CommandInterceptor> getDefaultCommandInterceptorsTxRequiresNew() {
return super.commandInterceptorsTxRequired;
}
}
</span>