gerrit.onap Code Review - policy/clamp.git/blob

   1 /*-
   2  * ============LICENSE_START=======================================================
   3  *  Copyright (C) 2021-2023 Nordix Foundation.
   4  *  Modifications Copyright (C) 2021 AT&T Intellectual Property. All rights reserved.
   5  * ================================================================================
   6  * Licensed under the Apache License, Version 2.0 (the "License");
   7  * you may not use this file except in compliance with the License.
   8  * You may obtain a copy of the License at
   9  *
  10  *      http://www.apache.org/licenses/LICENSE-2.0
  11  *
  12  * Unless required by applicable law or agreed to in writing, software
  13  * distributed under the License is distributed on an "AS IS" BASIS,
  14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15  * See the License for the specific language governing permissions and
  16  * limitations under the License.
  17  *
  18  * SPDX-License-Identifier: Apache-2.0
  19  * ============LICENSE_END=========================================================
  20  */
  21
  22 package org.onap.policy.clamp.acm.participant.intermediary.api;
  23
  24 import java.util.Map;
  25 import java.util.UUID;
  26 import org.onap.policy.clamp.models.acm.concepts.AcTypeState;
  27 import org.onap.policy.clamp.models.acm.concepts.AutomationComposition;
  28 import org.onap.policy.clamp.models.acm.concepts.AutomationCompositionElement;
  29 import org.onap.policy.clamp.models.acm.concepts.DeployState;
  30 import org.onap.policy.clamp.models.acm.concepts.LockState;
  31 import org.onap.policy.clamp.models.acm.concepts.StateChangeResult;
  32
  33 /**
  34  * This interface is used by participant implementations to use the participant intermediary.
  35  */
  36 public interface ParticipantIntermediaryApi {
  37
  38     /**
  39      * Update the state of a automation composition element.
  40      *
  41      * @param automationCompositionId the ID of the automation composition to update the state on
  42      * @param elementId the ID of the automation composition element to update the state on
  43      * @param deployState the Deploy State of the automation composition element
  44      * @param lockState the Lock State of the automation composition element
  45      * @param stateChangeResult the indicator if error occurs
  46      * @param message the message
  47      */
  48     void updateAutomationCompositionElementState(UUID automationCompositionId, UUID elementId, DeployState deployState,
  49             LockState lockState, StateChangeResult stateChangeResult, String message);
  50
  51     /**
  52      * Get a copy of all AutomationCompositions.
  53      *
  54      * @return get all AutomationCompositions
  55      */
  56     Map<UUID, AutomationComposition> getAutomationCompositions();
  57
  58     /**
  59      * Get a copy of the AutomationCompositionElement by automationCompositionId and elementId.
  60      *
  61      * @param automationCompositionId the ID of the automation composition to update the state on
  62      * @param elementId the ID of the automation composition element to update the state on
  63      * @return get the AutomationCompositionElement
  64      */
  65     AutomationCompositionElement getAutomationCompositionElement(UUID automationCompositionId, UUID elementId);
  66
  67     /**
  68      * Send Automation Composition Element update Info to AC-runtime.
  69      *
  70      * @param automationCompositionId the ID of the automation composition to update the states
  71      * @param id the ID of the automation composition element to update the states
  72      * @param useState the use State
  73      * @param operationalState the operational State
  74      * @param outProperties the output Properties Map
  75      */
  76     void sendAcElementInfo(UUID automationCompositionId, UUID id, String useState, String operationalState,
  77             Map<String, Object> outProperties);
  78
  79     void updateCompositionState(UUID compositionId, AcTypeState state, StateChangeResult stateChangeResult,
  80             String message);
  81 }