/* * ============LICENSE_START======================================================= * Copyright (C) 2019 Nordix Foundation. * ModificationsCopyright (C) 2019 AT&T Intellectual Property. All rights reserved. * ================================================================================ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * * SPDX-License-Identifier: Apache-2.0 * ============LICENSE_END========================================================= */ package org.onap.policy.models.base; import java.util.ArrayList; import java.util.List; import javax.persistence.Column; import javax.persistence.Embeddable; import lombok.EqualsAndHashCode; import lombok.Getter; import lombok.NonNull; import lombok.ToString; import org.onap.policy.common.utils.validation.Assertions; import org.onap.policy.models.base.PfValidationResult.ValidationResult; /** * An concept key uniquely identifies every first order entity in the system. Every first order concept in the system * must have an {@link PfConceptKey} to identify it. Concepts that are wholly contained in another concept are * identified using a {@link PfReferenceKey} key. * *

Key validation checks that the name and version fields match the NAME_REGEXP and VERSION_REGEXP * regular expressions respectively. */ @Embeddable @Getter @ToString @EqualsAndHashCode(callSuper = false) public class PfConceptKey extends PfKey { private static final long serialVersionUID = 8932717618579392561L; private static final String NAME_TOKEN = "name"; private static final String VERSION_TOKEN = "version"; @Column(name = NAME_TOKEN, length = 120) private String name; @Column(name = VERSION_TOKEN, length = 20) private String version; /** * The default constructor creates a null concept key. */ public PfConceptKey() { this(NULL_KEY_NAME, NULL_KEY_VERSION); } /** * Copy constructor. * * @param copyConcept the concept to copy from */ public PfConceptKey(@NonNull final PfConceptKey copyConcept) { super(copyConcept); } /** * Constructor to create a key with the specified name and version. * * @param name the key name * @param version the key version */ public PfConceptKey(@NonNull final String name, @NonNull final String version) { super(); this.name = Assertions.validateStringParameter(NAME_TOKEN, name, NAME_REGEXP); this.version = Assertions.validateStringParameter(VERSION_TOKEN, version, VERSION_REGEXP); } /** * Constructor to create a key using the key and version from the specified key ID. * * @param id the key ID in a format that respects the KEY_ID_REGEXP */ public PfConceptKey(@NonNull final String id) { // Check the incoming ID is valid Assertions.validateStringParameter("id", id, KEY_ID_REGEXP); // Split on colon, if the id passes the regular expression test above // it'll have just one colon separating the name and version // No need for range checks or size checks on the array final String[] nameVersionArray = id.split(":"); // Return the new key name = Assertions.validateStringParameter(NAME_TOKEN, nameVersionArray[0], NAME_REGEXP); version = Assertions.validateStringParameter(VERSION_TOKEN, nameVersionArray[1], VERSION_REGEXP); } /** * Get a null concept key. * * @return a null concept key */ public static final PfConceptKey getNullKey() { return new PfConceptKey(PfKey.NULL_KEY_NAME, PfKey.NULL_KEY_VERSION); } @Override public PfConceptKey getKey() { return this; } public void setName(@NonNull final String name) { this.name = Assertions.validateStringParameter(NAME_TOKEN, name, NAME_REGEXP); } public void setVersion(@NonNull final String version) { this.version = Assertions.validateStringParameter(VERSION_TOKEN, version, VERSION_REGEXP); } @Override public List getKeys() { final List keyList = new ArrayList<>(); keyList.add(getKey()); return keyList; } @Override public String getId() { return name + ':' + version; } @Override public boolean isNullKey() { return this.equals(PfConceptKey.getNullKey()); } /** * Determines if the version is "null". * * @return {@code true} if the version is null, {@code false} otherwise */ public boolean isNullVersion() { return PfKey.NULL_KEY_VERSION.equals(getVersion()); } @Override public PfKey.Compatibility getCompatibility(@NonNull final PfKey otherKey) { if (!(otherKey instanceof PfConceptKey)) { return Compatibility.DIFFERENT; } final PfConceptKey otherConceptKey = (PfConceptKey) otherKey; if (this.equals(otherConceptKey)) { return Compatibility.IDENTICAL; } if (!this.getName().equals(otherConceptKey.getName())) { return Compatibility.DIFFERENT; } final String[] thisVersionArray = getVersion().split("\\."); final String[] otherVersionArray = otherConceptKey.getVersion().split("\\."); // There must always be at least one element in each version if (!thisVersionArray[0].equals(otherVersionArray[0])) { return Compatibility.MAJOR; } if (thisVersionArray.length >= 2 && otherVersionArray.length >= 2 && !thisVersionArray[1].equals(otherVersionArray[1])) { return Compatibility.MINOR; } return Compatibility.PATCH; } @Override public boolean isCompatible(@NonNull final PfKey otherKey) { if (!(otherKey instanceof PfConceptKey)) { return false; } final PfConceptKey otherConceptKey = (PfConceptKey) otherKey; final Compatibility compatibility = this.getCompatibility(otherConceptKey); return !(compatibility == Compatibility.DIFFERENT || compatibility == Compatibility.MAJOR); } @Override public boolean isNewerThan(@NonNull final PfKey otherKey) { Assertions.instanceOf(otherKey, PfConceptKey.class); final PfConceptKey otherConceptKey = (PfConceptKey) otherKey; if (this.equals(otherConceptKey)) { return false; } if (!this.getName().equals(otherConceptKey.getName())) { return this.getName().compareTo(otherConceptKey.getName()) > 0; } final String[] thisVersionArray = getVersion().split("\\."); final String[] otherVersionArray = otherConceptKey.getVersion().split("\\."); // There must always be at least one element in each version if (!thisVersionArray[0].equals(otherVersionArray[0])) { return Integer.valueOf(thisVersionArray[0]) > Integer.valueOf(otherVersionArray[0]); } if (thisVersionArray.length >= 2 && otherVersionArray.length >= 2 && !thisVersionArray[1].equals(otherVersionArray[1])) { return Integer.valueOf(thisVersionArray[1]) > Integer.valueOf(otherVersionArray[1]); } if (thisVersionArray.length >= 3 && otherVersionArray.length >= 3 && !thisVersionArray[2].equals(otherVersionArray[2])) { return Integer.valueOf(thisVersionArray[2]) > Integer.valueOf(otherVersionArray[2]); } return false; } @Override public int getMajorVersion() { final String[] versionArray = getVersion().split("\\."); // There must always be at least one element in each version return Integer.parseInt(versionArray[0]); } @Override public int getMinorVersion() { final String[] versionArray = getVersion().split("\\."); if (versionArray.length >= 2) { return Integer.parseInt(versionArray[1]); } else { return 0; } } @Override public int getPatchVersion() { final String[] versionArray = getVersion().split("\\."); if (versionArray.length >= 3) { return Integer.parseInt(versionArray[2]); } else { return 0; } } @Override public PfValidationResult validate(final PfValidationResult result) { final String nameValidationErrorMessage = Assertions.getStringParameterValidationMessage(NAME_TOKEN, name, NAME_REGEXP); if (nameValidationErrorMessage != null) { result.addValidationMessage(new PfValidationMessage(this, this.getClass(), ValidationResult.INVALID, "name invalid-" + nameValidationErrorMessage)); } final String versionValidationErrorMessage = Assertions.getStringParameterValidationMessage(VERSION_TOKEN, version, VERSION_REGEXP); if (versionValidationErrorMessage != null) { result.addValidationMessage(new PfValidationMessage(this, this.getClass(), ValidationResult.INVALID, "version invalid-" + versionValidationErrorMessage)); } return result; } @Override public void clean() { name = Assertions.validateStringParameter(NAME_TOKEN, name, NAME_REGEXP); version = Assertions.validateStringParameter(VERSION_TOKEN, version, VERSION_REGEXP); } @Override public PfConcept copyTo(final PfConcept target) { Assertions.argumentNotNull(target, "target may not be null"); final PfConcept copyObject = target; Assertions.instanceOf(copyObject, PfConceptKey.class); final PfConceptKey copy = ((PfConceptKey) copyObject); copy.setName(name); copy.setVersion(version); return copyObject; } @Override public int compareTo(@NonNull final PfConcept otherObj) { Assertions.argumentNotNull(otherObj, "comparison object may not be null"); if (this == otherObj) { return 0; } if (getClass() != otherObj.getClass()) { return this.hashCode() - otherObj.hashCode(); } final PfConceptKey other = (PfConceptKey) otherObj; if (!name.equals(other.name)) { return name.compareTo(other.name); } return version.compareTo(other.version); } }