0e7e193f6443594ab9902871a3d6f0e07dfb72f2
[policy/clamp.git] /
1 /*-
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
10  *
11  *      http://www.apache.org/licenses/LICENSE-2.0
12  *
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  *
19  * SPDX-License-Identifier: Apache-2.0
20  * ============LICENSE_END=========================================================
21  */
22
23 package org.onap.policy.clamp.acm.participant.intermediary.handler;
24
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;
49
50 /**
51  * This class is responsible for managing the state of a participant.
52  */
53 @Component
54 @RequiredArgsConstructor
55 public class ParticipantHandler {
56     private static final Logger LOGGER = LoggerFactory.getLogger(ParticipantHandler.class);
57
58     private final AutomationCompositionHandler automationCompositionHandler;
59     private final AutomationCompositionOutHandler automationCompositionOutHandler;
60     private final ParticipantMessagePublisher publisher;
61     private final CacheProvider cacheProvider;
62
63     /**
64      * Method which handles a participant health check event from clamp.
65      *
66      * @param participantStatusReqMsg participant participantStatusReq message
67      */
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);
72     }
73
74     /**
75      * Handle a automation composition update message.
76      *
77      * @param updateMsg the update message
78      */
79     @Timed(
80             value = "listener.automation_composition_update",
81             description = "AUTOMATION_COMPOSITION_UPDATE messages received")
82     public void handleAutomationCompositionDeploy(AutomationCompositionDeploy updateMsg) {
83         automationCompositionHandler.handleAutomationCompositionDeploy(updateMsg);
84     }
85
86     /**
87      * Handle a automation composition state change message.
88      *
89      * @param stateChangeMsg the state change message
90      */
91     @Timed(
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);
96     }
97
98     /**
99      * Handle a automation composition property update message.
100      *
101      * @param propertyUpdateMsg the property update message
102      */
103     @Timed(value = "listener.properties_update", description = "PROPERTIES_UPDATE message received")
104     public void handleAcPropertyUpdate(PropertiesUpdate propertyUpdateMsg) {
105         automationCompositionHandler.handleAcPropertyUpdate(propertyUpdateMsg);
106     }
107
108     /**
109      * Check if a participant message applies to this participant handler.
110      *
111      * @param participantMsg the message to check
112      * @return true if it applies, false otherwise
113      */
114     public boolean appliesTo(ParticipantMessage participantMsg) {
115         return participantMsg.appliesTo(cacheProvider.getParticipantId());
116     }
117
118     /**
119      * Check if a participant message applies to this participant handler.
120      *
121      * @param participantMsg the message to check
122      * @return true if it applies, false otherwise
123      */
124     public boolean appliesTo(ParticipantAckMessage participantMsg) {
125         return participantMsg.appliesTo(cacheProvider.getParticipantId());
126     }
127
128     /**
129      * Method to send ParticipantRegister message to automation composition runtime.
130      */
131     public void sendParticipantRegister() {
132         var participantRegister = new ParticipantRegister();
133         participantRegister.setParticipantId(cacheProvider.getParticipantId());
134         participantRegister.setParticipantSupportedElementType(cacheProvider.getSupportedAcElementTypes());
135
136         publisher.sendParticipantRegister(participantRegister);
137     }
138
139     /**
140      * Handle a participantRegister Ack message.
141      *
142      * @param participantRegisterAckMsg the participantRegisterAck message
143      */
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));
149     }
150
151     /**
152      * Method to send ParticipantDeregister message to automation composition runtime.
153      */
154     public void sendParticipantDeregister() {
155         var participantDeregister = new ParticipantDeregister();
156         participantDeregister.setParticipantId(cacheProvider.getParticipantId());
157         publisher.sendParticipantDeregister(participantDeregister);
158     }
159
160     /**
161      * Handle a participantDeregister Ack message.
162      *
163      * @param participantDeregisterAckMsg the participantDeregisterAck message
164      */
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());
169     }
170
171     /**
172      * Handle a ParticipantPrime message.
173      *
174      * @param participantPrimeMsg the ParticipantPrime message
175      */
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());
179
180         if (!participantPrimeMsg.getParticipantDefinitionUpdates().isEmpty()) {
181             // prime
182             List<AutomationCompositionElementDefinition> list = new ArrayList<>();
183             for (var participantDefinition : participantPrimeMsg.getParticipantDefinitionUpdates()) {
184                 if (participantDefinition.getParticipantId().equals(cacheProvider.getParticipantId())) {
185                     list.addAll(participantDefinition.getAutomationCompositionElementDefinitionList());
186                 }
187             }
188             cacheProvider.addElementDefinition(participantPrimeMsg.getCompositionId(), list);
189             automationCompositionHandler.prime(participantPrimeMsg.getCompositionId(), list);
190         } else {
191             // deprime
192             cacheProvider.removeElementDefinition(participantPrimeMsg.getCompositionId());
193             automationCompositionHandler.deprime(participantPrimeMsg.getCompositionId());
194         }
195     }
196
197     /**
198      * Dispatch a heartbeat for this participant.
199      */
200     public void sendHeartbeat() {
201         publisher.sendHeartbeat(makeHeartbeat(false));
202     }
203
204     /**
205      * Method to send heartbeat to automation composition runtime.
206      */
207     public ParticipantStatus makeHeartbeat(boolean responseToParticipantStatusReq) {
208         var heartbeat = new ParticipantStatus();
209         heartbeat.setParticipantId(cacheProvider.getParticipantId());
210         heartbeat.setState(ParticipantState.ON_LINE);
211         heartbeat.setAutomationCompositionInfoList(getAutomationCompositionInfoList());
212         heartbeat.setParticipantSupportedElementType(cacheProvider.getSupportedAcElementTypes());
213
214         if (responseToParticipantStatusReq) {
215             var acElementDefsMap = cacheProvider.getAcElementsDefinitions();
216             List<ParticipantDefinition> participantDefinitionList = new ArrayList<>(acElementDefsMap.size());
217             for (var acElementDefs : acElementDefsMap.values()) {
218                 var participantDefinition = new ParticipantDefinition();
219                 participantDefinition.setParticipantId(cacheProvider.getParticipantId());
220                 participantDefinition
221                         .setAutomationCompositionElementDefinitionList(new ArrayList<>(acElementDefs.values()));
222                 participantDefinitionList.add(participantDefinition);
223             }
224             heartbeat.setParticipantDefinitionUpdates(participantDefinitionList);
225         }
226
227         return heartbeat;
228     }
229
230     /**
231      * get AutomationComposition Info List.
232      *
233      * @return list of AutomationCompositionInfo
234      */
235     private List<AutomationCompositionInfo> getAutomationCompositionInfoList() {
236         List<AutomationCompositionInfo> automationCompositionInfoList = new ArrayList<>();
237         for (var entry : cacheProvider.getAutomationCompositions().entrySet()) {
238             var acInfo = new AutomationCompositionInfo();
239             acInfo.setAutomationCompositionId(entry.getKey());
240             acInfo.setDeployState(entry.getValue().getDeployState());
241             acInfo.setLockState(entry.getValue().getLockState());
242             for (var element : entry.getValue().getElements().values()) {
243                 acInfo.getElements().add(automationCompositionOutHandler.getAutomationCompositionElementInfo(element));
244             }
245             automationCompositionInfoList.add(acInfo);
246         }
247         return automationCompositionInfoList;
248     }
249 }