2 * ============LICENSE_START=======================================================
3 * APPCActorServiceProvider
4 * ================================================================================
5 * Copyright (C) 2017-2020 AT&T Intellectual Property. All rights reserved.
6 * Modifications Copyright (C) 2019 Nordix Foundation.
7 * ================================================================================
8 * Licensed under the Apache License, Version 2.0 (the "License");
9 * you may not use this file except in compliance with the License.
10 * You may obtain a copy of the License at
12 * http://www.apache.org/licenses/LICENSE-2.0
14 * Unless required by applicable law or agreed to in writing, software
15 * distributed under the License is distributed on an "AS IS" BASIS,
16 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17 * See the License for the specific language governing permissions and
18 * limitations under the License.
19 * ============LICENSE_END=========================================================
22 package org.onap.policy.controlloop.actor.appc;
24 import com.google.common.collect.ImmutableList;
25 import com.google.common.collect.ImmutableMap;
26 import java.util.Collections;
27 import java.util.List;
29 import java.util.Map.Entry;
30 import org.onap.policy.appc.CommonHeader;
31 import org.onap.policy.appc.Request;
32 import org.onap.policy.common.utils.coder.CoderException;
33 import org.onap.policy.common.utils.coder.StandardCoder;
34 import org.onap.policy.controlloop.ControlLoopOperation;
35 import org.onap.policy.controlloop.VirtualControlLoopEvent;
36 import org.onap.policy.controlloop.actorserviceprovider.impl.ActorImpl;
37 import org.onap.policy.controlloop.policy.Policy;
38 import org.slf4j.Logger;
39 import org.slf4j.LoggerFactory;
42 public class AppcActorServiceProvider extends ActorImpl {
43 private static final String NAME = "APPC";
45 private static final Logger logger = LoggerFactory.getLogger(AppcActorServiceProvider.class);
47 private static final StandardCoder coder = new StandardCoder();
49 // Strings for targets
50 private static final String TARGET_VM = "VM";
51 private static final String TARGET_VNF = "VNF";
53 // Strings for recipes
54 private static final String RECIPE_RESTART = "Restart";
55 private static final String RECIPE_REBUILD = "Rebuild";
56 private static final String RECIPE_MIGRATE = "Migrate";
57 private static final String RECIPE_MODIFY = "ModifyConfig";
59 private static final ImmutableList<String> recipes =
60 ImmutableList.of(RECIPE_RESTART, RECIPE_REBUILD, RECIPE_MIGRATE, RECIPE_MODIFY);
61 private static final ImmutableMap<String, List<String>> targets = new ImmutableMap.Builder<String, List<String>>()
62 .put(RECIPE_RESTART, ImmutableList.of(TARGET_VM)).put(RECIPE_REBUILD, ImmutableList.of(TARGET_VM))
63 .put(RECIPE_MIGRATE, ImmutableList.of(TARGET_VM)).put(RECIPE_MODIFY, ImmutableList.of(TARGET_VNF)).build();
64 private static final ImmutableMap<String, List<String>> payloads = new ImmutableMap.Builder<String, List<String>>()
65 .put(RECIPE_MODIFY, ImmutableList.of("generic-vnf.vnf-id")).build();
67 public AppcActorServiceProvider() {
72 public String actor() {
77 public List<String> recipes() {
78 return ImmutableList.copyOf(recipes);
82 public List<String> recipeTargets(String recipe) {
83 return ImmutableList.copyOf(targets.getOrDefault(recipe, Collections.emptyList()));
87 public List<String> recipePayloads(String recipe) {
88 return ImmutableList.copyOf(payloads.getOrDefault(recipe, Collections.emptyList()));
92 * Constructs an APPC request conforming to the legacy API. The legacy API will be deprecated in
93 * future releases as all legacy functionality is moved into the LCM API.
95 * @param onset the event that is reporting the alert for policy to perform an action
96 * @param operation the control loop operation specifying the actor, operation, target, etc.
97 * @param policy the policy the was specified from the yaml generated by CLAMP or through the
99 * @return an APPC request conforming to the legacy API
101 public static Request constructRequest(VirtualControlLoopEvent onset, ControlLoopOperation operation, Policy policy,
104 * Construct an APPC request
106 Request request = new Request();
107 request.setCommonHeader(new CommonHeader());
108 request.getCommonHeader().setRequestId(onset.getRequestId());
109 request.getCommonHeader().setSubRequestId(operation.getSubRequestId());
110 request.setAction(policy.getRecipe().substring(0, 1).toUpperCase() + policy.getRecipe().substring(1));
112 // convert policy payload strings to objects
113 if (policy.getPayload() == null) {
114 logger.info("no APPC payload specified for policy {}", policy.getName());
116 convertPayload(policy.getPayload(), request.getPayload());
119 // add/replace specific values
120 request.getPayload().put("generic-vnf.vnf-id", targetVnf);
130 * Converts a payload. The original value is assumed to be a JSON string, which is
131 * decoded into an object.
133 * @param source source from which to get the values
134 * @param target where to place the decoded values
136 private static void convertPayload(Map<String, String> source, Map<String, Object> target) {
137 for (Entry<String, String> ent : source.entrySet()) {
139 target.put(ent.getKey(), coder.decode(ent.getValue(), Object.class));
141 } catch (CoderException e) {
142 logger.warn("cannot decode JSON value {}: {}", ent.getKey(), ent.getValue(), e);