Activiti_API

最新推荐文章于 2025-06-15 10:34:18 发布

hq_Tree

最新推荐文章于 2025-06-15 10:34:18 发布

阅读量653

点赞数 1

CC 4.0 BY-SA版权

分类专栏： activity-工作流

本文链接：https://blog.youkuaiyun.com/qq_31179919/article/details/71775573

activity-工作流专栏收录该内容

2 篇文章

订阅专栏

部署管理首页显示

    public String deployHome(){
        //1.查询部署对象信息
        List<Deployment> depList = workflowService.findDeployment();
        //2.查询流程定义的信息
        List<ProcessDefinition> pdList = workflowService.findProcessDefinition();

        ValueContext.putValueContext("depList", depList);
        ValueContext.putValueContext("pdList", pdList);
        return "deployHome";
    }

    /**
     * 查询部署对象信息
     */
    @Override
    public List<Deployment> findDeployment() {
        List<Deployment> list = repositoryService.createDeploymentQuery()
                .orderByDeploymenTime().asc().list();
        return list;
    }

    /**
     * 查询流程定义的信息
     */
    @Override
    public List<ProcessDefinition> findProcessDefinition() {
        List<ProcessDefinition> list = repositoryService
                .createProcessDefinitionQuery().orderByProcessDefinitionName()
                .asc().list();
        return list;
    }

发布流程

    public String newdeploy(){
        //获取页面传递的值
        //1.获取页面上传递的zip格式的文件，格式是file类型
        File file = workflowBean.getFile();
        //文件名称
        String filename = workflowBean.getFilename();
        //完成部署
        workflowService.saveNewDelove(file,filename);
        return "list";
    }

    // 部署流程定义
    @Override
    public void saveNewDelove(File file, String filename) {
        try {
            // 2：将File类型的文件转化成ZipInputStream流
            ZipInputStream zipInputStream = new ZipInputStream(
                    new FileInputStream(file));
            repositoryService.createDeployment()// 创建部署对象
                    .name(filename)// 添加部署名称
                    .addZipInputStream(zipInputStream)//
                    .deploy();// 完成部署
        } catch (Exception e) {
            e.printStackTrace();
        }
    }

删除部署信息

    public String delDeployment(){
        String deploymentId = workflowBean.getDeploymentId();
        workflowService.delDeploymentById(deploymentId);
        return "list";
    }

    /**
     * 删除流程定义
     */
    @Override
    public void delDeploymentById(String deploymentId) {
        try {
            //LogUtils.info("你好啊啊啊", this.getClass());
            repositoryService.deleteDeployment(deploymentId, true);

        } catch (Exception e) {
            LogUtils.info("你好啊啊啊", this.getClass());
            repositoryService.deleteDeployment(deploymentId);
        }
    }

查看流程图

    public String viewImage(){
        try {
            String deploymentId = workflowBean.getDeploymentId();
            String imageName = workflowBean.getImageName();
            InputStream in = workflowService.findImageView(deploymentId,imageName);
            OutputStream out = ServletActionContext.getResponse().getOutputStream();
            for(int b=-1;(b=in.read())!=-1;){
                out.write(b);
            }
            out.close();
            in.close();
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
        return null;
    }

    /**
     * 查看流程图
     */
    @Override
    public InputStream findImageView(String deploymentId, String imageName) {
        InputStream in = repositoryService.getResourceAsStream(deploymentId, imageName);
        return in;
    }

启动流程

    public String startProcess(){
        //更新请假状态，启动流程实例，让启动的流程实例关联业务
        workflowService.saveStartProcess(workflowBean);
        return "listTask";
    }

    /**
     * 启动流程
     */
    @Override
    public void saveStartProcess(WorkflowBean workflowBean) {
        //1：获取请假单ID，使用请假单ID，查询请假单的对象LeaveBill
        Long id = workflowBean.getId();
        LeaveBill leaveBill = leaveBillDao.findLeaveBillById(id);
        //2：更新请假单的请假状态从0变成1（初始录入-->审核中）
        leaveBill.setState(1);
        //3：使用当前对象获取到流程定义的key（对象的名称就是流程定义的key）
        String key = leaveBill.getClass().getSimpleName();
        /**
         * 4：从Session中获取当前任务的办理人，使用流程变量设置下一个任务的办理人
                * inputUser是流程变量的名称，
                * 获取的办理人是流程变量的值
         */
        Map<String, Object> variables = new HashMap<String,Object>();
        variables.put("inputUser", SessionContext.get().getName());//表示惟一用户
        /**
         * 5：   (1)使用流程变量设置字符串（格式：LeaveBill.id的形式），通过设置，让启动的流程（流程实例）关联业务
                (2)使用正在执行对象表中的一个字段BUSINESS_KEY（Activiti提供的一个字段），让启动的流程（流程实例）关联业务
         */
        //格式：LeaveBill.id的形式（使用流程变量）
        String objId = key+"."+id;
        variables.put("objId", objId);
        //6：使用流程定义的key，启动流程实例，同时设置流程变量，同时向正在执行的执行对象表中的字段BUSINESS_KEY添加业务数据，同时让流程关联业务
        runtimeService.startProcessInstanceByKey(key,objId,variables);

    }

任务管理首页显示

    public String listTask(){
        List<Task> list = workflowService.findPersonalTask();
        ValueContext.putValueContext("taskList", list);
        return "task";
    }

    /**
     * 查询个人任务列表
     */
    @Override
    public List<Task> findPersonalTask() {
        String name = SessionContext.get().getName();
        List<Task> list = taskService.createTaskQuery().taskAssignee(name).orderByTaskCreateTime().asc().list();
        return list;
    }

打开任务表单

    public String viewTaskForm(){
        //任务ID
        String taskId = workflowBean.getTaskId();
        //获取任务表单中任务节点的url连接
        String url = workflowService.findTaskFormKeyByTaskId(taskId);
        url += "?taskId="+taskId;
        ValueContext.putValueContext("url", url);
        return "viewTaskForm";
    }

    /**
     * 获取任务表单中任务节点的url连接
     */
    @Override
    public String findTaskFormKeyByTaskId(String taskId) {
        TaskFormData formData = formService.getTaskFormData(taskId);
        String url = formData.getFormKey();
        return url;
    }

准备表单数据

    public String audit(){
        //获取任务ID
        String taskId = workflowBean.getTaskId();
        /**一：使用任务ID，查找请假单ID，从而获取请假单信息*/
        LeaveBill leaveBill = workflowService.findLeaveBillByTaskId(taskId);
        ValueContext.putValueStack(leaveBill);
        /**二：已知任务ID，查询ProcessDefinitionEntiy对象，从而获取当前任务完成之后的连线名称，并放置到List<String>集合中*/
        List<String> outcomeList = workflowService.findOutComeListByTaskId(taskId);
        ValueContext.putValueContext("outcomeList", outcomeList);
        /**三：查询所有历史审核人的审核信息，帮助当前人完成审核，返回List<Comment>*/
        List<Comment> commentList = workflowService.findCommentByTaskId(taskId);
        ValueContext.putValueContext("commentList", commentList);
        return "taskForm";
    }

    /**一：使用任务ID，查找请假单ID，从而获取请假单信息*/
    @Override
    public LeaveBill findLeaveBillByTaskId(String taskId) {
        //1：使用任务ID，查询任务对象Task
        Task task = taskService.createTaskQuery()//
                        .taskId(taskId)//使用任务ID查询
                        .singleResult();
        //2：使用任务对象Task获取流程实例ID
        String processInstanceId = task.getProcessInstanceId();
        //3：使用流程实例ID，查询正在执行的执行对象表，返回流程实例对象
        ProcessInstance pi = runtimeService.createProcessInstanceQuery()//
                        .processInstanceId(processInstanceId)//使用流程实例ID查询
                        .singleResult();
        //4：使用流程实例对象获取BUSINESS_KEY
        String buniness_key = pi.getBusinessKey();
        //5：获取BUSINESS_KEY对应的主键ID，使用主键ID，查询请假单对象（LeaveBill.1）
        String id = "";
        if(StringUtils.isNotBlank(buniness_key)){
            //截取字符串，取buniness_key小数点的第2个值
            id = buniness_key.split("\\.")[1];
        }
        //查询请假单对象
        //使用hql语句：from LeaveBill o where o.id=1
        LeaveBill leaveBill = leaveBillDao.findLeaveBillById(Long.parseLong(id));
        return leaveBill;
    }

    /**
     * 已知任务ID，查询ProcessDefinitionEntiy对象，从而获取当前任务完成之后的连线名称，并放置到List<String>集合中
     */
    @Override
    public List<String> findOutComeListByTaskId(String taskId) {
        //返回存放连线的名称集合
        List<String> list = new ArrayList<String>();
        //1:使用任务ID，查询任务对象
        Task task = taskService.createTaskQuery()//
                    .taskId(taskId)//使用任务ID查询
                    .singleResult();
        //2：获取流程定义ID
        String processDefinitionId = task.getProcessDefinitionId();
        //3：查询ProcessDefinitionEntiy对象
        ProcessDefinitionEntity processDefinitionEntity = (ProcessDefinitionEntity) repositoryService.getProcessDefinition(processDefinitionId);
        //使用任务对象Task获取流程实例ID
        String processInstanceId = task.getProcessInstanceId();
        //使用流程实例ID，查询正在执行的执行对象表，返回流程实例对象
        ProcessInstance pi = runtimeService.createProcessInstanceQuery()//
                    .processInstanceId(processInstanceId)//使用流程实例ID查询
                    .singleResult();
        //获取当前活动的id
        String activityId = pi.getActivityId();
        //4：获取当前的活动
        ActivityImpl activityImpl = processDefinitionEntity.findActivity(activityId);
        //5：获取当前活动完成之后连线的名称
        List<PvmTransition> pvmList = activityImpl.getOutgoingTransitions();
        if(pvmList!=null && pvmList.size()>0){
            for(PvmTransition pvm:pvmList){
                String name = (String) pvm.getProperty("name");
                if(StringUtils.isNotBlank(name)){
                    list.add(name);
                }
                else{
                    list.add("默认提交");
                }
            }
        }
        return list;
    }

    /**
     * 获取批注信息，传递的是当前任务ID，获取历史任务ID对应的批注
     */
    @Override
    public List<Comment> findCommentByTaskId(String taskId) {
        List<Comment> list = new ArrayList<Comment>();
        //使用当前的任务ID，查询当前流程对应的历史任务ID
        //使用当前任务ID，获取当前任务对象
        Task task = taskService.createTaskQuery()//
                .taskId(taskId)//使用任务ID查询
                .singleResult();
        //获取流程实例ID
        String processInstanceId = task.getProcessInstanceId();
//      //使用流程实例ID，查询历史任务，获取历史任务对应的每个任务ID
//      List<HistoricTaskInstance> htiList = historyService.createHistoricTaskInstanceQuery()//历史任务表查询
//                      .processInstanceId(processInstanceId)//使用流程实例ID查询
//                      .list();
//      //遍历集合，获取每个任务ID
//      if(htiList!=null && htiList.size()>0){
//          for(HistoricTaskInstance hti:htiList){
//              //任务ID
//              String htaskId = hti.getId();
//              //获取批注信息
//              List<Comment> taskList = taskService.getTaskComments(htaskId);//对用历史完成后的任务ID
//              list.addAll(taskList);
//          }
//      }
        list = taskService.getProcessInstanceComments(processInstanceId);
        return list;
    }

提交任务

    public String submitTask(){
        workflowService.saveSubmitTask(workflowBean);
        return "listTask";
    }

    /**
     * 提交任务
     */
    @Override
    public void saveSubmitTask(WorkflowBean workflowBean) {
        //获取任务ID
        String taskId = workflowBean.getTaskId();
        //获取连线的名称
        String outcome = workflowBean.getOutcome();
        //批注信息
        String message = workflowBean.getComment();
        //获取请假单ID
        Long id = workflowBean.getId();

        /**
         * 1：在完成之前，添加一个批注信息，向act_hi_comment表中添加数据，用于记录对当前申请人的一些审核信息
         */
        //使用任务ID，查询任务对象，获取流程流程实例ID
        Task task = taskService.createTaskQuery()//
                        .taskId(taskId)//使用任务ID查询
                        .singleResult();
        //获取流程实例ID
        String processInstanceId = task.getProcessInstanceId();
        /**
         * 注意：添加批注的时候，由于Activiti底层代码是使用：
         *      String userId = Authentication.getAuthenticatedUserId();
                CommentEntity comment = new CommentEntity();
                comment.setUserId(userId);
              所有需要从Session中获取当前登录人，作为该任务的办理人（审核人），对应act_hi_comment表中的User_ID的字段，不过不添加审核人，该字段为null
             所以要求，添加配置执行使用Authentication.setAuthenticatedUserId();添加当前任务的审核人
         * */
        Authentication.setAuthenticatedUserId(SessionContext.get().getName());
        taskService.addComment(taskId, processInstanceId, message);
        /**
         * 2：如果连线的名称是“默认提交”，那么就不需要设置，如果不是，就需要设置流程变量
         * 在完成任务之前，设置流程变量，按照连线的名称，去完成任务
                 流程变量的名称：outcome
                 流程变量的值：连线的名称
         */
        Map<String, Object> variables = new HashMap<String,Object>();
        if(outcome!=null && !outcome.equals("默认提交")){
            variables.put("outcome", outcome);
        }

        //3：使用任务ID，完成当前人的个人任务，同时流程变量
        taskService.complete(taskId, variables);
        //4：当任务完成之后，需要指定下一个任务的办理人（使用类）-----已经开发完成

        /**
         * 5：在完成任务之后，判断流程是否结束
            如果流程结束了，更新请假单表的状态从1变成2（审核中-->审核完成）
         */
        ProcessInstance pi = runtimeService.createProcessInstanceQuery()//
                        .processInstanceId(processInstanceId)//使用流程实例ID查询
                        .singleResult();
        //流程结束了
        if(pi==null){
            //更新请假单表的状态从1变成2（审核中-->审核完成）
            LeaveBill bill = leaveBillDao.findLeaveBillById(id);
            bill.setState(2);
        }
    }

查看当前流程图（查看当前活动节点，并使用红色的框标注）

    public String viewCurrentImage(){
        //任务ID
        String taskId = workflowBean.getTaskId();
        /**一：查看流程图*/
        //1：获取任务ID，获取任务对象，使用任务对象获取流程定义ID，查询流程定义对象
        ProcessDefinition pd = workflowService.findProcessDefinitionByTaskId(taskId);
        //workflowAction_viewImage?deploymentId=<s:property value='#deploymentId'/>&imageName=<s:property value='#imageName'/>
        ValueContext.putValueContext("deploymentId", pd.getDeploymentId());
        ValueContext.putValueContext("imageName", pd.getDiagramResourceName());
        /**二：查看当前活动，获取当期活动对应的坐标x,y,width,height，将4个值存放到Map<String,Object>中*/
        Map<String, Object> map = workflowService.findCoordingByTask(taskId);
        ValueContext.putValueContext("acs", map);
        return "image";
    }

    public List<Comment> findCommentByLeaveBillId(Long id) {
        //使用请假单ID，查询请假单对象
        LeaveBill leaveBill = leaveBillDao.findLeaveBillById(id);
        //获取对象的名称
        String objectName = leaveBill.getClass().getSimpleName();
        //组织流程表中的字段中的值
        String objId = objectName+"."+id;

        /**1:使用历史的流程实例查询，返回历史的流程实例对象，获取流程实例ID*/
//      HistoricProcessInstance hpi = historyService.createHistoricProcessInstanceQuery()//对应历史的流程实例表
//                      .processInstanceBusinessKey(objId)//使用BusinessKey字段查询
//                      .singleResult();
//      //流程实例ID
//      String processInstanceId = hpi.getId();
        /**2:使用历史的流程变量查询，返回历史的流程变量的对象，获取流程实例ID*/
        HistoricVariableInstance hvi = historyService.createHistoricVariableInstanceQuery()//对应历史的流程变量表
                        .variableValueEquals("objId", objId)//使用流程变量的名称和流程变量的值查询
                        .singleResult();
        //流程实例ID
        String processInstanceId = hvi.getProcessInstanceId();
        List<Comment> list = taskService.getProcessInstanceComments(processInstanceId);
        return list;
    }

    /**
     * 二：查看当前活动，获取当期活动对应的坐标x,y,width,height，将4个值存放到Map<String,Object>中
         map集合的key：表示坐标x,y,width,height
         map集合的value：表示坐标对应的值
     */
    @Override
    public Map<String, Object> findCoordingByTask(String taskId) {
        //存放坐标
        Map<String, Object> map = new HashMap<String,Object>();
        //使用任务ID，查询任务对象
        Task task = taskService.createTaskQuery()//
                    .taskId(taskId)//使用任务ID查询
                    .singleResult();
        //获取流程定义的ID
        String processDefinitionId = task.getProcessDefinitionId();
        //获取流程定义的实体对象（对应.bpmn文件中的数据）
        ProcessDefinitionEntity processDefinitionEntity = (ProcessDefinitionEntity)repositoryService.getProcessDefinition(processDefinitionId);
        //流程实例ID
        String processInstanceId = task.getProcessInstanceId();
        //使用流程实例ID，查询正在执行的执行对象表，获取当前活动对应的流程实例对象
        ProcessInstance pi = runtimeService.createProcessInstanceQuery()//创建流程实例查询
                    .processInstanceId(processInstanceId)//使用流程实例ID查询
                    .singleResult();
        //获取当前活动的ID
        String activityId = pi.getActivityId();
        //获取当前活动对象
        ActivityImpl activityImpl = processDefinitionEntity.findActivity(activityId);//活动ID
        //获取坐标
        map.put("x", activityImpl.getX());
        map.put("y", activityImpl.getY());
        map.put("width", activityImpl.getWidth());
        map.put("height", activityImpl.getHeight());
        return map;
    }

查看历史的批注信息

    public String viewHisComment(){
        //获取清单ID
        Long id = workflowBean.getId();
        //1：使用请假单ID，查询请假单对象，将对象放置到栈顶，支持表单回显
        LeaveBill leaveBill = leaveBillService.findLeaveBillById(id);
        ValueContext.putValueStack(leaveBill);
        //2：使用请假单ID，查询历史的批注信息
        List<Comment> commentList = workflowService.findCommentByLeaveBillId(id);
        ValueContext.putValueContext("commentList", commentList);
        return "viewHisComment";
    }

    @Override
    public List<Comment> findCommentByLeaveBillId(Long id) {
        //使用请假单ID，查询请假单对象
        LeaveBill leaveBill = leaveBillDao.findLeaveBillById(id);
        //获取对象的名称
        String objectName = leaveBill.getClass().getSimpleName();
        //组织流程表中的字段中的值
        String objId = objectName+"."+id;

        /**1:使用历史的流程实例查询，返回历史的流程实例对象，获取流程实例ID*/
//      HistoricProcessInstance hpi = historyService.createHistoricProcessInstanceQuery()//对应历史的流程实例表
//                      .processInstanceBusinessKey(objId)//使用BusinessKey字段查询
//                      .singleResult();
//      //流程实例ID
//      String processInstanceId = hpi.getId();
        /**2:使用历史的流程变量查询，返回历史的流程变量的对象，获取流程实例ID*/
        HistoricVariableInstance hvi = historyService.createHistoricVariableInstanceQuery()//对应历史的流程变量表
                        .variableValueEquals("objId", objId)//使用流程变量的名称和流程变量的值查询
                        .singleResult();
        //流程实例ID
        String processInstanceId = hvi.getProcessInstanceId();
        List<Comment> list = taskService.getProcessInstanceComments(processInstanceId);
        return list;
    }