appc-adapters/appc-chef-adapter/appc-chef-adapter-bundle/src/main/java/org/onap/appc/adapter/chef/ChefActivator.java

   1 /*-
   2  * ============LICENSE_START=======================================================
   3  * ONAP : APPC
   4  * ================================================================================
   5  * Copyright (C) 2017 AT&T Intellectual Property. All rights reserved.
   6  * ================================================================================
   7  * Copyright (C) 2017 Amdocs
   8  * =============================================================================
   9  * Licensed under the Apache License, Version 2.0 (the "License");
  10  * you may not use this file except in compliance with the License.
  11  * You may obtain a copy of the License at
  12  *
  13  *      http://www.apache.org/licenses/LICENSE-2.0
  14  *
  15  * Unless required by applicable law or agreed to in writing, software
  16  * distributed under the License is distributed on an "AS IS" BASIS,
  17  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18  * See the License for the specific language governing permissions and
  19  * limitations under the License.
  20  *
  21  * ECOMP is a trademark and service mark of AT&T Intellectual Property.
  22  * ============LICENSE_END=========================================================
  23  */
  24
  25 package org.onap.appc.adapter.chef;
  26
  27 import org.onap.appc.Constants;
  28 import org.onap.appc.adapter.chef.impl.ChefAdapterImpl;
  29 import org.onap.appc.configuration.Configuration;
  30 import org.onap.appc.configuration.ConfigurationFactory;
  31 import org.onap.appc.i18n.Msg;
  32 import com.att.eelf.configuration.EELFLogger;
  33 import com.att.eelf.configuration.EELFManager;
  34 import org.osgi.framework.BundleActivator;
  35 import org.osgi.framework.BundleContext;
  36 import org.osgi.framework.ServiceRegistration;
  37
  38 /**
  39  * This activator is used to initialize and terminate the connection pool to one or more providers.
  40  * <p>
  41  * The CDP abstraction layer supports multiple types of providers, with each provider supporting multiple tenants. The
  42  * "connection" to a specific tenant on a specific provider is represented by a "context" object. These context objects
  43  * are authenticated to a specific tenant on the provider, but can be reused from one request to another. Contexts are
  44  * slow to set up and are resource intensive, so they are cached. However, the contexts for a specific tenant on a
  45  * specific provider must be cached separately.
  46  * </p>
  47  * <p>
  48  * Activation of the bundle creates an empty cache which is organized first by provider type, then by tenant name, with
  49  * the contents being an empty pool of contexts for that provider/tenant combination. The pool is created on first use,
  50  * and retained for as long as the bundle is active.
  51  * </p>
  52  * <p>
  53  * When the bundle is deactivated, the cache is torn down with all contexts being closed.
  54  * </p>
  55  */
  56 public class ChefActivator implements BundleActivator {
  57
  58     /**
  59      * The bundle registration
  60      */
  61     private ServiceRegistration registration = null;
  62
  63     /**
  64      * The reference to the actual implementation object that implements the services
  65      */
  66     private ChefAdapter adapter;
  67
  68     /**
  69      * The logger to be used
  70      */
  71     private final EELFLogger logger = EELFManager.getInstance().getLogger(ChefActivator.class);
  72
  73     /**
  74      * The configuration object used to configure this bundle
  75      */
  76     private Configuration configuration;
  77
  78     /**
  79      * Called when this bundle is started so the Framework can perform the bundle-specific activities necessary to start
  80      * this bundle. This method can be used to register services or to allocate any resources that this bundle needs.
  81      * <p>
  82      * This method must complete and return to its caller in a timely manner.
  83      * </p>
  84      *
  85      * @param context
  86      *            The execution context of the bundle being started.
  87      * @throws java.lang.Exception
  88      *             If this method throws an exception, this bundle is marked as stopped and the Framework will remove
  89      *             this bundle's listeners, unregister all services registered by this bundle, and release all services
  90      *             used by this bundle.
  91      * @see org.osgi.framework.BundleActivator#start(org.osgi.framework.BundleContext)
  92      */
  93     @Override
  94     public void start(BundleContext context) throws Exception {
  95         logger.info("Starting bundle " + getName());
  96         configuration = ConfigurationFactory.getConfiguration();
  97         String appName = configuration.getProperty(Constants.PROPERTY_APPLICATION_NAME);
  98         logger.info(Msg.COMPONENT_INITIALIZING, appName, "chef adapter");
  99         adapter = new ChefAdapterImpl();
 100         if (registration == null) {
 101             logger.info(Msg.REGISTERING_SERVICE, appName, adapter.getAdapterName(),
 102                 ChefAdapter.class.getSimpleName());
 103             registration = context.registerService(ChefAdapter.class, adapter, null);
 104         }
 105
 106         logger.info(Msg.COMPONENT_INITIALIZED, appName, "CHEF adapter");
 107     }
 108
 109     /**
 110      * Called when this bundle is stopped so the Framework can perform the bundle-specific activities necessary to stop
 111      * the bundle. In general, this method should undo the work that the BundleActivator.start method started. There
 112      * should be no active threads that were started by this bundle when this bundle returns. A stopped bundle must not
 113      * call any Framework objects.
 114      * <p>
 115      * This method must complete and return to its caller in a timely manner.
 116      * </p>
 117      *
 118      * @param context
 119      *            The execution context of the bundle being stopped.
 120      * @throws java.lang.Exception
 121      *             If this method throws an exception, the bundle is still marked as stopped, and the Framework will
 122      *             remove the bundle's listeners, unregister all services registered by the bundle, and release all
 123      *             services used by the bundle. *
 124      * @see org.osgi.framework.BundleActivator#stop(org.osgi.framework.BundleContext)
 125      */
 126     @Override
 127     public void stop(BundleContext context) throws Exception {
 128         logger.info("Stopping bundle " + getName());
 129
 130         if (registration != null) {
 131             String appName = configuration.getProperty(Constants.PROPERTY_APPLICATION_NAME);
 132             logger.info(Msg.COMPONENT_TERMINATING, appName, "CHEF adapter");
 133             logger.info(Msg.UNREGISTERING_SERVICE, appName, adapter.getAdapterName());
 134             registration.unregister();
 135             registration = null;
 136             logger.info(Msg.COMPONENT_TERMINATED, appName, "CHEF adapter");
 137         }
 138     }
 139
 140     public String getName() {
 141         return "APPC IaaS adapter";
 142     }
 143
 144 }