content: /*
   * Copyright 2010-2025 Hyland Software, Inc. and its affiliates.
   *
   * 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.activiti.engine.impl.persistence.entity;
  
  import java.util.List;
  import java.util.Map;
  import org.activiti.engine.ActivitiException;
  import org.activiti.engine.delegate.TaskListener;
  import org.activiti.engine.delegate.event.ActivitiEventType;
  import org.activiti.engine.delegate.event.impl.ActivitiEventBuilder;
  import org.activiti.engine.impl.TaskQueryImpl;
  import org.activiti.engine.impl.cfg.ProcessEngineConfigurationImpl;
  import org.activiti.engine.impl.history.HistoryLevel;
  import org.activiti.engine.impl.persistence.CountingExecutionEntity;
  import org.activiti.engine.impl.persistence.entity.data.DataManager;
  import org.activiti.engine.impl.persistence.entity.data.TaskDataManager;
  import org.activiti.engine.task.IdentityLinkType;
  import org.activiti.engine.task.Task;
  import org.activiti.engine.task.TaskInfo;
  import org.apache.commons.lang3.StringUtils;
  
  /**
  
  
   */
  public class TaskEntityManagerImpl extends AbstractEntityManager<TaskEntity> implements TaskEntityManager {
  
      protected TaskDataManager taskDataManager;
  
      public TaskEntityManagerImpl(
          ProcessEngineConfigurationImpl processEngineConfiguration,
          TaskDataManager taskDataManager
      ) {
          super(processEngineConfiguration);
          this.taskDataManager = taskDataManager;
      }
  
      @Override
      protected DataManager<TaskEntity> getDataManager() {
          return taskDataManager;
      }
  
      @Override
      public TaskEntity create() {
          TaskEntity taskEntity = super.create();
          taskEntity.setCreateTime(getClock().getCurrentTime());
          return taskEntity;
      }
  
      @Override
      public void insert(TaskEntity taskEntity, boolean fireCreateEvent) {
          if (taskEntity.getOwner() != null) {
              addOwnerIdentityLink(taskEntity, taskEntity.getOwner());
          }
          if (taskEntity.getAssignee() != null) {
              addAssigneeIdentityLinks(taskEntity);
          }
  
          super.insert(taskEntity, fireCreateEvent);
      }
  
      @Override
      public void insert(TaskEntity taskEntity, ExecutionEntity execution) {
          // Inherit tenant id (if applicable)
          if (execution != null && execution.getTenantId() != null) {
              taskEntity.setTenantId(execution.getTenantId());
          }
  
          if (execution != null) {
              execution.getTasks().add(taskEntity);
              taskEntity.setExecutionId(execution.getId());
              taskEntity.setProcessInstanceId(execution.getProcessInstanceId());
              taskEntity.setTaskProcessRootProcessInstanceId(execution.getRootProcessInstanceId());
              taskEntity.setProcessDefinitionId(execution.getProcessDefinitionId());
              taskEntity.setAppVersion(execution.getAppVersion());
  
              getHistoryManager().recordTaskExecutionIdChange(taskEntity.getId(), taskEntity.getExecutionId());
          }
  
          insert(taskEntity, true);
  
          if (execution != null && isExecutionRelatedEntityCountEnabled(execution)) {
              CountingExecutionEntity countingExecutionEntity = (CountingExecutionEntity) execution;
              countingExecutionEntity.setTaskCount(countingExecutionEntity.getTaskCount() + 1);
          }
  
          getHistoryManager().recordTaskCreated(taskEntity, execution);
          getHistoryManager().recordTaskId(taskEntity);
          if (taskEntity.getFormKey() != null) {
              getHistoryManager().recordTaskFormKeyChange(taskEntity.getId(), taskEntity.getFormKey());
          }
      }
  
      @Override
      public void changeTaskAssignee(TaskEntity taskEntity, String assignee) {
          changeTaskAssignee(taskEntity, assignee, true);
      }
  
      @Override
      public void changeTaskAssigneeNoEvents(TaskEntity taskEntity, String assignee) {
          changeTaskAssignee(taskEntity, assignee, false);
      }
  
      private void changeTaskAssignee(TaskEntity taskEntity, String assignee, boolean fireEvents) {
          if (
              (taskEntity.getAssignee() != null && !taskEntity.getAssignee().equals(assignee)) ||
              (taskEntity.getAssignee() == null && assignee != null)
          ) {
              taskEntity.setAssignee(assignee);
              if (fireEvents) {
                  fireAssignmentEvents(taskEntity);
              } else {
                  recordTaskAssignment(taskEntity);
              }
  
              if (taskEntity.getId() != null) {
                  getHistoryManager().recordTaskAssigneeChange(taskEntity.getId(), taskEntity.getAssignee());
                  addAssigneeIdentityLinks(taskEntity);
                  update(taskEntity, fireEvents);
              }
          }
      }
  
      @Override
      public void changeTaskOwner(TaskEntity taskEntity, String owner) {
          if (
              (taskEntity.getOwner() != null && !taskEntity.getOwner().equals(owner)) ||
              (taskEntity.getOwner() == null && owner != null)
          ) {
              taskEntity.setOwner(owner);
  
              if (taskEntity.getId() != null) {
                  getHistoryManager().recordTaskOwnerChange(taskEntity.getId(), taskEntity.getOwner());
                  addOwnerIdentityLink(taskEntity, taskEntity.getOwner());
                  update(taskEntity);
              }
          }
      }
  
      protected void fireAssignmentEvents(TaskEntity taskEntity) {
          recordTaskAssignment(taskEntity);
          if (getEventDispatcher().isEnabled()) {
              getEventDispatcher().dispatchEvent(
                  ActivitiEventBuilder.createEntityEvent(ActivitiEventType.TASK_ASSIGNED, taskEntity)
              );
          }
      }
  
      protected void recordTaskAssignment(TaskEntity taskEntity) {
          getProcessEngineConfiguration()
              .getListenerNotificationHelper()
              .executeTaskListeners(taskEntity, TaskListener.EVENTNAME_ASSIGNMENT);
          getHistoryManager().recordTaskAssignment(taskEntity);
      }
  
      private void addAssigneeIdentityLinks(TaskEntity taskEntity) {
          if (taskEntity.getAssignee() != null && taskEntity.getProcessInstance() != null) {
              getIdentityLinkEntityManager().involveUser(
                  taskEntity.getProcessInstance(),
                  taskEntity.getAssignee(),
                  IdentityLinkType.PARTICIPANT
              );
          }
      }
  
      protected void addOwnerIdentityLink(TaskEntity taskEntity, String owner) {
          if (owner == null && taskEntity.getOwner() == null) {
              return;
          }
  
          if (owner != null && taskEntity.getProcessInstanceId() != null) {
              getIdentityLinkEntityManager().involveUser(
                  taskEntity.getProcessInstance(),
                  owner,
                  IdentityLinkType.PARTICIPANT
              );
          }
      }
  
      @Override
      public void deleteTasksByProcessInstanceId(String processInstanceId, String deleteReason, boolean cascade) {
          List<TaskEntity> tasks = findTasksByProcessInstanceId(processInstanceId);
  
          for (TaskEntity task : tasks) {
              if (getEventDispatcher().isEnabled() && !task.isCanceled()) {
                  task.setCanceled(true);
                  getEventDispatcher().dispatchEvent(
                      ActivitiEventBuilder.createActivityCancelledEvent(
                          task.getExecution().getActivityId(),
                          task.getName(),
                          task.getExecutionId(),
                          task.getProcessInstanceId(),
                          task.getProcessDefinitionId(),
                          "userTask",
                          deleteReason
                      )
                  );
              }
  
              deleteTask(task, deleteReason, cascade, false);
          }
      }
  
      @Override
      public void deleteTask(TaskEntity task, String deleteReason, boolean cascade, boolean cancel) {
          if (!task.isDeleted()) {
              getProcessEngineConfiguration()
                  .getListenerNotificationHelper()
                  .executeTaskListeners(task, TaskListener.EVENTNAME_DELETE);
              task.setDeleted(true);
  
              String taskId = task.getId();
  
              List<Task> subTasks = findTasksByParentTaskId(taskId);
              for (Task subTask : subTasks) {
                  deleteTask((TaskEntity) subTask, deleteReason, cascade, cancel);
              }
  
              getIdentityLinkEntityManager().deleteIdentityLinksByTaskId(taskId);
              getVariableInstanceEntityManager().deleteVariableInstanceByTask(task);
  
              if (cascade) {
                  getHistoricTaskInstanceEntityManager().delete(taskId);
              } else {
                  getHistoryManager().recordTaskEnd(taskId, deleteReason);
              }
  
              delete(task, false);
  
              if (getEventDispatcher().isEnabled()) {
                  if (cancel && !task.isCanceled()) {
                      task.setCanceled(true);
                      getEventDispatcher().dispatchEvent(
                              ActivitiEventBuilder.createActivityCancelledEvent(
                                  task.getExecution() != null ? task.getExecution().getActivityId() : null,
                                  task.getName(),
                                  //temporary fix for standalone tasks
                                  task.getExecutionId() != null ? task.getExecutionId() : task.getId(),
                                  task.getProcessInstanceId(),
                                  task.getProcessDefinitionId(),
                                  "userTask",
                                  deleteReason
                              )
                          );
                  }
                  getEventDispatcher().dispatchEvent(
                      ActivitiEventBuilder.createEntityEvent(ActivitiEventType.ENTITY_DELETED, task)
                  );
              }
          }
      }
  
      @Override
      public void delete(TaskEntity entity, boolean fireDeleteEvent) {
          super.delete(entity, fireDeleteEvent);
  
          if (entity.getExecutionId() != null && isExecutionRelatedEntityCountEnabledGlobally()) {
              CountingExecutionEntity countingExecutionEntity = (CountingExecutionEntity) entity.getExecution();
              if (isExecutionRelatedEntityCountEnabled(countingExecutionEntity)) {
                  countingExecutionEntity.setTaskCount(countingExecutionEntity.getTaskCount() - 1);
              }
          }
      }
  
      @Override
      public List<TaskEntity> findTasksByExecutionId(String executionId) {
          return taskDataManager.findTasksByExecutionId(executionId);
      }
  
      @Override
      public List<TaskEntity> findTasksByProcessInstanceId(String processInstanceId) {
          return taskDataManager.findTasksByProcessInstanceId(processInstanceId);
      }
  
      @Override
      public List<Task> findTasksByQueryCriteria(TaskQueryImpl taskQuery) {
          return taskDataManager.findTasksByQueryCriteria(taskQuery);
      }
  
      @Override
      public List<Task> findTasksAndVariablesByQueryCriteria(TaskQueryImpl taskQuery) {
          return taskDataManager.findTasksAndVariablesByQueryCriteria(taskQuery);
      }
  
      @Override
      public long findTaskCountByQueryCriteria(TaskQueryImpl taskQuery) {
          return taskDataManager.findTaskCountByQueryCriteria(taskQuery);
      }
  
      @Override
      public List<Task> findTasksByNativeQuery(Map<String, Object> parameterMap, int firstResult, int maxResults) {
          return taskDataManager.findTasksByNativeQuery(parameterMap, firstResult, maxResults);
      }
  
      @Override
      public long findTaskCountByNativeQuery(Map<String, Object> parameterMap) {
          return taskDataManager.findTaskCountByNativeQuery(parameterMap);
      }
  
      @Override
      public List<Task> findTasksByParentTaskId(String parentTaskId) {
          return taskDataManager.findTasksByParentTaskId(parentTaskId);
      }
  
      @Override
      public void deleteTask(String taskId, String deleteReason, boolean cascade, boolean cancel) {
          TaskEntity task = findById(taskId);
  
          if (task != null) {
              if (task.getExecutionId() != null) {
                  throw new ActivitiException("The task cannot be deleted because is part of a running process");
              }
  
              deleteTask(task, deleteReason, cascade, cancel);
          } else if (cascade) {
              getHistoricTaskInstanceEntityManager().delete(taskId);
          }
      }
  
      @Override
      public void deleteTask(String taskId, String deleteReason, boolean cascade) {
          this.deleteTask(taskId, deleteReason, cascade, false);
      }
  
      @Override
      public void updateTaskTenantIdForDeployment(String deploymentId, String newTenantId) {
          taskDataManager.updateTaskTenantIdForDeployment(deploymentId, newTenantId);
      }
  
      public TaskDataManager getTaskDataManager() {
          return taskDataManager;
      }
  
      public void setTaskDataManager(TaskDataManager taskDataManager) {
          this.taskDataManager = taskDataManager;
      }
  }
  