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.cmd;
  
  import java.util.HashMap;
  import java.util.List;
  import java.util.Map;
  import org.activiti.engine.ActivitiException;
  import org.activiti.engine.ActivitiObjectNotFoundException;
  import org.activiti.engine.impl.interceptor.Command;
  import org.activiti.engine.impl.interceptor.CommandContext;
  import org.activiti.engine.impl.persistence.entity.EventSubscriptionEntityManager;
  import org.activiti.engine.impl.persistence.entity.ExecutionEntity;
  import org.activiti.engine.impl.persistence.entity.SignalEventSubscriptionEntity;
  import org.activiti.engine.runtime.Execution;
  
  /**
  
  
   */
  public class SignalEventReceivedCmd implements Command<Void> {
  
      protected final String eventName;
      protected final String executionId;
      protected final Map<String, Object> payload;
      protected final boolean async;
      protected String tenantId;
  
      public SignalEventReceivedCmd(
          String eventName,
          String executionId,
          Map<String, Object> processVariables,
          String tenantId
      ) {
          this.eventName = eventName;
          this.executionId = executionId;
          if (processVariables != null) {
              this.payload = new HashMap<String, Object>(processVariables);
          } else {
              this.payload = null;
          }
          this.async = false;
          this.tenantId = tenantId;
      }
  
      public SignalEventReceivedCmd(String eventName, String executionId, boolean async, String tenantId) {
          this.eventName = eventName;
          this.executionId = executionId;
          this.async = async;
          this.payload = null;
          this.tenantId = tenantId;
      }
  
      public Void execute(CommandContext commandContext) {
          List<SignalEventSubscriptionEntity> signalEvents = null;
  
          EventSubscriptionEntityManager eventSubscriptionEntityManager =
              commandContext.getEventSubscriptionEntityManager();
          if (executionId == null) {
              signalEvents = eventSubscriptionEntityManager.findSignalEventSubscriptionsByEventName(eventName, tenantId);
          } else {
              ExecutionEntity execution = commandContext.getExecutionEntityManager().findById(executionId);
  
              if (execution == null) {
                  throw new ActivitiObjectNotFoundException(
                      "Cannot find execution with id '" + executionId + "'",
                      Execution.class
                  );
              }
  
              if (execution.isSuspended()) {
                  throw new ActivitiException(
                      "Cannot throw signal event '" + eventName + "' because execution '" + executionId + "' is suspended"
                  );
              }
  
              signalEvents = eventSubscriptionEntityManager.findSignalEventSubscriptionsByNameAndExecution(
                  eventName,
                  executionId
              );
  
              if (signalEvents.isEmpty()) {
                  throw new ActivitiException(
                      "Execution '" +
                      executionId +
                      "' has not subscribed to a signal event with name '" +
                      eventName +
                      "'."
                  );
              }
          }
  
          for (SignalEventSubscriptionEntity signalEventSubscriptionEntity : signalEvents) {
              // We only throw the event to globally scoped signals.
              // Process instance scoped signals must be thrown within the process itself
              if (signalEventSubscriptionEntity.isGlobalScoped()) {
                  eventSubscriptionEntityManager.eventReceived(signalEventSubscriptionEntity, payload, async);
              }
          }
  
          return null;
      }
  }
  