renren-fast-activiti-rest

基于renren_fast框架，调用Activiti6 rest api

项目说明

• 基于renren-fast框架，调用activiti-rest接口，实现对工作流的各项操作。
• 调用接口的代码在/modules/app/controller/ActivitiController.java中
• 项目启动后可直接在http://localhost:8080/renren-fast/swagger-ui.html#/中调试
• 项目状态：【更新中】

REST API List

详见官方文档：https://www.activiti.org/userguide/#_rest_api

序号	REST API Item	Function
2.1.	List of Deployments	Deployments列表
2.2.	Get a deployment	获取Deployment
2.3.	Create a new deployment	创建新的Deployment
2.4.	Delete a deployment	删除Deployment
2.5.	List resources in a deployment	列出Deployment中的资源
2.6.	Get a deployment resource	获取Deployment资源
2.7.	Get a deployment resource content	获取Deployment资源内容

Process Definitions

序号	REST API Item	Function
3.1.	List of process definitions	流程定义列表
3.2.	Get a process definition	获取流程定义
3.3.	Update category for a process definition	流程定义的更新类别
3.4.	Get a process definition resource content	获取进程定义资源内容
3.5.	Get a process definition BPMN model	获取进程定义 BPMN 模型
3.6.	Suspend a process definition	暂停进程定义
3.7.	Activate a process definition	激活流程定义
3.8.	Get all candidate starters for a process-definition	获得所有候选者的过程
3.9.	Add a candidate starter to a process definition	在流程定义中添加候选启动器
3.10.	Delete a candidate starter from a process definition	从进程定义中删除候选启动器
3.11.	Get a candidate starter from a process definition	从流程定义中获取候选起始项

Models

序号	REST API Item	Function
4.1.	Get a list of models	获取模型列表
4.2.	Get a model	获取模型
4.3.	Update a model	更新模型
4.4.	Create a model	创建模型
4.5.	Delete a model	删除模型
4.6.	Get the editor source for a model	获取模型的编辑器源
4.7.	Set the editor source for a model	为模型设置编辑器源
4.8.	Get the extra editor source for a model	获取模型的额外编辑器源
4.9.	Set the extra editor source for a model	为模型设置额外的编辑器源

Process Instances

序号	REST API Item	Function
5.1.	Get a process instance	获取流程实例
5.2.	Delete a process instance	删除流程实例
5.3.	Activate or suspend a process instance	激活或挂起流程实例
5.4.	Start a process instance	启动流程实例
5.5.	List of process instances	流程实例列表
5.6.	Query process instances	查询流程实例
5.7.	Get diagram for a process instance	获取流程实例的关系图
5.8.	Get involved people for process instance	参与流程实例的人员
5.9.	Add an involved user to a process instance	将涉及的用户添加到流程实例
5.10.	Remove an involved user to from process instance	将涉及的用户从流程实例中删除
5.11.	List of variables for a process instance	流程实例的变量列表
5.12.	Get a variable for a process instance	获取流程实例的变量
5.13.	Create (or update) variables on a process instance	创建
5.14.	Update a single variable on a process instance	更新流程实例上的单个变量
5.15.	Create a new binary variable on a process-instance	在进程上创建新的二进制变量
5.16.	Update an existing binary variable on a process-instance	更新进程中的现有二进制变量

Executions

序号	REST API Item	Function
6.1.	Get an execution	获得Execution
6.2.	Execute an action on an execution	在Execution上执行操作
6.3.	Get active activities in an execution	在执行过程中获取活动
6.4.	List of executions	Execution列表
6.5.	Query executions	查询执行
6.6.	List of variables for an execution	执行变量列表
6.7.	Get a variable for an execution	获取用于执行的变量
6.8.	Create (or update) variables on an execution	创建
6.9.	Update a variable on an execution	更新Execution中的变量
6.10.	Create a new binary variable on an execution	在Execution中创建新的二进制变量
6.11.	Update an existing binary variable on a process-instance	更新Process-instance中的现有二进制变量

Tasks

序号	REST API Item	Function
7.1.	Get a task	获取任务
7.2.	List of tasks	任务清单
7.3.	Query for tasks	查询任务
7.4.	Update a task	更新任务
7.5.	Task actions	任务行动
7.6.	Delete a task	删除任务
7.7.	Get all variables for a task	获取任务的所有变量
7.8.	Get a variable from a task	从任务中获取变量
7.9.	Get the binary data for a variable	获取变量的二进制数据
7.10.	Create new variables on a task	在任务上创建新变量
7.11.	Create a new binary variable on a task	在任务上创建新的二进制变量
7.12.	Update an existing variable on a task	更新任务的现有变量
7.13.	Updating a binary variable on a task	更新任务的二进制变量
7.14.	Delete a variable on a task	删除任务上的变量
7.15.	Delete all local variables on a task	删除任务中的所有局部变量
7.16.	Get all identity links for a task	获取任务的所有标识链接
7.17.	Get all identitylinks for a task for either groups or users	为组或用户获取任务的所有 identitylinks
7.18.	Get a single identity link on a task	在任务上获取单个标识链接
7.19.	Create an identity link on a task	在任务上创建标识链接
7.20.	Delete an identity link on a task	删除任务上的标识链接
7.21.	Create a new comment on a task	创建新的任务注释
7.22.	Get all comments on a task	获取任务的所有注释
7.23.	Get a comment on a task	获取任务的注释
7.24.	Delete a comment on a task	删除任务的注释
7.25.	Get all events for a task	获取任务的所有事件
7.26.	Get an event on a task	在任务中获取事件
7.27.	Create a new attachment on a task, containing a link to an external resource	在任务上创建新附件, 包含指向外部资源的链接
7.28.	Create a new attachment on a task, with an attached file	使用附加文件在任务上创建新附件
7.29.	Get all attachments on a task	获取任务的所有附件
7.30.	Get an attachment on a task	获取任务的附件
7.31.	Get the content for an attachment	获取附件的内容
7.32.	Delete an attachment on a task	删除任务的附件

History

序号	REST API Item	Function
8.1.	Get a historic process instance	获取历史过程实例
8.2.	List of historic process instances	历史进程实例列表
8.3.	Query for historic process instances	查询历史进程实例
8.4.	Delete a historic process instance	删除历史进程实例
8.5.	Get the identity links of a historic process instance	获取历史进程实例的标识链接
8.6.	Get the binary data for a historic process instance variable	获取历史进程实例变量的二进制数据
8.7.	Create a new comment on a historic process instance	创建一个历史进程实例的新注释
8.8.	Get all comments on a historic process instance	获取历史过程实例的所有注释
8.9.	Get a comment on a historic process instance	获取一个历史过程实例的注释
8.10.	Delete a comment on a historic process instance	删除历史进程实例的注释
8.11.	Get a single historic task instance	获取单个历史任务实例
8.12.	Get historic task instances	获取历史任务实例
8.13.	Query for historic task instances	查询历史任务实例
8.14.	Delete a historic task instance	删除历史任务实例
8.15.	Get the identity links of a historic task instance	获取历史任务实例的标识链接
8.16.	Get the binary data for a historic task instance variable	获取历史任务实例变量的二进制数据
8.17.	Get historic activity instances	获取历史活动实例
8.18.	Query for historic activity instances	查询历史活动实例
8.19.	List of historic variable instances	历史变量实例列表
8.20.	Query for historic variable instances	查询历史变量实例
8.21.	Get historic detail	获取历史细节
8.22.	Query for historic details	查询历史细节
8.23.	Get the binary data for a historic detail variable	获取历史细节变量的二进制数据

Forms

序号	REST API Item	Function
9.1.	Get form data	获取表单数据
9.2.	Submit task form data	提交任务表单数据

Database tables

序号	REST API Item	Function
10.1.	List of tables	表格一览表
10.2.	Get a single table	获取单个表
10.3.	Get column info for a single table	获取单个表的列信息
10.4.	Get row data for a single table	获取单个表的行数据

Engine

序号	REST API Item	Function
11.1.	Get engine properties	获取引擎属性
11.2.	Get engine info	获取引擎信息

Runtime

序号	REST API Item	Function
12.1.	Signal event received	收到的信号事件

Jobs

序号	REST API Item	Function
13.1.	Get a single job	获得一份单独的工作
13.2.	Delete a job	删除作业
13.3.	Execute a single job	执行单个作业
13.4.	Get the exception stacktrace for a job	获取作业的异常堆栈
13.5.	Get a list of jobs	获取工作列表

Users

序号	REST API Item	Function
14.1.	Get a single user	获取单个用户
14.2.	Get a list of users	获取用户列表
14.3.	Update a user	更新用户
14.4.	Create a user	创建用户
14.5.	Delete a user	删除用户
14.6.	Get a user’s picture	获取用户的图片
14.7.	Updating a user’s picture	更新用户图片
14.8.	List a user’s info	列出用户信息
14.9.	Get a user’s info	获取用户信息
14.10.	Update a user’s info	更新用户信息
14.11.	Create a new user’s info entry	创建新用户的信息条目
14.12.	Delete a user’s info	删除用户信息

Groups

序号	REST API Item	Function
15.1.	Get a single group	获取单个组
15.2.	Get a list of groups	获取组列表
15.3.	Update a group	更新组
15.4.	Create a group	创建组
15.5.	Delete a group	删除组
15.6.	Get members in a group	获取组中的成员
15.7.	Add a member to a group	向组中添加成员
15.8.	Delete a member from a group	从组中删除成员

renren-fast框架说明（取自官方）

项目说明

• renren-fast是一个轻量级的，前后端分离的Java快速开发平台，能快速开发项目并交付【接私活利器】
• 支持MySQL、Oracle、SQL Server、PostgreSQL等主流数据库
• 前端地址：https://gitee.com/renrenio/renren-fast-vue

具有如下特点

• 友好的代码结构及注释，便于阅读及二次开发
• 实现前后端分离，通过token进行数据交互，前端再也不用关注后端技术
• 灵活的权限控制，可控制到页面或按钮，满足绝大部分的权限需求
• 页面交互使用Vue2.x，极大的提高了开发效率
• 完善的代码生成机制，可在线生成entity、xml、dao、service、vue、sql代码，减少70%以上的开发任务
• 引入quartz定时任务，可动态完成任务的添加、修改、删除、暂停、恢复及日志查看等功能
• 引入API模板，根据token作为登录令牌，极大的方便了APP接口开发
• 引入Hibernate Validator校验框架，轻松实现后端校验
• 引入云存储服务，已支持：七牛云、阿里云、腾讯云等
• 引入swagger文档支持，方便编写API接口文档

项目结构

renren-fast
├─db  项目SQL语句
│
├─common 公共模块
│  ├─aspect 系统日志
│  ├─exception 异常处理
│  ├─validator 后台校验
│  └─xss XSS过滤
│ 
├─config 配置信息
│ 
├─modules 功能模块
│  ├─app API接口模块(APP调用)
│  ├─job 定时任务模块
│  ├─oss 文件服务模块
│  └─sys 权限模块
│ 
├─RenrenApplication 项目启动类
│  
├──resources 
│  ├─mapper SQL对应的XML文件
│  └─static 静态资源

如何交流、反馈、参与贡献？

• 开发文档：https://www.renren.io/guide
• Git仓库：https://gitee.com/renrenio/renren-fast
• 人人开源社区：https://www.renren.io/community
• 官方QQ群：324780204、145799952
• 技术讨论、二次开发等咨询、问题和建议，请移步到人人开源社区，我会在第一时间进行解答和回复！
• 如需关注项目最新动态，请Watch、Star项目，同时也是对项目最好的支持
• 微信扫码并关注【人人开源】，获得项目最新动态及更新提醒
  

技术选型：

• 核心框架：Spring Boot 2.0
• 安全框架：Apache Shiro 1.4
• 视图框架：Spring MVC 5.0
• 持久层框架：MyBatis 3.3
• 定时器：Quartz 2.3
• 数据库连接池：Druid 1.0
• 日志管理：SLF4J 1.7、Log4j
• 页面交互：Vue2.x

后端部署

• 通过git下载源码
• 创建数据库renren_fast，数据库编码为UTF-8
• 执行db/mysql.sql文件，初始化数据
• 修改application-dev.yml，更新MySQL账号和密码
• Eclipse、IDEA运行RenrenApplication.java，则可启动项目
• Swagger路径：http://localhost:8080/renren-fast/swagger/index.html

前端部署

• 本项目是前后端分离的，还需要部署前端，才能运行起来
• 前端下载地址：https://gitee.com/renrenio/renren-fast-vue
• 前端部署文档：https://gitee.com/renrenio/renren-fast-vue/wikis/Home
• 前端部署完毕，就可以访问项目了，账号：admin，密码：admin

项目演示

• 演示地址：http://fast.demo.renren.io
• 账号密码：admin/admin

**接口文档效果图：** 

效果图：