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
10 * http://www.apache.org/licenses/LICENSE-2.0
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.
18 * SPDX-License-Identifier: Apache-2.0
19 * ============LICENSE_END=========================================================
22 package org.onap.policy.clamp.acm.runtime.commissioning;
24 import java.util.UUID;
25 import java.util.stream.Collectors;
26 import javax.ws.rs.core.Response.Status;
27 import lombok.RequiredArgsConstructor;
28 import org.onap.policy.clamp.acm.runtime.supervision.comm.ParticipantUpdatePublisher;
29 import org.onap.policy.clamp.models.acm.concepts.AcTypeState;
30 import org.onap.policy.clamp.models.acm.concepts.AutomationCompositionDefinition;
31 import org.onap.policy.clamp.models.acm.messages.rest.commissioning.AcTypeStateUpdate;
32 import org.onap.policy.clamp.models.acm.messages.rest.commissioning.CommissioningResponse;
33 import org.onap.policy.clamp.models.acm.persistence.provider.AcDefinitionProvider;
34 import org.onap.policy.clamp.models.acm.persistence.provider.AcTypeStateResolver;
35 import org.onap.policy.clamp.models.acm.persistence.provider.AutomationCompositionProvider;
36 import org.onap.policy.models.base.PfModelException;
37 import org.onap.policy.models.base.PfModelRuntimeException;
38 import org.onap.policy.models.tosca.authorative.concepts.ToscaServiceTemplate;
39 import org.onap.policy.models.tosca.authorative.concepts.ToscaServiceTemplates;
40 import org.springframework.stereotype.Service;
41 import org.springframework.transaction.annotation.Transactional;
44 * This class provides the create, read and delete actions on Commissioning of automation composition concepts in the
45 * database to the callers.
49 @RequiredArgsConstructor
50 public class CommissioningProvider {
51 public static final String AUTOMATION_COMPOSITION_NODE_TYPE = "org.onap.policy.clamp.acm.AutomationComposition";
53 private final AcDefinitionProvider acDefinitionProvider;
54 private final AutomationCompositionProvider acProvider;
55 private final AcTypeStateResolver acTypeStateResolver;
56 private final ParticipantUpdatePublisher participantUpdatePublisher;
58 private CommissioningResponse createCommissioningResponse(UUID compositionId,
59 ToscaServiceTemplate serviceTemplate) {
60 var response = new CommissioningResponse();
61 response.setCompositionId(compositionId);
63 response.setAffectedAutomationCompositionDefinitions(
64 serviceTemplate.getToscaTopologyTemplate().getNodeTemplates()
67 .map(template -> template.getKey().asIdentifier())
68 .collect(Collectors.toList()));
75 * Create automation composition from a service template.
77 * @param serviceTemplate the service template
78 * @return the result of the commissioning operation
80 public CommissioningResponse createAutomationCompositionDefinition(ToscaServiceTemplate serviceTemplate) {
82 var acmDefinition = acDefinitionProvider.createAutomationCompositionDefinition(serviceTemplate);
83 serviceTemplate = acmDefinition.getServiceTemplate();
84 return createCommissioningResponse(acmDefinition.getCompositionId(), serviceTemplate);
88 * Update Composition Definition.
90 * @param compositionId The UUID of the automation composition definition to update
91 * @param serviceTemplate the service template
92 * @return the result of the commissioning operation
94 public CommissioningResponse updateCompositionDefinition(UUID compositionId, ToscaServiceTemplate serviceTemplate) {
95 if (verifyIfInstanceExists(compositionId)) {
96 throw new PfModelRuntimeException(Status.BAD_REQUEST,
97 "There are ACM instances, Update of ACM Definition not allowed");
99 var acDefinition = acDefinitionProvider.getAcDefinition(compositionId);
100 if (!AcTypeState.COMMISSIONED.equals(acDefinition.getState())) {
101 throw new PfModelRuntimeException(Status.BAD_REQUEST,
102 "ACM not in COMMISSIONED state, Update of ACM Definition not allowed");
104 acDefinitionProvider.updateServiceTemplate(compositionId, serviceTemplate);
106 return createCommissioningResponse(compositionId, serviceTemplate);
110 * Delete the automation composition definition with the given name and version.
112 * @param compositionId The UUID of the automation composition definition to delete
113 * @return the result of the deletion
115 public CommissioningResponse deleteAutomationCompositionDefinition(UUID compositionId) {
116 if (verifyIfInstanceExists(compositionId)) {
117 throw new PfModelRuntimeException(Status.BAD_REQUEST,
118 "Delete instances, to commission automation composition definitions");
120 var acDefinition = acDefinitionProvider.getAcDefinition(compositionId);
121 if (!AcTypeState.COMMISSIONED.equals(acDefinition.getState())) {
122 throw new PfModelRuntimeException(Status.BAD_REQUEST,
123 "ACM not in COMMISSIONED state, Update of ACM Definition not allowed");
125 var serviceTemplate = acDefinitionProvider.deleteAcDefintion(compositionId);
126 return createCommissioningResponse(compositionId, serviceTemplate);
130 * Get automation composition definition.
132 * @param acName the name of the automation composition, null for all
133 * @param acVersion the version of the automation composition, null for all
134 * @return automation composition definition
135 * @throws PfModelException on errors getting automation composition definitions
137 @Transactional(readOnly = true)
138 public ToscaServiceTemplates getAutomationCompositionDefinitions(String acName, String acVersion) {
140 var result = new ToscaServiceTemplates();
141 result.setServiceTemplates(acDefinitionProvider.getServiceTemplateList(acName, acVersion));
146 * Get automation composition definition.
148 * @param compositionId the compositionId
149 * @return automation composition definition
151 @Transactional(readOnly = true)
152 public AutomationCompositionDefinition getAutomationCompositionDefinition(UUID compositionId) {
154 return acDefinitionProvider.getAcDefinition(compositionId);
158 * Validates to see if there is any instance saved.
160 * @return true if exists instance
162 private boolean verifyIfInstanceExists(UUID compositionId) {
163 return !acProvider.getAcInstancesByCompositionId(compositionId).isEmpty();
167 * Composition Definition Priming.
169 * @param compositionId the compositionId
170 * @param acTypeStateUpdate the ACMTypeStateUpdate
172 public void compositionDefinitionPriming(UUID compositionId, AcTypeStateUpdate acTypeStateUpdate) {
173 if (verifyIfInstanceExists(compositionId)) {
174 throw new PfModelRuntimeException(Status.BAD_REQUEST, "There are instances, Priming/Depriming not allowed");
176 var acmDefinition = acDefinitionProvider.getAcDefinition(compositionId);
177 var stateOrdered = acTypeStateResolver.resolve(acTypeStateUpdate.getPrimeOrder(), acmDefinition.getState());
178 switch (stateOrdered) {
180 prime(acmDefinition);
184 deprime(acmDefinition);
189 throw new PfModelRuntimeException(Status.BAD_REQUEST, "Not valid " + acTypeStateUpdate.getPrimeOrder());
193 private void prime(AutomationCompositionDefinition acmDefinition) {
194 var prearation = participantUpdatePublisher.prepareParticipantPriming(acmDefinition);
195 acDefinitionProvider.updateAcDefinition(acmDefinition);
196 participantUpdatePublisher.sendPriming(prearation, acmDefinition.getCompositionId(), null);
199 private void deprime(AutomationCompositionDefinition acmDefinition) {
200 if (!AcTypeState.COMMISSIONED.equals(acmDefinition.getState())) {
201 for (var elementState : acmDefinition.getElementStateMap().values()) {
202 elementState.setState(AcTypeState.DEPRIMING);
204 acmDefinition.setState(AcTypeState.DEPRIMING);
205 acDefinitionProvider.updateAcDefinition(acmDefinition);
207 participantUpdatePublisher.sendDepriming(acmDefinition.getCompositionId());