spring resource以及ant路径匹配规则 源码学习

spring中resource是一个接口,为资源的抽象提供了一套操作方式,可匹配类似于classpath:XXX,file://XXX等不同协议的资源访问。

image.png

如上图所示,spring已经提供了多种访问资源的实体类,还有DefaultResourceLoader类,使得与具体的context结合。在spring中根据设置的配置文件路径转换为对应的文件资源


// AbstractBeanDefinitionReader 文件
Resource[] resources = ((ResourcePatternResolver) resourceLoader).getResources(location);

// DefaultResourceLoader 文件
public Resource getResource(String location) {
    Assert.notNull(location, "Location must not be null");

    for (ProtocolResolver protocolResolver : this.protocolResolvers) {
        Resource resource = protocolResolver.resolve(location, this);
        if (resource != null) {
            return resource;
        }
    }

    if (location.startsWith("/")) {
       // ClassPathContextResource 
        return getResourceByPath(location);
    }
    else if (location.startsWith(CLASSPATH_URL_PREFIX)) {
        return new ClassPathResource(location.substring(CLASSPATH_URL_PREFIX.length()), getClassLoader());
        // 如果是以classpath:开头,认为是classpath样式的资源,返回ClassPathResource
    }
    else {
        try {
            URL url = new URL(location);
            return new UrlResource(url);
            // 符合URL协议,返回UrlResource
        }
        catch (MalformedURLException ex) {
            return getResourceByPath(location);
            // 剩下的无法判断的全部返回ClassPathContextResource
        }
    }
}

// 然后在真正的使用resource的文件流时,XmlBeanDefinitionReader文件内
InputStream inputStream = encodedResource.getResource().getInputStream();
image.png

有多种具体的Resource类的获取输入流的实现方式。
FileSystemResource 类

    public InputStream getInputStream() throws IOException {
        return new FileInputStream(this.file);
        // this.file 是个File对象
    }

ClassPathContextResource和ClassPathResource的获取IO流的方法是同一个

现在基本上清楚了spring针对不同协议的文件路径是如何操作路径,以什么样子的方式获取IO流,不过还是有几个疑问需要深入了解下。

  • 如何匹配多个资源文件
  • FileSystemXmlApplicationContext和ClassPathXmlApplicationContext的区别

匹配多个资源文件

之前说的例子都是明确指定context.xml 的情况,可是现实中会配置多个配置文件,然后依次加载,例如*.xml会匹配当前目录下面所有的.xml文件。来到了PathMatchingResourcePatternResolver.class匹配出多个xml的情况

至于为什么会定位到PathMatchingResourcePatternResolver.class这个文件,可以看

AbstractApplicationContext 文件

public AbstractApplicationContext() {
    this.resourcePatternResolver = getResourcePatternResolver();
}

protected ResourcePatternResolver getResourcePatternResolver() {
    return new PathMatchingResourcePatternResolver(this);
}

// 也就意味着在context类初始化的时候,就直接设置了好了resourcePatternResolver对象为PathMatchingResourcePatternResolver

PathMatchingResourcePatternResolver 文件

public Resource[] getResources(String locationPattern) throws IOException {
    Assert.notNull(locationPattern, "Location pattern must not be null");
    if (locationPattern.startsWith(CLASSPATH_ALL_URL_PREFIX)) {
        // 通过classpath:开头的地址
        if (getPathMatcher().isPattern(locationPattern.substring(CLASSPATH_ALL_URL_PREFIX.length()))) {
            // 地址路径中包含了 【*】这个匹配的关键字,意味着要模糊匹配
            return findPathMatchingResources(locationPattern);
        }
        else {
            // 查找当前所有的classpath资源并返回
            return findAllClassPathResources(locationPattern.substring(CLASSPATH_ALL_URL_PREFIX.length()));
        }
    }
    else {
        // and on Tomcat only after the "*/" separator for its "war:" protocol.
        int prefixEnd = (locationPattern.startsWith("war:") ? locationPattern.indexOf("*/") + 1 :
                locationPattern.indexOf(":") + 1);
        if (getPathMatcher().isPattern(locationPattern.substring(prefixEnd))) {
            // 除去前缀,包含【*】,进行模糊匹配
            return findPathMatchingResources(locationPattern);
        }
        else {
            // 这个是针对具体的xml文件的匹配规则,会进入到DefaultResourceLoader装载资源文件
            return new Resource[] {getResourceLoader().getResource(locationPattern)};
        }
    }
}


// 根据模糊地址找出所有匹配的资源文件
protected Resource[] findPathMatchingResources(String locationPattern) throws IOException {
    String rootDirPath = determineRootDir(locationPattern);
    // 根路径,此处为xml/
    String subPattern = locationPattern.substring(rootDirPath.length());
    // 子路径,此处为*.xml
    Resource[] rootDirResources = getResources(rootDirPath);
    // 调用本身,算出根路径的资源信息
    // 如果为xml/*.xml 则返回一个根路径资源信息xml/
    // 如果为xml/**/*.xml 则还是返回一组根路径资源信息xml/
    Set<Resource> result = new LinkedHashSet<Resource>(16);
    for (Resource rootDirResource : rootDirResources) {
        rootDirResource = resolveRootDirResource(rootDirResource);
        URL rootDirURL = rootDirResource.getURL();
        // 获取其URL信息
        if (equinoxResolveMethod != null) {
            if (rootDirURL.getProtocol().startsWith("bundle")) {
                rootDirURL = (URL) ReflectionUtils.invokeMethod(equinoxResolveMethod, null, rootDirURL);
                rootDirResource = new UrlResource(rootDirURL);
            }
        }
        if (rootDirURL.getProtocol().startsWith(ResourceUtils.URL_PROTOCOL_VFS)) {
        // jboss的文件协议
            result.addAll(VfsResourceMatchingDelegate.findMatchingResources(rootDirURL, subPattern, getPathMatcher()));
        }
        else if (ResourceUtils.isJarURL(rootDirURL) || 
        isJarResource(rootDirResource)) {
           // jar包
            result.addAll(doFindPathMatchingJarResources(rootDirResource, rootDirURL, subPattern));
        }
        else {
           // 默认扫描当前的所有资源,添加到result中
            result.addAll(doFindPathMatchingFileResources(rootDirResource, subPattern));
        }
    }
    if (logger.isDebugEnabled()) {
        logger.debug("Resolved location pattern [" + locationPattern + "] to resources " + result);
    }
    return result.toArray(new Resource[result.size()]);
}

// 通过路径去匹配到合适的资源,此处的rootDir包含了绝对路径
protected Set<File> retrieveMatchingFiles(File rootDir, String pattern) 
      throws IOException {
    if (!rootDir.exists()) {
       // 根路径都不存在,则返回空
        if (logger.isDebugEnabled()) {
            logger.debug("Skipping [" + rootDir.getAbsolutePath() + "] because it does not exist");
        }
        return Collections.emptySet();
    }
    if (!rootDir.isDirectory()) {
        // 不是文件夹,返回空
        if (logger.isWarnEnabled()) {
            logger.warn("Skipping [" + rootDir.getAbsolutePath() + "] because it does not denote a directory");
        }
        return Collections.emptySet();
    }
    if (!rootDir.canRead()) {
       // 文件不可读,也返回空
        if (logger.isWarnEnabled()) {
            logger.warn("Cannot search for matching files underneath directory [" + rootDir.getAbsolutePath() +
                    "] because the application is not allowed to read the directory");
        }
        return Collections.emptySet();
    }
    String fullPattern = StringUtils.replace(rootDir.getAbsolutePath(), File.separator, "/");
    // 得到当前系统下的文件绝对地址
    if (!pattern.startsWith("/")) {
        fullPattern += "/";
    }
    fullPattern = fullPattern + StringUtils.replace(pattern, File.separator, "/");
    // 得到完整的全路径 例如/user/...*.xml
    Set<File> result = new LinkedHashSet<File>(8);
    doRetrieveMatchingFiles(fullPattern, rootDir, result);
    // 得到当前rootDir下面的所有文件,然后配合fullPattern进行匹配,得到的结果在result中
    return result;
}

protected void doRetrieveMatchingFiles(String fullPattern, File dir, Set<File> result) throws IOException {
    if (logger.isDebugEnabled()) {
        logger.debug("Searching directory [" + dir.getAbsolutePath() +
                "] for files matching pattern [" + fullPattern + "]");
    }
    File[] dirContents = dir.listFiles();
    // 得到当前根路径的所有文件(包含了文件夹)
    if (dirContents == null) {
        if (logger.isWarnEnabled()) {
            logger.warn("Could not retrieve contents of directory [" + dir.getAbsolutePath() + "]");
        }
        return;
    }
    Arrays.sort(dirContents);
    // 这个也需要注意到,这个顺序决定了扫描文件的先后顺序,也意味着bean加载的情况
    for (File content : dirContents) {
        String currPath = StringUtils.replace(content.getAbsolutePath(), File.separator, "/");
        if (content.isDirectory() && getPathMatcher().matchStart(fullPattern, currPath + "/")) {
          // 如果是文件夹,类似于xml/**/*.xml 文件
          // 访问到了** 就会是文件夹
            if (!content.canRead()) {
                ...
            }
            else {
               // 循环迭代访问文件
                doRetrieveMatchingFiles(fullPattern, content, result);
            }
        }
        if (getPathMatcher().match(fullPattern, currPath)) {
            result.add(content);
            // 匹配完成,添加到结果集合中
        }
    }
}

这样整个的xml文件读取过程就全部完成,也清楚了实际中xml文件是什么样的形式被访问到的。
其实spring的路径风格是和Apache Ant的路径样式一样的,Ant的更多细节可以自行学习了解。

FileSystemXmlApplicationContext和ClassPathXmlApplicationContext的区别

这个看名字就很明显,就是加载文件不太一样,一个通过纯粹的文件协议去访问,另一个却可以兼容多种协议。仔细分析他们的差异,会发现主要的差异就在于FileSystemXmlApplicationContext重写的getResourceByPath方法

FileSystemXmlApplicationContext 文件

protected Resource getResourceByPath(String path) {
    if (path != null && path.startsWith("/")) {
        path = path.substring(1);
    }
    return new FileSystemResource(path);
}

上面代码学习,已经清楚了在默认的中是生成ClassPathContextResource资源,但是重写之后意味着被强制性的设置为了FileSystemResource,就会出现文件不存在的情况。

如下图,设置的path只有context.xml,就会被提示找不到文件,因为此时的文件路径是项目路径 + context.xml

image.png

如果改为使用simple-spring-demo/src/main/resources/context.xml,此时需要注意修改xml内的properties文件路径,否则也会提示文件找不到

image.png

image.png

这样就符合设置了,运行正常,这也告诉我们一旦使用FileSystemXmlApplicationContext记得修改所有的路径配置,以防止出现文件找不到的错误。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,014评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,796评论 3 386
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,484评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,830评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,946评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,114评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,182评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,927评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,369评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,678评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,832评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,533评论 4 335
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,166评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,885评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,128评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,659评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,738评论 2 351

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,639评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,781评论 6 342
  • 寻春?得到乡下——城里没有分明的四季,就如没有真正的夜晚。 跟我回乡吧。 春早来了呢,在乡下。 春天在小河边。 小...
    木棉之秋阅读 926评论 79 48
  • 明天公司又要开盘了,最近的售楼部真的是门庭若市,和我们本身的高端调性还有点不搭。谁叫今年市场好呢?谁叫国人买涨不买...
    杜美慧阅读 401评论 0 0
  • “死亡”是令我们恐惧的一个词,很多时候,我们都会避讳提及这两个字。 事实上,伴随死亡而来的一切比死亡本身更可怕。 ...
    WendyKoo阅读 365评论 3 3