2 * ============LICENSE_START=======================================================
3 * Copyright (C) 2021-2023 Nordix Foundation.
4 * ================================================================================
5 * Modifications Copyright (C) 2021 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.
19 * SPDX-License-Identifier: Apache-2.0
20 * ============LICENSE_END=========================================================
23 package org.onap.policy.clamp.acm.participant.intermediary.handler;
25 import io.micrometer.core.annotation.Timed;
26 import java.util.ArrayList;
27 import java.util.List;
28 import lombok.RequiredArgsConstructor;
29 import org.onap.policy.clamp.acm.participant.intermediary.comm.ParticipantMessagePublisher;
30 import org.onap.policy.clamp.models.acm.concepts.AutomationCompositionElementDefinition;
31 import org.onap.policy.clamp.models.acm.concepts.AutomationCompositionInfo;
32 import org.onap.policy.clamp.models.acm.concepts.ParticipantDefinition;
33 import org.onap.policy.clamp.models.acm.concepts.ParticipantState;
34 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.AutomationCompositionDeploy;
35 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.AutomationCompositionStateChange;
36 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.ParticipantAckMessage;
37 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.ParticipantDeregister;
38 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.ParticipantDeregisterAck;
39 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.ParticipantMessage;
40 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.ParticipantPrime;
41 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.ParticipantRegister;
42 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.ParticipantRegisterAck;
43 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.ParticipantStatus;
44 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.ParticipantStatusReq;
45 import org.onap.policy.clamp.models.acm.messages.dmaap.participant.PropertiesUpdate;
46 import org.slf4j.Logger;
47 import org.slf4j.LoggerFactory;
48 import org.springframework.stereotype.Component;
51 * This class is responsible for managing the state of a participant.
54 @RequiredArgsConstructor
55 public class ParticipantHandler {
56 private static final Logger LOGGER = LoggerFactory.getLogger(ParticipantHandler.class);
58 private final AutomationCompositionHandler automationCompositionHandler;
59 private final AutomationCompositionOutHandler automationCompositionOutHandler;
60 private final ParticipantMessagePublisher publisher;
61 private final CacheProvider cacheProvider;
64 * Method which handles a participant health check event from clamp.
66 * @param participantStatusReqMsg participant participantStatusReq message
68 @Timed(value = "listener.participant_status_req", description = "PARTICIPANT_STATUS_REQ messages received")
69 public void handleParticipantStatusReq(final ParticipantStatusReq participantStatusReqMsg) {
70 var participantStatus = makeHeartbeat(true);
71 publisher.sendParticipantStatus(participantStatus);
75 * Handle a automation composition update message.
77 * @param updateMsg the update message
80 value = "listener.automation_composition_update",
81 description = "AUTOMATION_COMPOSITION_UPDATE messages received")
82 public void handleAutomationCompositionDeploy(AutomationCompositionDeploy updateMsg) {
83 automationCompositionHandler.handleAutomationCompositionDeploy(updateMsg);
87 * Handle a automation composition state change message.
89 * @param stateChangeMsg the state change message
92 value = "listener.automation_composition_state_change",
93 description = "AUTOMATION_COMPOSITION_STATE_CHANGE messages received")
94 public void handleAutomationCompositionStateChange(AutomationCompositionStateChange stateChangeMsg) {
95 automationCompositionHandler.handleAutomationCompositionStateChange(stateChangeMsg);
99 * Handle a automation composition property update message.
101 * @param propertyUpdateMsg the property update message
103 @Timed(value = "listener.properties_update", description = "PROPERTIES_UPDATE message received")
104 public void handleAcPropertyUpdate(PropertiesUpdate propertyUpdateMsg) {
105 automationCompositionHandler.handleAcPropertyUpdate(propertyUpdateMsg);
109 * Check if a participant message applies to this participant handler.
111 * @param participantMsg the message to check
112 * @return true if it applies, false otherwise
114 public boolean appliesTo(ParticipantMessage participantMsg) {
115 return participantMsg.appliesTo(cacheProvider.getParticipantId());
119 * Check if a participant message applies to this participant handler.
121 * @param participantMsg the message to check
122 * @return true if it applies, false otherwise
124 public boolean appliesTo(ParticipantAckMessage participantMsg) {
125 return participantMsg.appliesTo(cacheProvider.getParticipantId());
129 * Method to send ParticipantRegister message to automation composition runtime.
131 public void sendParticipantRegister() {
132 var participantRegister = new ParticipantRegister();
133 participantRegister.setParticipantId(cacheProvider.getParticipantId());
134 participantRegister.setParticipantSupportedElementType(cacheProvider.getSupportedAcElementTypes());
136 publisher.sendParticipantRegister(participantRegister);
140 * Handle a participantRegister Ack message.
142 * @param participantRegisterAckMsg the participantRegisterAck message
144 @Timed(value = "listener.participant_register_ack", description = "PARTICIPANT_REGISTER_ACK messages received")
145 public void handleParticipantRegisterAck(ParticipantRegisterAck participantRegisterAckMsg) {
146 LOGGER.debug("ParticipantRegisterAck message received as responseTo {}",
147 participantRegisterAckMsg.getResponseTo());
148 publisher.sendParticipantStatus(makeHeartbeat(false));
152 * Method to send ParticipantDeregister message to automation composition runtime.
154 public void sendParticipantDeregister() {
155 var participantDeregister = new ParticipantDeregister();
156 participantDeregister.setParticipantId(cacheProvider.getParticipantId());
157 publisher.sendParticipantDeregister(participantDeregister);
161 * Handle a participantDeregister Ack message.
163 * @param participantDeregisterAckMsg the participantDeregisterAck message
165 @Timed(value = "listener.participant_deregister_ack", description = "PARTICIPANT_DEREGISTER_ACK messages received")
166 public void handleParticipantDeregisterAck(ParticipantDeregisterAck participantDeregisterAckMsg) {
167 LOGGER.debug("ParticipantDeregisterAck message received as responseTo {}",
168 participantDeregisterAckMsg.getResponseTo());
172 * Handle a ParticipantPrime message.
174 * @param participantPrimeMsg the ParticipantPrime message
176 @Timed(value = "listener.participant_prime", description = "PARTICIPANT_PRIME messages received")
177 public void handleParticipantPrime(ParticipantPrime participantPrimeMsg) {
178 LOGGER.debug("ParticipantPrime message received for participantId {}", participantPrimeMsg.getParticipantId());
180 if (!participantPrimeMsg.getParticipantDefinitionUpdates().isEmpty()) {
182 List<AutomationCompositionElementDefinition> list = new ArrayList<>();
183 for (var participantDefinition : participantPrimeMsg.getParticipantDefinitionUpdates()) {
184 if (participantDefinition.getParticipantId().equals(cacheProvider.getParticipantId())) {
185 list.addAll(participantDefinition.getAutomationCompositionElementDefinitionList());
188 cacheProvider.addElementDefinition(participantPrimeMsg.getCompositionId(), list);
189 automationCompositionHandler.prime(participantPrimeMsg.getMessageId(),
190 participantPrimeMsg.getCompositionId(), list);
193 cacheProvider.removeElementDefinition(participantPrimeMsg.getCompositionId());
194 automationCompositionHandler.deprime(participantPrimeMsg.getMessageId(),
195 participantPrimeMsg.getCompositionId());
200 * Dispatch a heartbeat for this participant.
202 public void sendHeartbeat() {
203 publisher.sendHeartbeat(makeHeartbeat(false));
207 * Method to send heartbeat to automation composition runtime.
209 public ParticipantStatus makeHeartbeat(boolean responseToParticipantStatusReq) {
210 var heartbeat = new ParticipantStatus();
211 heartbeat.setParticipantId(cacheProvider.getParticipantId());
212 heartbeat.setState(ParticipantState.ON_LINE);
213 heartbeat.setAutomationCompositionInfoList(getAutomationCompositionInfoList());
214 heartbeat.setParticipantSupportedElementType(cacheProvider.getSupportedAcElementTypes());
216 if (responseToParticipantStatusReq) {
217 var acElementDefsMap = cacheProvider.getAcElementsDefinitions();
218 List<ParticipantDefinition> participantDefinitionList = new ArrayList<>(acElementDefsMap.size());
219 for (var acElementDefs : acElementDefsMap.values()) {
220 var participantDefinition = new ParticipantDefinition();
221 participantDefinition.setParticipantId(cacheProvider.getParticipantId());
222 participantDefinition
223 .setAutomationCompositionElementDefinitionList(new ArrayList<>(acElementDefs.values()));
224 participantDefinitionList.add(participantDefinition);
226 heartbeat.setParticipantDefinitionUpdates(participantDefinitionList);
233 * get AutomationComposition Info List.
235 * @return list of AutomationCompositionInfo
237 private List<AutomationCompositionInfo> getAutomationCompositionInfoList() {
238 List<AutomationCompositionInfo> automationCompositionInfoList = new ArrayList<>();
239 for (var entry : cacheProvider.getAutomationCompositions().entrySet()) {
240 var acInfo = new AutomationCompositionInfo();
241 acInfo.setAutomationCompositionId(entry.getKey());
242 acInfo.setDeployState(entry.getValue().getDeployState());
243 acInfo.setLockState(entry.getValue().getLockState());
244 for (var element : entry.getValue().getElements().values()) {
245 acInfo.getElements().add(automationCompositionOutHandler.getAutomationCompositionElementInfo(element));
247 automationCompositionInfoList.add(acInfo);
249 return automationCompositionInfoList;