content: // Licensed to the Apache Software Foundation (ASF) under one
  // or more contributor license agreements.  See the NOTICE file
  // distributed with this work for additional information
  // regarding copyright ownership.  The ASF licenses this file
  // to you 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.apache.cloudstack.api.command.user.account;
  
  import java.util.List;
  
  import org.apache.cloudstack.api.ApiArgValidator;
  import org.apache.cloudstack.api.ApiCommandResourceType;
  import org.apache.cloudstack.api.BaseCmd;
  import org.apache.cloudstack.api.response.ProjectRoleResponse;
  import org.apache.commons.lang3.EnumUtils;
  import org.apache.commons.lang3.StringUtils;
  
  import org.apache.cloudstack.api.APICommand;
  import org.apache.cloudstack.api.ApiConstants;
  import org.apache.cloudstack.api.ApiErrorCode;
  import org.apache.cloudstack.api.BaseAsyncCmd;
  import org.apache.cloudstack.api.Parameter;
  import org.apache.cloudstack.api.ServerApiException;
  import org.apache.cloudstack.api.response.ProjectResponse;
  import org.apache.cloudstack.api.response.SuccessResponse;
  import org.apache.cloudstack.context.CallContext;
  
  import com.cloud.event.EventTypes;
  import com.cloud.exception.InvalidParameterValueException;
  import com.cloud.projects.Project;
  import com.cloud.projects.ProjectAccount;
  
  @APICommand(name = "addAccountToProject", description = "Adds account to a project", responseObject = SuccessResponse.class, since = "3.0.0",
          requestHasSensitiveInfo = false, responseHasSensitiveInfo = false)
  public class AddAccountToProjectCmd extends BaseAsyncCmd {
  
  
      /////////////////////////////////////////////////////
      //////////////// API parameters /////////////////////
      /////////////////////////////////////////////////////
  
      @Parameter(name = ApiConstants.PROJECT_ID,
                 type = CommandType.UUID,
                 entityType = ProjectResponse.class,
                 required = true,
                 description = "ID of the project to add the account to")
      private Long projectId;
  
      @Parameter(name = ApiConstants.ACCOUNT, type = CommandType.STRING, description = "name of the account to be added to the project")
      private String accountName;
  
      @Parameter(name = ApiConstants.EMAIL, type = CommandType.STRING, description = "email to which invitation to the project is going to be sent")
      private String email;
  
      @Parameter(name = ApiConstants.PROJECT_ROLE_ID, type = CommandType.UUID, entityType = ProjectRoleResponse.class,
              description = "ID of the project role", validations = {ApiArgValidator.PositiveNumber})
      private Long projectRoleId;
  
      @Parameter(name = ApiConstants.ROLE_TYPE, type = BaseCmd.CommandType.STRING,
              description = "Project role type to be assigned to the user - Admin/Regular; default: Regular")
      private String roleType;
  
      /////////////////////////////////////////////////////
      /////////////////// Accessors ///////////////////////
      /////////////////////////////////////////////////////
  
      public String getAccountName() {
          return accountName;
      }
  
      public Long getProjectId() {
          return projectId;
      }
  
      public String getEmail() {
          return email;
      }
  
      public Long getProjectRoleId() {
          return projectRoleId;
      }
  
      public ProjectAccount.Role getRoleType() {
          if (StringUtils.isNotEmpty(roleType)) {
              String role = roleType.substring(0, 1).toUpperCase() + roleType.substring(1).toLowerCase();
              if (!EnumUtils.isValidEnum(ProjectAccount.Role.class, role)) {
                  throw new InvalidParameterValueException("Only Admin or Regular project role types are valid");
              }
              return Enum.valueOf(ProjectAccount.Role.class, role);
          }
          return null;
      }
  
      /////////////////////////////////////////////////////
      /////////////// API Implementation///////////////////
      /////////////////////////////////////////////////////
  
      @Override
      public void execute() {
          if (accountName == null && email == null) {
              throw new InvalidParameterValueException("Either accountName or email is required");
          }
  
          CallContext.current().setEventDetails("Project ID: " + projectId + "; accountName " + accountName);
          boolean result = _projectService.addAccountToProject(getProjectId(), getAccountName(), getEmail(), getProjectRoleId(), getRoleType());
          if (result) {
              SuccessResponse response = new SuccessResponse(getCommandName());
              this.setResponseObject(response);
          } else {
              throw new ServerApiException(ApiErrorCode.INTERNAL_ERROR, "Failed to add account to the project");
          }
      }
  
      @Override
      public long getEntityOwnerId() {
          Project project = _projectService.getProject(getProjectId());
          //verify input parameters
          if (project == null) {
              InvalidParameterValueException ex = new InvalidParameterValueException("Unable to find project with specified ID");
              ex.addProxyObject(getProjectId().toString(), "projectId");
              throw ex;
          }
  
          return _projectService.getProjectOwner(getProjectId()).getId();
      }
  
      @Override
      public List<Long> getEntityOwnerIds() {
          return _projectService.getProjectOwners(projectId);
      }
  
      @Override
      public String getEventType() {
          return EventTypes.EVENT_PROJECT_ACCOUNT_ADD;
      }
  
      @Override
      public String getEventDescription() {
          if (accountName != null) {
              return "Adding account " + getAccountName() + " to project: " + getProjectId();
          } else {
              return "Sending invitation to email " + email + " to join project: " + getProjectId();
          }
      }
  
      @Override
      public Long getApiResourceId() {
          return projectId;
      }
  
      @Override
      public ApiCommandResourceType getApiResourceType() {
          return ApiCommandResourceType.Project;
      }
  }
  