activiti自定义流程之Spring整合activiti-modeler实例（一）：环境搭建

项目中需要整合activiti-modeler自定义流程，找了很多资料后，终于成功的跳转到activiti-modeler流程设计界面，以下是记录：

一、整合基础：eclipse4.4.1、tomcat7、jdk1.7、mysql5.6.25、maven3.2.5、activiti5.16.3、spring4.0.9
二、步骤：
   1、下载activiti-5.16.3.zip: http://www.activiti.org/download.html
   2、解压zip文件，解压后的目录打开如下：
    
   

  3、打开上图中wars，可看到如下：
 
   

   4、把上图中的api、editor、explorer、libs复制到项目的webapp下，如图：
 

   5、进入第三步所示的WEB-INF的classes目录，可看到如图：
 

   6、把上图中的editor.html、stencilset.json、plugins.xml复制到项目的src/main/sources中，（spring.xml是自己建立的）如图：
 
  

 7、配置web.xml文件，整个文件内容如下：

 <?xml version="1.0" encoding="UTF-8"?>
 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
     id="WebApp_ID" version="2.5">
     <filter>
         <description>字符集过滤器</description>
         <filter-name>encodingFilter</filter-name>
         <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
         <init-param>
             <description>字符集编码</description>
             <param-name>encoding</param-name>
             <param-value>UTF-8</param-value>
         </init-param>
     </filter>
     <filter-mapping>
         <filter-name>encodingFilter</filter-name>
         <url-pattern>/*</url-pattern>
     </filter-mapping>


     <servlet>
     <servlet-name>RestletServlet</servlet-name>
     <servlet-class>org.restlet.ext.servlet.ServerServlet</servlet-class>
     <init-param>
       <param-name>org.restlet.application</param-name>
       <param-value>org.activiti.rest.editor.application.ModelerRestApplication</param-value>
     </init-param>
   </servlet>
   <servlet-mapping>
     <servlet-name>RestletServlet</servlet-name>
     <url-pattern>/service/*</url-pattern>
   </servlet-mapping>


     <servlet>
         <servlet-name>springMVC</servlet-name>
         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
         <init-param>
             <param-name>contextConfigLocation</param-name>
             <param-value>classpath:spring.xml</param-value>
         </init-param>
     </servlet>
     <servlet-mapping>
         <servlet-name>springMVC</servlet-name>
         <url-pattern>*.do</url-pattern>
     </servlet-mapping>
     <welcome-file-list>
         <welcome-file>activiti.html</welcome-file>
         <welcome-file>activiti.htm</welcome-file>
         <welcome-file>activiti.jsp</welcome-file>
         <welcome-file>default.html</welcome-file>
         <welcome-file>default.htm</welcome-file>
         <welcome-file>default.jsp</welcome-file>
     </welcome-file-list>
 </web-app>

8、使用maven导入需要的pring、activiti以及mysql的jar包。Pom.xml内容如下：

 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
   <modelVersion>4.0.0</modelVersion>
   <groupId>activitiTest1</groupId>
   <artifactId>activitiTest1</artifactId>
   <packaging>war</packaging>
   <version>0.0.1-SNAPSHOT</version>
   <name>activitiTest1 Maven Webapp</name>
   <url>http://maven.apache.org</url>
   <dependencies>
     <dependency>
       <groupId>junit</groupId>
       <artifactId>junit</artifactId>
       <version>3.8.1</version>
       <scope>test</scope>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-beans</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-core</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-aop</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-context</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-webmvc</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-web</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-aspects</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-expression</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-tx</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
     <dependency>
         <groupId>javax.servlet</groupId>
         <artifactId>javax.servlet-api</artifactId>
         <version>3.1.0</version>
     </dependency>
     <dependency>
         <groupId>com.fasterxml.jackson.core</groupId>
         <artifactId>jackson-annotations</artifactId>
         <version>2.2.3</version>
     </dependency>
     <dependency>
         <groupId>com.fasterxml.jackson.core</groupId>
         <artifactId>jackson-core</artifactId>
         <version>2.2.3</version>
     </dependency>
     <dependency>
         <groupId>com.fasterxml.jackson.core</groupId>
         <artifactId>jackson-databind</artifactId>
         <version>2.2.3</version>
     </dependency>
     <dependency>
         <groupId>org.activiti</groupId>
         <artifactId>activiti-modeler</artifactId>
         <version>5.16</version>
     </dependency>
     <dependency>
         <groupId>org.activiti</groupId>
         <artifactId>activiti-engine</artifactId>
         <version>5.16</version>
     </dependency>
     <dependency>
         <groupId>org.activiti</groupId>
         <artifactId>activiti-explorer</artifactId>
         <version>5.16</version>
     </dependency>
     <dependency>
         <groupId>org.activiti</groupId>
         <artifactId>activiti-rest</artifactId>
         <version>5.16</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-context-support</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
     <dependency>
         <groupId>mysql</groupId>
         <artifactId>mysql-connector-java</artifactId>
         <version>5.1.34</version>
     </dependency>


     <dependency>
         <groupId>org.activiti</groupId>
         <artifactId>activiti-spring</artifactId>
         <version>5.16</version>
     </dependency>
     <dependency>
         <groupId>org.springframework</groupId>
         <artifactId>spring-jdbc</artifactId>
         <version>4.0.9.RELEASE</version>
     </dependency>
   </dependencies>
   <build>
     <finalName>activitiTest1</finalName>
   </build>
 </project>

9、建立spring的配置文件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" xmlns:p="http://www.springframework.org/schema/p"
     xmlns:context="http://www.springframework.org/schema/context"
     xmlns:mvc="http://www.springframework.org/schema/mvc"
     xsi:schemaLocation="
         http://www.springframework.org/schema/beans
         http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
         http://www.springframework.org/schema/context
         http://www.springframework.org/schema/context/spring-context-3.0.xsd
         http://www.springframework.org/schema/mvc
         http://www.springframework.org/schema/mvc/spring-mvc.xsd">


     <context:annotation-config />
     <mvc:annotation-driven />
     <context:component-scan base-package="controllers" />
     <bean id="dataSource" class="org.springframework.jdbc.datasource.SimpleDriverDataSource">

        <property name="driverClass" value="com.mysql.jdbc.Driver"></property>
        <property name="url" value="jdbc:mysql://192.168.0.201:3306/testtu?useUnicode=true&characterEncoding=utf8" ></property>
        <property name="username" value="root" ></property>
        <property name="password" value="123456" ></property>
     </bean>

     <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"></property>
     </bean>

     <bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration">
         <property name="dataSource" ref="dataSource" />
         <property name="databaseSchemaUpdate" value="true" />
         <property name="jobExecutorActivate" value="false"/>
         <property name="history" value="full"/>
         <property name="transactionManager" ref="transactionManager" />
         <!-- 配置事务管理器，统一事务 -->

         <!-- 设置建表策略，如果没有表，自动创建表 -->
     </bean>
     <!-- 创建流程引擎对象 -->
     <bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean">
         <property name="processEngineConfiguration" ref="processEngineConfiguration" />
     </bean>


     <!-- 由流程引擎对象，提供的方法，创建项目中使用的Activiti工作流的Service -->
     <bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService" />
     <bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService" />
     <bean id="taskService" factory-bean="processEngine" factory-method="getTaskService" />
     <bean id="historyService" factory-bean="processEngine" factory-method="getHistoryService" />
     <bean id="formService" factory-bean="processEngine" factory-method="getFormService" />

     <!-- 避免IE执行AJAX时,返回JSON出现下载文件 -->
     <bean id="mappingJacksonHttpMessageConverter"
         class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
         <property name="supportedMediaTypes">
             <list>
                 <value>text/html;charset=UTF-8</value>
             </list>
         </property>
     </bean>


     <!-- 启动Spring MVC的注解功能，完成请求和注解POJO的映射 -->
     <bean
         class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
         <property name="messageConverters">
             <list>
                 <ref bean="mappingJacksonHttpMessageConverter" /><!-- json转换器 -->
             </list>
         </property>
     </bean>

 </beans>

10、建立controller类，用来控制页面跳转到activiti-modeler流程设计页面：

 package controllers;


 import java.util.HashMap;
 import java.util.Map;


 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;


 import org.activiti.editor.constants.ModelDataJsonConstants;
 import org.activiti.engine.RepositoryService;
 import org.activiti.engine.repository.Model;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Controller;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestMethod;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.ResponseBody;


 import com.fasterxml.jackson.databind.ObjectMapper;
 import com.fasterxml.jackson.databind.node.ObjectNode;


 @Controller
 public class ActivitiController {
     @Autowired
     private RepositoryService repositoryService;


     /**
      * 查询生日列表
      *
      * @param req
      * @return
      */
     @RequestMapping(value = "/activiti.do", method = RequestMethod.GET, produces = "application/json;charset=utf-8")
     @ResponseBody
     public Object brithdayList(HttpServletRequest req) {
         Map<String, Object> map = new HashMap<String, Object>();
         map.put("name", "activiti");
         return map;
     }


     @RequestMapping(value = "/create.do", method = RequestMethod.GET, produces = "application/json;charset=utf-8")
     public void create(
             @RequestParam("name") String name,
             @RequestParam("key") String key,
             @RequestParam(value = "description", required = false) String description,
             HttpServletRequest request, HttpServletResponse response) {
         try {
             ObjectMapper objectMapper = new ObjectMapper();
             ObjectNode modelObjectNode = objectMapper.createObjectNode();
             modelObjectNode.put(ModelDataJsonConstants.MODEL_NAME, name);
             modelObjectNode.put(ModelDataJsonConstants.MODEL_REVISION, 1);
             modelObjectNode.put(ModelDataJsonConstants.MODEL_DESCRIPTION,
                     org.apache.commons.lang3.StringUtils
                             .defaultString(description));
             Model newModel = repositoryService.newModel();
             newModel.setMetaInfo(modelObjectNode.toString());
             newModel.setName(name);
             newModel.setKey(key);
             repositoryService.saveModel(newModel);
             ObjectNode editorNode = objectMapper.createObjectNode();
             editorNode.put("id", "canvas");
             editorNode.put("resourceId", "canvas");
             ObjectNode stencilSetNode = objectMapper.createObjectNode();
             stencilSetNode.put("namespace",
                     "http://b3mn.org/stencilset/bpmn2.0#");
             editorNode.put("stencilset", stencilSetNode);
             repositoryService.addModelEditorSource(newModel.getId(), editorNode
                     .toString().getBytes("utf-8"));
             response.sendRedirect(request.getContextPath()
                     + "/service/editor?id=" + newModel.getId());
         } catch (Exception e) {
             e.getStackTrace();
         }
     }
 }

11、修改index.jsp为activiti.html:

 <!DOCTYPE html>
 <html>
 <head>
 <meta charset="utf-8">
 </head>
 <body>
 <h2>Hello World!</h2>
 <a href="./activiti.do">activiti</a>
   <form action="./create.do" method="get">
     <input type="text" id="name" name="name"></input>
     <input type="text" id="key" name="key"></input>
     <input type="text" id="description" name="description"></input>
     <input type="submit" value="提交">
   </form>
 </body>
 </html>

12、启动项目，使用http://localhost:8080/activitiTest1访问项目，看到如下页面：

 
13、点击提交后，跳转到流程图设计界面：

参考文档：http://weir2009.iteye.com/blog/2119072

                    http://lpyyn.iteye.com/blog/2149219

                   http://www.mossle.com/docs/activiti/index.html

                   http://blog.csdn.net/lfsf802/article/details/46237003

                   http://www.kafeitu.me/activiti/2013/03/10/integrate-activiti-modeler.html