diff options
author | Pamela Dragosh <pdragosh@research.att.com> | 2020-08-24 15:06:10 +0000 |
---|---|---|
committer | Gerrit Code Review <gerrit@onap.org> | 2020-08-24 15:06:10 +0000 |
commit | 3d2058a63eb8996d9af6f9f6142a9f882895d682 (patch) | |
tree | 6b572a6d0a8b0392b83344b7584976663b51cd92 /controlloop/common/controller-usecases | |
parent | 0a5d9cf30c61956e62cc7db4faf84f999a7196cc (diff) | |
parent | 6a37af48d1db199a0f5a9e9c48f7c5f834a90d1b (diff) |
Merge "Add "special" Operation classes for new usecases"
Diffstat (limited to 'controlloop/common/controller-usecases')
9 files changed, 1230 insertions, 0 deletions
diff --git a/controlloop/common/controller-usecases/pom.xml b/controlloop/common/controller-usecases/pom.xml new file mode 100644 index 000000000..e99077a47 --- /dev/null +++ b/controlloop/common/controller-usecases/pom.xml @@ -0,0 +1,235 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!-- + ============LICENSE_START======================================================= + ONAP + ================================================================================ + Copyright (C) 2020 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. + ============LICENSE_END========================================================= + --> + +<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> + <modelVersion>4.0.0</modelVersion> + + <parent> + <groupId>org.onap.policy.drools-applications.controlloop.common</groupId> + <artifactId>drools-applications-common</artifactId> + <version>1.7.1-SNAPSHOT</version> + </parent> + + <artifactId>controller-usecases</artifactId> + + <name>${project.artifactId}</name> + <description>Usecases Experimental Controller</description> + + <dependencies> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-impl</groupId> + <artifactId>events</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-impl</groupId> + <artifactId>aai</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-impl</groupId> + <artifactId>appc</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-impl</groupId> + <artifactId>appclcm</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-impl</groupId> + <artifactId>cds</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-impl</groupId> + <artifactId>sdc</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-impl</groupId> + <artifactId>sdnc</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-impl</groupId> + <artifactId>sdnr</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-impl</groupId> + <artifactId>so</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-impl</groupId> + <artifactId>vfc</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.drools-applications.controlloop.common</groupId> + <artifactId>eventmanager</artifactId> + <version>${project.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-actors</groupId> + <artifactId>actorServiceProvider</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-actors</groupId> + <artifactId>actor.aai</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-actors</groupId> + <artifactId>actor.appc</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-actors</groupId> + <artifactId>actor.appclcm</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-actors</groupId> + <artifactId>actor.cds</artifactId> + <version>${policy.models.version}</version> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-actors</groupId> + <artifactId>actor.guard</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-actors</groupId> + <artifactId>actor.sdnc</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-actors</groupId> + <artifactId>actor.sdnr</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-actors</groupId> + <artifactId>actor.so</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions.model-actors</groupId> + <artifactId>actor.vfc</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.models.policy-models-interactions</groupId> + <artifactId>model-yaml</artifactId> + <version>${policy.models.version}</version> + <scope>provided</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.drools-pdp</groupId> + <artifactId>policy-management</artifactId> + <version>${version.policy.drools-pdp}</version> + <scope>provided</scope> + <optional>true</optional> + </dependency> + <dependency> + <groupId>org.onap.policy.drools-applications.controlloop.common</groupId> + <artifactId>rules-test</artifactId> + <version>${project.version}</version> + <scope>test</scope> + </dependency> + <dependency> + <groupId>org.onap.policy.common</groupId> + <artifactId>utils-test</artifactId> + <version>${version.policy.common}</version> + <scope>test</scope> + </dependency> + <dependency> + <groupId>com.h2database</groupId> + <artifactId>h2</artifactId> + <scope>test</scope> + </dependency> + </dependencies> + + <profiles> + <profile> + <!--This profile is used to store Eclipse m2e settings only. It has no + influence on the Maven build itself. --> + <id>only-eclipse</id> + <activation> + <property> + <name>m2e.version</name> + </property> + </activation> + <build> + <pluginManagement> + <plugins> + <plugin> + <groupId>org.eclipse.m2e</groupId> + <artifactId>lifecycle-mapping</artifactId> + <version>1.0.0</version> + <configuration> + <lifecycleMappingMetadata> + <pluginExecutions> + <pluginExecution> + <pluginExecutionFilter> + <groupId>org.kie</groupId> + <artifactId>kie-maven-plugin</artifactId> + <goals> + <goal>build</goal> + </goals> + </pluginExecutionFilter> + <action> + <ignore /> + </action> + </pluginExecution> + </pluginExecutions> + </lifecycleMappingMetadata> + </configuration> + </plugin> + </plugins> + </pluginManagement> + </build> + </profile> + </profiles> +</project> diff --git a/controlloop/common/controller-usecases/src/main/java/org/onap/policy/drools/apps/controller/usecases/GetTargetEntityOperation2.java b/controlloop/common/controller-usecases/src/main/java/org/onap/policy/drools/apps/controller/usecases/GetTargetEntityOperation2.java new file mode 100644 index 000000000..e1259e48d --- /dev/null +++ b/controlloop/common/controller-usecases/src/main/java/org/onap/policy/drools/apps/controller/usecases/GetTargetEntityOperation2.java @@ -0,0 +1,204 @@ +/*- + * ============LICENSE_START======================================================= + * ONAP + * ================================================================================ + * Copyright (C) 2020 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. + * ============LICENSE_END========================================================= + */ + +package org.onap.policy.drools.apps.controller.usecases; + +import static org.onap.policy.drools.apps.controller.usecases.UsecasesConstants.AAI_DEFAULT_GENERIC_VNF; +import static org.onap.policy.drools.apps.controller.usecases.UsecasesConstants.GENERIC_VNF_VNF_ID; +import static org.onap.policy.drools.apps.controller.usecases.UsecasesConstants.GENERIC_VNF_VNF_NAME; +import static org.onap.policy.drools.apps.controller.usecases.UsecasesConstants.PNF_NAME; +import static org.onap.policy.drools.apps.controller.usecases.UsecasesConstants.VSERVER_VSERVER_NAME; + +import java.util.Collections; +import java.util.List; +import java.util.concurrent.CompletableFuture; +import org.onap.aai.domain.yang.GenericVnf; +import org.onap.policy.controlloop.VirtualControlLoopEvent; +import org.onap.policy.controlloop.actorserviceprovider.OperationOutcome; +import org.onap.policy.controlloop.actorserviceprovider.OperationProperties; +import org.onap.policy.controlloop.actorserviceprovider.impl.OperationPartial; +import org.onap.policy.controlloop.actorserviceprovider.parameters.ControlLoopOperationParams; +import org.onap.policy.controlloop.eventmanager.StepContext; +import org.onap.policy.controlloop.policy.Target; + +/** + * An operation to get the target entity. This is a "pseudo" operation; it is not found + * within an ActorService, but is created directly. It gets/sets the targetEntity found + * within the step context's properties. + */ +public class GetTargetEntityOperation2 extends OperationPartial { + + private final StepContext stepContext; + private final VirtualControlLoopEvent event; + + + /** + * Constructs the operation as a preprocessing step for a policy's operation. + * + * @param stepContext the step's context + * @param event event being processed + * @param params operation's parameters + */ + public GetTargetEntityOperation2(StepContext stepContext, VirtualControlLoopEvent event, + ControlLoopOperationParams params) { + super(params, null, Collections.emptyList()); + this.event = event; + this.stepContext = stepContext; + } + + @Override + public List<String> getPropertyNames() { + String propName = detmTarget(params.getTarget()); + return (propName == null ? Collections.emptyList() : List.of(propName)); + } + + @Override + public CompletableFuture<OperationOutcome> start() { + throw new UnsupportedOperationException("cannot start get-target-entity operation"); + } + + /** + * Determines the target entity. + * + * @param target policy target + * + * @return the property containing the target entity, or {@code null} if the target + * entity is already known + */ + private String detmTarget(Target target) { + if (stepContext.contains(OperationProperties.AAI_TARGET_ENTITY)) { + // the target entity has already been determined + return null; + } + + if (target == null) { + throw new IllegalArgumentException("The target is null"); + } + + if (target.getType() == null) { + throw new IllegalArgumentException("The target type is null"); + } + + switch (target.getType()) { + case PNF: + return detmPnfTarget(); + case VM: + case VNF: + case VFMODULE: + return detmVfModuleTarget(); + default: + throw new IllegalArgumentException("The target type is not supported"); + } + } + + /** + * Determines the PNF target entity. + * + * @return the property containing the target entity, or {@code null} if the target + * entity is already known + */ + private String detmPnfTarget() { + if (!PNF_NAME.equalsIgnoreCase(event.getTarget())) { + throw new IllegalArgumentException("Target does not match target type"); + } + + String targetEntity = event.getAai().get(PNF_NAME); + if (targetEntity == null) { + throw new IllegalArgumentException("AAI section is missing " + PNF_NAME); + } + + setTargetEntity(targetEntity); + + return null; + } + + /** + * Determines the VF Module target entity. + * + * @return the property containing the target entity, or {@code null} if the target + * entity is already known + */ + private String detmVfModuleTarget() { + String targetFieldName = event.getTarget(); + if (targetFieldName == null) { + throw new IllegalArgumentException("Target is null"); + } + + String targetEntity; + + switch (targetFieldName.toLowerCase()) { + case VSERVER_VSERVER_NAME: + targetEntity = event.getAai().get(VSERVER_VSERVER_NAME); + break; + case GENERIC_VNF_VNF_ID: + targetEntity = event.getAai().get(GENERIC_VNF_VNF_ID); + break; + case GENERIC_VNF_VNF_NAME: + return detmVnfName(); + default: + throw new IllegalArgumentException("Target does not match target type"); + } + + if (targetEntity == null) { + throw new IllegalArgumentException("Enrichment data is missing " + targetFieldName); + } + + setTargetEntity(targetEntity); + + return null; + } + + /** + * Determines the VNF Name target entity. + * + * @return the property containing the target entity, or {@code null} if the target + * entity is already known + */ + private String detmVnfName() { + // if the onset is enriched with the vnf-id, we don't need an A&AI response + String targetEntity = event.getAai().get(GENERIC_VNF_VNF_ID); + if (targetEntity == null) { + // don't have the data yet - add a step to retrieve it + return AAI_DEFAULT_GENERIC_VNF; + } + + setTargetEntity(targetEntity); + + return null; + } + + @Override + public void setProperty(String name, Object value) { + // only care about one property + if (UsecasesConstants.AAI_DEFAULT_GENERIC_VNF.equals(name)) { + GenericVnf vnf = (GenericVnf) value; + setTargetEntity(vnf.getVnfId()); + } + } + + /** + * Sets the target entity within the properties. + * + * @param targetEntity the new target entity + */ + private void setTargetEntity(String targetEntity) { + stepContext.setProperty(OperationProperties.AAI_TARGET_ENTITY, targetEntity); + } +} diff --git a/controlloop/common/controller-usecases/src/main/java/org/onap/policy/drools/apps/controller/usecases/LockOperation2.java b/controlloop/common/controller-usecases/src/main/java/org/onap/policy/drools/apps/controller/usecases/LockOperation2.java new file mode 100644 index 000000000..f5b03d2f5 --- /dev/null +++ b/controlloop/common/controller-usecases/src/main/java/org/onap/policy/drools/apps/controller/usecases/LockOperation2.java @@ -0,0 +1,75 @@ +/*- + * ============LICENSE_START======================================================= + * ONAP + * ================================================================================ + * Copyright (C) 2020 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. + * ============LICENSE_END========================================================= + */ + +package org.onap.policy.drools.apps.controller.usecases; + +import java.util.List; +import java.util.concurrent.CompletableFuture; +import lombok.Getter; +import org.onap.policy.controlloop.actorserviceprovider.OperationOutcome; +import org.onap.policy.controlloop.actorserviceprovider.OperationProperties; +import org.onap.policy.controlloop.actorserviceprovider.impl.OperationPartial; +import org.onap.policy.controlloop.actorserviceprovider.parameters.ControlLoopOperationParams; +import org.onap.policy.controlloop.eventmanager.StepContext; + +/** + * A LOCK operation for a particular target entity. This is a "pseudo" operation; it is + * not found within an ActorService, but is created directly. + */ +public class LockOperation2 extends OperationPartial { + + private final StepContext stepContext; + + private static final List<String> PROPERTY_NAMES = List.of(OperationProperties.AAI_TARGET_ENTITY); + + /** + * Set when {@link #setProperty(String, Object)} is invoked. + */ + @Getter + private String targetEntity; + + + /** + * Constructs the lock operation as a preprocessing step for a policy's operation. + * + * @param stepContext the context to use to request the lock + * @param params operation's parameters + */ + public LockOperation2(StepContext stepContext, ControlLoopOperationParams params) { + super(params, null, PROPERTY_NAMES); + this.stepContext = stepContext; + } + + @Override + public CompletableFuture<OperationOutcome> start() { + if (targetEntity == null) { + throw new IllegalStateException("target lock entity has not been determined yet"); + } + + return stepContext.requestLock(targetEntity); + } + + @Override + public void setProperty(String name, Object value) { + if (OperationProperties.AAI_TARGET_ENTITY.equals(name) && value != null) { + targetEntity = value.toString(); + } + } +} diff --git a/controlloop/common/controller-usecases/src/main/java/org/onap/policy/drools/apps/controller/usecases/UsecasesConstants.java b/controlloop/common/controller-usecases/src/main/java/org/onap/policy/drools/apps/controller/usecases/UsecasesConstants.java new file mode 100644 index 000000000..17db745ad --- /dev/null +++ b/controlloop/common/controller-usecases/src/main/java/org/onap/policy/drools/apps/controller/usecases/UsecasesConstants.java @@ -0,0 +1,49 @@ +/*- + * ============LICENSE_START======================================================= + * ONAP + * ================================================================================ + * Copyright (C) 2020 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. + * ============LICENSE_END========================================================= + */ + +package org.onap.policy.drools.apps.controller.usecases; + +public class UsecasesConstants { + + public static final String GET_TARGET_ENTITY_ACTOR = "pseudo/getTargetEntity"; + public static final String GET_TARGET_ENTITY_OPERATION = "pseudo/getTargetEntity"; + + public static final String PROV_STATUS_ACTIVE = "ACTIVE"; + public static final String VM_NAME = "VM_NAME"; + public static final String VNF_NAME = "VNF_NAME"; + public static final String GENERIC_VNF_VNF_ID = "generic-vnf.vnf-id"; + public static final String GENERIC_VNF_VNF_NAME = "generic-vnf.vnf-name"; + public static final String VSERVER_VSERVER_NAME = "vserver.vserver-name"; + public static final String GENERIC_VNF_IS_CLOSED_LOOP_DISABLED = "generic-vnf.is-closed-loop-disabled"; + public static final String VSERVER_IS_CLOSED_LOOP_DISABLED = "vserver.is-closed-loop-disabled"; + public static final String PNF_IS_IN_MAINT = "pnf.in-maint"; + public static final String GENERIC_VNF_PROV_STATUS = "generic-vnf.prov-status"; + public static final String VSERVER_PROV_STATUS = "vserver.prov-status"; + public static final String PNF_ID = "pnf.pnf-id"; + public static final String PNF_NAME = "pnf.pnf-name"; + + // additional properties that the Operations may need + + public static final String AAI_DEFAULT_GENERIC_VNF = "AAI/default/genericVnf"; + + private UsecasesConstants() { + super(); + } +} diff --git a/controlloop/common/controller-usecases/src/test/java/org/onap/policy/drools/apps/controller/usecases/GetTargetEntityOperation2Test.java b/controlloop/common/controller-usecases/src/test/java/org/onap/policy/drools/apps/controller/usecases/GetTargetEntityOperation2Test.java new file mode 100644 index 000000000..238ac3d70 --- /dev/null +++ b/controlloop/common/controller-usecases/src/test/java/org/onap/policy/drools/apps/controller/usecases/GetTargetEntityOperation2Test.java @@ -0,0 +1,348 @@ +/*- + * ============LICENSE_START======================================================= + * ONAP + * ================================================================================ + * Copyright (C) 2020 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. + * ============LICENSE_END========================================================= + */ + +package org.onap.policy.drools.apps.controller.usecases; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatIllegalArgumentException; +import static org.assertj.core.api.Assertions.assertThatThrownBy; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertFalse; +import static org.mockito.ArgumentMatchers.any; +import static org.mockito.Mockito.never; +import static org.mockito.Mockito.verify; +import static org.mockito.Mockito.when; + +import java.util.List; +import java.util.Map; +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mock; +import org.mockito.MockitoAnnotations; +import org.onap.aai.domain.yang.GenericVnf; +import org.onap.policy.controlloop.VirtualControlLoopEvent; +import org.onap.policy.controlloop.actorserviceprovider.OperationProperties; +import org.onap.policy.controlloop.actorserviceprovider.parameters.ControlLoopOperationParams; +import org.onap.policy.controlloop.eventmanager.StepContext; +import org.onap.policy.controlloop.policy.Target; +import org.onap.policy.controlloop.policy.TargetType; + +public class GetTargetEntityOperation2Test { + private static final String GENERIC_VNF_ID = "generic-vnf.vnf-id"; + private static final String VSERVER_NAME = "vserver.vserver-name"; + private static final String GENERIC_VNF_NAME = "generic-vnf.vnf-name"; + private static final String MY_PNF = "my-pnf"; + private static final String MY_VNF = "my-vnf"; + private static final String MY_ACTOR = "my-actor"; + private static final String MY_OPERATION = "my-operation"; + + @Mock + private StepContext stepContext; + @Mock + private ControlLoopOperationParams params; + + private VirtualControlLoopEvent event; + private Target target; + private GenericVnf vnf; + private GetTargetEntityOperation2 oper; + + /** + * Sets up. + */ + @Before + public void setUp() { + MockitoAnnotations.initMocks(this); + + event = new VirtualControlLoopEvent(); + event.setTarget("pnf.pnf-name"); + event.setAai(Map.of("pnf.pnf-name", MY_PNF)); + + target = new Target(); + target.setType(TargetType.PNF); + + vnf = new GenericVnf(); + vnf.setVnfId(MY_VNF); + + when(params.getTarget()).thenReturn(target); + when(params.getActor()).thenReturn(MY_ACTOR); + when(params.getOperation()).thenReturn(MY_OPERATION); + + oper = new GetTargetEntityOperation2(stepContext, event, params); + } + + @Test + public void testGetPropertyNames() { + // already have the data - no properties needed + assertThat(oper.getPropertyNames()).isEmpty(); + + // try an operation that needs data + remakeWithoutData(); + assertEquals(List.of(UsecasesConstants.AAI_DEFAULT_GENERIC_VNF), oper.getPropertyNames()); + + // tell it the entity is available + when(stepContext.contains(OperationProperties.AAI_TARGET_ENTITY)).thenReturn(true); + assertThat(oper.getPropertyNames()).isEmpty(); + } + + @Test + public void testStart() { + assertThatThrownBy(() -> oper.start()).isInstanceOf(UnsupportedOperationException.class) + .hasMessage("cannot start get-target-entity operation"); + } + + /** + * Tests detmTarget() when the target has already been determined. + */ + @Test + public void testDetmTargetRepeat() { + remakeWithoutData(); + assertFalse(oper.getPropertyNames().isEmpty()); + + // tell it the entity is available + when(stepContext.contains(OperationProperties.AAI_TARGET_ENTITY)).thenReturn(true); + assertThat(oper.getPropertyNames()).isEmpty(); + + // repeat + assertThat(oper.getPropertyNames()).isEmpty(); + } + + /** + * Tests detmTarget() when the target is {@code null}. + */ + @Test + public void testDetmTargetNull() { + remakeWithoutData(); + when(params.getTarget()).thenReturn(null); + + assertThatIllegalArgumentException().isThrownBy(() -> oper.getPropertyNames()) + .withMessage("The target is null"); + } + + /** + * Tests detmTarget() when the target type is {@code null}. + */ + @Test + public void testDetmTargetNullType() { + remakeWithoutData(); + target.setType(null); + + assertThatIllegalArgumentException().isThrownBy(() -> oper.getPropertyNames()) + .withMessage("The target type is null"); + } + + /** + * Tests detmTarget() when the target type is VM and enrichment data is provided. + */ + @Test + public void testDetmTargetVm() { + target.setType(TargetType.VM); + enrichTarget(VSERVER_NAME); + assertThat(oper.getPropertyNames()).isEmpty(); + verifyTarget(MY_VNF); + } + + /** + * Tests detmTarget() when the target type is VNF and enrichment data is provided. + */ + @Test + public void testDetmTargetVnf() { + target.setType(TargetType.VNF); + enrichTarget(VSERVER_NAME); + assertThat(oper.getPropertyNames()).isEmpty(); + verifyTarget(MY_VNF); + } + + /** + * Tests detmTarget() when the target type is VF Module and enrichment data is + * provided. + */ + @Test + public void testDetmTargetVfModule() { + target.setType(TargetType.VFMODULE); + enrichTarget(VSERVER_NAME); + assertThat(oper.getPropertyNames()).isEmpty(); + verifyTarget(MY_VNF); + } + + /** + * Tests detmTarget() when the target type is unknown. + */ + @Test + public void testDetmTargetUnknownType() { + target.setType(TargetType.VFC); + enrichTarget(VSERVER_NAME); + assertThatIllegalArgumentException().isThrownBy(() -> oper.getPropertyNames()) + .withMessage("The target type is not supported"); + } + + @Test + public void testDetmPnfTargetPnf() { + assertThat(oper.getPropertyNames()).isEmpty(); + verifyTarget(MY_PNF); + } + + /** + * Tests detmPnfTarget() when the target name is incorrect. + */ + @Test + public void testDetmPnfTargetInvalidName() { + event.setTarget("unknown-pnf"); + assertThatIllegalArgumentException().isThrownBy(() -> oper.getPropertyNames()) + .withMessage("Target does not match target type"); + } + + /** + * Tests detmPnfTarget() when the enrichment data is missing. + */ + @Test + public void testDetmPnfTargetPnfNoEnrichment() { + event.setAai(Map.of()); + assertThatIllegalArgumentException().isThrownBy(() -> oper.getPropertyNames()) + .withMessage("AAI section is missing pnf.pnf-name"); + } + + /** + * Tests detmVfModuleTarget() when the target is null. + */ + @Test + public void testDetmVfModuleTargetNullTarget() { + target.setType(TargetType.VM); + event.setTarget(null); + assertThatIllegalArgumentException().isThrownBy(() -> oper.getPropertyNames()).withMessage("Target is null"); + } + + /** + * Tests detmVfModuleTarget() when the target is the vserver name. + */ + @Test + public void testDetmVfModuleTargetVserverName() { + target.setType(TargetType.VM); + enrichTarget(VSERVER_NAME); + assertThat(oper.getPropertyNames()).isEmpty(); + verifyTarget(MY_VNF); + } + + /** + * Tests detmVfModuleTarget() when the target is the VNF ID. + */ + @Test + public void testDetmVfModuleTargetVnfId() { + target.setType(TargetType.VM); + enrichTarget(GENERIC_VNF_ID); + assertThat(oper.getPropertyNames()).isEmpty(); + verifyTarget(MY_VNF); + } + + /** + * Tests detmVfModuleTarget() when the target is the VNF name. Note: the enrichment + * data is actually stored in the VNF ID field. + */ + @Test + public void testDetmVfModuleTargetVnfName() { + target.setType(TargetType.VM); + enrichTarget(GENERIC_VNF_ID); + + // set this AFTER setting enrichment data + event.setTarget("generic-vnf.vnf-name"); + + assertThat(oper.getPropertyNames()).isEmpty(); + verifyTarget(MY_VNF); + } + + /** + * Tests detmVfModuleTarget() when the target is unknown. + */ + @Test + public void testDetmVfModuleTargetUnknown() { + target.setType(TargetType.VM); + enrichTarget(VSERVER_NAME); + event.setTarget("unknown-vnf"); + assertThatIllegalArgumentException().isThrownBy(() -> oper.getPropertyNames()) + .withMessage("Target does not match target type"); + } + + /** + * Tests detmVfModuleTarget() when the enrichment data is missing. + */ + @Test + public void testDetmVfModuleTargetMissingEnrichment() { + target.setType(TargetType.VM); + event.setTarget(VSERVER_NAME); + assertThatIllegalArgumentException().isThrownBy(() -> oper.getPropertyNames()) + .withMessage("Enrichment data is missing " + VSERVER_NAME); + } + + /** + * Tests detmVnfName() when enrichment data is available. + */ + @Test + public void testDetmVnfNameHaveData() { + target.setType(TargetType.VM); + event.setTarget(GENERIC_VNF_NAME); + event.setAai(Map.of(GENERIC_VNF_ID, MY_VNF)); + assertThat(oper.getPropertyNames()).isEmpty(); + verifyTarget(MY_VNF); + } + + /** + * Tests detmVnfName() when enrichment data is missing. + */ + @Test + public void testDetmVnfNameNoData() { + target.setType(TargetType.VM); + event.setTarget(GENERIC_VNF_NAME); + assertThat(oper.getPropertyNames()).isEqualTo(List.of(UsecasesConstants.AAI_DEFAULT_GENERIC_VNF)); + } + + @Test + public void testSetProperty() { + target.setType(TargetType.VM); + event.setTarget(GENERIC_VNF_NAME); + + // not a property of interest - should be ignored + oper.setProperty("unknown-property", vnf); + verify(stepContext, never()).setProperty(any(), any()); + + // now set the desired property and try again + oper.setProperty(UsecasesConstants.AAI_DEFAULT_GENERIC_VNF, vnf); + verifyTarget(MY_VNF); + } + + @Test + public void testGetActorName_testGetName() { + assertEquals(MY_ACTOR, oper.getActorName()); + assertEquals(MY_OPERATION, oper.getName()); + } + + private void verifyTarget(String targetEntity) { + verify(stepContext).setProperty(OperationProperties.AAI_TARGET_ENTITY, targetEntity); + } + + private void remakeWithoutData() { + target.setType(TargetType.VNF); + event.setTarget(GENERIC_VNF_NAME); + oper = new GetTargetEntityOperation2(stepContext, event, params); + } + + private void enrichTarget(String enrichmentTargetType) { + event.setTarget(enrichmentTargetType); + event.setAai(Map.of(enrichmentTargetType, MY_VNF)); + } +} diff --git a/controlloop/common/controller-usecases/src/test/java/org/onap/policy/drools/apps/controller/usecases/LockOperation2Test.java b/controlloop/common/controller-usecases/src/test/java/org/onap/policy/drools/apps/controller/usecases/LockOperation2Test.java new file mode 100644 index 000000000..dfbedc2c7 --- /dev/null +++ b/controlloop/common/controller-usecases/src/test/java/org/onap/policy/drools/apps/controller/usecases/LockOperation2Test.java @@ -0,0 +1,121 @@ +/*- + * ============LICENSE_START======================================================= + * ONAP + * ================================================================================ + * Copyright (C) 2020 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. + * ============LICENSE_END========================================================= + */ + +package org.onap.policy.drools.apps.controller.usecases; + +import static org.assertj.core.api.Assertions.assertThat; +import static org.assertj.core.api.Assertions.assertThatIllegalStateException; +import static org.junit.Assert.assertEquals; +import static org.junit.Assert.assertNull; +import static org.junit.Assert.assertSame; +import static org.mockito.ArgumentMatchers.anyString; +import static org.mockito.Mockito.when; + +import java.util.List; +import java.util.Map; +import java.util.concurrent.CompletableFuture; +import org.junit.Before; +import org.junit.Test; +import org.mockito.Mock; +import org.mockito.MockitoAnnotations; +import org.onap.aai.domain.yang.GenericVnf; +import org.onap.policy.controlloop.VirtualControlLoopEvent; +import org.onap.policy.controlloop.actorserviceprovider.OperationOutcome; +import org.onap.policy.controlloop.actorserviceprovider.OperationProperties; +import org.onap.policy.controlloop.actorserviceprovider.parameters.ControlLoopOperationParams; +import org.onap.policy.controlloop.eventmanager.StepContext; +import org.onap.policy.controlloop.policy.Target; +import org.onap.policy.controlloop.policy.TargetType; + +public class LockOperation2Test { + private static final String MY_PNF = "my-pnf"; + private static final String MY_VNF = "my-vnf"; + private static final String MY_ACTOR = "my-actor"; + private static final String MY_OPERATION = "my-operation"; + + @Mock + private StepContext stepContext; + @Mock + private ControlLoopOperationParams params; + + private VirtualControlLoopEvent event; + private Target target; + private CompletableFuture<OperationOutcome> future; + private GenericVnf vnf; + private LockOperation2 oper; + + /** + * Sets up. + */ + @Before + public void setUp() { + MockitoAnnotations.initMocks(this); + + event = new VirtualControlLoopEvent(); + event.setTarget("pnf.pnf-name"); + event.setAai(Map.of("pnf.pnf-name", MY_PNF)); + + target = new Target(); + target.setType(TargetType.PNF); + + future = new CompletableFuture<>(); + + vnf = new GenericVnf(); + vnf.setVnfId(MY_VNF); + + when(stepContext.requestLock(anyString())).thenReturn(future); + + when(params.getTarget()).thenReturn(target); + when(params.getActor()).thenReturn(MY_ACTOR); + when(params.getOperation()).thenReturn(MY_OPERATION); + + oper = new LockOperation2(stepContext, params); + } + + @Test + public void testGetPropertyNames() { + assertThat(oper.getPropertyNames()).isEqualTo(List.of(OperationProperties.AAI_TARGET_ENTITY)); + } + + @Test + public void testStart() { + // missing data + assertThatIllegalStateException().isThrownBy(() -> oper.start()) + .withMessage("target lock entity has not been determined yet"); + + oper.setProperty(OperationProperties.AAI_TARGET_ENTITY, "some-target"); + assertSame(future, oper.start()); + } + + @Test + public void testSetProperty() { + oper.setProperty("unknown-property", "some data"); + assertNull(oper.getTargetEntity()); + + oper.setProperty(OperationProperties.AAI_TARGET_ENTITY, "other data"); + assertEquals("other data", oper.getTargetEntity()); + } + + @Test + public void testGetActorName_testGetName() { + assertEquals(MY_ACTOR, oper.getActorName()); + assertEquals(MY_OPERATION, oper.getName()); + } +} diff --git a/controlloop/common/controller-usecases/src/test/resources/config/event-manager.properties b/controlloop/common/controller-usecases/src/test/resources/config/event-manager.properties new file mode 100644 index 000000000..bd82b50a7 --- /dev/null +++ b/controlloop/common/controller-usecases/src/test/resources/config/event-manager.properties @@ -0,0 +1,83 @@ +# +# ============LICENSE_START====================================================== +# ONAP +# =============================================================================== +# Copyright (C) 2020 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. +# ============LICENSE_END======================================================== +# + +# DB parameters +operation.history.url=jdbc:h2:mem:Usecases +operation.history.userName=sa +operation.history.password= + +# Actor parameters +# +# Note: every operation must have at least one entry, otherwise it will not be +# configured and started. Thus some of them have a "placeholder" property. +# + +#actor.service.GUARD.disabled=true +actor.service.GUARD.clientName=GUARD +actor.service.GUARD.onapName=my-onap-name +actor.service.GUARD.onapComponent=my-onap-component +actor.service.GUARD.onapInstance=my-onap-instance +actor.service.GUARD.operations.Decision.path=decision + +actor.service.AAI.clientName=AAI +actor.service.AAI.operations.CustomQuery.path=aai/v16/query +actor.service.AAI.operations.Pnf.path=aai/v16/network/pnfs/pnf +actor.service.AAI.operations.Tenant.path=aai/v16/search/nodes-query + +actor.service.APPC.sinkTopic=APPC-LCM-READ +actor.service.APPC.sourceTopic=APPC-LCM-WRITE +actor.service.APPC.operations.ConfigModify.placeholder= +actor.service.APPC.operations.Migrate.placeholder= +actor.service.APPC.operations.Restart.placeholder= +actor.service.APPC.operations.Rebuild.placeholder= + +# legacy APPC - must specify sink and source for each operation +actor.service.APPC.operations.ModifyConfig.sinkTopic=APPC-CL +actor.service.APPC.operations.ModifyConfig.sourceTopic=APPC-CL + +actor.service.CDS.operations.any.host=localhost +actor.service.CDS.operations.any.port=7878 +actor.service.CDS.operations.any.username=grpc-username +actor.service.CDS.operations.any.password=grpc-password +actor.service.CDS.operations.any.timeout=10 + +actor.service.SDNC.clientName=SDNC +actor.service.SDNC.operations.BandwidthOnDemand.path=\ + GENERIC-RESOURCE-API:vf-module-topology-operation +actor.service.SDNC.operations.Reroute.path=\ + GENERIC-RESOURCE-API:network-topology-operation + +actor.service.SDNR.sinkTopic=SDNR-CL +actor.service.SDNR.sourceTopic=SDNR-CL-RSP +actor.service.SDNR.operations.any.placeholder= + +actor.service.SO.clientName=SO +actor.service.SO.pollPath=orchestrationRequests/v5/ +actor.service.SO.maxPolls=20 +actor.service.SO.pollWaitSec=20 +actor.service.SO.operations.VF\ Module\ Create.path=serviceInstantiation/v7/serviceInstances +actor.service.SO.operations.VF\ Module\ Delete.path=serviceInstances/v7 + +actor.service.VFC.clientName=VFC +actor.service.VFC.pollPath=jobs +actor.service.VFC.maxPolls=20 +actor.service.VFC.pollWaitSec=20 +actor.service.VFC.operations.Restart.path=ns +actor.service.VFC.operations.Restart.timeoutSec=60 diff --git a/controlloop/common/controller-usecases/src/test/resources/config/usecases-controller.properties b/controlloop/common/controller-usecases/src/test/resources/config/usecases-controller.properties new file mode 100644 index 000000000..f90b1d18c --- /dev/null +++ b/controlloop/common/controller-usecases/src/test/resources/config/usecases-controller.properties @@ -0,0 +1,63 @@ +# +# ============LICENSE_START======================================================= +# ONAP +# ================================================================================ +# Copyright (C) 2020 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. +# ============LICENSE_END========================================================= +# + +controller.name=usecases + +rules.groupId=org.onap.policy.controlloop +rules.artifactId=usecases +rules.version=1.1.0 + +noop.source.topics=DCAE_TOPIC,APPC-CL,APPC-LCM-WRITE,SDNR-CL-RSP,POLICY-CL-MGT,APPC-LCM-READ + +noop.source.topics.DCAE_TOPIC.events=\ + org.onap.policy.controlloop.CanonicalOnset,org.onap.policy.controlloop.CanonicalAbated +noop.source.topics.DCAE_TOPIC.events.org.onap.policy.controlloop.CanonicalOnset.\ + filter=[?($.closedLoopEventStatus == 'ONSET')] +noop.source.topics.DCAE_TOPIC.events.org.onap.policy.controlloop.CanonicalAbated.\ + filter=[?($.closedLoopEventStatus == 'ABATED')] +noop.source.topics.DCAE_TOPIC.events.custom.gson=org.onap.policy.controlloop.util.Serialization,gson + +noop.source.topics.APPC-CL.events=org.onap.policy.appc.Response,org.onap.policy.appc.Request +noop.source.topics.APPC-CL.events.org.onap.policy.appc.Response.filter=[?($.CommonHeader && $.Status)] +noop.source.topics.APPC-CL.events.org.onap.policy.appc.Request.filter=[?($.CommonHeader && $.Action)] +noop.source.topics.APPC-CL.events.custom.gson=org.onap.policy.appc.util.Serialization,gsonPretty + +noop.source.topics.APPC-LCM-WRITE.events=org.onap.policy.appclcm.AppcLcmDmaapWrapper +noop.source.topics.APPC-LCM-WRITE.events.org.onap.policy.appclcm.AppcLcmDmaapWrapper.filter=[?($.type == 'response')] +noop.source.topics.APPC-LCM-WRITE.events.custom.gson=org.onap.policy.appclcm.util.Serialization,gson + +noop.source.topics.SDNR-CL-RSP.events=org.onap.policy.sdnr.PciResponseWrapper +noop.source.topics.SDNR-CL-RSP.events.org.onap.policy.sdnr.PciResponseWrapper.filter=[?($.type == 'response')] +noop.source.topics.SDNR-CL-RSP.events.custom.gson=org.onap.policy.sdnr.util.Serialization,gson + +noop.source.topics.POLICY-CL-MGT.events=org.onap.policy.controlloop.VirtualControlLoopNotification +noop.source.topics.POLICY-CL-MGT.events.custom.gson=org.onap.policy.controlloop.util.Serialization,gsonPretty + +noop.source.topics.APPC-LCM-READ.events=org.onap.policy.appclcm.AppcLcmDmaapWrapper +noop.source.topics.APPC-LCM-READ.events.custom.gson=org.onap.policy.appclcm.util.Serialization,gson + +noop.sink.topics=APPC-CL,APPC-LCM-READ,POLICY-CL-MGT,SDNR-CL,DCAE_CL_RSP + +noop.sink.topics.POLICY-CL-MGT.events=org.onap.policy.controlloop.VirtualControlLoopNotification +noop.sink.topics.POLICY-CL-MGT.events.custom.gson=org.onap.policy.controlloop.util.Serialization,gsonPretty + +noop.sink.topics.DCAE_CL_RSP.events=org.onap.policy.controlloop.ControlLoopResponse +noop.sink.topics.DCAE_CL_RSP.events.custom.gson=org.onap.policy.controlloop.util.Serialization,gsonPretty + diff --git a/controlloop/common/controller-usecases/src/test/resources/config/usecases-http-client.properties b/controlloop/common/controller-usecases/src/test/resources/config/usecases-http-client.properties new file mode 100644 index 000000000..1e3e88cec --- /dev/null +++ b/controlloop/common/controller-usecases/src/test/resources/config/usecases-http-client.properties @@ -0,0 +1,52 @@ +# +# ============LICENSE_START======================================================= +# ONAP +# ================================================================================ +# Copyright (C) 2020 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. +# ============LICENSE_END========================================================= +# + +http.client.services=GUARD,AAI,SDNC,SO,VFC + +http.client.services.GUARD.managed=true +http.client.services.GUARD.host=localhost +http.client.services.GUARD.port=6669 +http.client.services.GUARD.userName=pdpx +http.client.services.GUARD.password=pdpx +http.client.services.GUARD.contextUriPath=policy/pdpx/v1/ + +http.client.services.AAI.managed=true +http.client.services.AAI.host=localhost +http.client.services.AAI.port=6666 +http.client.services.AAI.contextUriPath= + +http.client.services.SDNC.managed=true +http.client.services.SDNC.host=localhost +http.client.services.SDNC.port=6665 +http.client.services.SDNC.userName=sdnc +http.client.services.SDNC.password=sdnc +http.client.services.SDNC.contextUriPath= + +http.client.services.SO.managed=true +http.client.services.SO.host=localhost +http.client.services.SO.port=6667 +http.client.services.SO.contextUriPath= + +http.client.services.VFC.managed=true +http.client.services.VFC.host=localhost +http.client.services.VFC.port=6668 +http.client.services.VFC.userName=VFC +http.client.services.VFC.password=VFC +http.client.services.VFC.contextUriPath=api/nslcm/v1 |