uflo2安装与配置

UFLO2视频教程

地址：​​https://pan.baidu.com/s/1jIcMNAY​​ 密码：2jr4

将UFLO添加到我们的项目当中分两种情况，一种是Maven项目，另一种是普通的web项目，我们首先来看看如果将UFLO添加到我们现有的一个由Maven管理的项目当中。

       UFLO提供了两个模块，分别是uflo-core和uflo-console。uflo-core是uflo的核心引擎模块，提供流利引擎的核心流转控制；uflo-console模块则提供了uflo的网页版流程设计器、网页版的流程控制中心等页面，因为uflo-console模块依赖于uflo-core模版，所以安装时我们只需要依赖uflo-console模块即可。

uflo-console模块依赖，内容如下：

uflo-console模块依赖配置

<dependency>
<groupId>com.bstek.uflo</groupId>
<artifactId>uflo-console</artifactId>
<version>[version]</version>
</dependency>

       默认的uflo-console是基于JDK1.8以及Hibernate5编译的，所以如果采用上述maven配置，我们需要本地安装好1.8版本的JDK。除此之外，如果我们需要Hibernate4或Hibernate3版本的uflo，那么可采用下面的依赖配置：

       Hibernate4版本的uflo依赖配置：

uflo-console-hibernate4模块依赖配置

<dependency>
<groupId>com.bstek.uflo</groupId>
<artifactId>uflo-console-hibernate4</artifactId>
<version>[version]</version>
</dependency>

       Hibernate5版本的uflo依赖配置：

uflo-console-hibernate3模块依赖配置

<dependency>
<groupId>com.bstek.uflo</groupId>
<artifactId>uflo-console-hibernate3</artifactId>
<version>[version]</version>
</dependency>

       需要注意的是，Hibernate4与Hibernate3版本的uflo都是采用JDK1.7编译，所以需要我们预先准备好对应版本的JDK。

关于UFLO版本

目前uflo-core及uflo-console的最新版为2.0.2，我们可以到​​http://search.maven.org/​​上输入“uflo-core”或“uflo-console”关键字查询版本。

       需要注意的是，在​​http://search.maven.org/​​​上我们只能查找到最新的release版本，如果您需要最新的snapshot，那么可以到​​https://oss.sonatype.org/​​​上查找，因为sonatype规定，只有正式版本才可以发到​​http://search.maven.org/​​​上，也就是mave的central repository中，snapshot版本只能存在于​​https://oss.sonatype.org/​​​中，所以如果我们要采用​​https://oss.sonatype.org/​​中最新的snapshot，那么就需要在pom.xml中添加一个repository信息，告诉Maven该到这里去下载snapshot版本的包，repository信息如下所示：

Maven库配置

<repositories>
<repository>
<id>sonatype</id>
<url>https://oss.sonatype.org/content/groups/public/</url>
</repository>
</repositories>

       以上为Maven项目在添加UFLO支持时所需要做的工作，如果您采用的是传统项目，那配置过程相比之下就麻烦多了，我们需要到​​http://search.maven.org/​​​或​​https://oss.sonatype.org/​​上下载最新的uflo-core及uflo-console及所需要的第三方依赖Jar包，然后把它们放到我们的项目当中，最后就是检查有没有同类型但版本不同的Jar，如果有还需要进行清理，最后启动测试。

接下来还需要编写一个名为EnvironmentProvider接口实现类，其源码如下，具体作用见接口描述：

package com.bstek.uflo.env;
import org.hibernate.SessionFactory;
import org.springframework.transaction.PlatformTransactionManager;
/**
* @author Jacky.gao
* @since 2013年9月17日
*/
public interface EnvironmentProvider {
/**
* @return 返回流程引擎需要使用的Hibernate SessionFactory
*/
SessionFactory getSessionFactory();
/**
* @return 返回与当前SessionFactory绑定的PlatformTransactionManager对象
*/
PlatformTransactionManager getPlatformTransactionManager();
/**
* @return 返回当前系统的登录用户
*/
String getLoginUser();
/**
* @return 返回当前系统分类ID
*/
String getCategoryId();
}

       下面的代码当中向我们展示了一个实现了EnvironmentProvider接口的示例。

EnvironmentProvider实现类示例

import org.hibernate.SessionFactory;
import org.springframework.transaction.PlatformTransactionManager;
import com.bstek.uflo.env.EnvironmentProvider;
public class TestEnvironmentProvider implements EnvironmentProvider {
private SessionFactory sessionFactory;
private PlatformTransactionManager platformTransactionManager;
 
public SessionFactory getSessionFactory() {
return sessionFactory;
}
 
public void setSessionFactory(SessionFactory sessionFactory) {
this.sessionFactory = sessionFactory;
}
 
public PlatformTransactionManager getPlatformTransactionManager() {
return platformTransactionManager;
}
 
public void setPlatformTransactionManager(
PlatformTransactionManager platformTransactionManager) {
this.platformTransactionManager = platformTransactionManager;
}
public String getCategoryId() {
return null;
}
public String getLoginUser() {
return "anonymous";
}
}

SessionFactory及TransactionManager都是通过Spring环境注入；getLoginUser方法用于返回当前登录用户，因为我们这里没有用户登录的概念，所以这里返回一个固定值“anonymous”；getCategoryId方法返回null，表示不对流程进行分类处理。

       该接口实现类编写完成后，需要将其配置到Spring当中，让其成为一个标准的Spring Bean，这样UFLO引擎会自动检测到该类并使用它。在这个接口实现类当中，主要是其中的getSessionFactory与getPlatformTransactionManager这两个方法，第一个getSessionFactory是要返回当前指向uflo数据库的hibernate的sessionFactory对象，因为uflo是构建在spring环境之上，所以这里的sessionFactory最好是一个配置在spring环境中的sessionFactory对象，而spring恰恰也提供了创建hibernate3及hibernate4的sessionFactory对象，比如下面的spring配置是用来创建一个hibernate3的sessionFactory对象的。

<bean id="sessionFactory" class="org.springframework.orm.hibernate3.annotation.AnnotationSessionFactoryBean">
<property name="dataSource" ref="dataSource" />
<property name="packagesToScan">
<list>
<value>com.bstek.uflo.model*</value>
</list>
</property>
<property name="hibernateProperties">
<props>
<prop key="hibernate.dialect">org.hibernate.dialect.MySQL5InnoDBDialect</prop>
<prop key="hibernate.show_sql">true</prop>
<prop key="hibernate.hbm2ddl.auto">update</prop>
</props>
</property>
</bean>

m.hibernate4.LocalSessionFactoryBean即可。这里需要注意的是上面的packagesToScan属性，无论是哪种类型的sessionFactory，在使用uflo时都需要添加这一属性，并且需要添加一个com.bstek.uflo.model*的值，这样才能让uflo中hibernate模型对象加载到当前sessionFactory当中；还有就是uflo并没有提供流程所需要的建表schema，所以我们需要将sessionFactory配置中的hibernate.hbm2ddl.auto属性设置为update，这样hibernate会帮助我们自动创建uflo所需要的表信息。

       getPlatformTransactionManager方法要求返回一个spring的PlatformTransactionManager接口实现，当然如果非JTA事务，那么PlatformTransactionManager实现必须要与当前返回的sessionFactory对应的transactionManager绑定。

      打开web.xml文件，在其中添加uflo专用的servlet，配置如下：

UFLO的Servlet配置

<servlet>
<servlet-name>ufloServlet</servlet-name>
<servlet-class>com.bstek.uflo.console.UfloServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>ufloServlet</servlet-name>
<url-pattern>/uflo/*</url-pattern>
</servlet-mapping>

       最后还需要在我们的spring配置文件中导入uflo-console的spring配置文件，方法如下：

加载uflo-console的spring配置文件

<import resource="classpath:uflo-console-context.xml" />

关于Properties文件加载

如果你是将UFLO配置到一个已存在的Spring项目中，同时项目也要Spring中加载自己的Properties文件，比如通过下面的方式加载自己的Properties文件

<context:property-placeholder location="/WEB-INF/app.properties"/>

这时启动应用，我们会发现启动过程中系统会报各种属性找不到的异常，解决办法就是在上面配置中加上 ignore-unresolvable="true" 以及 order="1" 两个属性即可，其中ignore-unresolvable属性表达忽略当前配置的Properties文件中没有配置的属性，order属性值表示加载优先级，值越小，优先级越高。

当然如果你的项目中Properties文件加载是通过配置PropertyPlaceholderConfigurer为bean的方式加载，那么同样需要为这个bean添加如下两个属性，作用也是一样：

<property name="ignoreUnresolvablePlaceholders" value="true"></property>
<property name="order" value="1"></property>

       在UFLO当中提供了一些可供外部系统覆盖的属性，通过对这些属性值的重新定义，可让UFLO更加适应我们的业务系统，如果我们项目中没有属性文件，那么可以在我们的spring配置文件中添加如下bean:

覆盖UFLO属性的属性文件加载方式

<bean id="propertyConfigurer" parent="uflo.props">
<property name="location">
<value>/WEB-INF/config.properties</value>
</property>
</bean>

       上面的“uflo.props”Bean是UFLO中提供的一个标准的org.springframework.beans.factory.config.PropertyPlaceholderConfigurer类的子类，所以该Bean采用的属性文件的加载方式就是标准的spring属性文件的加载方式。

       UFLO中可覆盖的属性如下表所示。

       启动应用，打开浏览器， 浏览http://localhost:8080/uflo-test/uflo/designer这个URL，就可以看到UFLO2中提供的全新的基于网页的流程模版设计器，如下图所示：

       浏览​​http://localhost:8080/uflo-test/uflo/todo​​这个URL就可以看到UFLO中提供的默认的待办页面（实际应用中多数都需要自定义待办页面），如下图：

处理任务的业务页面在完成任务后关闭弹出窗口的方法

执行JS：window.parent.dialogEvent.eventEmitter.emit(window.parent.dialogEvent.CLOSE_DIALOG)

在自定义处理任务页面里刷新待办任务列表方法

执行JS：window.parent.todoEvent.eventEmitter.emit(window.parent.todoEvent.RELOAD_TODO);

在自定义处理任务页面里刷新待领取任务列表方法

执行JS：window.parent.todoEvent.eventEmitter.emit(window.parent.todoEvent.RELOAD_CLIAM);

在自定义任务处理页面里刷新历史任务列表方法

执行JS：window.parent.todoEvent.eventEmitter.emit(window.parent.todoEvent.RELOAD_HISTORY);

浏览​​http://localhost:8080/uflo-test/uflo/central​​页面就可以看到UFLO中提供的监控测试页面。

浏览​​http://localhost:8080/uflo-test/uflo/calendar​​页面就可以看到UFLO中提供的日历管理页面。