Introduction
==========
Snaker-Struts2项目主要是基于struts2、spring3、mybatis3、snaker框架整合的一个最基本的流程管理模块，方便大家轻松地完成流程引擎的整合
###整合步骤
####1).依赖包整合
```java
cglib-nodep-2.2.jar
commons-beanutils-1.8.3.jar
commons-lang-2.5.jar
jackson-core-asl-1.9.4.jar
jackson-mapper-asl-1.9.4.jar
slf4j-api-1.7.2.jar
joda-time-2.3.jar
snaker-core-*.*.*.jar
snaker-hibernate-*.*.*.jar
snaker-spring-*.*.*.jar
commons-dbutils-1.5.jar
juel-impl-2.1.2.jar[可选-使用Juel表达式引擎时需要,Spring框架项目,建议使用SpelExpression]
slf4j-log4j12-1.7.2.jar[可选-使用log4j日志时需要]
```
maven项目可直接添加依赖
```xml
<dependency>
<groupId>com.github.snakerflow</groupId>
<artifactId>snaker-core</artifactId>
<version>${snaker.version}</version>
</dependency>
<dependency>
<groupId>com.github.snakerflow</groupId>
<artifactId>snaker-spring</artifactId>
<version>${snaker.version}</version>
</dependency>
<dependency>
<groupId>com.github.snakerflow</groupId>
<artifactId>snaker-mybatis</artifactId>
<version>${snaker.version}</version>
</dependency>
```
####2).流程引擎配置
增加snaker的spring配置文件
```xml
<?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-3.0.xsd"
default-lazy-init="true">
<description>SnakerEngine配置 </description>
<bean class="org.snaker.engine.spring.SpringSnakerEngine">
<property name="processService" ref="processService"/>
<property name="orderService" ref="orderService"/>
<property name="taskService" ref="taskService"/>
<property name="queryService" ref="queryService"/>
<property name="managerService" ref="managerService"/>
</bean>
<bean id="dbAccess" class="org.snaker.engine.access.mybatis.MybatisAccess">
<property name="sqlSessionFactory" ref="sqlSessionFactory"/>
</bean>
<bean id="processService" class="org.snaker.engine.core.ProcessService">
<property name="access" ref="dbAccess"/>
<property name="cacheManager" ref="cacheManager"/>
</bean>
<bean id="orderService" class="org.snaker.engine.core.OrderService">
<property name="access" ref="dbAccess"/>
</bean>
<bean id="taskService" class="org.snaker.engine.core.TaskService">
<property name="access" ref="dbAccess"/>
</bean>
<bean id="managerService" class="org.snaker.engine.core.ManagerService">
<property name="access" ref="dbAccess"/>
</bean>
<bean id="queryService" class="org.snaker.engine.core.QueryService">
<property name="access" ref="dbAccess"/>
</bean>
<bean id="cacheManager" class="org.snaker.engine.cache.memory.MemoryCacheManager"/>
<bean class="org.snaker.engine.impl.LogInterceptor"/>
<bean class="org.snaker.engine.spring.SpelExpression"/>
<bean class="org.snaker.engine.impl.SurrogateInterceptor"/>
</beans>
```
配置事务[注意：事务配置会影响流程引擎的数据处理]
```xml
<!-- 事务管理器配置,单数据源事务 -->
<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource" />
</bean>
<tx:advice id="txAdvice" transaction-manager="transactionManager">
<tx:attributes>
<tx:method name="start*" propagation="REQUIRED"/>
<tx:method name="execute*" propagation="REQUIRED"/>
<tx:method name="save*" propagation="REQUIRED"/>
<tx:method name="delete*" propagation="REQUIRED" />
<tx:method name="update*" propagation="REQUIRED" />
<tx:method name="remove*" propagation="REQUIRED" />
<tx:method name="assign*" propagation="REQUIRED" />
<tx:method name="create*" propagation="REQUIRED" />
<tx:method name="complete*" propagation="REQUIRED" />
<tx:method name="finish*" propagation="REQUIRED" />
<tx:method name="terminate*" propagation="REQUIRED" />
<tx:method name="take*" propagation="REQUIRED" />
<tx:method name="deploy*" propagation="REQUIRED" />
<tx:method name="undeploy*" propagation="REQUIRED" />
<tx:method name="redeploy*" propagation="REQUIRED" />
<tx:method name="get*" propagation="REQUIRED" read-only="true" />
<tx:method name="find*" propagation="REQUIRED" read-only="true" />
<tx:method name="query*" propagation="REQUIRED" read-only="true" />
<tx:method name="search*" propagation="REQUIRED" read-only="true" />
<tx:method name="is*" propagation="REQUIRED" read-only="true" />
<tx:method name="*" propagation="REQUIRED" />
</tx:attributes>
</tx:advice>
<aop:config>
<aop:advisor advice-ref="txAdvice"
pointcut="execution(* org.snaker.engine.core..*.*(..))"/>
</aop:config>
<aop:aspectj-autoproxy proxy-target-class="true" />
```
####3).辅助工具类
```java
//流程引擎api的简易封装
com.snakerflow.examples.struts2.engine.SnakerEngineFacets.java
//页面状态图使用json数据展现，通过此类构造json数据
com.snakerflow.examples.struts2.engine.SnakerHelper.java
```
####4).流程定义整合
前端页面整合，可以将应用中的jsp页面copy，替换自己项目的样式即可
```java
processList.jsp//流程定义查询列表页面
processEdit.jsp//流程定义编辑页面,一般可编辑状态、类别、重新上传流程定义文件
processDesigner.jsp//流程定义的web设计器,需要依赖设计器的js、css等
processDeploy.jsp//流程定义部署页面,只提供一个文件上传控件,上传流程定义的xml文件
processView.jsp//流程定义查看页面,用于查看流程状态图及历史任务记录
actor.jsp//动态添加参与者页面
diagram.jsp//流程定义的状态图
```
后台服务整合
```java
com.snakerflow.examples.struts2.web.snaker.ProcessAction.java
```
Web设计器整合
```java
styles\js\snaker 文件夹
styles\js\jquery-ui-1.8.4.custom
styles\js\raphael-min.js
```
####5).待办、协办、抄送、历史任务整合
前端页面整合
```java
activeTask.jsp//待办任务页面(主办、协办、抄送)
activeTaskMore.jsp//待办任务列表页面
activeCCMore.jsp//抄送列表页面
historyTask.jsp//历史任务列表页面
```
后台服务整合
```java
com.snakerflow.examples.struts2.web.snaker.TaskAction.java
```
####6).流程实例整合
前端页面整合
```java
order.jsp//流程实例列表页面
```
后台服务整合
```java
com.snakerflow.examples.struts2.web.snaker.FlowAction.java
```
####7).委托代理功能整合
前端页面整合
```java
surrogateList.jsp//委托代理列表页面
surrogateEdit.jsp//新增委托代理页面
surrogateView.jsp//查看委托代理页面
```
后台服务整合
```java
com.snakerflow.examples.struts2.web.snaker.SurrogateAction.java
```
Contact
-----
* Snaker群号：293568574
* snakerflow: <snakerflow@163.com>
Wiki
----
* Snaker:<http://snakerflow.com/>
License
-----
Apache License Version 2.0 <http://www.apache.org/licenses/LICENSE-2.0.html>
马建仓 AI 助手
