Spring 2.0 源代码

/* * Copyright 2002-2006 the original author or authors. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package org.springframework.beans.factory.support; import java.beans.PropertyEditor; import java.util.ArrayList; import java.util.Arrays; import java.util.Collections; import java.util.HashMap; import java.util.HashSet; import java.util.Iterator; import java.util.List; import java.util.Map; import java.util.Set; import org.springframework.beans.BeanWrapper; import org.springframework.beans.BeansException; import org.springframework.beans.PropertyEditorRegistrar; import org.springframework.beans.PropertyEditorRegistry; import org.springframework.beans.TypeConverter; import org.springframework.beans.TypeMismatchException; import org.springframework.beans.factory.BeanCreationException; import org.springframework.beans.factory.BeanCurrentlyInCreationException; import org.springframework.beans.factory.BeanDefinitionStoreException; import org.springframework.beans.factory.BeanFactory; import org.springframework.beans.factory.BeanFactoryUtils; import org.springframework.beans.factory.BeanIsAbstractException; import org.springframework.beans.factory.BeanIsNotAFactoryException; import org.springframework.beans.factory.BeanNotOfRequiredTypeException; import org.springframework.beans.factory.CannotLoadBeanClassException; import org.springframework.beans.factory.DisposableBean; import org.springframework.beans.factory.FactoryBean; import org.springframework.beans.factory.FactoryBeanNotInitializedException; import org.springframework.beans.factory.NoSuchBeanDefinitionException; import org.springframework.beans.factory.ObjectFactory; import org.springframework.beans.factory.config.BeanDefinition; import org.springframework.beans.factory.config.BeanPostProcessor; import org.springframework.beans.factory.config.ConfigurableBeanFactory; import org.springframework.beans.factory.config.DestructionAwareBeanPostProcessor; import org.springframework.beans.factory.config.Scope; import org.springframework.beans.propertyeditors.StringArrayPropertyEditor; import org.springframework.core.CollectionFactory; import org.springframework.core.MethodParameter; import org.springframework.util.Assert; import org.springframework.util.ClassUtils; import org.springframework.util.StringUtils; /** * Abstract superclass for BeanFactory implementations, implementing the * ConfigurableBeanFactory SPI interface. Does <i>not</i> assume a listable * bean factory: can therefore also be used as base class for bean factory * implementations which fetch bean definitions from a variety of backend * resources (where bean definition access is an expensive operation). * * <p>This class provides singleton/prototype determination, singleton cache, * aliases, FactoryBean handling, bean definition merging for child bean definitions, * and bean destruction (DisposableBean interface, custom destroy methods). * Furthermore, it can manage a bean factory hierarchy, through implementing the * HierarchicalBeanFactory interface (superinterface of ConfigurableBeanFactory). * * <p>The main template methods to be implemented by subclasses are * <code>getBeanDefinition</code> and <code>createBean</code>, retrieving a * bean definition for a given bean name or creating a bean instance for a * given bean definition. Default implementations for those can be found in * DefaultListableBeanFactory or AbstractAutowireCapableBeanFactory, respectively. * * @author Rod Johnson * @author Juergen Hoeller * @since 15 April 2001 * @see #getBeanDefinition * @see #createBean * @see org.springframework.beans.factory.HierarchicalBeanFactory * @see org.springframework.beans.factory.DisposableBean * @see RootBeanDefinition * @see ChildBeanDefinition * @see AbstractAutowireCapableBeanFactory#createBean * @see DefaultListableBeanFactory#getBeanDefinition */ public abstract class AbstractBeanFactory extends DefaultSingletonBeanRegistry implements ConfigurableBeanFactory { /** Parent bean factory, for bean inheritance support */ private BeanFactory parentBeanFactory; /** ClassLoader to resolve bean class names with, if necessary */ private ClassLoader beanClassLoader = ClassUtils.getDefaultClassLoader(); /** Whether to cache bean metadata or rather reobtain it for every access */ private boolean cacheBeanMetadata = true; /** Custom PropertyEditors to apply to the beans of this factory */ private final Map customEditors = new HashMap(); /** Custom PropertyEditorRegistrars to apply to the beans of this factory */ private final Set propertyEditorRegistrars = CollectionFactory.createLinkedSetIfPossible(16); /** BeanPostProcessors to apply in createBean */ private final List beanPostProcessors = new ArrayList(); /** Indicates whether any DestructionAwareBeanPostProcessors have been registered */ private boolean hasDestructionAwareBeanPostProcessors; /** Map from scope identifier String to corresponding Scope */ private final Map scopes = new HashMap(); /** Map from alias to canonical bean name */ private final Map aliasMap = new HashMap(); /** Map from bean name to merged RootBeanDefinition */ private final Map mergedBeanDefinitions = new HashMap(); /** Names of beans that have already been created at least once */ private final Set alreadyCreated = Collections.synchronizedSet(new HashSet()); /** Names of beans that are currently in creation */ private final ThreadLocal prototypesCurrentlyInCreation = new ThreadLocal(); /** Cache of singleton objects created by FactoryBeans: FactoryBean name --> object */ private final Map factoryBeanObjectCache = new HashMap(); /** * Create a new AbstractBeanFactory. */ public AbstractBeanFactory() { } /** * Create a new AbstractBeanFactory with the given parent. * @param parentBeanFactory parent bean factory, or <code>null</code> if none * @see #getBean */ public AbstractBeanFactory(BeanFactory parentBeanFactory) { this.parentBeanFactory = parentBeanFactory; } //--------------------------------------------------------------------- // Implementation of BeanFactory interface //--------------------------------------------------------------------- public Object getBean(String name) throws BeansException { return getBean(name, null, null); } public Object getBean(String name, Class requiredType) throws BeansException { return getBean(name, requiredType, null); } /** * Return the bean with the given name, * checking the parent bean factory if not found. * @param name the name of the bean to retrieve * @param args arguments to use if creating a prototype using explicit arguments to a * static factory method. It is invalid to use a non-null args value in any other case. */ public Object getBean(String name, Object[] args) throws BeansException { return getBean(name, null, args); } /** * Return the bean with the given name, * checking the parent bean factory if not found. * @param name the name of the bean to retrieve * @param requiredType the required type of the bean to retrieve * @param args arguments to use if creating a prototype using explicit arguments to a * static factory method. It is invalid to use a non-null args value in any other case. */ public Object getBean(String name, C