Give better messages than NPE for missing data
[policy/models.git] / models-interactions / model-actors / actor.appclcm / src / main / java / org / onap / policy / controlloop / actor / appclcm / AppcLcmOperation.java
index c0b8331..559709e 100644 (file)
@@ -1,8 +1,8 @@
 /*-
  * ============LICENSE_START=======================================================
- * AppcLcmOperation
+ * ONAP
  * ================================================================================
- * Copyright (C) 2020 AT&T Intellectual Property. All rights reserved.
+ * Copyright (C) 2020-2021 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.
@@ -22,42 +22,38 @@ package org.onap.policy.controlloop.actor.appclcm;
 
 import java.util.List;
 import java.util.Map;
-import java.util.UUID;
-import java.util.concurrent.CompletableFuture;
-import org.onap.aai.domain.yang.GenericVnf;
-import org.onap.policy.aai.AaiConstants;
-import org.onap.policy.aai.AaiCqResponse;
 import org.onap.policy.appclcm.AppcLcmBody;
 import org.onap.policy.appclcm.AppcLcmCommonHeader;
 import org.onap.policy.appclcm.AppcLcmDmaapWrapper;
 import org.onap.policy.appclcm.AppcLcmInput;
+import org.onap.policy.appclcm.AppcLcmOutput;
 import org.onap.policy.appclcm.AppcLcmResponseCode;
+import org.onap.policy.appclcm.AppcLcmResponseStatus;
 import org.onap.policy.common.utils.coder.CoderException;
-import org.onap.policy.common.utils.coder.StandardCoder;
-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.OperationResult;
 import org.onap.policy.controlloop.actorserviceprovider.impl.BidirectionalTopicOperation;
 import org.onap.policy.controlloop.actorserviceprovider.parameters.BidirectionalTopicConfig;
 import org.onap.policy.controlloop.actorserviceprovider.parameters.ControlLoopOperationParams;
 import org.onap.policy.controlloop.actorserviceprovider.topic.SelectorKey;
-import org.onap.policy.controlloop.policy.PolicyResult;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
-public abstract class AppcLcmOperation extends BidirectionalTopicOperation<AppcLcmDmaapWrapper, AppcLcmDmaapWrapper> {
+public class AppcLcmOperation extends BidirectionalTopicOperation<AppcLcmDmaapWrapper, AppcLcmDmaapWrapper> {
 
-    private static final Logger logger = LoggerFactory.getLogger(AppcLcmOperation.class);
-    private static final StandardCoder coder = new StandardCoder();
+    private static final String MISSING_STATUS = "APPC-LCM response is missing the response status";
     public static final String VNF_ID_KEY = "vnf-id";
 
+    private static final List<String> PROPERTY_NAMES = List.of(OperationProperties.AAI_TARGET_ENTITY);
+
     /**
      * Keys used to match the response with the request listener. The sub request ID is a
      * UUID, so it can be used to uniquely identify the response.
      * <p/>
-     * Note: if these change, then {@link #getExpectedKeyValues(int, Request)} must be
-     * updated accordingly.
+     * Note: if these change, then {@link #getExpectedKeyValues(int, AppcLcmDmaapWrapper)}
+     * must be updated accordingly.
      */
-    public static final List<SelectorKey> SELECTOR_KEYS = List.of(new SelectorKey("common-header", "sub-request-id"));
+    public static final List<SelectorKey> SELECTOR_KEYS =
+                    List.of(new SelectorKey("body", "output", "common-header", "sub-request-id"));
 
     /**
      * Constructs the object.
@@ -66,74 +62,36 @@ public abstract class AppcLcmOperation extends BidirectionalTopicOperation<AppcL
      * @param config configuration for this operation
      */
     public AppcLcmOperation(ControlLoopOperationParams params, BidirectionalTopicConfig config) {
-        super(params, config, AppcLcmDmaapWrapper.class);
-    }
-
-    /**
-     * Ensures that A&AI customer query has been performed, and then runs the guard query.
-     * Starts the GUARD using startGuardAsync.
-     */
-    @Override
-    @SuppressWarnings("unchecked")
-    protected CompletableFuture<OperationOutcome> startPreprocessorAsync() {
-        if (params != null) {
-            ControlLoopOperationParams cqParams = params.toBuilder().actor(AaiConstants.ACTOR_NAME)
-                    .operation(AaiCqResponse.OPERATION).payload(null).retry(null).timeoutSec(null).build();
-
-            // run Custom Query and Guard, in parallel
-            return allOf(() -> params.getContext().obtain(AaiCqResponse.CONTEXT_KEY, cqParams), this::startGuardAsync);
-        }
-        return startGuardAsync();
+        super(params, config, AppcLcmDmaapWrapper.class, PROPERTY_NAMES);
     }
 
     @Override
     protected AppcLcmDmaapWrapper makeRequest(int attempt) {
-        AaiCqResponse cq = params.getContext().getProperty(AaiCqResponse.CONTEXT_KEY);
-
-        GenericVnf genvnf = cq.getGenericVnfByModelInvariantId(params.getTarget().getResourceID());
-        if (genvnf == null) {
-            logger.info("{}: target entity could not be found for {}", getFullName(), params.getRequestId());
-            throw new IllegalArgumentException("target vnf-id could not be found");
-        }
-
-        return makeRequest(attempt, genvnf.getVnfId());
-    }
-
-    /**
-     * Makes a request, given the target VNF. This is a support function for
-     * {@link #makeRequest(int)}.
-     *
-     * @param attempt attempt number
-     * @param targetVnf target VNF
-     * @return a new request
-     */
-    protected AppcLcmDmaapWrapper makeRequest(int attempt, String targetVnf) {
-        VirtualControlLoopEvent onset = params.getContext().getEvent();
-        String subRequestId = UUID.randomUUID().toString();
+        String subRequestId = getSubRequestId();
 
         AppcLcmCommonHeader header = new AppcLcmCommonHeader();
-        header.setOriginatorId(onset.getRequestId().toString());
-        header.setRequestId(onset.getRequestId());
+        header.setOriginatorId(params.getRequestId().toString());
+        header.setRequestId(params.getRequestId());
         header.setSubRequestId(subRequestId);
 
         AppcLcmInput inputRequest = new AppcLcmInput();
         inputRequest.setCommonHeader(header);
-        inputRequest.setAction(getName());
+
+        AppcLcmRecipeFormatter recipeFormatter = new AppcLcmRecipeFormatter(getName());
+        inputRequest.setAction(recipeFormatter.getBodyRecipe());
 
         /*
-         * Action Identifiers are required for APPC LCM requests. For R1, the recipes supported by
-         * Policy only require a vnf-id.
+         * Action Identifiers are required for APPC LCM requests. For R1, the recipes
+         * supported by Policy only require a vnf-id.
          */
-        if (inputRequest.getActionIdentifiers() != null) {
-            inputRequest.getActionIdentifiers().put(VNF_ID_KEY, targetVnf);
-        } else {
-            inputRequest.setActionIdentifiers(Map.of(VNF_ID_KEY, targetVnf));
-        }
+        String target = getRequiredProperty(OperationProperties.AAI_TARGET_ENTITY, "target entity");
+        inputRequest.setActionIdentifiers(Map.of(VNF_ID_KEY, target));
 
         /*
-         * For R1, the payloads will not be required for the Restart, Rebuild, or Migrate recipes.
-         * APPC will populate the payload based on A&AI look up of the vnd-id provided in the action
-         * identifiers. The payload is set when converPayload() is called.
+         * For R1, the payloads will not be required for the Restart, Rebuild, or Migrate
+         * recipes. APPC will populate the payload based on A&AI look up of the vnd-id
+         * provided in the action identifiers. The payload is set when converPayload() is
+         * called.
          */
         if (operationSupportsPayload()) {
             convertPayload(params.getPayload(), inputRequest);
@@ -144,13 +102,10 @@ public abstract class AppcLcmOperation extends BidirectionalTopicOperation<AppcL
         AppcLcmBody body = new AppcLcmBody();
         body.setInput(inputRequest);
 
-        AppcLcmRecipeFormatter recipeFormatter = new AppcLcmRecipeFormatter(getName());
-        inputRequest.setAction(recipeFormatter.getBodyRecipe());
-
         AppcLcmDmaapWrapper dmaapRequest = new AppcLcmDmaapWrapper();
         dmaapRequest.setBody(body);
         dmaapRequest.setVersion("2.0");
-        dmaapRequest.setCorrelationId(onset.getRequestId() + "-" + subRequestId);
+        dmaapRequest.setCorrelationId(params.getRequestId() + "-" + subRequestId);
         dmaapRequest.setRpcName(recipeFormatter.getUrlRecipe());
         dmaapRequest.setType("request");
 
@@ -166,14 +121,12 @@ public abstract class AppcLcmOperation extends BidirectionalTopicOperation<AppcL
      * @param source source from which to get the values
      * @param map where to place the decoded values
      */
-    private static void convertPayload(Map<String, Object> source, AppcLcmInput request) {
-        String encodedPayloadString = null;
+    private void convertPayload(Map<String, Object> source, AppcLcmInput request) {
         try {
-            encodedPayloadString = coder.encode(source);
+            String encodedPayloadString = getCoder().encode(source);
             request.setPayload(encodedPayloadString);
         } catch (CoderException e) {
-            logger.error("Cannot convert payload. Error encoding source as a string.", e);
-            throw new IllegalArgumentException("Cannot convert payload. Error encoding source as a string.");
+            throw new IllegalArgumentException("Cannot convert payload", e);
         }
     }
 
@@ -182,21 +135,19 @@ public abstract class AppcLcmOperation extends BidirectionalTopicOperation<AppcL
      */
     @Override
     protected List<String> getExpectedKeyValues(int attempt, AppcLcmDmaapWrapper request) {
-        return List.of(request.getBody().getInput().getCommonHeader().getSubRequestId());
+        return List.of(getSubRequestId());
     }
 
     @Override
     protected Status detmStatus(String rawResponse, AppcLcmDmaapWrapper response) {
-        if (response == null || response.getBody() == null || response.getBody().getOutput() == null
-                || response.getBody().getOutput().getStatus() == null) {
-            throw new IllegalArgumentException("APPC-LCM response is missing the response status");
+        AppcLcmResponseStatus status = getStatus(response);
+        if (status == null) {
+            throw new IllegalArgumentException(MISSING_STATUS);
         }
 
-        String code = AppcLcmResponseCode.toResponseValue(response.getBody().getOutput().getStatus().getCode());
-
+        String code = AppcLcmResponseCode.toResponseValue(status.getCode());
         if (code == null) {
-            throw new IllegalArgumentException(
-                    "unknown APPC-LCM response status code: " + response.getBody().getOutput().getStatus().getCode());
+            throw new IllegalArgumentException("unknown APPC-LCM response status code: " + status.getCode());
         }
 
         switch (code) {
@@ -217,19 +168,55 @@ public abstract class AppcLcmOperation extends BidirectionalTopicOperation<AppcL
      * Sets the message to the status description, if available.
      */
     @Override
-    public OperationOutcome setOutcome(OperationOutcome outcome, PolicyResult result, AppcLcmDmaapWrapper response) {
-        if (response == null || response.getBody() == null || response.getBody().getOutput() == null
-                || response.getBody().getOutput().getStatus() == null
-                || response.getBody().getOutput().getStatus().getMessage() == null) {
+    public OperationOutcome setOutcome(OperationOutcome outcome, OperationResult result, AppcLcmDmaapWrapper response) {
+        outcome.setResponse(response);
+
+        AppcLcmResponseStatus status = getStatus(response);
+        if (status == null) {
+            return setOutcome(outcome, result);
+        }
+
+        String message = status.getMessage();
+        if (message == null) {
             return setOutcome(outcome, result);
         }
 
         outcome.setResult(result);
-        outcome.setMessage(response.getBody().getOutput().getStatus().getMessage());
+        outcome.setMessage(message);
         return outcome;
     }
 
+    /**
+     * Gets the status from the response.
+     *
+     * @param response the response from which to extract the status, or {@code null}
+     * @return the status, or {@code null} if it does not exist
+     */
+    protected AppcLcmResponseStatus getStatus(AppcLcmDmaapWrapper response) {
+        if (response == null) {
+            return null;
+        }
+
+        AppcLcmBody body = response.getBody();
+        if (body == null) {
+            return null;
+        }
+
+        AppcLcmOutput output = body.getOutput();
+        if (output == null) {
+            return null;
+        }
+
+        return output.getStatus();
+    }
+
+    /**
+     * Determines if the operation supports a payload.
+     *
+     * @return {@code true} if the operation supports a payload, {@code false} otherwise
+     */
     protected boolean operationSupportsPayload() {
-        return params.getPayload() != null && !params.getPayload().isEmpty();
+        return params.getPayload() != null && !params.getPayload().isEmpty()
+                        && AppcLcmConstants.SUPPORTS_PAYLOAD.contains(params.getOperation().toLowerCase());
     }
 }