e51482ce4d3c010542eec089f7167d24e9af8750
[policy/apex-pdp.git] /
1 /*-
2  * ============LICENSE_START=======================================================
3  *  Copyright (C) 2016-2018 Ericsson. 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
8  *
9  *      http://www.apache.org/licenses/LICENSE-2.0
10  *
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.
16  *
17  * SPDX-License-Identifier: Apache-2.0
18  * ============LICENSE_END=========================================================
19  */
20
21 package org.onap.policy.apex.plugins.event.carrier.restserver;
22
23 import java.util.EnumMap;
24 import java.util.Map;
25
26 import org.onap.policy.apex.service.engine.event.ApexEventException;
27 import org.onap.policy.apex.service.engine.event.ApexEventProducer;
28 import org.onap.policy.apex.service.engine.event.PeeredReference;
29 import org.onap.policy.apex.service.engine.event.SynchronousEventCache;
30 import org.onap.policy.apex.service.parameters.eventhandler.EventHandlerParameters;
31 import org.onap.policy.apex.service.parameters.eventhandler.EventHandlerPeeredMode;
32 import org.slf4j.Logger;
33 import org.slf4j.LoggerFactory;
34
35 /**
36  * Concrete implementation of an Apex event producer that sends events using REST.
37  *
38  * @author Liam Fallon (liam.fallon@ericsson.com)
39  *
40  */
41 public class ApexRestServerProducer implements ApexEventProducer {
42     private static final Logger LOGGER = LoggerFactory.getLogger(ApexRestServerProducer.class);
43
44     // The REST carrier properties
45     private RESTServerCarrierTechnologyParameters restProducerProperties;
46
47     // The name for this producer
48     private String name = null;
49
50     // The peer references for this event handler
51     private Map<EventHandlerPeeredMode, PeeredReference> peerReferenceMap = new EnumMap<>(EventHandlerPeeredMode.class);
52
53     /*
54      * (non-Javadoc)
55      *
56      * @see org.onap.policy.apex.service.engine.event.ApexEventProducer#init(java.lang.String,
57      * org.onap.policy.apex.service.parameters.eventhandler.EventHandlerParameters)
58      */
59     @Override
60     public void init(final String producerName, final EventHandlerParameters producerParameters)
61             throws ApexEventException {
62         this.name = producerName;
63
64         // Check and get the REST Properties
65         if (!(producerParameters.getCarrierTechnologyParameters() instanceof RESTServerCarrierTechnologyParameters)) {
66             final String errorMessage =
67                     "specified producer properties are not applicable to REST Server producer (" + this.name + ")";
68             LOGGER.warn(errorMessage);
69             throw new ApexEventException(errorMessage);
70         }
71         restProducerProperties =
72                 (RESTServerCarrierTechnologyParameters) producerParameters.getCarrierTechnologyParameters();
73
74         // Check if host and port are defined
75         if (restProducerProperties.getHost() != null || restProducerProperties.getPort() != -1
76                 || restProducerProperties.isStandalone()) {
77             final String errorMessage =
78                     "the parameters \"host\", \"port\", and \"standalone\" are illegal on REST Server producer ("
79                             + this.name + ")";
80             LOGGER.warn(errorMessage);
81             throw new ApexEventException(errorMessage);
82         }
83
84         // Check if we are in synchronous mode
85         if (!producerParameters.isPeeredMode(EventHandlerPeeredMode.SYNCHRONOUS)) {
86             final String errorMessage =
87                     "REST Server producer (" + this.name + ") must run in synchronous mode with a REST Server consumer";
88             LOGGER.warn(errorMessage);
89             throw new ApexEventException(errorMessage);
90         }
91     }
92
93     /*
94      * (non-Javadoc)
95      *
96      * @see org.onap.policy.apex.service.engine.event.ApexEventProducer#getName()
97      */
98     @Override
99     public String getName() {
100         return name;
101     }
102
103     /*
104      * (non-Javadoc)
105      *
106      * @see org.onap.policy.apex.service.engine.event.ApexEventProducer#getPeeredReference(org.onap.policy.apex.service.
107      * parameters. eventhandler.EventHandlerPeeredMode)
108      */
109     @Override
110     public PeeredReference getPeeredReference(final EventHandlerPeeredMode peeredMode) {
111         return peerReferenceMap.get(peeredMode);
112     }
113
114     /*
115      * (non-Javadoc)
116      *
117      * @see org.onap.policy.apex.service.engine.event.ApexEventProducer#setPeeredReference(org.onap.policy.apex.service.
118      * parameters. eventhandler.EventHandlerPeeredMode, org.onap.policy.apex.service.engine.event.PeeredReference)
119      */
120     @Override
121     public void setPeeredReference(final EventHandlerPeeredMode peeredMode, final PeeredReference peeredReference) {
122         peerReferenceMap.put(peeredMode, peeredReference);
123     }
124
125     /*
126      * (non-Javadoc)
127      *
128      * @see org.onap.policy.apex.service.engine.event.ApexEventProducer#sendEvent(long, java.lang. String,
129      * java.lang.Object)
130      */
131     @Override
132     public void sendEvent(final long executionId, final String eventName, final Object event) {
133         if (LOGGER.isDebugEnabled()) {
134             LOGGER.debug(name + ": event " + executionId + ':' + eventName + " recevied from Apex, event=" + event);
135         }
136
137         // If we are not synchronized, then exit
138         final SynchronousEventCache synchronousEventCache =
139                 (SynchronousEventCache) peerReferenceMap.get(EventHandlerPeeredMode.SYNCHRONOUS);
140         if (synchronousEventCache == null) {
141             return;
142         }
143
144         // We see all events on the receiver, even those that are not replies to events sent by the synchronized
145         // consumer of this producer, ignore those
146         // events
147         if (!synchronousEventCache.existsEventToApex(executionId)) {
148             return;
149         }
150
151         if (LOGGER.isDebugEnabled()) {
152             LOGGER.debug(name + ": event " + executionId + ':' + eventName + " is a reply to a REST server call from "
153                     + name);
154         }
155
156         // Add the event to the received event cache
157         synchronousEventCache.cacheSynchronizedEventFromApex(executionId, event);
158     }
159
160     /*
161      * (non-Javadoc)
162      *
163      * @see org.onap.policy.apex.service.engine.event.ApexEventProducer#stop()
164      */
165     @Override
166     public void stop() {}
167 }