gerrit.onap Code Review - policy/apex-pdp.git/blob

   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.jms;
  22
  23 import java.util.EnumMap;
  24 import java.util.Map;
  25
  26 import javax.jms.Connection;
  27 import javax.jms.ConnectionFactory;
  28 import javax.jms.Message;
  29 import javax.jms.MessageConsumer;
  30 import javax.jms.MessageListener;
  31 import javax.jms.Session;
  32 import javax.jms.Topic;
  33 import javax.naming.InitialContext;
  34
  35 import org.onap.policy.apex.core.infrastructure.threading.ApplicationThreadFactory;
  36 import org.onap.policy.apex.core.infrastructure.threading.ThreadUtilities;
  37 import org.onap.policy.apex.service.engine.event.ApexEventConsumer;
  38 import org.onap.policy.apex.service.engine.event.ApexEventException;
  39 import org.onap.policy.apex.service.engine.event.ApexEventReceiver;
  40 import org.onap.policy.apex.service.engine.event.ApexEventRuntimeException;
  41 import org.onap.policy.apex.service.engine.event.PeeredReference;
  42 import org.onap.policy.apex.service.parameters.eventhandler.EventHandlerParameters;
  43 import org.onap.policy.apex.service.parameters.eventhandler.EventHandlerPeeredMode;
  44 import org.slf4j.Logger;
  45 import org.slf4j.LoggerFactory;
  46
  47 /**
  48  * This class implements an Apex event consumer that receives events using JMS.
  49  *
  50  * @author Liam Fallon (liam.fallon@ericsson.com)
  51  */
  52 public class ApexJMSConsumer implements MessageListener, ApexEventConsumer, Runnable {
  53     // Get a reference to the logger
  54     private static final Logger LOGGER = LoggerFactory.getLogger(ApexJMSConsumer.class);
  55
  56     // The Apex and JMS parameters read from the parameter service
  57     private JMSCarrierTechnologyParameters jmsConsumerProperties;
  58
  59     // The event receiver that will receive events from this consumer
  60     private ApexEventReceiver eventReceiver;
  61
  62     // The consumer thread and stopping flag
  63     private Thread consumerThread;
  64     private boolean stopOrderedFlag = false;
  65
  66     // The connection to the JMS server
  67     private Connection connection;
  68
  69     // The topic on which we receive events from JMS
  70     private Topic jmsIncomingTopic;
  71
  72     // The name for this consumer
  73     private String name = null;
  74
  75     // The peer references for this event handler
  76     private Map<EventHandlerPeeredMode, PeeredReference> peerReferenceMap = new EnumMap<>(EventHandlerPeeredMode.class);
  77
  78     @Override
  79     public void init(final String consumerName, final EventHandlerParameters consumerParameters,
  80             final ApexEventReceiver incomingEventReceiver) throws ApexEventException {
  81         this.eventReceiver = incomingEventReceiver;
  82
  83         this.name = consumerName;
  84
  85         // Check and get the JMS Properties
  86         if (!(consumerParameters.getCarrierTechnologyParameters() instanceof JMSCarrierTechnologyParameters)) {
  87             final String errorMessage = "specified consumer properties of type \""
  88                     + consumerParameters.getCarrierTechnologyParameters().getClass().getCanonicalName()
  89                     + "\" are not applicable to a JMS consumer";
  90             LOGGER.warn(errorMessage);
  91             throw new ApexEventException(errorMessage);
  92         }
  93         jmsConsumerProperties = (JMSCarrierTechnologyParameters) consumerParameters.getCarrierTechnologyParameters();
  94
  95         // Look up the JMS connection factory
  96         InitialContext jmsContext = null;
  97         ConnectionFactory connectionFactory = null;
  98         try {
  99             jmsContext = new InitialContext(jmsConsumerProperties.getJMSConsumerProperties());
 100             connectionFactory = (ConnectionFactory) jmsContext.lookup(jmsConsumerProperties.getConnectionFactory());
 101
 102             // Check if we actually got a connection factory
 103             if (connectionFactory == null) {
 104                 throw new NullPointerException(
 105                         "JMS context lookup of \"" + jmsConsumerProperties.getConnectionFactory() + "\" returned null");
 106             }
 107         } catch (final Exception e) {
 108             final String errorMessage = "lookup of JMS connection factory  \""
 109                     + jmsConsumerProperties.getConnectionFactory() + "\" failed for JMS consumer properties \""
 110                     + jmsConsumerProperties.getJMSConsumerProperties() + "\"";
 111             LOGGER.warn(errorMessage, e);
 112             throw new ApexEventException(errorMessage, e);
 113         }
 114
 115         // Lookup the topic on which we will receive events
 116         try {
 117             jmsIncomingTopic = (Topic) jmsContext.lookup(jmsConsumerProperties.getConsumerTopic());
 118
 119             // Check if we actually got a topic
 120             if (jmsIncomingTopic == null) {
 121                 throw new NullPointerException(
 122                         "JMS context lookup of \"" + jmsConsumerProperties.getConsumerTopic() + "\" returned null");
 123             }
 124         } catch (final Exception e) {
 125             final String errorMessage = "lookup of JMS topic  \"" + jmsConsumerProperties.getConsumerTopic()
 126                     + "\" failed for JMS consumer properties \"" + jmsConsumerProperties.getJMSConsumerProperties()
 127                     + "\"";
 128             LOGGER.warn(errorMessage, e);
 129             throw new ApexEventException(errorMessage, e);
 130         }
 131
 132         // Create and start a connection to the JMS server
 133         try {
 134             connection = connectionFactory.createConnection(jmsConsumerProperties.getSecurityPrincipal(),
 135                     jmsConsumerProperties.getSecurityCredentials());
 136             connection.start();
 137         } catch (final Exception e) {
 138             final String errorMessage = "connection to the JMS server failed for JMS properties \""
 139                     + jmsConsumerProperties.getJMSConsumerProperties() + "\"";
 140             LOGGER.warn(errorMessage, e);
 141             throw new ApexEventException(errorMessage, e);
 142         }
 143     }
 144
 145     /*
 146      * (non-Javadoc)
 147      *
 148      * @see org.onap.policy.apex.service.engine.event.ApexEventConsumer#start()
 149      */
 150     @Override
 151     public void start() {
 152         // Configure and start the event reception thread
 153         final String threadName = this.getClass().getName() + ":" + this.name;
 154         consumerThread = new ApplicationThreadFactory(threadName).newThread(this);
 155         consumerThread.setDaemon(true);
 156         consumerThread.start();
 157     }
 158
 159     /*
 160      * (non-Javadoc)
 161      *
 162      * @see org.onap.policy.apex.service.engine.event.ApexEventConsumer#getName()
 163      */
 164     @Override
 165     public String getName() {
 166         return name;
 167     }
 168
 169     /*
 170      * (non-Javadoc)
 171      *
 172      * @see org.onap.policy.apex.service.engine.event.ApexEventConsumer#getPeeredReference(org.onap.policy.apex.service.
 173      * parameters. eventhandler.EventHandlerPeeredMode)
 174      */
 175     @Override
 176     public PeeredReference getPeeredReference(final EventHandlerPeeredMode peeredMode) {
 177         return peerReferenceMap.get(peeredMode);
 178     }
 179
 180     /*
 181      * (non-Javadoc)
 182      *
 183      * @see org.onap.policy.apex.service.engine.event.ApexEventConsumer#setPeeredReference(org.onap.policy.apex.service.
 184      * parameters. eventhandler.EventHandlerPeeredMode, org.onap.policy.apex.service.engine.event.PeeredReference)
 185      */
 186     @Override
 187     public void setPeeredReference(final EventHandlerPeeredMode peeredMode, final PeeredReference peeredReference) {
 188         peerReferenceMap.put(peeredMode, peeredReference);
 189     }
 190
 191     /*
 192      * (non-Javadoc)
 193      *
 194      * @see java.lang.Runnable#run()
 195      */
 196     @Override
 197     public void run() {
 198         // JMS session and message consumer for receiving messages
 199         Session jmsSession = null;
 200         MessageConsumer messageConsumer = null;
 201
 202         // Create a session to the JMS server
 203         try {
 204             jmsSession = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
 205         } catch (final Exception e) {
 206             final String errorMessage = "failed to create a JMS session towards the JMS server for receiving messages";
 207             LOGGER.warn(errorMessage, e);
 208             throw new ApexEventRuntimeException(errorMessage, e);
 209         }
 210
 211         // Create a message consumer for reception of messages and set this class as a message listener
 212         try {
 213             messageConsumer = jmsSession.createConsumer(jmsIncomingTopic);
 214             messageConsumer.setMessageListener(this);
 215         } catch (final Exception e) {
 216             final String errorMessage = "failed to create a JMS message consumer for receiving messages";
 217             LOGGER.warn(errorMessage, e);
 218             throw new ApexEventRuntimeException(errorMessage, e);
 219         }
 220
 221         // Everything is now set up
 222         if (LOGGER.isDebugEnabled()) {
 223             LOGGER.debug("event receiver " + this.getClass().getName() + ":" + this.name + " subscribed to JMS topic: "
 224                     + jmsConsumerProperties.getConsumerTopic());
 225         }
 226
 227         // The endless loop that receives events over JMS
 228         while (consumerThread.isAlive() && !stopOrderedFlag) {
 229             ThreadUtilities.sleep(jmsConsumerProperties.getConsumerWaitTime());
 230         }
 231
 232         // Close the message consumer
 233         try {
 234             messageConsumer.close();
 235         } catch (final Exception e) {
 236             final String errorMessage = "failed to close the JMS message consumer for receiving messages";
 237             LOGGER.warn(errorMessage, e);
 238         }
 239
 240         // Close the session
 241         try {
 242             jmsSession.close();
 243         } catch (final Exception e) {
 244             final String errorMessage = "failed to close the JMS session for receiving messages";
 245             LOGGER.warn(errorMessage, e);
 246         }
 247     }
 248
 249     /*
 250      * (non-Javadoc)
 251      *
 252      * @see javax.jms.MessageListener#onMessage(javax.jms.Message)
 253      */
 254     @Override
 255     public void onMessage(final Message jmsMessage) {
 256         try {
 257             if (LOGGER.isTraceEnabled()) {
 258                 LOGGER.trace("event received for {} for forwarding to Apex engine : {} {}",
 259                         this.getClass().getName() + ":" + this.name, jmsMessage.getJMSMessageID(),
 260                         jmsMessage.getJMSType());
 261             }
 262
 263             eventReceiver.receiveEvent(jmsMessage);
 264         } catch (final Exception e) {
 265             final String errorMessage = "failed to receive message from JMS";
 266             LOGGER.warn(errorMessage, e);
 267             throw new ApexEventRuntimeException(errorMessage, e);
 268         }
 269     }
 270
 271     /*
 272      * (non-Javadoc)
 273      *
 274      * @see org.onap.policy.apex.apps.uservice.producer.ApexEventProducer#stop()
 275      */
 276     @Override
 277     public void stop() {
 278         stopOrderedFlag = true;
 279
 280         while (consumerThread.isAlive()) {
 281             ThreadUtilities.sleep(jmsConsumerProperties.getConsumerWaitTime());
 282         }
 283
 284         // Close the connection to the JMS server
 285         try {
 286             if (connection != null) {
 287                 connection.close();
 288             }
 289         } catch (final Exception e) {
 290             final String errorMessage = "close of connection to the JMS server failed";
 291             LOGGER.warn(errorMessage, e);
 292         }
 293     }
 294
 295 }