# snaker-springmvc

**Repository Path**: yuqs/snaker-springmvc

## Basic Information

- **Project Name**: snaker-springmvc
- **Description**: 基于springmvc、hibernate3、snaker整合精简版
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 52
- **Forks**: 48
- **Created**: 2014-11-30
- **Last Updated**: 2025-02-17

## Categories & Tags

**Categories**: workflow

**Tags**: None

## README

Introduction
==========

Snaker-SpringMVC项目主要是基于springMVC、spring3、hibernate3、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[可选-使用JdbcAccess时需要]
    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-hibernate</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.hibernate.Hibernate3Access">
    		<property name="sessionFactory" ref="sessionFactory"/>
    	</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>
```

配置Hibernate的实体类（sessionFactory配置中增加以下属性）

```xml
    <property name="mappingResources">
		<list>
			<value>hbm/snaker.task.hbm.xml</value>
			<value>hbm/snaker.order.hbm.xml</value>
			<value>hbm/snaker.ccorder.hbm.xml</value>
			<value>hbm/snaker.process.hbm.xml</value>
			<value>hbm/snaker.taskactor.hbm.xml</value>
			<value>hbm/snaker.workitem.hbm.xml</value>
			<value>hbm/snaker.surrogate.hbm.xml</value>
		</list>
	</property>
```

配置事务[注意：事务配置会影响流程引擎的数据处理]

```xml
    <!-- 事务管理器配置,单数据源事务 -->
	<bean id="transactionManager" class="org.springframework.orm.hibernate3.HibernateTransactionManager">
		<property name="sessionFactory" ref="sessionFactory" />
	</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.springmvc.engine.SnakerEngineFacets.java
    //页面状态图使用json数据展现，通过此类构造json数据
    com.snakerflow.examples.springmvc.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.springmvc.web.ProcessContoller.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.springmvc.web.TaskController.java
```

####6).流程实例整合

前端页面整合
```java
	order.jsp//流程实例列表页面
```

后台服务整合
```java
	com.snakerflow.examples.springmvc.web.FlowController.java
```

####7).委托代理功能整合

前端页面整合
```java
	surrogateList.jsp//委托代理列表页面
    surrogateEdit.jsp//新增委托代理页面
    surrogateView.jsp//查看委托代理页面
```

后台服务整合
```java
	com.snakerflow.examples.springmvc.web.SurrogateController.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>