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

   1 /*-
   2  * ============LICENSE_START=======================================================
   3  *  Copyright (C) 2016-2018 Ericsson. All rights reserved.
   4  *  Modifications Copyright (C) 2019-2021 Nordix Foundation.
   5  * ================================================================================
   6  * Licensed under the Apache License, Version 2.0 (the "License");
   7  * you may not use this file except in compliance with the License.
   8  * You may obtain a copy of the License at
   9  *
  10  *      http://www.apache.org/licenses/LICENSE-2.0
  11  *
  12  * Unless required by applicable law or agreed to in writing, software
  13  * distributed under the License is distributed on an "AS IS" BASIS,
  14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15  * See the License for the specific language governing permissions and
  16  * limitations under the License.
  17  *
  18  * SPDX-License-Identifier: Apache-2.0
  19  * ============LICENSE_END=========================================================
  20  */
  21
  22 package org.onap.policy.apex.plugins.event.carrier.jms;
  23
  24 import java.util.Properties;
  25 import javax.jms.Connection;
  26 import javax.jms.ConnectionFactory;
  27 import javax.jms.Message;
  28 import javax.jms.MessageConsumer;
  29 import javax.jms.MessageListener;
  30 import javax.jms.Session;
  31 import javax.jms.Topic;
  32 import javax.naming.InitialContext;
  33 import javax.naming.NamingException;
  34 import org.onap.policy.apex.core.infrastructure.threading.ThreadUtilities;
  35 import org.onap.policy.apex.service.engine.event.ApexEventException;
  36 import org.onap.policy.apex.service.engine.event.ApexEventReceiver;
  37 import org.onap.policy.apex.service.engine.event.ApexEventRuntimeException;
  38 import org.onap.policy.apex.service.engine.event.ApexPluginsEventConsumer;
  39 import org.onap.policy.apex.service.parameters.eventhandler.EventHandlerParameters;
  40 import org.slf4j.Logger;
  41 import org.slf4j.LoggerFactory;
  42
  43 /**
  44  * This class implements an Apex event consumer that receives events using JMS.
  45  *
  46  * @author Liam Fallon (liam.fallon@ericsson.com)
  47  */
  48 public class ApexJmsConsumer extends ApexPluginsEventConsumer implements MessageListener {
  49     // Get a reference to the logger
  50     private static final Logger LOGGER = LoggerFactory.getLogger(ApexJmsConsumer.class);
  51
  52     // The Apex and JMS parameters read from the parameter service
  53     private JmsCarrierTechnologyParameters jmsConsumerProperties;
  54
  55     // The event receiver that will receive events from this consumer
  56     private ApexEventReceiver eventReceiver;
  57
  58     // The connection to the JMS server
  59     private Connection connection;
  60
  61     // The topic on which we receive events from JMS
  62     private Topic jmsIncomingTopic;
  63
  64     @Override
  65     public void init(final String consumerName, final EventHandlerParameters consumerParameters,
  66             final ApexEventReceiver incomingEventReceiver) throws ApexEventException {
  67         this.eventReceiver = incomingEventReceiver;
  68
  69         this.name = consumerName;
  70
  71         // Check and get the JMS Properties
  72         if (!(consumerParameters.getCarrierTechnologyParameters() instanceof JmsCarrierTechnologyParameters)) {
  73             final String errorMessage = "specified consumer properties of type \""
  74                     + consumerParameters.getCarrierTechnologyParameters().getClass().getName()
  75                     + "\" are not applicable to a JMS consumer";
  76             throw new ApexEventException(errorMessage);
  77         }
  78         jmsConsumerProperties = (JmsCarrierTechnologyParameters) consumerParameters.getCarrierTechnologyParameters();
  79
  80         // Look up the JMS connection factory
  81         InitialContext jmsContext;
  82         ConnectionFactory connectionFactory;
  83         try {
  84             jmsContext = getInitialContext();
  85             connectionFactory = (ConnectionFactory) jmsContext.lookup(jmsConsumerProperties.getConnectionFactory());
  86
  87             // Check if we actually got a connection factory
  88             if (connectionFactory == null) {
  89                 throw new IllegalArgumentException(
  90                         "JMS context lookup of \"" + jmsConsumerProperties.getConnectionFactory() + "\" returned null");
  91             }
  92         } catch (final Exception e) {
  93             final String errorMessage = "lookup of JMS connection factory  \""
  94                     + jmsConsumerProperties.getConnectionFactory() + "\" failed for JMS consumer properties \""
  95                     + jmsConsumerProperties.getJmsConsumerProperties() + "\"";
  96             throw new ApexEventException(errorMessage, e);
  97         }
  98
  99         // Lookup the topic on which we will receive events
 100         try {
 101             jmsIncomingTopic = (Topic) jmsContext.lookup(jmsConsumerProperties.getConsumerTopic());
 102
 103             // Check if we actually got a topic
 104             if (jmsIncomingTopic == null) {
 105                 throw new IllegalArgumentException(
 106                         "JMS context lookup of \"" + jmsConsumerProperties.getConsumerTopic() + "\" returned null");
 107             }
 108         } catch (final Exception e) {
 109             final String errorMessage = "lookup of JMS topic  \"" + jmsConsumerProperties.getConsumerTopic()
 110                     + "\" failed for JMS consumer properties \"" + jmsConsumerProperties.getJmsConsumerProperties()
 111                     + "\"";
 112             throw new ApexEventException(errorMessage, e);
 113         }
 114
 115         // Create and start a connection to the JMS server
 116         try {
 117             connection = connectionFactory.createConnection(jmsConsumerProperties.getSecurityPrincipal(),
 118                     jmsConsumerProperties.getSecurityCredentials());
 119             connection.start();
 120         } catch (final Exception e) {
 121             final String errorMessage = "connection to the JMS server failed for JMS properties \""
 122                     + jmsConsumerProperties.getJmsConsumerProperties() + "\"";
 123             throw new ApexEventException(errorMessage, e);
 124         }
 125     }
 126
 127     /**
 128      * Construct InitialContext. This function should not be run directly.
 129      * Package-private access is set for testing purposes only.
 130      *
 131      * @return InitialContext
 132      * @throws NamingException if a naming exception is encountered
 133      */
 134     InitialContext getInitialContext() throws NamingException {
 135         return new InitialContext(jmsConsumerProperties.getJmsConsumerProperties());
 136     }
 137
 138     /**
 139      * {@inheritDoc}.
 140      */
 141     @Override
 142     public void run() {
 143         // JMS session and message consumer for receiving messages
 144         try (final Session jmsSession = connection.createSession(false, Session.AUTO_ACKNOWLEDGE)) {
 145             // Create a message consumer for reception of messages and set this class as a message listener
 146             createMessageConsumer(jmsSession);
 147         } catch (final Exception exc) {
 148             final String errorMessage = "failed to create a JMS session towards the JMS server for receiving messages";
 149             throw new ApexEventRuntimeException(errorMessage, exc);
 150         }
 151         // Everything is now set up
 152         if (LOGGER.isDebugEnabled()) {
 153             LOGGER.debug("event receiver {}:{} subscribed to JMS topic: {}", this.getClass().getName(),
 154                     this.name, jmsConsumerProperties.getConsumerTopic());
 155         }
 156     }
 157
 158     /**
 159      * The helper function to create a message consumer from a given JMS session.
 160      *
 161      * @param jmsSession a JMS session
 162      */
 163     private void createMessageConsumer(final Session jmsSession) {
 164         try (final MessageConsumer messageConsumer = jmsSession.createConsumer(jmsIncomingTopic)) {
 165             messageConsumer.setMessageListener(this);
 166
 167             // The endless loop that receives events over JMS
 168             while (consumerThread.isAlive() && !stopOrderedFlag) {
 169                 ThreadUtilities.sleep(jmsConsumerProperties.getConsumerWaitTime());
 170             }
 171         } catch (final Exception exc) {
 172             final String errorMessage = "failed to create a JMS message consumer for receiving messages";
 173             throw new ApexEventRuntimeException(errorMessage, exc);
 174         }
 175     }
 176
 177     /**
 178      * {@inheritDoc}.
 179      */
 180     @Override
 181     public void onMessage(final Message jmsMessage) {
 182         try {
 183             if (LOGGER.isTraceEnabled()) {
 184                 LOGGER.trace("event received for {} for forwarding to Apex engine : {} {}",
 185                         this.getClass().getName() + ":" + this.name, jmsMessage.getJMSMessageID(),
 186                         jmsMessage.getJMSType());
 187             }
 188
 189             eventReceiver.receiveEvent(new Properties(), jmsMessage);
 190         } catch (final Exception e) {
 191             final String errorMessage = "failed to receive message from JMS";
 192             throw new ApexEventRuntimeException(errorMessage, e);
 193         }
 194     }
 195
 196     /**
 197      * {@inheritDoc}.
 198      */
 199     @Override
 200     public void stop() {
 201         stopOrderedFlag = true;
 202
 203         while (consumerThread.isAlive()) {
 204             ThreadUtilities.sleep(jmsConsumerProperties.getConsumerWaitTime());
 205         }
 206
 207         // Close the connection to the JMS server
 208         try {
 209             if (connection != null) {
 210                 connection.close();
 211             }
 212         } catch (final Exception e) {
 213             final String errorMessage = "close of connection to the JMS server failed";
 214             LOGGER.warn(errorMessage, e);
 215         }
 216     }
 217
 218 }