appc-adapters/appc-rest-adapter/appc-rest-adapter-bundle/src/main/java/org/openecomp/appc/adapter/rest/RestActivator.java

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