/*- * ============LICENSE_START======================================================= * policy-endpoints * ================================================================================ * Copyright (C) 2017 AT&T Intellectual Property. All rights reserved. * ================================================================================ * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ============LICENSE_END========================================================= */ package org.openecomp.policy.drools.event.comm.bus; import java.util.ArrayList; import java.util.Arrays; import java.util.HashMap; import java.util.List; import java.util.Properties; import org.openecomp.policy.drools.event.comm.bus.internal.SingleThreadedUebTopicSource; import org.openecomp.policy.common.logging.flexlogger.FlexLogger; import org.openecomp.policy.common.logging.flexlogger.Logger; import org.openecomp.policy.drools.properties.PolicyProperties; /** * UEB Topic Source Factory */ public interface UebTopicSourceFactory { /** * Creates an UEB Topic Source based on properties files * * @param properties Properties containing initialization values * * @return an UEB Topic Source * @throws IllegalArgumentException if invalid parameters are present */ public List build(Properties properties) throws IllegalArgumentException; /** * Instantiates a new UEB Topic Source * * @param servers list of servers * @param topic topic name * @param apiKey API Key * @param apiSecret API Secret * @param consumerGroup Consumer Group * @param consumerInstance Consumer Instance * @param fetchTimeout Read Fetch Timeout * @param fetchLimit Fetch Limit * @param managed is this source endpoint managed? * * @return an UEB Topic Source * @throws IllegalArgumentException if invalid parameters are present */ public UebTopicSource build(List servers, String topic, String apiKey, String apiSecret, String consumerGroup, String consumerInstance, int fetchTimeout, int fetchLimit, boolean managed) throws IllegalArgumentException; /** * Instantiates a new UEB Topic Source * * @param servers list of servers * @param topic topic name * @param apiKey API Key * @param apiSecret API Secret * * @return an UEB Topic Source * @throws IllegalArgumentException if invalid parameters are present */ public UebTopicSource build(List servers, String topic, String apiKey, String apiSecret) throws IllegalArgumentException; /** * Instantiates a new UEB Topic Source * * @param uebTopicSourceType Implementation type * @param servers list of servers * @param topic topic name * * @return an UEB Topic Source * @throws IllegalArgumentException if invalid parameters are present */ public UebTopicSource build(List servers, String topic) throws IllegalArgumentException; /** * Destroys an UEB Topic Source based on a topic * * @param topic topic name * @throws IllegalArgumentException if invalid parameters are present */ public void destroy(String topic); /** * Destroys all UEB Topic Sources */ public void destroy(); /** * gets an UEB Topic Source based on topic name * @param topic the topic name * @return an UEB Topic Source with topic name * @throws IllegalArgumentException if an invalid topic is provided * @throws IllegalStateException if the UEB Topic Source is * an incorrect state */ public UebTopicSource get(String topic) throws IllegalArgumentException, IllegalStateException; /** * Provides a snapshot of the UEB Topic Sources * @return a list of the UEB Topic Sources */ public List inventory(); } /* ------------- implementation ----------------- */ /** * Factory of UEB Source Topics indexed by topic name */ class IndexedUebTopicSourceFactory implements UebTopicSourceFactory { // get an instance of logger private static Logger logger = FlexLogger.getLogger(IndexedUebTopicSourceFactory.class); /** * UEB Topic Name Index */ protected HashMap uebTopicSources = new HashMap(); /** * {@inheritDoc} */ @Override public UebTopicSource build(List servers, String topic, String apiKey, String apiSecret, String consumerGroup, String consumerInstance, int fetchTimeout, int fetchLimit, boolean managed) throws IllegalArgumentException { if (topic == null || topic.isEmpty()) { throw new IllegalArgumentException("A topic must be provided"); } synchronized(this) { if (uebTopicSources.containsKey(topic)) { return uebTopicSources.get(topic); } UebTopicSource uebTopicSource = new SingleThreadedUebTopicSource(servers, topic, apiKey, apiSecret, consumerGroup, consumerInstance, fetchTimeout, fetchLimit); if (managed) uebTopicSources.put(topic, uebTopicSource); return uebTopicSource; } } /** * {@inheritDoc} */ @Override public List build(Properties properties) throws IllegalArgumentException { String readTopics = properties.getProperty(PolicyProperties.PROPERTY_UEB_SOURCE_TOPICS); if (readTopics == null || readTopics.isEmpty()) { logger.warn("No topic for UEB Source " + properties); return new ArrayList(); } List readTopicList = new ArrayList(Arrays.asList(readTopics.split("\\s*,\\s*"))); List uebTopicSources = new ArrayList(); synchronized(this) { for (String topic: readTopicList) { String servers = properties.getProperty(PolicyProperties.PROPERTY_UEB_SOURCE_TOPICS + "." + topic + PolicyProperties.PROPERTY_TOPIC_SERVERS_SUFFIX); if (servers == null || servers.isEmpty()) { logger.error("No UEB servers provided in " + properties); continue; } List serverList = new ArrayList(Arrays.asList(servers.split("\\s*,\\s*"))); String apiKey = properties.getProperty(PolicyProperties.PROPERTY_UEB_SOURCE_TOPICS + "." + topic + PolicyProperties.PROPERTY_TOPIC_API_KEY_SUFFIX); String apiSecret = properties.getProperty(PolicyProperties.PROPERTY_UEB_SOURCE_TOPICS + "." + topic + PolicyProperties.PROPERTY_TOPIC_API_SECRET_SUFFIX); String consumerGroup = properties.getProperty(PolicyProperties.PROPERTY_UEB_SOURCE_TOPICS + "." + topic + PolicyProperties.PROPERTY_TOPIC_SOURCE_CONSUMER_GROUP_SUFFIX); String consumerInstance = properties.getProperty(PolicyProperties.PROPERTY_UEB_SOURCE_TOPICS + "." + topic + PolicyProperties.PROPERTY_TOPIC_SOURCE_CONSUMER_INSTANCE_SUFFIX); String fetchTimeoutString = properties.getProperty(PolicyProperties.PROPERTY_UEB_SOURCE_TOPICS + "." + topic + PolicyProperties.PROPERTY_TOPIC_SOURCE_FETCH_TIMEOUT_SUFFIX); int fetchTimeout = UebTopicSource.DEFAULT_TIMEOUT_MS_FETCH; if (fetchTimeoutString != null && !fetchTimeoutString.isEmpty()) { try { fetchTimeout = Integer.parseInt(fetchTimeoutString); } catch (NumberFormatException nfe) { logger.warn("Fetch Timeout in invalid format for topic " + topic + ": " + fetchTimeoutString); } } String fetchLimitString = properties.getProperty(PolicyProperties.PROPERTY_UEB_SOURCE_TOPICS + "." + topic + PolicyProperties.PROPERTY_TOPIC_SOURCE_FETCH_TIMEOUT_SUFFIX); int fetchLimit = UebTopicSource.DEFAULT_LIMIT_FETCH; if (fetchLimitString != null && !fetchLimitString.isEmpty()) { try { fetchLimit = Integer.parseInt(fetchLimitString); } catch (NumberFormatException nfe) { logger.warn("Fetch Limit in invalid format for topic " + topic + ": " + fetchLimitString); } } String managedString = properties.getProperty(PolicyProperties.PROPERTY_UEB_SOURCE_TOPICS + "." + topic + PolicyProperties.PROPERTY_MANAGED_SUFFIX); boolean managed = true; if (managedString != null && !managedString.isEmpty()) { managed = Boolean.parseBoolean(managedString); } UebTopicSource uebTopicSource = this.build(serverList, topic, apiKey, apiSecret, consumerGroup, consumerInstance, fetchTimeout, fetchLimit, managed); uebTopicSources.add(uebTopicSource); } } return uebTopicSources; } /** * {@inheritDoc} */ @Override public UebTopicSource build(List servers, String topic, String apiKey, String apiSecret) { return this.build(servers, topic, apiKey, apiSecret, null, null, UebTopicSource.DEFAULT_TIMEOUT_MS_FETCH, UebTopicSource.DEFAULT_LIMIT_FETCH, true); } /** * {@inheritDoc} */ @Override public UebTopicSource build(List servers, String topic) { return this.build(servers, topic, null, null); } /** * {@inheritDoc} */ @Override public void destroy(String topic) throws IllegalArgumentException { if (topic == null || topic.isEmpty()) { throw new IllegalArgumentException("A topic must be provided"); } UebTopicSource uebTopicSource; synchronized(this) { if (!uebTopicSources.containsKey(topic)) { return; } uebTopicSource = uebTopicSources.remove(topic); } uebTopicSource.shutdown(); } /** * {@inheritDoc} */ @Override public UebTopicSource get(String topic) throws IllegalArgumentException, IllegalStateException { if (topic == null || topic.isEmpty()) { throw new IllegalArgumentException("A topic must be provided"); } synchronized(this) { if (uebTopicSources.containsKey(topic)) { return uebTopicSources.get(topic); } else { throw new IllegalStateException("UebTopiceSource for " + topic + " not found"); } } } @Override public synchronized List inventory() { List readers = new ArrayList(this.uebTopicSources.values()); return readers; } @Override public void destroy() { List readers = this.inventory(); for (UebTopicSource reader: readers) { reader.shutdown(); } synchronized(this) { this.uebTopicSources.clear(); } } }