gerrit.onap Code Review - cps.git/blob

   1 /*
   2  * ============LICENSE_START========================================================
   3  *  Copyright (C) 2022-2024 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  *
  17  *  SPDX-License-Identifier: Apache-2.0
  18  *  ============LICENSE_END=========================================================
  19  */
  20
  21 package org.onap.cps.ncmp.impl.inventory.sync;
  22
  23 import com.hazelcast.collection.ISet;
  24 import com.hazelcast.config.MapConfig;
  25 import com.hazelcast.config.QueueConfig;
  26 import com.hazelcast.config.SetConfig;
  27 import com.hazelcast.map.IMap;
  28 import java.util.concurrent.BlockingQueue;
  29 import java.util.concurrent.locks.Lock;
  30 import lombok.extern.slf4j.Slf4j;
  31 import org.onap.cps.ncmp.impl.cache.HazelcastCacheConfig;
  32 import org.springframework.context.annotation.Bean;
  33 import org.springframework.context.annotation.Configuration;
  34
  35 /**
  36  * Core infrastructure of the hazelcast distributed caches for Module Sync and Data Sync use cases.
  37  */
  38 @Slf4j
  39 @Configuration
  40 public class SynchronizationCacheConfig extends HazelcastCacheConfig {
  41
  42     public static final int MODULE_SYNC_STARTED_TTL_SECS = 600;
  43     public static final int DATA_SYNC_SEMAPHORE_TTL_SECS = 1800;
  44
  45     private static final QueueConfig commonQueueConfig = createQueueConfig("defaultQueueConfig");
  46     private static final MapConfig moduleSyncStartedConfig = createMapConfig("moduleSyncStartedConfig");
  47     private static final MapConfig dataSyncSemaphoresConfig = createMapConfig("dataSyncSemaphoresConfig");
  48     private static final SetConfig moduleSetTagsBeingProcessedConfig
  49         = createSetConfig("moduleSetTagsBeingProcessedConfig");
  50     private static final String LOCK_NAME_FOR_WORK_QUEUE = "workQueueLock";
  51
  52     /**
  53      * Module Sync Distributed Queue Instance.
  54      *
  55      * @return queue of cm handle ids that need module sync
  56      */
  57     @Bean
  58     public BlockingQueue<String> moduleSyncWorkQueue() {
  59         return getOrCreateHazelcastInstance(commonQueueConfig).getQueue("moduleSyncWorkQueue");
  60     }
  61
  62     /**
  63      * Module Sync started (and maybe finished) on cm handles (ids).
  64      *
  65      * @return Map of cm handles (ids) and objects (not used really) for which module sync has started or been completed
  66      */
  67     @Bean
  68     public IMap<String, Object> moduleSyncStartedOnCmHandles() {
  69         return getOrCreateHazelcastInstance(moduleSyncStartedConfig).getMap("moduleSyncStartedOnCmHandles");
  70     }
  71
  72     /**
  73      * Data Sync Distributed Map Instance.
  74      *
  75      * @return configured map of data sync semaphores
  76      */
  77     @Bean
  78     public IMap<String, Boolean> dataSyncSemaphores() {
  79         return getOrCreateHazelcastInstance(dataSyncSemaphoresConfig).getMap("dataSyncSemaphores");
  80     }
  81
  82     /**
  83      * Collection of (new) module set tags being processed.
  84      * To prevent processing on multiple threads of same tag
  85      *
  86      * @return set of module set tags being processed
  87      */
  88     @Bean
  89     public ISet<String> moduleSetTagsBeingProcessed() {
  90         return getOrCreateHazelcastInstance(moduleSetTagsBeingProcessedConfig).getSet("moduleSetTagsBeingProcessed");
  91     }
  92
  93     /**
  94      * Retrieves a distributed lock used to control access to the work queue for module synchronization.
  95      * This lock ensures that the population and modification of the work queue are thread-safe and
  96      * protected from concurrent access across different nodes in the distributed system.
  97      * The lock guarantees that only one instance of the application can populate or modify the
  98      * module sync work queue at a time, preventing race conditions and potential data inconsistencies.
  99      * The lock is obtained using the Hazelcast CP Subsystem's {@link Lock}, which provides
 100      * strong consistency guarantees for distributed operations.
 101      *
 102      * @return a {@link Lock} instance used for synchronizing access to the work queue.
 103      */
 104     @Bean
 105     public Lock workQueueLock() {
 106         // TODO Method below does not use commonQueueConfig for creating lock (Refactor later)
 107         return getOrCreateHazelcastInstance(commonQueueConfig).getCPSubsystem().getLock(LOCK_NAME_FOR_WORK_QUEUE);
 108     }
 109 }