/* * Copyright (C) 2005-2010 Alfresco Software Limited. * * This file is part of Alfresco * * Alfresco is free software: you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * Alfresco is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public License * along with Alfresco. If not, see . */ package org.alfresco.util; import java.util.Arrays; import org.springframework.beans.BeansException; import org.springframework.beans.factory.xml.XmlBeanDefinitionReader; import org.springframework.context.ApplicationContext; import org.springframework.context.support.ClassPathXmlApplicationContext; /** * Helper class to provide static and common access to the Spring * {@link org.springframework.context.ApplicationContext application context}. * * @author Derek Hulley */ public class ApplicationContextHelper { private static ClassPathXmlApplicationContext instance; private static String[] usedConfiguration; private static boolean useLazyLoading = false; private static boolean noAutoStart = false; /** location of required configuration files */ public static final String[] CONFIG_LOCATIONS = new String[] { "classpath:alfresco/application-context.xml" }; /** * Provides a static, single instance of the default Alfresco application context. This method can be * called repeatedly. *

* If the configuration requested differs from one used previously, then the previously-created * context is shut down. * * @return Returns an application context for the default Alfresco configuration */ public synchronized static ApplicationContext getApplicationContext() { return getApplicationContext(CONFIG_LOCATIONS); } /** * Provides a static, single instance of the application context. This method can be * called repeatedly. *

* If the configuration requested differs from one used previously, then the previously-created * context is shut down. * * @return Returns an application context for the given configuration */ public synchronized static ApplicationContext getApplicationContext(String[] configLocations) { if (configLocations == null) { throw new IllegalArgumentException("configLocations argument is mandatory."); } if (usedConfiguration != null && Arrays.deepEquals(configLocations, usedConfiguration)) { // The configuration was used to create the current context return instance; } // The config has changed so close the current context (if any) closeApplicationContext(); if(useLazyLoading || noAutoStart) { instance = new VariableFeatureClassPathXmlApplicationContext(configLocations); } else { instance = new ClassPathXmlApplicationContext(configLocations); } usedConfiguration = configLocations; return instance; } /** * Closes and releases the application context. On the next call to * {@link #getApplicationContext()}, a new context will be given. */ public static synchronized void closeApplicationContext() { if (instance == null) { // Nothing to do return; } instance.close(); instance = null; usedConfiguration = null; } /** * Should the Spring beans be initilised in a lazy manner, or * all in one go? * Normally lazy loading/intialising shouldn't be used when * running with the full context, but it may be appropriate * to reduce startup times when using a small, cut down context. */ public static void setUseLazyLoading(boolean lazyLoading) { useLazyLoading = lazyLoading; } /** * Will the Spring beans be initilised in a lazy manner, or * all in one go? The default it to load everything in one * go, as spring normally does. */ public static boolean isUsingLazyLoading() { return useLazyLoading; } /** * Should the autoStart=true property on subsystems * be honoured, or should this property be ignored * and the auto start prevented? * Normally we will use the spring configuration to * decide what to start, but when running tests, * you can use this to prevent the auto start. */ public static void setNoAutoStart(boolean noAutoStart) { ApplicationContextHelper.noAutoStart = noAutoStart; } /** * Will Subsystems with the autoStart=true property set * on them be allowed to auto start? The default is to * honour the spring configuration and allow them to, * but they can be prevented if required. */ public static boolean isNoAutoStart() { return noAutoStart; } public static void main(String ... args) { ClassPathXmlApplicationContext ctx = (ClassPathXmlApplicationContext) getApplicationContext(); synchronized (ctx) { try { ctx.wait(10000L); } catch (Throwable e) {} } ctx.close(); } /** * A wrapper around {@link ClassPathXmlApplicationContext} which * allows us to enable lazy loading or prevent Subsystem * autostart as requested. */ protected static class VariableFeatureClassPathXmlApplicationContext extends ClassPathXmlApplicationContext { protected VariableFeatureClassPathXmlApplicationContext(String[] configLocations) throws BeansException { super(configLocations); } protected void initBeanDefinitionReader(XmlBeanDefinitionReader reader) { super.initBeanDefinitionReader(reader); if(useLazyLoading) { LazyClassPathXmlApplicationContext.postInitBeanDefinitionReader(reader); } if(noAutoStart) { NoAutoStartClassPathXmlApplicationContext.postInitBeanDefinitionReader(reader); } } } }