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 com.fasterxml.jackson.databind.JsonNode;
  import com.fasterxml.jackson.databind.node.ObjectNode;
  import java.io.Serializable;
  import org.activiti.bpmn.model.BpmnModel;
  import org.activiti.bpmn.model.SubProcess;
  import org.activiti.bpmn.model.ValuedDataObject;
  import org.activiti.engine.ActivitiIllegalArgumentException;
  import org.activiti.engine.ActivitiObjectNotFoundException;
  import org.activiti.engine.DynamicBpmnConstants;
  import org.activiti.engine.impl.DataObjectImpl;
  import org.activiti.engine.impl.context.Context;
  import org.activiti.engine.impl.interceptor.Command;
  import org.activiti.engine.impl.interceptor.CommandContext;
  import org.activiti.engine.impl.persistence.entity.ExecutionEntity;
  import org.activiti.engine.impl.persistence.entity.VariableInstance;
  import org.activiti.engine.impl.util.ProcessDefinitionUtil;
  import org.activiti.engine.runtime.DataObject;
  import org.activiti.engine.runtime.Execution;
  
  public class GetDataObjectCmd implements Command<DataObject>, Serializable {
  
      private static final long serialVersionUID = 1L;
      protected String executionId;
      protected String dataObjectName;
      protected boolean isLocal;
      protected String locale;
      protected boolean withLocalizationFallback;
  
      public GetDataObjectCmd(String executionId, String dataObjectName, boolean isLocal) {
          this.executionId = executionId;
          this.dataObjectName = dataObjectName;
          this.isLocal = isLocal;
      }
  
      public GetDataObjectCmd(
          String executionId,
          String dataObjectName,
          boolean isLocal,
          String locale,
          boolean withLocalizationFallback
      ) {
          this.executionId = executionId;
          this.dataObjectName = dataObjectName;
          this.isLocal = isLocal;
          this.locale = locale;
          this.withLocalizationFallback = withLocalizationFallback;
      }
  
      public DataObject execute(CommandContext commandContext) {
          if (executionId == null) {
              throw new ActivitiIllegalArgumentException("executionId is null");
          }
          if (dataObjectName == null) {
              throw new ActivitiIllegalArgumentException("dataObjectName is null");
          }
  
          ExecutionEntity execution = commandContext.getExecutionEntityManager().findById(executionId);
  
          if (execution == null) {
              throw new ActivitiObjectNotFoundException("execution " + executionId + " doesn't exist", Execution.class);
          }
  
          DataObject dataObject = null;
  
          VariableInstance variableEntity = getVariable(execution, commandContext);
  
          String localizedName = null;
          String localizedDescription = null;
  
          if (variableEntity != null) {
              ExecutionEntity executionEntity = commandContext
                  .getExecutionEntityManager()
                  .findById(variableEntity.getExecutionId());
              while (!executionEntity.isScope()) {
                  executionEntity = executionEntity.getParent();
              }
  
              BpmnModel bpmnModel = ProcessDefinitionUtil.getBpmnModel(executionEntity.getProcessDefinitionId());
              ValuedDataObject foundDataObject = null;
              if (executionEntity.getParentId() == null) {
                  for (ValuedDataObject dataObjectDefinition : bpmnModel.getMainProcess().getDataObjects()) {
                      if (dataObjectDefinition.getName().equals(variableEntity.getName())) {
                          foundDataObject = dataObjectDefinition;
                          break;
                      }
                  }
              } else {
                  SubProcess subProcess = (SubProcess) bpmnModel.getFlowElement(execution.getActivityId());
                  for (ValuedDataObject dataObjectDefinition : subProcess.getDataObjects()) {
                      if (dataObjectDefinition.getName().equals(variableEntity.getName())) {
                          foundDataObject = dataObjectDefinition;
                          break;
                      }
                  }
              }
  
              if (locale != null && foundDataObject != null) {
                  ObjectNode languageNode = Context.getLocalizationElementProperties(
                      locale,
                      foundDataObject.getId(),
                      execution.getProcessDefinitionId(),
                      withLocalizationFallback
                  );
  
                  if (variableEntity != null && languageNode != null) {
                      JsonNode nameNode = languageNode.get(DynamicBpmnConstants.LOCALIZATION_NAME);
                      if (nameNode != null) {
                          localizedName = nameNode.asText();
                      }
                      JsonNode descriptionNode = languageNode.get(DynamicBpmnConstants.LOCALIZATION_DESCRIPTION);
                      if (descriptionNode != null) {
                          localizedDescription = descriptionNode.asText();
                      }
                  }
              }
  
              if (foundDataObject != null) {
                  dataObject = new DataObjectImpl(
                      variableEntity.getName(),
                      variableEntity.getValue(),
                      foundDataObject.getDocumentation(),
                      foundDataObject.getType(),
                      localizedName,
                      localizedDescription,
                      foundDataObject.getId()
                  );
              }
          }
  
          return dataObject;
      }
  
      protected VariableInstance getVariable(ExecutionEntity execution, CommandContext commandContext) {
          VariableInstance variableEntity = null;
          if (isLocal) {
              variableEntity = execution.getVariableInstanceLocal(dataObjectName, false);
          } else {
              variableEntity = execution.getVariableInstance(dataObjectName, false);
          }
          return variableEntity;
      }
  }
  