2 * ============LICENSE_START=======================================================
3 * Copyright (C) 2019-2020 Nordix Foundation.
4 * Modifications Copyright (C) 2019-2020 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.models.base;
24 import java.lang.reflect.ParameterizedType;
25 import java.util.ArrayList;
26 import java.util.LinkedHashMap;
27 import java.util.List;
29 import java.util.Map.Entry;
30 import java.util.NavigableMap;
32 import java.util.TreeMap;
34 import javax.persistence.CascadeType;
35 import javax.persistence.EmbeddedId;
36 import javax.persistence.Entity;
37 import javax.persistence.JoinColumn;
38 import javax.persistence.JoinTable;
39 import javax.persistence.ManyToMany;
40 import javax.persistence.MappedSuperclass;
41 import javax.persistence.Table;
42 import javax.ws.rs.core.Response;
45 import lombok.EqualsAndHashCode;
46 import lombok.NonNull;
48 import org.onap.policy.models.base.PfValidationResult.ValidationResult;
52 * This class is a concept container and holds a map of concepts. The {@link PfConceptContainer} class implements the
53 * helper methods of the {@link PfConceptGetter} interface to allow {@link PfConceptContainer} instances to be retrieved
54 * by calling methods directly on this class without referencing the contained map.
56 * <p>Validation checks that a container key is not null. An error is issued if no concepts are defined in a container.
57 * Each concept entry is checked to ensure that its key and value are not null and that the key matches the key in the
58 * map value. Each concept entry is then validated individually.
60 * @param C the concept being contained
65 @Table(name = "PfConceptContainer")
67 @EqualsAndHashCode(callSuper = false)
69 public class PfConceptContainer<C extends PfConcept, A extends PfNameVersion> extends PfConcept
70 implements PfConceptGetter<C>, PfAuthorative<List<Map<String, A>>> {
71 private static final long serialVersionUID = -324211738823208318L;
74 private PfConceptKey key;
76 @ManyToMany(cascade = CascadeType.ALL)
80 @JoinColumn(name = "conceptContainerMapName", referencedColumnName = "name"),
81 @JoinColumn(name = "concpetContainerMapVersion", referencedColumnName = "version")
83 inverseJoinColumns = {
84 @JoinColumn(name = "conceptContainerName", referencedColumnName = "name"),
85 @JoinColumn(name = "conceptContainerVersion", referencedColumnName = "version")
89 private Map<PfConceptKey, C> conceptMap;
92 * The Default Constructor creates a {@link PfConceptContainer} object with a null artifact key and creates an empty
95 public PfConceptContainer() {
96 this(new PfConceptKey());
100 * The Key Constructor creates a {@link PfConceptContainer} object with the given artifact key and creates an empty
103 * @param key the concept key
105 public PfConceptContainer(@NonNull final PfConceptKey key) {
106 this(key, new TreeMap<PfConceptKey, C>());
110 * This Constructor creates an concept container with all of its fields defined.
112 * @param key the concept container key
113 * @param conceptMap the concepts to be stored in the concept container
115 public PfConceptContainer(@NonNull final PfConceptKey key, @NonNull final Map<PfConceptKey, C> conceptMap) {
119 this.conceptMap = new TreeMap<>(conceptMap);
125 * @param copyConcept the concept to copy from
127 public PfConceptContainer(@NonNull final PfConceptContainer<C, A> copyConcept) {
129 this.key = new PfConceptKey(copyConcept.key);
131 this.conceptMap = new TreeMap<>();
132 for (final Entry<PfConceptKey, C> conceptMapEntry : copyConcept.conceptMap.entrySet()) {
133 PfConceptKey newK = new PfConceptKey(conceptMapEntry.getKey());
134 C newC = PfUtils.makeCopy(conceptMapEntry.getValue());
135 this.conceptMap.put(newK, newC);
140 public List<PfKey> getKeys() {
141 final List<PfKey> keyList = key.getKeys();
143 for (final C concept : conceptMap.values()) {
144 keyList.addAll(concept.getKeys());
151 public List<Map<String, A>> toAuthorative() {
152 // The returned list is a list of map singletons with one map for each map
153 // entry in the concept container
154 List<Map<String, A>> toscaPolicyMapList = new ArrayList<>();
156 for (Entry<PfConceptKey, C> conceptEntry : getConceptMap().entrySet()) {
157 // Create a map to hold this entry
158 Map<String, A> toscaPolicyMap = new LinkedHashMap<>(1);
160 // Add the concept container entry to the singleton map
161 @SuppressWarnings("unchecked")
162 PfAuthorative<A> authoritiveImpl = (PfAuthorative<A>) conceptEntry.getValue();
163 toscaPolicyMap.put(conceptEntry.getKey().getName(), authoritiveImpl.toAuthorative());
165 // Add the map to the returned list
166 toscaPolicyMapList.add(toscaPolicyMap);
169 return toscaPolicyMapList;
173 public void fromAuthorative(List<Map<String, A>> authorativeList) {
174 // Clear any existing map entries
177 // Concepts are in lists of maps
178 for (Map<String, A> incomingConceptMap : authorativeList) {
179 // Add the map entries one by one
180 for (Entry<String, A> incomingConceptEntry : incomingConceptMap.entrySet()) {
181 C jpaConcept = getConceptNewInstance();
183 // This cast allows us to call the fromAuthorative method
184 @SuppressWarnings("unchecked")
185 PfAuthorative<A> authoritiveImpl = (PfAuthorative<A>) jpaConcept;
187 if (incomingConceptEntry.getValue().getName() == null) {
188 incomingConceptEntry.getValue().setName(incomingConceptEntry.getKey());
191 // Set the key name and the rest of the values on the concept
192 authoritiveImpl.fromAuthorative(incomingConceptEntry.getValue());
194 // This cast gets the key of the concept
195 PfConceptKey conceptKey = (PfConceptKey) jpaConcept.getKey();
197 // Set the concept key of the concept
198 conceptKey.setName(incomingConceptEntry.getValue().getName());
200 if (incomingConceptEntry.getValue().getVersion() != null) {
201 conceptKey.setVersion(incomingConceptEntry.getValue().getVersion());
203 conceptKey.setVersion(PfKey.NULL_KEY_VERSION);
206 // After all that, save the map entry
207 conceptMap.put(conceptKey, jpaConcept);
211 if (conceptMap.isEmpty()) {
212 throw new PfModelRuntimeException(Response.Status.BAD_REQUEST,
213 "An incoming list of concepts must have at least one entry");
218 public void clean() {
220 for (final Entry<PfConceptKey, C> conceptEntry : conceptMap.entrySet()) {
221 conceptEntry.getKey().clean();
222 conceptEntry.getValue().clean();
227 public PfValidationResult validate(@NonNull final PfValidationResult resultIn) {
228 PfValidationResult result = resultIn;
230 if (key.equals(PfConceptKey.getNullKey())) {
231 result.addValidationMessage(
232 new PfValidationMessage(key, this.getClass(), ValidationResult.INVALID, "key is a null key"));
235 result = key.validate(result);
237 if (conceptMap.isEmpty()) {
238 result.addValidationMessage(new PfValidationMessage(key, this.getClass(), ValidationResult.INVALID,
239 "conceptMap may not be empty"));
241 result = validateConceptMap(result);
248 * Validate the concept map of the container.
250 * @param resultIn the incoming validation results so far
251 * @return the validation results with the results of this validation added
253 private PfValidationResult validateConceptMap(final PfValidationResult resultIn) {
254 PfValidationResult result = resultIn;
256 for (final Entry<PfConceptKey, C> conceptEntry : conceptMap.entrySet()) {
257 if (conceptEntry.getKey().equals(PfConceptKey.getNullKey())) {
258 result.addValidationMessage(new PfValidationMessage(key, this.getClass(), ValidationResult.INVALID,
259 "key on concept entry " + conceptEntry.getKey() + " may not be the null key"));
260 } else if (conceptEntry.getValue() == null) {
261 result.addValidationMessage(new PfValidationMessage(key, this.getClass(), ValidationResult.INVALID,
262 "value on concept entry " + conceptEntry.getKey() + " may not be null"));
263 } else if (!conceptEntry.getKey().equals(conceptEntry.getValue().getKey())) {
264 result.addValidationMessage(new PfValidationMessage(key, this.getClass(), ValidationResult.INVALID,
265 "key on concept entry key " + conceptEntry.getKey() + " does not equal concept value key "
266 + conceptEntry.getValue().getKey()));
267 result = conceptEntry.getValue().validate(result);
269 result = conceptEntry.getValue().validate(result);
276 public int compareTo(final PfConcept otherConcept) {
277 if (otherConcept == null) {
280 if (this == otherConcept) {
283 if (getClass() != otherConcept.getClass()) {
284 return getClass().getName().compareTo(otherConcept.getClass().getName());
287 @SuppressWarnings("unchecked")
288 final PfConceptContainer<C, A> other = (PfConceptContainer<C, A>) otherConcept;
289 int retVal = key.compareTo(other.key);
294 if (!conceptMap.equals(other.conceptMap)) {
295 return (conceptMap.hashCode() - other.conceptMap.hashCode());
302 public C get(final PfConceptKey conceptKey) {
303 return new PfConceptGetterImpl<>((NavigableMap<PfConceptKey, C>) conceptMap).get(conceptKey);
307 public C get(final String conceptKeyName) {
308 return new PfConceptGetterImpl<>((NavigableMap<PfConceptKey, C>) conceptMap).get(conceptKeyName);
312 public C get(final String conceptKeyName, final String conceptKeyVersion) {
313 return new PfConceptGetterImpl<>((NavigableMap<PfConceptKey, C>) conceptMap).get(conceptKeyName,
318 public Set<C> getAll(final String conceptKeyName) {
319 return new PfConceptGetterImpl<>((NavigableMap<PfConceptKey, C>) conceptMap).getAll(conceptKeyName);
323 public Set<C> getAll(final String conceptKeyName, final String conceptKeyVersion) {
324 return new PfConceptGetterImpl<>((NavigableMap<PfConceptKey, C>) conceptMap).getAll(conceptKeyName,
329 * Get a new empty instance of a concept for this concept map.
331 * @return the new instance
333 @SuppressWarnings("unchecked")
334 private C getConceptNewInstance() {
336 String conceptClassName =
337 ((ParameterizedType) getClass().getGenericSuperclass()).getActualTypeArguments()[0].getTypeName();
338 return (C) Class.forName(conceptClassName).getDeclaredConstructor().newInstance();
339 } catch (Exception ex) {
340 throw new PfModelRuntimeException(Response.Status.INTERNAL_SERVER_ERROR,
341 "failed to instantiate instance of container concept class", ex);