2 * ============LICENSE_START=======================================================
3 * Copyright (C) 2021 Nordix Foundation.
4 * ================================================================================
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
17 * SPDX-License-Identifier: Apache-2.0
18 * ============LICENSE_END=========================================================
21 package org.onap.policy.clamp.controlloop.runtime.commissioning;
23 import java.io.Closeable;
24 import java.io.IOException;
25 import java.util.ArrayList;
26 import java.util.Collections;
27 import java.util.List;
29 import java.util.stream.Collectors;
30 import org.apache.commons.collections4.CollectionUtils;
31 import org.apache.commons.collections4.MapUtils;
32 import org.onap.policy.clamp.controlloop.models.controlloop.persistence.provider.ControlLoopProvider;
33 import org.onap.policy.clamp.controlloop.models.messages.rest.commissioning.CommissioningResponse;
34 import org.onap.policy.models.base.PfModelException;
35 import org.onap.policy.models.base.PfModelRuntimeException;
36 import org.onap.policy.models.provider.PolicyModelsProvider;
37 import org.onap.policy.models.provider.PolicyModelsProviderFactory;
38 import org.onap.policy.models.provider.PolicyModelsProviderParameters;
39 import org.onap.policy.models.tosca.authorative.concepts.ToscaConceptIdentifier;
40 import org.onap.policy.models.tosca.authorative.concepts.ToscaNodeTemplate;
41 import org.onap.policy.models.tosca.authorative.concepts.ToscaServiceTemplate;
42 import org.onap.policy.models.tosca.authorative.concepts.ToscaServiceTemplates;
43 import org.onap.policy.models.tosca.authorative.concepts.ToscaTypedEntityFilter;
46 * This class provides the create, read and delete actions on Commissioning of Control Loop concepts in the database to
49 public class CommissioningProvider implements Closeable {
50 public static final String CONTROL_LOOP_NODE_TYPE = "org.onap.policy.clamp.controlloop.ControlLoop";
52 private final PolicyModelsProvider modelsProvider;
53 private final ControlLoopProvider clProvider;
55 private static final Object lockit = new Object();
58 * Create a commissioning provider.
59 * @param databaseProviderParameters parameters for database access
60 * @throws PfModelRuntimeException on errors creating the database provider
62 public CommissioningProvider(PolicyModelsProviderParameters databaseProviderParameters) {
64 modelsProvider = new PolicyModelsProviderFactory()
65 .createPolicyModelsProvider(databaseProviderParameters);
66 } catch (PfModelException e) {
67 throw new PfModelRuntimeException(e);
71 clProvider = new ControlLoopProvider(databaseProviderParameters);
72 } catch (PfModelException e) {
73 throw new PfModelRuntimeException(e);
78 public void close() throws IOException {
80 modelsProvider.close();
81 } catch (PfModelException e) {
82 throw new IOException("error closing modelsProvider", e);
87 * Create control loops from a service template.
89 * @param serviceTemplate the service template
90 * @return the result of the commissioning operation
91 * @throws PfModelException on creation errors
93 public CommissioningResponse createControlLoopDefinitions(ToscaServiceTemplate serviceTemplate)
94 throws PfModelException {
95 synchronized (lockit) {
96 modelsProvider.createServiceTemplate(serviceTemplate);
99 var response = new CommissioningResponse();
101 response.setAffectedControlLoopDefinitions(serviceTemplate.getToscaTopologyTemplate().getNodeTemplates()
104 .map(template -> template.getKey().asIdentifier())
105 .collect(Collectors.toList()));
112 * Delete the control loop definition with the given name and version.
114 * @param name the name of the control loop definition to delete
115 * @param version the version of the control loop to delete
116 * @return the result of the deletion
117 * @throws PfModelException on deletion errors
119 public CommissioningResponse deleteControlLoopDefinition(String name, String version) throws PfModelException {
120 synchronized (lockit) {
121 modelsProvider.deleteServiceTemplate(name, version);
124 var response = new CommissioningResponse();
125 response.setAffectedControlLoopDefinitions(
126 Collections.singletonList(new ToscaConceptIdentifier(name, version)));
132 * Get control loop node templates.
134 * @param clName the name of the control loop, null for all
135 * @param clVersion the version of the control loop, null for all
136 * @return list of control loop node templates
137 * @throws PfModelException on errors getting control loop definitions
139 public List<ToscaNodeTemplate> getControlLoopDefinitions(String clName, String clVersion) throws PfModelException {
142 ToscaTypedEntityFilter<ToscaNodeTemplate> nodeTemplateFilter = ToscaTypedEntityFilter
143 .<ToscaNodeTemplate>builder()
146 .type(CONTROL_LOOP_NODE_TYPE)
150 return clProvider.getFilteredNodeTemplates(nodeTemplateFilter);
154 * Get the control loop elements from a control loop node template.
156 * @param controlLoopNodeTemplate the control loop node template
157 * @return a list of the control loop element node templates in a control loop node template
158 * @throws PfModelException on errors get control loop element node templates
160 public List<ToscaNodeTemplate> getControlLoopElementDefinitions(ToscaNodeTemplate controlLoopNodeTemplate)
161 throws PfModelException {
162 if (!CONTROL_LOOP_NODE_TYPE.equals(controlLoopNodeTemplate.getType())) {
163 return Collections.emptyList();
166 if (MapUtils.isEmpty(controlLoopNodeTemplate.getProperties())) {
167 return Collections.emptyList();
170 @SuppressWarnings("unchecked")
171 List<Map<String, String>> controlLoopElements =
172 (List<Map<String, String>>) controlLoopNodeTemplate.getProperties().get("elements");
174 if (CollectionUtils.isEmpty(controlLoopElements)) {
175 return Collections.emptyList();
178 List<ToscaNodeTemplate> controlLoopElementList = new ArrayList<>();
180 controlLoopElementList.addAll(
183 .map(elementMap -> clProvider.getNodeTemplates(elementMap.get("name"),
184 elementMap.get("version")))
185 .flatMap(List::stream)
186 .collect(Collectors.toList())
190 return controlLoopElementList;
194 * Get the requested control loop definitions.
196 * @param name the name of the definition to get, null for all definitions
197 * @param version the version of the definition to get, null for all definitions
198 * @return the control loop definitions
199 * @throws PfModelException on errors getting control loop definitions
201 public ToscaServiceTemplate getToscaServiceTemplate(String name, String version) throws PfModelException {
202 var serviceTemplates = new ToscaServiceTemplates();
203 serviceTemplates.setServiceTemplates(modelsProvider.getServiceTemplateList(name, version));
204 return serviceTemplates.getServiceTemplates().get(0);