2 * ============LICENSE_START=======================================================
3 * Copyright (C) 2021-2024 Nordix Foundation.
4 * ================================================================================
5 * Modifications Copyright (C) 2021 AT&T Intellectual Property. All rights reserved.
6 * ================================================================================
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
19 * SPDX-License-Identifier: Apache-2.0
20 * ============LICENSE_END=========================================================
23 package org.onap.policy.clamp.models.acm.persistence.concepts;
25 import jakarta.persistence.AttributeOverride;
26 import jakarta.persistence.Column;
27 import jakarta.persistence.Convert;
28 import jakarta.persistence.Entity;
29 import jakarta.persistence.Id;
30 import jakarta.persistence.Inheritance;
31 import jakarta.persistence.InheritanceType;
32 import jakarta.persistence.Lob;
33 import jakarta.persistence.Table;
34 import java.util.LinkedHashMap;
36 import java.util.UUID;
37 import java.util.function.UnaryOperator;
39 import lombok.EqualsAndHashCode;
40 import lombok.NonNull;
41 import org.apache.commons.lang3.ObjectUtils;
42 import org.onap.policy.clamp.models.acm.concepts.AutomationCompositionElement;
43 import org.onap.policy.clamp.models.acm.concepts.DeployState;
44 import org.onap.policy.clamp.models.acm.concepts.LockState;
45 import org.onap.policy.clamp.models.acm.concepts.SubState;
46 import org.onap.policy.common.parameters.annotations.NotNull;
47 import org.onap.policy.common.parameters.annotations.Valid;
48 import org.onap.policy.models.base.PfAuthorative;
49 import org.onap.policy.models.base.PfConceptKey;
50 import org.onap.policy.models.base.PfUtils;
51 import org.onap.policy.models.base.Validated;
52 import org.onap.policy.models.base.validation.annotations.VerifyKey;
53 import org.onap.policy.models.tosca.authorative.concepts.ToscaConceptIdentifier;
56 * Class to represent a participant automation composition element in the database.
58 * @author Liam Fallon (liam.fallon@est.tech)
61 @Table(name = "AutomationCompositionElement")
62 @Inheritance(strategy = InheritanceType.TABLE_PER_CLASS)
64 @EqualsAndHashCode(callSuper = false)
65 public class JpaAutomationCompositionElement extends Validated
66 implements PfAuthorative<AutomationCompositionElement>, Comparable<JpaAutomationCompositionElement> {
70 private String elementId;
74 private String instanceId;
78 @AttributeOverride(name = "name", column = @Column(name = "definition_name"))
79 @AttributeOverride(name = "version", column = @Column(name = "definition_version"))
80 private PfConceptKey definition;
84 private String participantId;
87 private Boolean restarting;
91 private DeployState deployState;
95 private LockState lockState;
99 private SubState subState;
102 private String operationalState;
105 private String useState;
108 private Integer stage;
111 private String description;
114 private String message;
119 @Convert(converter = StringToMapConverter.class)
120 @Column(length = 100000)
121 private Map<String, Object> properties;
126 @Convert(converter = StringToMapConverter.class)
127 @Column(length = 100000)
128 private Map<String, Object> outProperties;
131 * The Default Constructor creates a {@link JpaAutomationCompositionElement} object with a null key.
133 public JpaAutomationCompositionElement() {
134 this(UUID.randomUUID().toString(), UUID.randomUUID().toString());
138 * The Key Constructor creates a {@link JpaAutomationCompositionElement} object with the given concept key.
140 * @param elementId The id of the automation composition instance Element
141 * @param instanceId The id of the automation composition instance
143 public JpaAutomationCompositionElement(@NonNull final String elementId, @NonNull final String instanceId) {
144 this(elementId, instanceId, new PfConceptKey(),
145 DeployState.UNDEPLOYED, LockState.NONE, SubState.NONE);
149 * The Key Constructor creates a {@link JpaAutomationCompositionElement} object with all mandatory fields.
151 * @param elementId The id of the automation composition instance Element
152 * @param instanceId The id of the automation composition instance
153 * @param definition the TOSCA definition of the automation composition element
154 * @param deployState the Deploy State of the automation composition
155 * @param lockState the Lock State of the automation composition
156 * @param subState the Sub State of the automation composition
158 public JpaAutomationCompositionElement(@NonNull final String elementId, @NonNull final String instanceId,
159 @NonNull final PfConceptKey definition,
160 @NonNull final DeployState deployState, @NonNull final LockState lockState,
161 @NonNull final SubState subState) {
162 this.elementId = elementId;
163 this.instanceId = instanceId;
164 this.definition = definition;
165 this.deployState = deployState;
166 this.lockState = lockState;
167 this.subState = subState;
173 * @param copyConcept the concept to copy from
175 public JpaAutomationCompositionElement(@NonNull final JpaAutomationCompositionElement copyConcept) {
176 this.elementId = copyConcept.elementId;
177 this.instanceId = copyConcept.instanceId;
178 this.definition = new PfConceptKey(copyConcept.definition);
179 this.participantId = copyConcept.participantId;
180 this.description = copyConcept.description;
181 this.properties = (copyConcept.properties != null ? new LinkedHashMap<>(copyConcept.properties) : null);
183 (copyConcept.outProperties != null ? new LinkedHashMap<>(copyConcept.outProperties)
185 this.restarting = copyConcept.restarting;
186 this.deployState = copyConcept.deployState;
187 this.lockState = copyConcept.lockState;
188 this.subState = copyConcept.subState;
189 this.operationalState = copyConcept.operationalState;
190 this.useState = copyConcept.useState;
191 this.stage = copyConcept.stage;
192 this.message = copyConcept.message;
196 * Authorative constructor.
198 * @param authorativeConcept the authorative concept to copy from
200 public JpaAutomationCompositionElement(@NonNull final AutomationCompositionElement authorativeConcept) {
201 this.fromAuthorative(authorativeConcept);
205 public AutomationCompositionElement toAuthorative() {
206 var element = new AutomationCompositionElement();
208 element.setId(UUID.fromString(elementId));
209 element.setDefinition(new ToscaConceptIdentifier(definition));
210 element.setParticipantId(UUID.fromString(participantId));
211 element.setDescription(description);
212 element.setProperties(PfUtils.mapMap(properties, UnaryOperator.identity()));
213 element.setOutProperties(PfUtils.mapMap(outProperties, UnaryOperator.identity()));
214 element.setRestarting(restarting);
215 element.setDeployState(deployState);
216 element.setLockState(lockState);
217 element.setSubState(subState);
218 element.setOperationalState(operationalState);
219 element.setUseState(useState);
220 element.setStage(stage);
221 element.setMessage(message);
227 public void fromAuthorative(@NonNull final AutomationCompositionElement element) {
228 this.definition = element.getDefinition().asConceptKey();
229 this.participantId = element.getParticipantId().toString();
230 this.description = element.getDescription();
231 this.properties = PfUtils.mapMap(element.getProperties(), UnaryOperator.identity());
232 this.outProperties = PfUtils.mapMap(element.getOutProperties(), UnaryOperator.identity());
233 this.restarting = element.getRestarting();
234 this.deployState = element.getDeployState();
235 this.lockState = element.getLockState();
236 this.subState = element.getSubState();
237 this.operationalState = element.getOperationalState();
238 this.useState = element.getUseState();
239 this.stage = element.getStage();
240 this.message = element.getMessage();
244 public int compareTo(final JpaAutomationCompositionElement other) {
252 var result = ObjectUtils.compare(elementId, other.elementId);
257 result = ObjectUtils.compare(instanceId, other.instanceId);
262 result = definition.compareTo(other.definition);
267 result = participantId.compareTo(other.participantId);
272 result = ObjectUtils.compare(restarting, other.restarting);
277 result = ObjectUtils.compare(deployState, other.deployState);
282 result = ObjectUtils.compare(lockState, other.lockState);
287 result = ObjectUtils.compare(subState, other.subState);
292 result = ObjectUtils.compare(useState, other.useState);
297 result = ObjectUtils.compare(stage, other.stage);
302 result = ObjectUtils.compare(operationalState, other.operationalState);
307 result = ObjectUtils.compare(message, other.message);
311 return ObjectUtils.compare(description, other.description);