/** * This file Copyright (c) 2011-2012 Magnolia International * Ltd. (http://www.magnolia-cms.com). All rights reserved. * * * This file is dual-licensed under both the Magnolia * Network Agreement and the GNU General Public License. * You may elect to use one or the other of these licenses. * * This file is distributed in the hope that it will be * useful, but AS-IS and WITHOUT ANY WARRANTY; without even the * implied warranty of MERCHANTABILITY or FITNESS FOR A * PARTICULAR PURPOSE, TITLE, or NONINFRINGEMENT. * Redistribution, except as permitted by whichever of the GPL * or MNA you select, is prohibited. * * 1. For the GPL license (GPL), you can redistribute and/or * modify this file under the terms of the GNU General * Public License, Version 3, as published by the Free Software * Foundation. You should have received a copy of the GNU * General Public License, Version 3 along with this program; * if not, write to the Free Software Foundation, Inc., 51 * Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * 2. For the Magnolia Network Agreement (MNA), this file * and the accompanying materials are made available under the * terms of the MNA which accompanies this distribution, and * is available at http://www.magnolia-cms.com/mna.html * * Any modifications to this file must keep this entire header * intact. * */ package info.magnolia.objectfactory.guice; import info.magnolia.objectfactory.ComponentProvider; import info.magnolia.objectfactory.Components; import info.magnolia.objectfactory.configuration.ComponentConfigurer; import info.magnolia.objectfactory.configuration.ComponentProviderConfiguration; import java.util.ArrayList; import java.util.List; import com.mycila.inject.jsr250.Jsr250; import org.slf4j.Logger; import org.slf4j.LoggerFactory; import com.google.inject.AbstractModule; import com.google.inject.CreationException; import com.google.inject.Guice; import com.google.inject.Injector; import com.google.inject.Module; import com.google.inject.Stage; import com.google.inject.util.Modules; /** * Builder for creating a GuiceComponentProvider. * * @version $Id$ */ public class GuiceComponentProviderBuilder { private static final Logger log = LoggerFactory.getLogger(GuiceComponentProviderBuilder.class); private ComponentProviderConfiguration configuration; private boolean exposeGlobally; private GuiceComponentProvider parent; private final List<Module> extraModules = new ArrayList<Module>(); private Stage stage; public GuiceComponentProviderBuilder exposeGlobally() { this.exposeGlobally = true; return this; } public GuiceComponentProviderBuilder withConfiguration(ComponentProviderConfiguration configuration) { this.configuration = configuration; return this; } public GuiceComponentProviderBuilder withParent(GuiceComponentProvider parent) { this.parent = parent; return this; } public GuiceComponentProviderBuilder inStage(Stage stage) { this.stage = stage; return this; } public void addModule(Module module) { this.extraModules.add(module); } public GuiceComponentProvider build(ComponentConfigurer... configurers) { if (configuration == null) { configuration = new ComponentProviderConfiguration(); } // Add implicit configurers for (ComponentConfigurer configurer: configurers) { configuration.addConfigurer(configurer); } // Allow configurers to customize the configuration before we use it for (ComponentConfigurer configurer : configuration.getConfigurers()) { configurer.doWithConfiguration(parent, configuration); } // Create the ComponentProvider instance and expose it globally if required final GuiceComponentProvider componentProvider = new GuiceComponentProvider(configuration.getTypeMapping(), parent); if (exposeGlobally) { Components.setComponentProvider(componentProvider); } Module module = new AbstractModule() { @Override protected void configure() { // Bind the ComponentProvider instance first so its the first thing to get member injection bind(ComponentProvider.class).toInstance(componentProvider); // JSR-250 support added by Mycila install(Jsr250.newJsr250Module()); install(new GuiceComponentConfigurationModule(configuration)); for (Module extraModule : extraModules) { binder().install(extraModule); } } }; if (parent != null) { GuiceParentBindingsModule parentBindingsModule = new GuiceParentBindingsModule(parent.getInjector()); module = Modules.override(parentBindingsModule).with(module); } try { Injector injector = Guice.createInjector(resolveStageToUse(), module); return (GuiceComponentProvider) injector.getInstance(ComponentProvider.class); } catch (CreationException e) { log.error("Magnolia failed to load module configuration. Please ensure you don't have any legacy modules present in your web application.", e); throw e; } } public GuiceComponentProvider build() { return build(new GuiceContextAndScopesConfigurer(), new GuicePropertyConfigurer()); } private Stage resolveStageToUse() { if (stage != null) { return stage; } if (parent != null) { return parent.getInjector().getInstance(Stage.class); } return Stage.PRODUCTION; } }