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.jobexecutor;
  
  import java.util.HashMap;
  import org.activiti.bpmn.model.FlowElement;
  import org.activiti.engine.ActivitiException;
  import org.activiti.engine.delegate.event.ActivitiEventType;
  import org.activiti.engine.delegate.event.impl.ActivitiEventBuilder;
  import org.activiti.engine.impl.cmd.StartProcessInstanceCmd;
  import org.activiti.engine.impl.interceptor.CommandContext;
  import org.activiti.engine.impl.persistence.entity.ExecutionEntity;
  import org.activiti.engine.impl.persistence.entity.JobEntity;
  import org.activiti.engine.impl.persistence.entity.ProcessDefinitionEntity;
  import org.activiti.engine.impl.util.ProcessDefinitionUtil;
  import org.activiti.engine.impl.util.ProcessInstanceHelper;
  import org.slf4j.Logger;
  import org.slf4j.LoggerFactory;
  
  public class TimerStartEventJobHandler extends TimerEventHandler implements JobHandler {
  
      private static Logger log = LoggerFactory.getLogger(TimerStartEventJobHandler.class);
  
      public static final String TYPE = "timer-start-event";
  
      public String getType() {
          return TYPE;
      }
  
      public void execute(JobEntity job, String configuration, ExecutionEntity execution, CommandContext commandContext) {
          ProcessDefinitionEntity processDefinitionEntity = ProcessDefinitionUtil.getProcessDefinitionFromDatabase(
              job.getProcessDefinitionId()
          ); // From DB -> need to get latest suspended state
          if (processDefinitionEntity == null) {
              throw new ActivitiException("Could not find process definition needed for timer start event");
          }
  
          try {
              if (!processDefinitionEntity.isSuspended()) {
                  if (commandContext.getEventDispatcher().isEnabled()) {
                      commandContext
                          .getEventDispatcher()
                          .dispatchEvent(ActivitiEventBuilder.createEntityEvent(ActivitiEventType.TIMER_FIRED, job));
                  }
  
                  // Find initial flow element matching the signal start event
                  org.activiti.bpmn.model.Process process = ProcessDefinitionUtil.getProcess(
                      job.getProcessDefinitionId()
                  );
                  String activityId = TimerEventHandler.getActivityIdFromConfiguration(configuration);
                  if (activityId != null) {
                      FlowElement flowElement = process.getFlowElement(activityId, true);
                      if (flowElement == null) {
                          throw new ActivitiException("Could not find matching FlowElement for activityId " + activityId);
                      }
                      ProcessInstanceHelper processInstanceHelper = commandContext
                          .getProcessEngineConfiguration()
                          .getProcessInstanceHelper();
                      processInstanceHelper.createAndStartProcessInstanceWithInitialFlowElement(
                          processDefinitionEntity,
                          null,
                          null,
                          flowElement,
                          process,
                          new HashMap<>(),
                          null,
                          true
                      );
                  } else {
                      new StartProcessInstanceCmd(
                          processDefinitionEntity.getKey(),
                          null,
                          null,
                          null,
                          job.getTenantId()
                      ).execute(commandContext);
                  }
              } else {
                  log.debug("ignoring timer of suspended process definition {}", processDefinitionEntity.getName());
              }
          } catch (RuntimeException e) {
              log.error("exception during timer execution", e);
              throw e;
          } catch (Exception e) {
              log.error("exception during timer execution", e);
              throw new ActivitiException("exception during timer execution: " + e.getMessage(), e);
          }
      }
  }
  