Activiti Rest集成Spring/SpringMVC环境(activiti rest API环境配置)（附源码）

最新推荐文章于 2023-06-30 12:28:13 发布

小流至江河

最新推荐文章于 2023-06-30 12:28:13 发布

阅读量1.6k

点赞数 3

分类专栏： Activiti 文章标签： activiti rest spring集成 spring集成activiti rest

本文链接：https://blog.csdn.net/javaYouCome/article/details/93738691

版权

Activiti 专栏收录该内容

0 篇文章 0 订阅

订阅专栏

一、Activiti REST API介绍

Activiti REST是activiti框架的一个模块，Activiti提供了基于RestFul风格的API，从而可以通过HTTP协议直接访问Activiti的REST API来实现流程的各种操作，同时也做到了跨平台，跨语音的通信，对于除了JAVA的其他语言可以通过HTTP协议访问API来操控流程引擎，使用这不需关心流程引擎使用哪种语言实现，这样做的好处是方便统一管理。

接口文档可以参考Activiti的用户手册查看各API用途

官网用户手册5.21版(第15章-REST API)http://www.mossle.com/docs/activiti/5.21/index.html#_rest_api

二、Activiti REST环境搭建

2.1 第一种是直接运行在Tomcat中

在Activiti的官网把activiti的包下载下来

文件的wars文件夹里面有三个文件activiti-app.war、activiti-admin.war、activiti-rest.war，只要将最后一个“activiti-rest.war” 放在tomcat->webapps文件夹下，修改配置文件db.properties（启动tomcat后，自动解压项目，然后再修改配置文件，记得重启tomcat）如下

db=MySQL
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/activiti?characterEncoding=UTF-8
jdbc.username=root
jdbc.password=123456

activiti-rest的lib目录下默认是没有mysql的驱动程序的，需要手动将mysql-connector-java.jar拷贝到tomcat/webapps/activiti-rest/WEB-INF/lib

接下来就可以启动tomcat了，启动成功后可以通过访问：http://localhost:8080/activiti-rest/docs/#/ 默认用户名密码是kermit/kermit，查看服务的api接口文档

默认所有REST资源都需要先使用有效的activiti用户认证后才能使用。会使用Basic HTTP认证，所以你要一直在请求的HTTP头中包含一个Authorization: Basic ...==属性，或在请求url中包含用户名和密码，有关basic的认证可以自行百度，说白了就是在请求头加上一个Authorization: Basic base64(user:possword)，编码的内容是“用户名：密码”的base64加密，默认用户名和密码都是kermit

想要测试接口的话，可以借助postman、REST Client等接口测试的软件，当然可以直接用swagger接口文档直接测试。

2.2将activiti-rest集成到项目中

直接将rest放在tomcat跑没有什么问题，可实际项目中，我们要灵活的在自己的项目中启动才放心，并且可以灵活的添加接口等内容，鉴于网上的资料和官网大部分都是对rest api的接口说明，没有对实际项目的搭建有说明，也是自己找了很多材料和实践才真是的吧activiti-rest与spring、springMVC集成出来，供大家学习参考。

自己整理好了一份项目可以自己下载参考：https://github.com/wangtaowtao/activiti-rest-spring

2.2.1 maven的依赖

activiti-rest依赖

<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-rest</artifactId>
    <version>6.0.0</version>
</dependency>

spring依赖最好是最新版本的，起码4.3.x以上的版本

2.2.2 spring配置文件

activiti-rest的所有组件的Controller都放在了org.activiti.rest包下

1. 在springMVC的配置文件要把activiti-rest的Controller包扫描添加进去

<!-- 开启spring mvc注解扫描 -->
<context:component-scan base-package="org.activiti.rest"/>

2. 因为在启动项目的时候activiti-rest还需要几个bean是自己配置的，所以还需要添加如下几个bean（踩出来的坑，我给你填）

<bean id="restResponseFactory" class="org.activiti.rest.service.api.RestResponseFactory"></bean>
<bean id="contentTypeResolver" class="org.activiti.rest.common.application.DefaultContentTypeResolver"></bean>
<bean id="objectMapper" class="com.fasterxml.jackson.databind.ObjectMapper"></bean>

当然其他的springMVC，spring-activiti等的配置还得添加，上面才是activit-rest的关键配置，以下是我的各个配置文件有用没用的可以参考，springMVC.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"
	xmlns:aop="http://www.springframework.org/schema/aop"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
		http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd
		http://www.springframework.org/schema/context  http://www.springframework.org/schema/context/spring-context.xsd">
	
	<!-- mvc注解驱动 -->
	<mvc:annotation-driven/>
	
	<!-- 开启spring mvc注解扫描 com.eyaoshun.activiti.oa.controller,com.eyaoshun.activiti.controller -->
	<context:component-scan base-package="org.activiti.rest"/>
	
	<bean id="restResponseFactory" class="org.activiti.rest.service.api.RestResponseFactory" ></bean>
	<bean id="contentTypeResolver" class="org.activiti.rest.common.application.DefaultContentTypeResolver"></bean>
	<bean id="objectMapper" class="com.fasterxml.jackson.databind.ObjectMapper"></bean>
	
	<!-- 根目录'/'对应页面 -->
	<mvc:view-controller path="/" view-name="/index.jsp" />

	<!-- Jsp视图 -->
	<bean id="viewResolver"
		class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<property name="order" value="1" />
		<property name="prefix" value="/WEB-INF/views/" />
		<property name="suffix" value=".jsp" />
		<property name="contentType" value="text/html; charset=utf-8" />
		<property name="viewClass" value="org.springframework.web.servlet.view.JstlView" />
	</bean>
	
	<!-- spring mvc 能够访问静态内容 begin -->
	<mvc:resources location="/js/" mapping="/js/**" />
	<mvc:resources location="/css/" mapping="/css/**" />
	<mvc:resources location="/image/" mapping="/image/**" />
	<mvc:resources location="/html/" mapping="/html/**" />
	<mvc:resources location="/favicon.ico" mapping="/favicon.ico" />
	<mvc:resources location="/static/" mapping="/static/**" />
	<!-- spring mvc 能够访问静态内容 end -->

	<!-- 跨域访问 -->
	<mvc:cors>
		<mvc:mapping path="/**" 
			allowed-origins="*"
			allowed-methods="GET,POST,OPTIONS" 
			allowed-headers="header1, header2"
			exposed-headers="header1, header2" 
			allow-credentials="true"
			max-age="3600" />
	</mvc:cors>
	
	<!-- 文件上传 -->
	<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
		<property name="maxUploadSize" value="104857600" /> <!-- 100m -->
		<property name="maxInMemorySize" value="4096" />
		<property name="defaultEncoding" value="UTF-8"></property>
	</bean>
	
	<!-- 定义首页 -->
	<mvc:view-controller path="/" view-name="redirect:/index" />   

</beans>

applicationContext-activiti.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:aop="http://www.springframework.org/schema/aop"
	xmlns:tx="http://www.springframework.org/schema/tx"
	xmlns:jdbc="http://www.springframework.org/schema/jdbc"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="
	     http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd
	     http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
	     http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd
	     http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd">


	<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
        <!-- 基本属性 url、user、password -->
        <property name="driverClassName" value="${jdbc.driverClassName}"/>
        <property name="url" value="${jdbc.url}"/>
        <property name="username" value="${jdbc.username}"/>
        <property name="password" value="${jdbc.password}"/>
        <!-- 配置初始化大小、最小、最大 -->
        <property name="initialSize" value="1"/>
        <property name="minIdle" value="1"/>
        <property name="maxActive" value="20"/>
        <!-- 配置获取连接等待超时的时间 -->
        <property name="maxWait" value="60000"/>
        <!-- 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒 -->
        <property name="timeBetweenEvictionRunsMillis" value="60000"/>
        <!-- 配置一个连接在池中最小生存的时间，单位是毫秒 -->
        <property name="minEvictableIdleTimeMillis" value="300000"/>
        <!-- 校验语句 -->
        <property name="validationQuery" value="SELECT 1 FROM DUAL"/>
        <property name="testWhileIdle" value="true"/>
        <property name="testOnBorrow" value="false"/>
        <property name="testOnReturn" value="false"/>
        <!-- 配置监控统计拦截的filters -->
        <property name="filters" value="stat"/>
    </bean>
	
	<!-- activiti的流程引擎配置对象由spring提供 -->
    <bean id="processEngineConfiguration" class="org.activiti.spring.SpringProcessEngineConfiguration">
        <property name="dataSource" ref="dataSource" />
        <property name="transactionManager" ref="transactionManager" />
        <property name="databaseSchemaUpdate" value="true" />
    </bean>

	<!-- activiti流程引擎对象由spring提供 -->
    <bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean">
        <property name="processEngineConfiguration" ref="processEngineConfiguration" />
    </bean>

	<!-- 各组件service由引擎获取 -->
    <bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService" />
    <bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService" />
    <bean id="formService" factory-bean="processEngine" factory-method="getFormService" />
    <bean id="identityService" factory-bean="processEngine" factory-method="getIdentityService" />
    <bean id="taskService" factory-bean="processEngine" factory-method="getTaskService" />
    <bean id="historyService" factory-bean="processEngine" factory-method="getHistoryService" />
    <bean id="managementService" factory-bean="processEngine" factory-method="getManagementService"/>
    
</beans>

applicationContext.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:aop="http://www.springframework.org/schema/aop"
       xmlns:tx="http://www.springframework.org/schema/tx" xmlns:jdbc="http://www.springframework.org/schema/jdbc"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="
     http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd
     http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
     http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd
     http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.2.xsd">
	
	<!-- 自动扫描 -->  
	<context:component-scan base-package="com.eyaoshun.activiti"/>

	<!-- <context:property-placeholder location="classpath:jdbc.properties"/> -->
	<bean id="propertyConfigurer" class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
        <property name="locations">
        	<list>
	            <value>classpath:jdbc.properties</value>
        	</list>
        </property>
    </bean>
	
	<context:annotation-config/>
	
	<aop:aspectj-autoproxy/>
	
	<!-- 使用@Transactional进行声明式事务管理需要声明下面这行 -->
	<!-- <tx:annotation-driven transaction-manager="transactionManager" proxy-target-class="false" /> -->
	<!-- 事务管理 -->
	<bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
		<property name="dataSource" ref="dataSource" />
		<property name="rollbackOnCommitFailure" value="true" />
	</bean>
	
	<import resource="applicationContext-activiti.xml"/>
	<import resource="applicationContext-mybatis.xml"/>
	
</beans>

之后运行程序，（我的项目里是用jetty启动）

希望不报错吧，然后按照接口文档的接口路径，或者自己查看源码找各action接口的访问路径去访问下接口，因为接口包括Get,Post,Put,Delete四种请求方法,所以需要借助如RESTClient等测试接口的软件(推荐：火狐的RESTClient插件，自带Basic认证功能)。

其实看源码发现，activiti-rest就是Activiti官网人家自己将activiti引擎所有的方法封装成了一套比较全的Http API，如果大家在开发activiti的项目时候不想使用REST API服务，完全可以将参考REST API源码里的东西复制出来，做成自己的逻辑业务来开发工作，岂不是也挺好的吗？

（完）

小流至江河

关注

3
点赞
踩
7

收藏

觉得还不错? 一键收藏
0
评论
Activiti Rest集成Spring/SpringMVC环境(activiti rest API环境配置)（附源码）

一、Activiti REST API介绍Activiti REST是activiti框架的一个模块，Activiti提供了基于RestFul风格的API，从而可以通过HTTP协议直接访问Activiti的REST API来实现流程的各种操作，同时也做到了跨平台，跨语音的通信，对于除了JAVA的其他语言可以通过HTTP协议访问API来操控流程引擎，使用这不需关心流程引擎使用哪种语言实现，这样...
复制链接

扫一扫