org.finra.herd.service.ActivitiService Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of herd-service Show documentation
This project contains the business service code. This is a classic service tier where business logic is defined along with it's associated transaction management configuration.
There is a newer version: 0.160.0
Show newest version
/*
* Copyright 2015 herd contributors
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
*     http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.finra.herd.service;

import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Set;

import org.activiti.engine.history.HistoricActivityInstance;
import org.activiti.engine.history.HistoricProcessInstance;
import org.activiti.engine.repository.ProcessDefinition;
import org.activiti.engine.runtime.Execution;
import org.activiti.engine.runtime.Job;
import org.activiti.engine.runtime.ProcessInstance;
import org.joda.time.DateTime;

import org.finra.herd.model.api.xml.JobStatusEnum;

/**
 * Service interface to Activiti operations. The purpose of this interface is to provide abstraction on top of direct Activiti API (ex. to avoid chaining query
 * builder methods directly in the business logic service layer).
 */
public interface ActivitiService
{
    /**
     * Gets a process definition by its ID.
     *
     * @param processDefinitionId The process definition ID
     * @return The process definition
     */
    ProcessDefinition getProcessDefinitionById(String processDefinitionId);

    /**
     * Starts a process instance of a given process definition with the given variables.
     *
     * @param processDefinitionId The process definition ID
     * @param variables The variables
     * @return The process instance
     */
    ProcessInstance startProcessInstanceByProcessDefinitionId(String processDefinitionId, Map variables);

    /**
     * Gets a process instance by its ID.
     *
     * @param processInstanceId The process instance ID
     * @return The process instance
     */
    ProcessInstance getProcessInstanceById(String processInstanceId);

    /**
     * Gets a list of all currently suspended process instances.
     *
     * @return the list of currently suspended process instances
     */
    public List getSuspendedProcessInstances();

    /**
     * Gets a historic process instance by its process instance ID.
     *
     * @param processInstanceId The process instance ID
     * @return The historic process instance
     */
    HistoricProcessInstance getHistoricProcessInstanceByProcessInstanceId(String processInstanceId);

    /**
     * Gets all historic activity instances by their process instance ID sorted by start time and end time.
     *
     * @param processInstanceId The process instance ID
     * @return List of historic activity instances
     */
    List getHistoricActivityInstancesByProcessInstanceId(String processInstanceId);

    /**
     * Gets all jobs with exceptions by process instance ID.
     *
     * @param processInstanceId The process instance ID
     * @return List of jobs
     */
    List getJobsWithExceptionByProcessInstanceId(String processInstanceId);

    /**
     * Gets the stacktrace of a job.
     *
     * @param jobId The job ID
     * @return The stacktrace
     */
    String getJobExceptionStacktrace(String jobId);

    /**
     * Gets all process definitions by their IDs
     *
     * @param processDefinitionIds The process definition IDs
     * @return List of process definitions
     */
    List getProcessDefinitionsByIds(Set processDefinitionIds);

    /**
     * Gets the count of jobs with exceptions by their process instance ID.
     *
     * @param processInstanceId The process instance ID
     * @return The count
     */
    long getJobsWithExceptionCountByProcessInstanceId(String processInstanceId);

    /**
     * Gets all historic process instances by their status and process definition keys. When job status is RUNNING or SUSPENDED, then all "unfinished" process
     * instances are returned.
     *
     * @param jobStatus The job status. Optional.
     * @param processDefinitionKeys Collection of process definition keys
     * @param startTime an optional job start time
     * @param endTime an optional job end time
     * @return List of historic process instances
     */
    List getHistoricProcessInstancesByStatusAndProcessDefinitionKeys(JobStatusEnum jobStatus, Collection processDefinitionKeys,
        DateTime startTime, DateTime endTime);

    /**
     * Gets the count of historic process instances by their status and process definition keys. When job status is RUNNING or SUSPENDED, then all "unfinished"
     * process are counted.
     *
     * @param jobStatus The job status. Optional.
     * @param processDefinitionKeys Collection of process definition keys
     * @param startTime an optional job start time
     * @param endTime an optional job end time
     * @return The count
     */
    long getHistoricProcessInstancesCountByStatusAndProcessDefinitionKeys(JobStatusEnum jobStatus, Collection processDefinitionKeys, DateTime startTime,
        DateTime endTime);

    /**
     * Gets an execution by its process instance ID and activiti ID.
     *
     * @param processInstanceId The process instance ID
     * @param activitiId The activiti ID
     * @return The execution
     */
    Execution getExecutionByProcessInstanceIdAndActivitiId(String processInstanceId, String activitiId);

    /**
     * Signals an execution at a waiting state to continue with the given variables.
     *
     * @param executionId The execution ID
     * @param processVariables The process variables
     */
    void signal(String executionId, Map processVariables);

    /**
     * Suspends the process instance with the given id.
     *
     * @param processInstanceId the process instance id
     */
    void suspendProcessInstance(String processInstanceId);

    /**
     * Resumes (activates) the process instance with the given id.
     *
     * @param processInstanceId the process instance id
     */
    void resumeProcessInstance(String processInstanceId);

    /**
     * Gets the process model by the given process definition ID.
     *
     * @param processDefinitionId The process definition ID
     * @return The process model
     */
    String getProcessModel(String processDefinitionId);

    /**
     * Deletes a process instance by the given process instance ID and supplies the given delete reason.
     *
     * @param processInstanceId The process instance ID
     * @param deleteReason The delete reason
     */
    void deleteProcessInstance(String processInstanceId, String deleteReason);
}