深入Spring IOC源码之ResourceLoader

简介:

在《深入Spring IOC源码之Resource》中已经详细介绍了SpringResource的抽象,Resource接口有很多实现类,我们当然可以使用各自的构造函数创建符合需求的Resource实例,然而Spring提供了ResourceLoader接口用于实现不同的Resource加载策略,即将不同Resource实例的创建交给ResourceLoader来计算。

public interface ResourceLoader {

    //classpath

    String CLASSPATH_URL_PREFIX = ResourceUtils.CLASSPATH_URL_PREFIX;

    Resource getResource(String location);

    ClassLoader getClassLoader();

}

ResourceLoader接口中,主要定义了一个方法:getResource(),它通过提供的资源location参数获取Resource实例,该实例可以是ClasPathResourceFileSystemResourceUrlResource等,但是该方法返回的Resource实例并不保证该Resource一定是存在的,需要调用exists方法判断。该方法需要支持一下模式的资源加载:

1.       URL位置资源,如”file:C:/test.dat”

2.       ClassPath位置资源,如”classpath:test.dat”

3.       相对路径资源,如”WEB-INF/test.dat”,此时返回的Resource实例根据实现不同而不同。

ResourceLoader接口还提供了getClassLoader()方法,在加载classpath下的资源时作为参数传入ClassPathResource。将ClassLoader暴露出来,对于想要获取ResourceLoader使用的ClassLoader用户来说,可以直接调用getClassLoader()方法获得,而不是依赖于Thread Context ClassLoader,因为有些时候ResourceLoader内部使用自定义的ClassLoader

在实际开发中经常会遇到需要通过某种匹配方式查找资源,而且可能有多个资源匹配这种模式,在Spring中提供了ResourcePatternResolver接口用于实现这种需求,该接口继承自ResourceLoader接口,定义了自己的模式匹配接口:

public interface ResourcePatternResolver extends ResourceLoader {

    String CLASSPATH_ALL_URL_PREFIX = "classpath*:";

    Resource[] getResources(String locationPattern) throws IOException;

}

ResourcePatternResolver定义了getResources()方法用于根据传入的locationPattern查找和其匹配的Resource实例,并以数组的形式返回,在返回的数组中不可以存在相同的Resource实例。ResourcePatternResolver中还定义了”classpath*:”模式,用于表示查找classpath下所有的匹配Resource

Spring中,对ResourceLoader提供了DefaultResourceLoaderFileSystemResourceLoaderServletContextResourceLoader等单独实现,对ResourcePatternResolver接口则提供了PathMatchingResourcePatternResolver实现。并且ApplicationContext接口继承了ResourcePatternResolver,在实现中,ApplicationContext的实现类会将逻辑代理给相关的单独实现类,如PathMatchingResourceLoader等。在ApplicationContextResourceLoaderAware接口,可以将ResourceLoader(自身)注入到实现该接口的Bean中,在Bean中可以将其强制转换成ResourcePatternResolver接口使用(为了安全,强转前需要判断)。在Spring中对ResourceLoader相关类的类图如下:


DefaultResourceLoader

DefaultResourceLoaderResourceLoader的默认实现,AbstractApplicationContext继承该类(关于这个继承,简单吐槽一下,Spring内部感觉有很多这种个人感觉使用组合更合适的继承,比如还有AbstractBeanFactory继承自FactoryBeanRegisterySupport,这个让我看起来有点不习惯,而且也增加了类的继承关系)。它接收ClassLoader作为构造函数的参数,或使用不带参数的构造函数,此时ClassLoader使用默认的ClassLoader(一般为Thread Context ClassLoader),ClassLoader也可以通过set方法后继设置。

其最主要的逻辑实现在getResource方法中,该方法首先判断传入的location是否以”classpath:”开头,如果是,则创建ClassPathResource(移除”classpath:”前缀),否则尝试创建UrlResource,如果当前location没有定义URL的协议(即以”file:””zip:”等开头,比如使用相对路径”resources/META-INF/MENIFEST.MF),则创建UrlResource会抛出MalformedURLException,此时调用getResourceByPath()方法获取Resource实例。getResourceByPath()方法默认返回ClassPathContextResource实例,在FileSystemResourceLoader中有不同实现。

public Resource getResource(String location) {

    Assert.notNull(location, "Location must not be null");

    if (location.startsWith(CLASSPATH_URL_PREFIX)) {

        return new ClassPathResource(location.substring(CLASSPATH_URL_PREFIX.length()), getClassLoader());

    }

    else {

        try {

            // Try to parse the location as a URL...

            URL url = new URL(location);

            return new UrlResource(url);

        }

        catch (MalformedURLException ex) {

            // No URL -> resolve as resource path.

            return getResourceByPath(location);

        }

    }

}

protected Resource getResourceByPath(String path) {

    return new ClassPathContextResource(path, getClassLoader());

}

FileSystemResourceLoader

FileSystemResourceLoader继承自DefaultResourceLoader,它的getResource方法的实现逻辑和DefaultResourceLoader相同,不同的是它实现了自己的getResourceByPath方法,即当UrlResource创建失败时,它会使用FileSystemContextResource实例而不是ClassPathContextResource

protected Resource getResourceByPath(String path) {

    if (path != null && path.startsWith("/")) {

        path = path.substring(1);

    }

    return new FileSystemContextResource(path);

}

使用该类时要特别注意的一点:即使location”/”开头,资源的查找还是相对于VM启动时的相对路径而不是绝对路径(从以上代码片段也可以看出,它会先截去开头的”/”),这个和Servlet Container保持一致。如果需要使用绝对路径,需要添加”file:”前缀。

ServletContextResourceLoader

ServletContextResourceLoader类继承自DefaultResourceLoader,和FileSystemResourceLoader一样,它的getResource方法的实现逻辑和DefaultResourceLoader相同,不同的是它实现了自己的getResourceByPath方法,即当UrlResource创建失败时,它会使用ServletContextResource实例:

protected Resource getResourceByPath(String path) {

    return new ServletContextResource(this.servletContext, path);

}

这里的path即使以”/”开头,也是相对ServletContext的路径,而不是绝对路径,要使用绝对路径,需要添加”file:”前缀。

PathMatchingResourcePatternResolver

PathMatchingResourcePatternResolver类实现了ResourcePatternResolver接口,它包含了对ResourceLoader接口的引用,在对继承自ResourceLoader接口的方法的实现会代理给该引用,同时在getResources()方法实现中,当找到一个匹配的资源location时,可以使用该引用解析成Resource实例。默认使用DefaultResourceLoader类,用户可以使用构造函数传入自定义的ResourceLoader

PathMatchingResourcePatternResolver还包含了一个对PathMatcher接口的引用,该接口基于路径字符串实现匹配处理,如判断一个路径字符串是否包含通配符(’*’’?’),判断给定的path是否匹配给定的pattern等。Spring提供了AntPathMatcherPathMatcher的默认实现,表达该PathMatcher是采用Ant风格的实现。其中PathMatcher的接口定义如下:

public interface PathMatcher {

    boolean isPattern(String path);

    boolean match(String pattern, String path);

    boolean matchStart(String pattern, String path);

    String extractPathWithinPattern(String pattern, String path);

}

isPattern(String path)

判断path是否是一个pattern,即判断path是否包含通配符:

public boolean isPattern(String path) {

    return (path.indexOf('*') != -1 || path.indexOf('?') != -1);

}

match(String pattern, String path)

判断给定path是否可以匹配给定pattern

matchStart(String pattern, String path)

判断给定path是否可以匹配给定pattern,该方法不同于match,它只是做部分匹配,即当发现给定path匹配给定path的可能性比较大时,即返回true。在PathMatchingResourcePatternResolver中,可以先使用它确定需要全面搜索的范围,然后在这个比较小的范围内再找出所有的资源文件全路径做匹配运算。

AntPathMatcher中,都使用doMatch方法实现,match方法的fullMatchtrue,而matchStartfullMatchfalse

protected boolean doMatch(String pattern, String path, boolean fullMatch)

doMatch的基本算法如下:

1.       检查patternpath是否都以”/”开头或者都不是以”/”开头,否则,返回false

2.       patternpath都以”/”为分隔符,分割成两个字符串数组pattArraypathArray

3.       从头遍历两个字符串数组,如果遇到两给字符串不匹配(两个字符串的匹配算法再下面介绍),返回false,否则,直到遇到pattArray中的”**”字符串,或pattArraypathArray中有一个遍历完。

4.       如果pattArray遍历完:

a)         pathArray也遍历完,并且patternpath都以”/”结尾或都不以”/”,返回true,否则返回false

b)         pattArray没有遍历完,但fullMatchfalse,返回true

c)         pattArray只剩最后一个”*”,同时path”/”结尾,返回true

d)         pattArray剩下的字符串都是”**”,返回true,否则返回false

5.       如果pathArray没有遍历完,而pattArray遍历完了,返回false

6.       如果pathArraypattArray都没有遍历完,fullMatchfalse,而且pattArray下一个字符串为”**”时,返回true

7.       从后开始遍历pathArraypattArray,如果遇到两个字符串不匹配,返回false,否则,直到遇到pattArray中的”**”字符串,或pathArraypattArray中有一个和之前的遍历索引相遇。

8.       如果是因为pathArray与之前的遍历索引相遇,此时,如果没有遍历完的pattArray所有字符串都是”**”,则返回true,否则,返回false

9.       如果pathArraypattArray中间都没有遍历完:

a)         去除pattArray中相邻的”**”字符串,并找到其下一个”**”字符串,其索引号为pattIdxTmp,他们的距离即为s

b)         从剩下的pathArray中的第i个元素向后查找s个元素,如果找到所有s个元素都匹配,则这次查找成功,记itemp,如果没有找到这样的s个元素,返回false

c)         pattArray的起始索引设置为pattIdxTmp,将pathArray的索引号设置为temp+s,继续查找,直到pattArraypathArray遍历完。

10.   如果pattArray没有遍历完,但剩下的元素都是”**”,返回true,否则返回false

对路径字符串数组中的字符串匹配算法如下:

1.       pattern为模式字符串,str为要匹配的字符串,将两个字符串转换成两个字符数组pattArraystrArray

2.       遍历pattArray直到遇到’*’字符。

3.       如果pattArray中不存在’*’字符,则只有在pattArraystrArray的长度相同两个字符数组中所有元素都相同,其中pattArray中的’?’字符可以匹配strArray中的任何一个字符,否则,返回false

4.       如果pattArray只包含一个’*’字符,返回true

5.       遍历pattArraystrArray直到pattArray遇到’*’字符或strArray遍历完,如果存在不匹配的字符,返回false

6.       如果因为strArray遍历完成,而pattArray剩下的字符都是’*’,返回true,否则返回false

7.       从末尾开始遍历pattArraystrArray,直到pattArray遇到’*’字符,或strArray遇到之前的遍历索引,中间如果遇到不匹配字符,返回false

8.       如果strArray遍历完,而剩下的pattArray字符都是’*’字符,返回true,否则返回false

9.       如果pattArraystrArray都没有遍历完(类似之前的算法):

a)         去除pattArray相邻的’*’字符,查找下一个’*’字符,记其索引号为pattIdxTmp,两个’*’字符的相隔距离为s

b)         从剩下的strArray中的第i个元素向后查找s个元素,如果有找到所有s个元素都匹配,则这次查找成功,记itemp,如果没有到这样的s个元素,返回false

c)         pattArray的起始索引设置为pattIdxTmpstrArray的起始索引设置为temp+s,继续查找,直到pattArraystrArray遍历完。

10.   如果pattArray没有遍历完,但剩下的元素都是’*’,返回true,否则返回false

String extractPathWithinPattern(String pattern, String path)

去除path中和pattern相同的字符串,只保留匹配的字符串。比如如果pattern”/doc/csv/*.htm”,而path”/doc/csv/commit.htm”,则该方法的返回值为commit.htm。该方法默认patternpath已经匹配成功,因而算法比较简单:

’/’分割patternpath为两个字符串数组pattArraypathArray,遍历pattArray,如果该字符串包含’*’’?’字符,则并且pathArray的长度大于当前索引号,则将该字符串添加到结果中。

遍历完pattArray后,如果pathArray长度大于pattArray,则将剩下的pathArray都添加到结果字符串中。

最后返回该字符串。

不过也正是因为该算法实现比较简单,因而它的结果貌似不那么准确,比如pattern的值为:/com/**/levin/**/commit.html,而path的值为:/com/citi/cva/levin/html/commit.html,其返回结果为:citi/levin/commit.html

现在言归正传,看一下PathMatchingResourcePatternResolver中的getResources方法的实现:

public Resource[] getResources(String locationPattern) throws IOException {

    Assert.notNull(locationPattern, "Location pattern must not be null");

    if (locationPattern.startsWith(CLASSPATH_ALL_URL_PREFIX)) {

        // a class path resource (multiple resources for same name possible)

        if (getPathMatcher().isPattern(locationPattern.substring(CLASSPATH_ALL_URL_PREFIX.length()))) {

            // a class path resource pattern

            return findPathMatchingResources(locationPattern);

        }

        else {

            // all class path resources with the given name

            return findAllClassPathResources(locationPattern.substring(CLASSPATH_ALL_URL_PREFIX.length()));

        }

    }

    else {

        // Only look for a pattern after a prefix here

        // (to not get fooled by a pattern symbol in a strange prefix).

        int prefixEnd = locationPattern.indexOf(":") + 1;

        if (getPathMatcher().isPattern(locationPattern.substring(prefixEnd))) {

            // a file pattern

            return findPathMatchingResources(locationPattern);

        }

        else {

            // a single resource with the given name

            return new Resource[] {getResourceLoader().getResource(locationPattern)};

        }

    }

}

classpath下的资源,相同名字的资源可能存在多个,如果使用”classpath*:”作为前缀,表明需要找到classpath下所有该名字资源,因而需要调用findClassPathResources方法查找classpath下所有该名称的Resource,对非classpath下的资源,对于不存在模式字符的location,一般认为一个location对应一个资源,因而直接调用ResourceLoader.getResource()方法即可(对classpath下没有以”classpath*:”开头的location也适用)。

findClassPathResources方法实现相对比较简单:

适用ClassLoader.getResources()方法,遍历结果URL集合,将每个结果适用UrlResource封装,最后组成一个Resource数组返回即可。

对包含模式匹配字符的location来说,需要调用findPathMatchingResources方法:

protected Resource[] findPathMatchingResources(String locationPattern) throws IOException {

    String rootDirPath = determineRootDir(locationPattern);

    String subPattern = locationPattern.substring(rootDirPath.length());

    Resource[] rootDirResources = getResources(rootDirPath);

    Set result = new LinkedHashSet(16);

    for (int i = 0; i < rootDirResources.length; i++) {

        Resource rootDirResource = resolveRootDirResource(rootDirResources[i]);

        if (isJarResource(rootDirResource)) {

            result.addAll(doFindPathMatchingJarResources(rootDirResource, subPattern));

        }

        else {

            result.addAll(doFindPathMatchingFileResources(rootDirResource, subPattern));

        }

    }

    if (logger.isDebugEnabled()) {

        logger.debug("Resolved location pattern [" + locationPattern + "] to resources " + result);

    }

    return (Resource[]) result.toArray(new Resource[result.size()]);

}

1.       determinRootDir()方法返回locationPattern中最长的没有出现模式匹配字符的路径

2.       subPattern则表示rootDirPath之后的包含模式匹配字符的路径信pattern

3.       使用getResources()获取rootDirPath下的所有资源数组。

4.       遍历这个数组。

a)         jar中的资源,使用doFindPathMatchingJarResources()方法来查找和匹配。

b)         对非jar中资源,使用doFindPathMatchingFileResources()方法来查找和匹配。

doFindPathMatchingJarResources()实现:

1.       计算当前ResourceJar文件中的根路径rootEntryPath

2.       遍历Jar文件中所有entry,如果当前entry名以rootEntryPath开头,并且之后的路径信息和之前从patternLocation中截取出的subPattern使用PathMatcher匹配,若匹配成功,则调用rootDirResource.createRelative方法创建一个Resource,将新创建的Resource添加入结果集中。

doFindPathMatchingFileResources()实现:

1.       获取要查找资源的根路径(根路径全名)

2.       递归获得根路径下的所有资源,使用PathMatcher匹配,如果匹配成功,则创建FileSystemResource,并将其加入到结果集中。在递归进入一个目录前首先调用PathMatcher.matchStart()方法,以先简单的判断是否需要递归进去,以提升性能。

protected void doRetrieveMatchingFiles(String fullPattern, File dir, Set result) throws IOException {

    if (logger.isDebugEnabled()) {

        logger.debug("Searching directory [" + dir.getAbsolutePath() +

                "] for files matching pattern [" + fullPattern + "]");

    }

    File[] dirContents = dir.listFiles();

    if (dirContents == null) {

        throw new IOException("Could not retrieve contents of directory [" + dir.getAbsolutePath() + "]");

    }

    for (int i = 0; i < dirContents.length; i++) {

        File content = dirContents[i];

        String currPath = StringUtils.replace(content.getAbsolutePath(), File.separator"/");

        if (content.isDirectory() && getPathMatcher().matchStart(fullPattern, currPath + "/")) {

            doRetrieveMatchingFiles(fullPattern, content, result);

        }

        if (getPathMatcher().match(fullPattern, currPath)) {

            result.add(content);

        }

    }

}

最后,需要注意的是,由于ClassLoader.getResources()方法存在的限制,当传入一个空字符串时,它只能从classpath的文件目录下查找,而不会从Jar文件的根目录下查找,因而对”classpath*:”前缀的资源来说,找不到Jar根路径下的资源。即如果我们有以下定义:”classpath*:*.xml”,如果只有在Jar文件的根目录下存在*.xml文件,那么这个pattern将返回空的Resource数组。解决方法是不要再Jar文件根目录中放文件,可以将这些文件放到Jar文件中的resourcesconfig等目录下去。并且也不要在”classpath*:”之后加一些通配符,如”classpath*:**/*Enum.class”,至少在”classpath*:”后加入一个不存在通配符的路径名。

ServletContextResourcePatternResolver

ServletContextResourcePatternResolver类继承自PathMatchingResourcePatternResolver类,它重写了父类的文件查找逻辑,即对ServletContextResource资源使用ServletContext.getResourcePaths()方法来查找参数目录下的文件,而不是File.listFiles()方法:

protected Set doFindPathMatchingFileResources(Resource rootDirResource, String subPattern) throws IOException {

    if (rootDirResource instanceof ServletContextResource) {

        ServletContextResource scResource = (ServletContextResource) rootDirResource;

        ServletContext sc = scResource.getServletContext();

        String fullPattern = scResource.getPath() + subPattern;

        Set result = new LinkedHashSet(8);

        doRetrieveMatchingServletContextResources(sc, fullPattern, scResource.getPath(), result);

        return result;

    }

    else {

        return super.doFindPathMatchingFileResources(rootDirResource, subPattern);

    }

}

AbstractApplicationContextResourcePatternResolver接口的实现

AbstractApplicationContext中,对ResourcePatternResolver的实现只是简单的将getResources()方法的实现代理给resourcePatternResolver字段,而该字段默认在AbstractApplicationContext创建时新建一个PathMatchingResourcePatternResolver实例:

public AbstractApplicationContext(ApplicationContext parent) {

    this.parent = parent;

    this.resourcePatternResolver = getResourcePatternResolver();

}

protected ResourcePatternResolver getResourcePatternResolver() {

    return new PathMatchingResourcePatternResolver(this);

}

public Resource[] getResources(String locationPattern) throws IOException {

    return this.resourcePatternResolver.getResources(locationPattern);

}


相关文章
|
1月前
|
监控 Java 应用服务中间件
高级java面试---spring.factories文件的解析源码API机制
【11月更文挑战第20天】Spring Boot是一个用于快速构建基于Spring框架的应用程序的开源框架。它通过自动配置、起步依赖和内嵌服务器等特性,极大地简化了Spring应用的开发和部署过程。本文将深入探讨Spring Boot的背景历史、业务场景、功能点以及底层原理,并通过Java代码手写模拟Spring Boot的启动过程,特别是spring.factories文件的解析源码API机制。
77 2
|
1月前
|
数据采集 监控 前端开发
二级公立医院绩效考核系统源码,B/S架构,前后端分别基于Spring Boot和Avue框架
医院绩效管理系统通过与HIS系统的无缝对接,实现数据网络化采集、评价结果透明化管理及奖金分配自动化生成。系统涵盖科室和个人绩效考核、医疗质量考核、数据采集、绩效工资核算、收支核算、工作量统计、单项奖惩等功能,提升绩效评估的全面性、准确性和公正性。技术栈采用B/S架构,前后端分别基于Spring Boot和Avue框架。
|
3天前
|
设计模式 XML Java
【23种设计模式·全精解析 | 自定义Spring框架篇】Spring核心源码分析+自定义Spring的IOC功能,依赖注入功能
本文详细介绍了Spring框架的核心功能,并通过手写自定义Spring框架的方式,深入理解了Spring的IOC(控制反转)和DI(依赖注入)功能,并且学会实际运用设计模式到真实开发中。
【23种设计模式·全精解析 | 自定义Spring框架篇】Spring核心源码分析+自定义Spring的IOC功能,依赖注入功能
|
2天前
|
存储 Java 应用服务中间件
【Spring】IoC和DI,控制反转,Bean对象的获取方式
IoC,DI,控制反转容器,Bean的基本常识,类注解@Controller,获取Bean对象的常用三种方式
|
23天前
|
存储 缓存 Java
Spring面试必问:手写Spring IoC 循环依赖底层源码剖析
在Spring框架中,IoC(Inversion of Control,控制反转)是一个核心概念,它允许容器管理对象的生命周期和依赖关系。然而,在实际应用中,我们可能会遇到对象间的循环依赖问题。本文将深入探讨Spring如何解决IoC中的循环依赖问题,并通过手写源码的方式,让你对其底层原理有一个全新的认识。
44 2
|
1月前
|
前端开发 Java 开发者
Spring生态学习路径与源码深度探讨
【11月更文挑战第13天】Spring框架作为Java企业级开发中的核心框架,其丰富的生态系统和强大的功能吸引了无数开发者的关注。学习Spring生态不仅仅是掌握Spring Framework本身,更需要深入理解其周边组件和工具,以及源码的底层实现逻辑。本文将从Spring生态的学习路径入手,详细探讨如何系统地学习Spring,并深入解析各个重点的底层实现逻辑。
67 9
|
1月前
|
XML 缓存 Java
搞透 IOC、Spring IOC ,看这篇就够了!
本文详细解析了Spring框架的核心内容——IOC(控制反转)及其依赖注入(DI)的实现原理,帮助读者理解如何通过IOC实现组件解耦,提高程序的灵活性和可维护性。关注【mikechen的互联网架构】,10年+BAT架构经验倾囊相授。
|
1月前
|
安全 Java 测试技术
Java开发必读,谈谈对Spring IOC与AOP的理解
Spring的IOC和AOP机制通过依赖注入和横切关注点的分离,大大提高了代码的模块化和可维护性。IOC使得对象的创建和管理变得灵活可控,降低了对象之间的耦合度;AOP则通过动态代理机制实现了横切关注点的集中管理,减少了重复代码。理解和掌握这两个核心概念,是高效使用Spring框架的关键。希望本文对你深入理解Spring的IOC和AOP有所帮助。
44 0
|
2月前
|
XML Java 数据格式
Spring IOC容器的深度解析及实战应用
【10月更文挑战第14天】在软件工程中,随着系统规模的扩大,对象间的依赖关系变得越来越复杂,这导致了系统的高耦合度,增加了开发和维护的难度。为解决这一问题,Michael Mattson在1996年提出了IOC(Inversion of Control,控制反转)理论,旨在降低对象间的耦合度,提高系统的灵活性和可维护性。Spring框架正是基于这一理论,通过IOC容器实现了对象间的依赖注入和生命周期管理。
80 0
|
2月前
|
人工智能 自然语言处理 前端开发
SpringBoot + 通义千问 + 自定义React组件:支持EventStream数据解析的技术实践
【10月更文挑战第7天】在现代Web开发中,集成多种技术栈以实现复杂的功能需求已成为常态。本文将详细介绍如何使用SpringBoot作为后端框架,结合阿里巴巴的通义千问(一个强大的自然语言处理服务),并通过自定义React组件来支持服务器发送事件(SSE, Server-Sent Events)的EventStream数据解析。这一组合不仅能够实现高效的实时通信,还能利用AI技术提升用户体验。
245 2