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.Collection;
  import java.util.List;
  import org.activiti.engine.api.internal.Internal;
  
  /**
  
   */
  @Internal
  public interface IdentityLinkEntityManager extends EntityManager<IdentityLinkEntity> {
      List<IdentityLinkEntity> findIdentityLinksByTaskId(String taskId);
  
      List<IdentityLinkEntity> findIdentityLinksByProcessInstanceId(String processInstanceId);
  
      List<IdentityLinkEntity> findIdentityLinksByProcessDefinitionId(String processDefinitionId);
  
      List<IdentityLinkEntity> findIdentityLinkByTaskUserGroupAndType(
          String taskId,
          String userId,
          String groupId,
          String type
      );
  
      List<IdentityLinkEntity> findIdentityLinkByProcessInstanceUserGroupAndType(
          String processInstanceId,
          String userId,
          String groupId,
          String type
      );
  
      List<IdentityLinkEntity> findIdentityLinkByProcessDefinitionUserAndGroup(
          String processDefinitionId,
          String userId,
          String groupId
      );
  
      IdentityLinkEntity addIdentityLink(ExecutionEntity executionEntity, String userId, String groupId, String type);
  
      IdentityLinkEntity addIdentityLink(
          ExecutionEntity executionEntity,
          String userId,
          String groupId,
          String type,
          byte[] details
      );
  
      IdentityLinkEntity addIdentityLink(TaskEntity taskEntity, String userId, String groupId, String type);
  
      IdentityLinkEntity addIdentityLink(
          TaskEntity taskEntity,
          String userId,
          String groupId,
          String type,
          byte[] details
      );
  
      IdentityLinkEntity addIdentityLink(ProcessDefinitionEntity processDefinitionEntity, String userId, String groupId);
  
      /**
       * Adds an IdentityLink for the given user id with the specified type,
       * but only if the user is not associated with the execution entity yet.
       **/
      IdentityLinkEntity involveUser(ExecutionEntity executionEntity, String userId, String type);
  
      void addCandidateUser(TaskEntity taskEntity, String userId);
  
      void addCandidateUsers(TaskEntity taskEntity, Collection<String> candidateUsers);
  
      void addCandidateGroup(TaskEntity taskEntity, String groupId);
  
      void addCandidateGroups(TaskEntity taskEntity, Collection<String> candidateGroups);
  
      void addGroupIdentityLink(TaskEntity taskEntity, String groupId, String identityLinkType);
  
      void addUserIdentityLink(TaskEntity taskEntity, String userId, String identityLinkType);
  
      void addUserIdentityLink(TaskEntity taskEntity, String userId, String identityLinkType, byte[] details);
  
      void deleteIdentityLink(IdentityLinkEntity identityLink, boolean cascadeHistory);
  
      void deleteIdentityLink(ExecutionEntity executionEntity, String userId, String groupId, String type);
  
      void deleteIdentityLink(TaskEntity taskEntity, String userId, String groupId, String type);
  
      void deleteIdentityLink(ProcessDefinitionEntity processDefinitionEntity, String userId, String groupId);
  
      void deleteIdentityLinksByTaskId(String taskId);
  
      void deleteIdentityLinksByProcDef(String processDefId);
  }
  