2 * ============LICENSE_START=======================================================
3 * Copyright (C) 2019, 2021 AT&T Intellectual Property. All rights reserved.
4 * ================================================================================
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
17 * SPDX-License-Identifier: Apache-2.0
18 * ============LICENSE_END=========================================================
21 package org.onap.policy.pdpx.main;
23 import java.util.Collections;
24 import org.apache.commons.lang3.StringUtils;
25 import org.onap.policy.common.utils.network.NetworkUtil;
26 import org.onap.policy.models.pdp.concepts.PdpMessage;
27 import org.onap.policy.models.pdp.concepts.PdpResponseDetails;
28 import org.onap.policy.models.pdp.concepts.PdpStateChange;
29 import org.onap.policy.models.pdp.concepts.PdpStatus;
30 import org.onap.policy.models.pdp.concepts.PdpUpdate;
31 import org.onap.policy.models.pdp.enums.PdpHealthStatus;
32 import org.onap.policy.models.pdp.enums.PdpResponseStatus;
33 import org.onap.policy.models.pdp.enums.PdpState;
34 import org.onap.policy.pdpx.main.rest.XacmlPdpApplicationManager;
35 import org.onap.policy.pdpx.main.startstop.XacmlPdpActivator;
36 import org.slf4j.Logger;
37 import org.slf4j.LoggerFactory;
40 * Current state of this XACML PDP.
42 public class XacmlState {
43 // The logger for this class
44 private static final Logger LOGGER = LoggerFactory.getLogger(XacmlState.class);
47 * Unique name for the xacml-pdp JVM, used in PdpStatus messages.
49 public static final String PDP_NAME = NetworkUtil.genUniqueName("xacml");
52 * The application manager.
54 private final XacmlPdpApplicationManager appManager;
57 * Records the current state of this PDP.
59 private final PdpStatus status;
62 * Constructs the object, initializing the state.
64 public XacmlState(XacmlPdpApplicationManager appManager, String pdpGroupName, String pdpType) {
65 this.appManager = appManager;
67 this.status = new PdpStatus();
68 this.status.setName(PDP_NAME);
69 this.status.setPdpType(pdpType);
70 this.status.setState(PdpState.PASSIVE);
71 this.status.setPolicies(Collections.emptyList());
72 this.status.setPdpGroup(pdpGroupName);
76 * Determines if this PDP should handle the given message.
78 * @param message message of interest
79 * @return {@code true} if this PDP should handle the message, {@code false} otherwise
81 public boolean shouldHandle(PdpMessage message) {
82 return message.appliesTo(status.getName(), status.getPdpGroup(), status.getPdpType());
86 * Generates a new heart beat message.
88 * @return a new heart beat message
90 public synchronized PdpStatus genHeartbeat() {
91 // first, update status fields
92 status.setHealthy(XacmlPdpActivator.getCurrent().isAlive() ? PdpHealthStatus.HEALTHY
93 : PdpHealthStatus.NOT_HEALTHY);
95 return new PdpStatus(status);
99 * Updates the internal state based on the given message.
101 * @param message message from which to update the internal state
102 * @return a response to the message
104 public synchronized PdpStatus updateInternalState(PdpStateChange message) {
105 LOGGER.info("set state of {} to {}", this, message.getState());
106 status.setState(message.getState());
109 * NOTE: Do NOT update group & subgroup as state-change requests do not set those
110 * fields to indicate new values; they only set them to do broadcasts to all PDPs
111 * within a group/subgroup.
114 PdpStatus status2 = makeResponse(message, "");
116 // start/stop rest controller based on state change
117 handleXacmlRestController();
119 // these fields aren't needed in the response, so clear them out to avoid sending
120 status2.setPolicies(null);
126 * Updates the internal state based on the given message. Assumes that the policies
127 * have already been updated within the application manager.
129 * @param message message from which to update the internal state
130 * @return a response to the message
132 public synchronized PdpStatus updateInternalState(PdpUpdate message, String errMessage) {
133 status.setPdpSubgroup(message.getPdpSubgroup());
134 status.setPolicies(appManager.getToscaPolicyIdentifiers());
136 return makeResponse(message, errMessage);
140 * Updates the internal state to Terminated.
142 * @return the current PdpStatus with Terminated state
144 public synchronized PdpStatus terminatePdpMessage() {
145 LOGGER.info("set state of {} to {}", this, PdpState.TERMINATED);
146 status.setState(PdpState.TERMINATED);
147 return new PdpStatus(status);
151 * Makes a response to the given message, based on the current state.
153 * @param message message for which the response should be made
154 * @param errMessage the error message to be sent to PAP
155 * @return a new response
157 private PdpStatus makeResponse(PdpMessage message, String errMessage) {
158 var resp = new PdpResponseDetails();
160 if (StringUtils.isBlank(errMessage)) {
161 resp.setResponseStatus(PdpResponseStatus.SUCCESS);
163 resp.setResponseStatus(PdpResponseStatus.FAIL);
164 resp.setResponseMessage(errMessage);
166 resp.setResponseTo(message.getRequestId());
168 var status2 = new PdpStatus(status);
169 status2.setResponse(resp);
174 * Manages the Xacml-Pdp rest controller based on the Xacml-Pdp State.
175 * Current supported states:
176 * ACTIVE - rest service is running and handling requests
177 * PASSIVE - rest service is not running
179 private void handleXacmlRestController() {
180 if (status.getState() == PdpState.ACTIVE) {
181 LOGGER.info("State change: {} - Starting rest controller", status.getState());
182 XacmlPdpActivator.getCurrent().startXacmlRestController();
183 } else if (status.getState() == PdpState.PASSIVE) {
184 LOGGER.info("State change: {} - Stopping rest controller", status.getState());
185 XacmlPdpActivator.getCurrent().stopXacmlRestController();
188 LOGGER.warn("Unsupported state: {}", status.getState());