gerrit.onap Code Review - policy/common.git/blob

   1 /*
   2  * ============LICENSE_START=======================================================
   3  * Copyright (C) 2022 Nordix Foundation.
   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  * ============LICENSE_END=========================================================
  17  */
  18
  19 package org.onap.policy.common.endpoints.event.comm.bus;
  20
  21 import com.google.re2j.Pattern;
  22 import java.util.ArrayList;
  23 import java.util.HashMap;
  24 import java.util.List;
  25 import java.util.Properties;
  26 import org.apache.commons.lang3.StringUtils;
  27 import org.onap.policy.common.endpoints.event.comm.bus.internal.BusTopicParams;
  28 import org.onap.policy.common.endpoints.event.comm.bus.internal.SingleThreadedKafkaTopicSource;
  29 import org.onap.policy.common.endpoints.properties.PolicyEndPointProperties;
  30 import org.onap.policy.common.endpoints.utils.KafkaPropertyUtils;
  31 import org.onap.policy.common.endpoints.utils.PropertyUtils;
  32 import org.slf4j.Logger;
  33 import org.slf4j.LoggerFactory;
  34
  35 /**
  36  * Factory of KAFKA Source Topics indexed by topic name.
  37  */
  38 class IndexedKafkaTopicSourceFactory implements KafkaTopicSourceFactory {
  39     private static final Pattern COMMA_SPACE_PAT = Pattern.compile("\\s*,\\s*");
  40     private static final String MISSING_TOPIC = "A topic must be provided";
  41
  42     /**
  43      * Logger.
  44      */
  45     private static Logger logger = LoggerFactory.getLogger(IndexedKafkaTopicSourceFactory.class);
  46
  47     /**
  48      * KAFKA Topic Name Index.
  49      */
  50     protected HashMap<String, KafkaTopicSource> kafkaTopicSources = new HashMap<>();
  51
  52     @Override
  53     public KafkaTopicSource build(BusTopicParams busTopicParams) {
  54         if (busTopicParams.getServers() == null || busTopicParams.getServers().isEmpty()) {
  55             throw new IllegalArgumentException("KAFKA Server(s) must be provided");
  56         }
  57
  58         if (busTopicParams.getTopic() == null || busTopicParams.getTopic().isEmpty()) {
  59             throw new IllegalArgumentException(MISSING_TOPIC);
  60         }
  61
  62         synchronized (this) {
  63             if (kafkaTopicSources.containsKey(busTopicParams.getTopic())) {
  64                 return kafkaTopicSources.get(busTopicParams.getTopic());
  65             }
  66
  67             var kafkaTopicSource = makeSource(busTopicParams);
  68
  69             kafkaTopicSources.put(busTopicParams.getTopic(), kafkaTopicSource);
  70
  71             return kafkaTopicSource;
  72         }
  73     }
  74
  75     @Override
  76     public List<KafkaTopicSource> build(Properties properties) {
  77
  78         String readTopics = properties.getProperty(PolicyEndPointProperties.PROPERTY_KAFKA_SOURCE_TOPICS);
  79         if (StringUtils.isBlank(readTopics)) {
  80             logger.info("{}: no topic for KAFKA Source", this);
  81             return new ArrayList<>();
  82         }
  83
  84         List<KafkaTopicSource> newKafkaTopicSources = new ArrayList<>();
  85         synchronized (this) {
  86             for (String topic : COMMA_SPACE_PAT.split(readTopics)) {
  87                 addTopic(newKafkaTopicSources, topic, properties);
  88             }
  89         }
  90         return newKafkaTopicSources;
  91     }
  92
  93     @Override
  94     public KafkaTopicSource build(List<String> servers, String topic) {
  95         return this.build(BusTopicParams.builder()
  96                 .servers(servers)
  97                 .topic(topic)
  98                 .managed(true)
  99                 .useHttps(false).build());
 100     }
 101
 102     private void addTopic(List<KafkaTopicSource> newKafkaTopicSources, String topic, Properties properties) {
 103         if (this.kafkaTopicSources.containsKey(topic)) {
 104             newKafkaTopicSources.add(this.kafkaTopicSources.get(topic));
 105             return;
 106         }
 107
 108         String topicPrefix = PolicyEndPointProperties.PROPERTY_KAFKA_SOURCE_TOPICS + "." + topic;
 109
 110         var props = new PropertyUtils(properties, topicPrefix,
 111             (name, value, ex) -> logger.warn("{}: {} {} is in invalid format for topic {} ", this, name, value, topic));
 112
 113         String servers = properties.getProperty(topicPrefix + PolicyEndPointProperties.PROPERTY_TOPIC_SERVERS_SUFFIX);
 114         if (StringUtils.isBlank(servers)) {
 115             logger.error("{}: no KAFKA servers configured for sink {}", this, topic);
 116             return;
 117         }
 118
 119         var kafkaTopicSource = this.build(KafkaPropertyUtils.makeBuilder(props, topic, servers)
 120                 .build());
 121
 122         newKafkaTopicSources.add(kafkaTopicSource);
 123     }
 124
 125     /**
 126      * Makes a new source.
 127      *
 128      * @param busTopicParams parameters to use to configure the source
 129      * @return a new source
 130      */
 131     protected KafkaTopicSource makeSource(BusTopicParams busTopicParams) {
 132         return new SingleThreadedKafkaTopicSource(busTopicParams);
 133     }
 134
 135     @Override
 136     public void destroy(String topic) {
 137
 138         if (topic == null || topic.isEmpty()) {
 139             throw new IllegalArgumentException(MISSING_TOPIC);
 140         }
 141
 142         KafkaTopicSource kafkaTopicSource;
 143
 144         synchronized (this) {
 145             if (!kafkaTopicSources.containsKey(topic)) {
 146                 return;
 147             }
 148
 149             kafkaTopicSource = kafkaTopicSources.remove(topic);
 150         }
 151
 152         kafkaTopicSource.shutdown();
 153     }
 154
 155     @Override
 156     public void destroy() {
 157         List<KafkaTopicSource> readers = this.inventory();
 158         for (KafkaTopicSource reader : readers) {
 159             reader.shutdown();
 160         }
 161
 162         synchronized (this) {
 163             this.kafkaTopicSources.clear();
 164         }
 165     }
 166
 167     @Override
 168     public KafkaTopicSource get(String topic) {
 169
 170         if (topic == null || topic.isEmpty()) {
 171             throw new IllegalArgumentException(MISSING_TOPIC);
 172         }
 173
 174         synchronized (this) {
 175             if (kafkaTopicSources.containsKey(topic)) {
 176                 return kafkaTopicSources.get(topic);
 177             } else {
 178                 throw new IllegalStateException("KafkaTopiceSource for " + topic + " not found");
 179             }
 180         }
 181     }
 182
 183     @Override
 184     public synchronized List<KafkaTopicSource> inventory() {
 185         return new ArrayList<>(this.kafkaTopicSources.values());
 186     }
 187
 188     @Override
 189     public String toString() {
 190         return "IndexedKafkaTopicSourceFactory " + kafkaTopicSources.keySet();
 191     }
 192 }