2 * ============LICENSE_START=======================================================
4 * ================================================================================
5 * Copyright (C) 2020 AT&T Intellectual Property. All rights reserved.
6 * ================================================================================
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
18 * ============LICENSE_END=========================================================
21 package org.onap.policy.controlloop.actor.guard;
24 import java.util.UUID;
25 import java.util.concurrent.CompletableFuture;
26 import java.util.concurrent.Executor;
27 import javax.ws.rs.client.Entity;
28 import javax.ws.rs.core.MediaType;
29 import javax.ws.rs.core.Response;
30 import org.onap.policy.common.endpoints.event.comm.Topic.CommInfrastructure;
31 import org.onap.policy.common.endpoints.utils.NetLoggerUtil.EventType;
32 import org.onap.policy.controlloop.actorserviceprovider.CallbackManager;
33 import org.onap.policy.controlloop.actorserviceprovider.OperationOutcome;
34 import org.onap.policy.controlloop.actorserviceprovider.Util;
35 import org.onap.policy.controlloop.actorserviceprovider.impl.HttpOperation;
36 import org.onap.policy.controlloop.actorserviceprovider.impl.OperationPartial;
37 import org.onap.policy.controlloop.actorserviceprovider.parameters.ControlLoopOperationParams;
38 import org.onap.policy.controlloop.actorserviceprovider.parameters.HttpConfig;
39 import org.onap.policy.controlloop.policy.PolicyResult;
40 import org.onap.policy.models.decisions.concepts.DecisionRequest;
41 import org.onap.policy.models.decisions.concepts.DecisionResponse;
42 import org.slf4j.Logger;
43 import org.slf4j.LoggerFactory;
46 * Guard Operation. The outcome message is set to the guard response. If the guard is
47 * permitted or indeterminate, then the outcome is set to SUCCESS.
49 * The input to the request is taken from the payload, where properties are mapped to the
50 * field names in the {@link DecisionRequest} object. Properties whose names begin with
51 * "resource." are placed into the "resource" field of the {@link DecisionRequest}. The
52 * following will be provided, if not specified in the payload:
60 public class GuardOperation extends HttpOperation<DecisionResponse> {
61 private static final Logger logger = LoggerFactory.getLogger(GuardOperation.class);
64 public static final String NAME = OperationPartial.GUARD_OPERATION_NAME;
66 public static final String PERMIT = "Permit";
67 public static final String DENY = "Deny";
68 public static final String INDETERMINATE = "Indeterminate";
71 * Prefix for properties in the payload that should be copied to the "resource" field
74 public static final String RESOURCE_PREFIX = "resource.";
76 private final GuardConfig config;
80 * Constructs the object.
82 * @param params operation parameters
83 * @param config configuration for this operation
85 public GuardOperation(ControlLoopOperationParams params, HttpConfig config) {
86 super(params, config, DecisionResponse.class);
87 this.config = (GuardConfig) config;
91 public CompletableFuture<OperationOutcome> start() {
92 if (!config.isDisabled()) {
93 // enabled - do full guard operation
97 // guard is disabled, thus it is always treated as a success
98 logger.info("{}: guard disabled, always succeeds for {}", getFullName(), params.getRequestId());
100 final Executor executor = params.getExecutor();
101 final CallbackManager callbacks = new CallbackManager();
103 return CompletableFuture.completedFuture(params.makeOutcome())
104 .whenCompleteAsync(callbackStarted(callbacks), executor)
105 .whenCompleteAsync(callbackCompleted(callbacks), executor);
109 protected CompletableFuture<OperationOutcome> startOperationAsync(int attempt, OperationOutcome outcome) {
110 outcome.setSubRequestId(String.valueOf(attempt));
112 DecisionRequest request = Util.translate(getName(), makeRequest(), DecisionRequest.class);
114 Entity<DecisionRequest> entity = Entity.entity(request, MediaType.APPLICATION_JSON);
116 Map<String, Object> headers = makeHeaders();
118 headers.put("Accept", MediaType.APPLICATION_JSON);
119 String url = getUrl();
121 logMessage(EventType.OUT, CommInfrastructure.REST, url, request);
124 return handleResponse(outcome, url,
125 callback -> getClient().post(callback, getPath(), entity, headers));
130 * Makes a request from the payload.
132 * @return a new request map
134 protected Map<String, Object> makeRequest() {
135 if (params.getPayload() == null) {
136 throw new IllegalArgumentException("missing payload");
139 Map<String, Object> req = config.makeRequest();
140 req.putAll(params.getPayload());
141 req.computeIfAbsent("requestId", key -> UUID.randomUUID().toString());
147 protected CompletableFuture<OperationOutcome> postProcessResponse(OperationOutcome outcome, String url,
148 Response rawResponse, DecisionResponse response) {
150 // determine the result
151 String status = response.getStatus();
152 if (status == null) {
153 outcome.setResult(PolicyResult.FAILURE);
154 outcome.setMessage("response contains no status");
155 return CompletableFuture.completedFuture(outcome);
158 if (PERMIT.equalsIgnoreCase(status) || INDETERMINATE.equalsIgnoreCase(status)) {
159 outcome.setResult(PolicyResult.SUCCESS);
161 outcome.setResult(PolicyResult.FAILURE);
165 outcome.setMessage(response.getStatus());
167 return CompletableFuture.completedFuture(outcome);