/** * Copyright (c) 2010, Sebastian Sdorra * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, * this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright notice, * this list of conditions and the following disclaimer in the documentation * and/or other materials provided with the distribution. * 3. Neither the name of SCM-Manager; nor the names of its * contributors may be used to endorse or promote products derived from this * software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * http://bitbucket.org/sdorra/scm-manager * */ package sonia.scm.plugin; //~--- non-JDK imports -------------------------------------------------------- import com.google.inject.Binder; import com.google.inject.Singleton; import com.google.inject.binder.AnnotatedBindingBuilder; import com.google.inject.binder.ScopedBindingBuilder; import com.google.inject.multibindings.Multibinder; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import sonia.scm.EagerSingleton; import sonia.scm.util.Util; /** * * @author Sebastian Sdorra */ @SuppressWarnings("unchecked") public final class ExtensionBinder { /** Field description */ private static final String TYPE_LOOSE_EXT = "loose extension"; /** Field description */ private static final String TYPE_REST_RESOURCE = "rest resource"; /** * the logger for ExtensionBinder */ private static final Logger logger = LoggerFactory.getLogger(ExtensionBinder.class); //~--- constructors --------------------------------------------------------- /** * Constructs ... * * * @param binder */ public ExtensionBinder(Binder binder) { this.binder = binder; } //~--- methods -------------------------------------------------------------- /** * Method description * * * @param collector */ public void bind(ExtensionCollector collector) { logger.info("bind extensions to extension points"); for (ExtensionPointElement epe : collector.getExtensionPointElements()) { bindExtensionPoint(collector, epe); } logger.info("bind loose extensions"); bindLooseExtensions(collector.getLooseExtensions()); logger.info("bind rest providers"); bindRestProviders(collector.getRestProviders()); logger.info("bind rest resources"); bindRestResource(collector.getRestResources()); } /** * Method description * * * @param collector * @param epe */ private void bindExtensionPoint(ExtensionCollector collector, ExtensionPointElement epe) { if (epe.isAutoBind()) { if (epe.isMultiple()) { bindMultiExtensionPoint(epe, collector.byExtensionPoint(epe)); } else { Class extension = collector.oneByExtensionPoint(epe); if (extension != null) { bindSingleInstance(epe, extension); } else { logger.warn("could not find extension for extension point {}", epe.getClazz()); } } } else { logger.debug("bind type of {} is manual", epe.getClazz()); } } /** * Method description * * * @param extensions */ private void bindLooseExtensions(Iterable extensions) { for (Class extension : extensions) { singleBind(TYPE_LOOSE_EXT, extension); } } /** * Method description * * * * @param found * * @param extensionPoint * * @param boundClasses * @param extensionPointClass * @param extensions */ private void bindMultiExtensionPoint(ExtensionPointElement extensionPoint, Iterable extensions) { Class extensionPointClass = extensionPoint.getClazz(); if (logger.isInfoEnabled()) { logger.info("create multibinder for {}", extensionPointClass.getName()); } Multibinder multibinder = Multibinder.newSetBinder(binder, extensionPointClass); for (Class extensionClass : extensions) { boolean eagerSingleton = isEagerSingleton(extensionClass); if (logger.isInfoEnabled()) { String as = Util.EMPTY_STRING; if (eagerSingleton) { as = " as eager singleton"; } logger.info("bind {} to multibinder of {}{}", extensionClass.getName(), extensionPointClass.getName(), as); } ScopedBindingBuilder sbb = multibinder.addBinding().to(extensionClass); if (eagerSingleton) { sbb.asEagerSingleton(); } } } /** * Method description * * * @param restProviders */ private void bindRestProviders(Iterable restProviders) { for (Class restProvider : restProviders) { logger.info("bind rest provider {}", restProvider); binder.bind(restProvider).in(Singleton.class); } } /** * Method description * * * @param restResources */ private void bindRestResource(Iterable restResources) { for (Class restResource : restResources) { singleBind(TYPE_REST_RESOURCE, restResource); } } /** * Method description * * * @param extensionPointClass * * @param extensionPoint * @param extensionClass */ private void bindSingleInstance(ExtensionPointElement extensionPoint, Class extensionClass) { Class extensionPointClass = extensionPoint.getClazz(); boolean eagerSingleton = isEagerSingleton(extensionClass); if (logger.isInfoEnabled()) { String as = Util.EMPTY_STRING; if (eagerSingleton) { as = " as eager singleton"; } logger.info("bind {} to {}{}", extensionClass.getName(), extensionPointClass.getName(), as); } ScopedBindingBuilder sbb = binder.bind(extensionPointClass).to(extensionClass); if (eagerSingleton) { sbb.asEagerSingleton(); } } /** * Method description * * * @param type * @param extension */ private void singleBind(String type, Class extension) { StringBuilder log = new StringBuilder(); log.append("bind ").append(type).append(" ").append(extension); AnnotatedBindingBuilder abb = binder.bind(extension); if (isEagerSingleton(extension)) { log.append(" as eager singleton"); abb.asEagerSingleton(); } logger.info(log.toString()); } //~--- get methods ---------------------------------------------------------- /** * Method description * * * @param extensionClass * * @return */ private boolean isEagerSingleton(Class extensionClass) { return extensionClass.isAnnotationPresent(EagerSingleton.class); } //~--- fields --------------------------------------------------------------- /** Field description */ private final Binder binder; }