Spring IOC容器的初始化过程--资源定位

时间:2022-08-26 19:41:34
      IOC容器的初始化是又refresh()方法启动的,这个方法标志着IOC容器的正式启动。具体来说,这个启动包括bean的resource定位,载入和注册三个过程。今天我们主要了解资源定位的过程。

定位

       以编程的方式使用DefaultListableBeanFactory时,首先定义一个Resource来定位容器使用的BeanDefinition。这时使用的是ClassPathResource,这意味着Spring会在类路径中去寻找以文件形式存在的BeanDefinition信息。
    
    
  1. ClassPathResource res=new ClassPathResource("beans.xml");
       这里定义的Resource并不能由DefaultListableBeanFactory直接使用,Spring通过BeanDefinitionReader来对这些信息进行处理。我们也可以看到使用Application­Context 相对于直接使用DefaultListableBeanFactory的好处。因为在ApplicationContext中,spring已经为我们提供了一系列加载不同Resource的读取器的实现,而DefaultListableBeanFactory只是一个纯粹的IoC容器,需要为它配置特定的读取器才能完成这些功能。        当然, 有利就有弊, 使用DefaultListableBeanFactory这种更底层的容器,能提高定制IoC容器的灵活性。
        FilesystemXmlApplicationContext可以从文件系统载入Resource,ClassPathXmlApplication­Context可以从ClassPath载入Resource,,XmlWebApplicationContext可以在Web容器中载入Resource。
       以FileSystemXmlApplicationContext为例, 通过分析这个ApplicationContext的实现来看看它是怎样完成这个Resource定位过程的。下面是这个ApplicationContext的继承体系。Spring IOC容器的初始化过程--资源定位
Spring IOC容器的初始化过程--资源定位图1   FilesystemXmlApplicationContext的继承体系
从源代码角度看:Spring IOC容器的初始化过程--资源定位
Spring IOC容器的初始化过程--资源定位
                                          图2    代码角度看FilesystemXmlApplicationContext的继承体系

FilesystemXmlApplicationContext.class

    
    
  1. public class FileSystemXmlApplicationContext extends AbstractXmlApplicationContext {
  2. public FileSystemXmlApplicationContext() {
  3. }
  4. public FileSystemXmlApplicationContext(ApplicationContext parent) {
  5. super(parent);
  6. }
  7. /**
  8. * Create a new FileSystemXmlApplicationContext, loading the definitions
  9. * from the given XML file and automatically refreshing the context.
  10. * @param configLocation file path
  11. * @throws BeansException if context creation failed
  12. */
  13. public FileSystemXmlApplicationContext(String configLocation) throws BeansException {
  14. this(new String[] {configLocation}, true, null);
  15. }
  16. /**
  17. * Create a new FileSystemXmlApplicationContext, loading the definitions
  18. * from the given XML files and automatically refreshing the context.
  19. * @param configLocations array of file paths
  20. * @throws BeansException if context creation failed
  21. */
  22. public FileSystemXmlApplicationContext(String... configLocations) throws BeansException {
  23. this(configLocations, true, null);
  24. }
  25. /**
  26. * Create a new FileSystemXmlApplicationContext with the given parent,
  27. * loading the definitions from the given XML files and automatically
  28. * refreshing the context.
  29. * @param configLocations array of file paths
  30. * @param parent the parent context
  31. * @throws BeansException if context creation failed
  32. */
  33. public FileSystemXmlApplicationContext(String[] configLocations, ApplicationContext parent) throws BeansException {
  34. this(configLocations, true, parent);
  35. }
  36. /**
  37. * Create a new FileSystemXmlApplicationContext, loading the definitions
  38. * from the given XML files.
  39. * @param configLocations array of file paths
  40. * @param refresh whether to automatically refresh the context,
  41. * loading all bean definitions and creating all singletons.
  42. * Alternatively, call refresh manually after further configuring the context.
  43. * @throws BeansException if context creation failed
  44. * @see #refresh()
  45. */
  46. public FileSystemXmlApplicationContext(String[] configLocations, boolean refresh) throws BeansException {
  47. this(configLocations, refresh, null);
  48. }
  49. /**
  50. * Create a new FileSystemXmlApplicationContext with the given parent,
  51. * loading the definitions from the given XML files.
  52. * @param configLocations array of file paths
  53. * @param refresh whether to automatically refresh the context,
  54. * loading all bean definitions and creating all singletons.
  55. * Alternatively, call refresh manually after further configuring the context.
  56. * @param parent the parent context
  57. * @throws BeansException if context creation failed
  58. * @see #refresh()
  59. */
  60. public FileSystemXmlApplicationContext(String[] configLocations, boolean refresh, ApplicationContext parent)
  61. throws BeansException {
  62. super(parent);
  63. setConfigLocations(configLocations);
  64. if (refresh) {
  65. refresh();
  66. }
  67. }
  68. /**
  69. * Resolve resource paths as file system paths.
  70. * <p>Note: Even if a given path starts with a slash, it will get
  71. * interpreted as relative to the current VM working directory.
  72. * This is consistent with the semantics in a Servlet container.
  73. * @param path path to the resource
  74. * @return Resource handle
  75. * @see org.springframework.web.context.support.XmlWebApplicationContext#getResourceByPath
  76. */
  77. @Override
  78. protected Resource getResourceByPath(String path) {
  79. if (path != null && path.startsWith("/")) {
  80. path = path.substring(1);
  81. }
  82. return new FileSystemResource(path);
  83. }
  84. }
       我们可以看到在构造函数中,实现了对configuration进行处理的功能。让所有配置在文件系统中的,以.XML 文件方式存在的BeanDefnition都能够得到有效的处理。实现了 getResourceByPath方法,这个方法是个模板方法,是为读取Resource服务的。对于IoC容器功能的实现,这里没有涉及,因为它继承了AbstractXmlApplicationContext 。关于IoC容器功能相关的实现,都是在FileSysternXmlApplicationContext中完成的,但是在构造函数中通过refresh来启动IoC容器的初始化,这个refresh方法非常重要,也是我们以后分析容器初始化过程实现的一个重要入口。
       关于读入器的配置,可以到它的基类AbstractXmlApplicationContext中查看。      Spring IOC容器的初始化过程--资源定位Spring IOC容器的初始化过程--资源定位                                                           图3   getResourceByPath的调用关系
Spring IOC容器的初始化过程--资源定位
Spring IOC容器的初始化过程--资源定位
                                                 图4   getResourceByPath的调用过程我们重点AbstractRefreshableApplicationContext的refreshBeanFactory方法的实现。

AbstractRefreshableApplicationContext.class

    
    
  1. protected final void refreshBeanFactory() throws BeansException {
  2. //这里判断,如果已经建立了BeanFactory,则销毁并关闭该工厂。
  3. if (hasBeanFactory()) {
  4. destroyBeans();
  5. closeBeanFactory();
  6. }
  7. //创建并设置持有的DefaultListableBeanFactory的地方同时调用loadBeanDefinitions载入beandefinition信息
  8. try {
  9. DefaultListableBeanFactory beanFactory = createBeanFactory();
  10. beanFactory.setSerializationId(getId());
  11. customizeBeanFactory(beanFactory);
  12. loadBeanDefinitions(beanFactory);
  13. synchronized (this.beanFactoryMonitor) {
  14. this.beanFactory = beanFactory;
  15. }
  16. }
  17. catch (IOException ex) {
  18. throw new ApplicationContextException("I/O error parsing bean definition source for " + getDisplayName(), ex);
  19. }
  20. }
  21. //在上下文中创建DefaultListableBeanFactory的地方载入bean定义,因为允许有多种载入方式,虽然用得最多的是XML定义的形式,
  22. //这里通过一个抽象函数把具体的实现委托给子类来完成
  23. protected abstract void loadBeanDefinitions(DefaultListableBeanFactory beanFactory)
  24. throws BeansException, IOException;

AbstractBeanDefinitionReader.class

    
    
  1. public int loadBeanDefinitions(String location, Set<Resource> actualResources) throws BeanDefinitionStoreException {
  2. //这里取得ResourceLoader,使用的是DefaultResourceLoader
  3. ResourceLoader resourceLoader = getResourceLoader();
  4. if (resourceLoader == null) {
  5. throw new BeanDefinitionStoreException(
  6. "Cannot import bean definitions from location [" + location + "]: no ResourceLoader available");
  7. }
  8. //对Resource的路径模式进行解析,得到需要的Resource集合
  9. if (resourceLoader instanceof ResourcePatternResolver) {
  10. // Resource pattern matching available.
  11. try {
  12. Resource[] resources = ((ResourcePatternResolver) resourceLoader).getResources(location);
  13. int loadCount = loadBeanDefinitions(resources);
  14. if (actualResources != null) {
  15. for (Resource resource : resources) {
  16. actualResources.add(resource);
  17. }
  18. }
  19. if (logger.isDebugEnabled()) {
  20. logger.debug("Loaded " + loadCount + " bean definitions from location pattern [" + location + "]");
  21. }
  22. return loadCount;
  23. }
  24. catch (IOException ex) {
  25. throw new BeanDefinitionStoreException(
  26. "Could not resolve bean definition resource pattern [" + location + "]", ex);
  27. }
  28. }
  29. else {
  30. // Can only load single resources by absolute URL.
  31. Resource resource = resourceLoader.getResource(location);
  32. int loadCount = loadBeanDefinitions(resource);
  33. if (actualResources != null) {
  34. actualResources.add(resource);
  35. }
  36. if (logger.isDebugEnabled()) {
  37. logger.debug("Loaded " + loadCount + " bean definitions from location [" + location + "]");
  38. }
  39. return loadCount;
  40. }
  41. }

DefaultResourceLoader.class

    
    
  1. //对于取得Resource的具体过程,看DefaultResourceLoader是怎样完成的。
  2. public Resource getResource(String location) {
  3. Assert.notNull(location, "Location must not be null");
  4. //这里处理带有classpath标识的Resource
  5. if (location.startsWith("/")) {
  6. return getResourceByPath(location);
  7. }
  8. else if (location.startsWith(CLASSPATH_URL_PREFIX)) {
  9. return new ClassPathResource(location.substring(CLASSPATH_URL_PREFIX.length()), getClassLoader());
  10. }
  11. else {
  12. try {
  13. //这里处理带有URL标识的Resource
  14. URL url = new URL(location);
  15. return new UrlResource(url);
  16. }
  17. catch (MalformedURLException ex) {
  18. // No URL -> resolve as resource path.
  19. //两者都不是,用此方法,默认得到一个ClassPathContextResource,这个方法常用子类来实现
  20. //前面看到子类FilesystemXmlApplicationContext实现此方法,返回一个Filesystemresource。
  21. return getResourceByPath(location);
  22. }
  23. }
  24. }
                 其他ApplicationContext会对应生成其他种类的Resource。下图中我们可以看到Resource类的继承关系。
 Spring IOC容器的初始化过程--资源定位Spring IOC容器的初始化过程--资源定位                                                图5   Resource的定义和继承关系              我们通过对FilesystemXmlApplicationContext的实现原理为例,了解了Resource定位问题的解决方案。定位完成,接下来就是对返回的Resource对象进行载入了。接下来我们会介绍BeanDdfinition的载入和解析过程。