2016.3.23 集成新版activiti-modeler（5.17+）到项目中

书：《activiti实战》

博客：

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

http://www.kafeitu.me/activiti/2015/12/27/integrate-new-activiti-modeler-and-rest.html

http://blog.sina.com.cn/s/blog_bca2afff0102wrjk.html

首先按书中所说办法集成，里面的内容和博客（第一个）地址一致。但是没有注意它集成的是5.16，即旧版。但是我复制的一些文件是github中的最新版，所以造成了一些奇怪的问题。

然后搜索后，发现书的作者在15年又更新了一篇博客（第二个），针对新版5.17+的modeler集成。但是在这篇博客中，复制的文件包含了explorer的源代码，觉得不好。

搜索后，又联合参考了第三个博客。

总结：比对了许多博客，也试过几个方法，最后懂了每一步在做什么之后，就容易多了。

ps：在《activiti实战》中，作者提到集成activiti-modeler依赖activiti-rest，但是我没做activiti-rest的集成，也成功了，所以它到底依赖哪里？

集成后的效果：

访问路径: http://localhost:8080/项目名/editor-app所在文件夹路径/modeler.html?modelId=XX （前提是这个model已经创建好了）

项目总结构：

步骤简要概述：

 在pom.xml中添加依赖
 修改web.xml
 修改applicationContext.xml（与spring相关的配置）
 修改applicationContext-workflow.xml（与activiti相关的配置）
 新增applicationContext-mvc-modeler.xml（与activiti-modeler相关的配置）
 在webapp下新建文件夹designer，复制activiti-explorer的editor-app与modeler.html到此路径下。
 复制explorer的stencilset.json到resources路径下。
 在controller文件夹下新建ModelController.java，用来测试集成效果。

1.pom.xml

只列出与activiti相关的。

 版本号 5.22.0
 activiti-spring
 activiti-modeler
 activiti-diagram-rest
 activiti-explorer
 java-uuid-generator

其中的java-uuid-generator，没有在一篇博客中看到需要加这个依赖。但是我运行时总是提示缺少java.uuid，项目启动失败。搜索后我自己加了这个依赖，于是就不再报异常了。

<!-- activiti 与 Spring 集成 -->
<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-spring</artifactId>
    <version>${activiti.version}</version>
</dependency>
<!-- activiti 设计器集成 -->
<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-modeler</artifactId>
    <version>${activiti.version}</version>
</dependency>
<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-diagram-rest</artifactId>
    <version>${activiti.version}</version>
</dependency>
<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-explorer</artifactId>
    <version>${activiti.version}</version>
</dependency>
<dependency>
    <groupId>com.fasterxml.uuid</groupId>
    <artifactId>java-uuid-generator</artifactId>
    <version>3.1.4</version>
</dependency>

 2.web.xml

配置modeler的servlet。其中路径/service/* 很重要。和后面修改的app.cfg.js文件有对应关系。所以一定要匹配（不一定要取名service）。

    <servlet>
         <servlet-name>ModelRestServlet</servlet-name>
         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
         <init-param>
             <param-name>contextConfigLocation</param-name>
             <param-value>
                 classpath:/spring/**/applicationContext-mvc-modeler.xml
             </param-value>
         </init-param>
         <load-on-startup>1</load-on-startup>
     </servlet>
     <servlet-mapping>
         <servlet-name>ModelRestServlet</servlet-name>
         <url-pattern>/service/*</url-pattern>
     </servlet-mapping>

3.applicationContext.xml

     <context:component-scan
             base-package="org.activiti.rest.editor">
         <context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
     </context:component-scan>

     <import resource="classpath:spring/framework/applicationContext-workflow.xml"/>

4.applicationContext-workflow.xml

1     <!--原来就有的一些配置不再提，比如processEngine--> 
     <!-- 单例json对象 -->
     <bean id="objectMapper" class="com.fasterxml.jackson.databind.ObjectMapper"/>

     <!-- 引擎内部提供的UUID生成器，依赖fastxml的java-uuid-generator模块 -->
     <bean id="uuidGenerator" class="org.activiti.engine.impl.persistence.StrongUuidGenerator" />

5.applicationContext-mvc-modeler.xml

     <!-- 自动扫描且只扫描@Controller -->
     <context:component-scan base-package="org.activiti.rest.editor,org.activiti.rest.diagram">
         <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
     </context:component-scan>

     <mvc:annotation-driven/>

6.复制文件

先从Github下载官方Activiti源码，地址：https://github.com/Activiti/Activiti。

源码目录（如果是zip下载请先解压缩）中找到modules/activiti-webapp-explorer2/src/main子目录。去webapp里和resources里去找要复制的那三个文件。

但是我进入这个目录，根本没有editor-app、modeler.html、stencilset.json? 连webapp和resources路径都没有？？

于是我就直接复制了kafeitu的项目里的这三个文件。（版本也是5.22.0）

复制完后，修改designer/editor-app/app-cfg.js文件，把根路径修改为：项目名/ModelServlet定义的映射路径。

ACTIVITI.CONFIG = {
    'contextRoot' : '/wfs_web/service',
};

7.创建model

（1）Model.jsp与Model.js

 <!DOCTYPE html>
 <%@ page contentType="text/html; charset=UTF-8" %>
 <html>
 <head>
     <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
     <title>流程任务管理</title>

 </head>
 <body>
 <%@ include file="/bxui/bxuihead.jsp" %>
 <script type="text/javascript"
         src="<%=toolkitPath%>/bxui/baosight-require.js"></script>
 <script type="text/javascript"
         src="<%=toolkitPath%>/workflow/model.js"></script>
 <link rel="stylesheet"
       href="<%=toolkitPath%>/bxui/other/css/style-frame-inner.css"/>

     <div class="col-sm-3  col-xs-3" style="margin-top: 5px">
         <button class="btn btn-sm pull-right btn-block"
                 onclick="createModel();">
             <div class="ace-icon fa fa-search"></div>
             <span>createModel</span>
         </button>
     </div>
     <div class="col-sm-3  col-xs-3" style="margin-top: 5px">
         <button class="btn btn-sm pull-right btn-block"
                 onclick="deleteModel();">
             <div class="ace-icon fa fa-trash-o"></div>
             <span>deleteModel</span>
         </button>
     </div>
     <div class="col-sm-3  col-xs-3" style="margin-top: 5px">
         <button class="btn btn-sm pull-right btn-block"
                 onclick="viewModel();">
             <div class="ace-icon fa fa-search"></div>
             <span>createModel</span>
         </button>
     </div>
     <div class="col-sm-3  col-xs-3" style="margin-top: 5px">
         <button class="btn btn-sm pull-right btn-block"
                 onclick="updateModel();">
             <div class="ace-icon fa fa-trash-o"></div>
             <span>deleteModel</span>
         </button>
     </div>

 </body>
 </html>

model.jsp

 function createModel() {
     alert("createModel");
     var paramJsonObj = new Object();
     paramJsonObj.name = "name";
     paramJsonObj.key = "key";
     paramJsonObj.description = "description";

     var callback = {
         onSuccess: function() {
             alert("onSuccess");
         }
     };
     AjaxCommunicator.ajaxRequest('/workflow/model.do?method=create', 'POST', paramJsonObj, callback);
 }

model.js

点击button时会访问路径：

AjaxCommunicator.ajaxRequest('/workflow/model.do?method=create', 'POST', paramJsonObj, callback);

（2）ModelController


新建模型并跳转到模型设计器。

 /**
  * 流程模型控制器
  * Created by liyuhui on 2017/3/15.
  */
 @Controller
 @RequestMapping("/wfs_web/model.do")
 public class ModelController {

     protected Logger logger = LoggerFactory.getLogger(getClass());

     @Autowired
     private RepositoryService repositoryService;
     @Autowired
     private HttpServletRequest request;
     @Autowired
     private HttpServletResponse response;

     /**
      * 测试页面
      */
     @RequestMapping(value = "")
     public ModelAndView init(HttpServletRequest request,
                              HttpServletResponse response) {
         return new ModelAndView("/wfs/model"); //访问wfs目录下的model.jsp
     }

     /**
      * 创建模型
      */
     @RequestMapping(params = "method=create", method = RequestMethod.POST)
     public void create(String ajaxParam) {
         try {
             JSONObject ajaxParamObj = JSONObject.parseObject(ajaxParam);
             String name = ajaxParamObj.getString("name");
             String description = ajaxParamObj.getString("description");
             String key = ajaxParamObj.getString("key");

             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, StringUtils.defaultString(description));

             Model newModel = repositoryService.newModel();
             newModel.setMetaInfo(modelObjectNode.toString());
             newModel.setName(name);
             newModel.setKey(StringUtils.defaultString(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"));

             //打开模型设计器页面
             String a = request.getContextPath(); //wfs_web
 response.sendRedirect(request.getContextPath() + "/designer/modeler.html?modelId=" + newModel.getId());

         } catch (Exception e) {
             logger.error("创建模型失败：", e);
         }
     }
 }

（3）测试

输入http://localhost:8080/wfs_web/model.do，跳转到model.jsp页面。

点击createModel那个button，进入ModelController里的create方法。

执行完saveModel，数据库中表act_re_model多了一条信息：

然后重定向到路径：http://localhost:8080/wfs_web/designer/modeler.html?modelId=30007，成功打开设计器页面，并且可以进行操作。

因为editor-app复制到了webapp下的designer文件夹，所以路径要加上designer。

至此，集成成功，model的增删改查其他代码，可以参看咖啡兔的博客和代码。