【第四章】 资源 之 4.4 Resource通配符路径 ——跟我学spring3

4.4.1  使用路径通配符加载Resource

       前面介绍的资源路径都是非常简单的一个路径匹配一个资源，Spring还提供了一种更强大的Ant模式通配符匹配，从能一个路径匹配一批资源。

 

       Ant路径通配符支持“？”、“*”、“**”，注意通配符匹配不包括目录分隔符“/”：

 

         “?”：匹配一个字符，如“config?.xml”将匹配“config1.xml”；

         “*”：匹配零个或多个字符串，如“cn/*/config.xml”将匹配“cn/javass/config.xml”，但不匹配匹配“cn/config.xml”；而“cn/config-*.xml”将匹配“cn/config-dao.xml”；

         “**”：匹配路径中的零个或多个目录，如“cn/**/config.xml”将匹配“cn /config.xml”，也匹配“cn/javass/spring/config.xml”；而“cn/javass/config-**.xml”将匹配“cn/javass/config-dao.xml”，即把“**”当做两个“*”处理。

 

Spring提供AntPathMatcher来进行Ant风格的路径匹配。具体测试请参考cn.javass.spring.chapter4. AntPathMatcherTest。

 

Spring在加载类路径资源时除了提供前缀“classpath:”的来支持加载一个Resource，还提供一个前缀“classpath*:”来支持加载所有匹配的类路径Resource。

 

Spring提供ResourcePatternResolver接口来加载多个Resource，该接口继承了ResourceLoader并添加了“Resource[] getResources(String locationPattern)”用来加载多个Resource：

 

java代码：

public interface ResourcePatternResolver extends ResourceLoader {
       String CLASSPATH_ALL_URL_PREFIX = "classpath*:";
       Resource[] getResources(String locationPattern) throws IOException;
}

 

Spring提供了一个ResourcePatternResolver实现PathMatchingResourcePatternResolver，它是基于模式匹配的，默认使用AntPathMatcher进行路径匹配，它除了支持ResourceLoader支持的前缀外，还额外支持“classpath*:”用于加载所有匹配的类路径Resource，ResourceLoader不支持前缀“classpath*:”：

 

首先做下准备工作，在项目的“resources”创建“META-INF”目录，然后在其下创建一个“INDEX.LIST”文件。同时在“org.springframework.beans-3.0.5.RELEASE.jar”和“org.springframework.context-3.0.5.RELEASE.jar”两个jar包里也存在相同目录和文件。然后创建一个“LICENSE”文件，该文件存在于“com.springsource.cn.sf.cglib-2.2.0.jar”里。

 

 

一、“classpath”： 用于加载类路径（包括jar包）中的一个且仅一个资源；对于多个匹配的也只返回一个，所以如果需要多个匹配的请考虑“classpath*:”前缀；

 

java代码：

@Test
public void testClasspathPrefix() throws IOException {
    ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
    //只加载一个绝对匹配Resource，且通过ResourceLoader.getResource进行加载
    Resource[] resources=resolver.getResources("classpath:META-INF/INDEX.LIST");
    Assert.assertEquals(1, resources.length);
    //只加载一个匹配的Resource，且通过ResourceLoader.getResource进行加载
    resources = resolver.getResources("classpath:META-INF/*.LIST");
    Assert.assertTrue(resources.length == 1);
}

 

二、“classpath*”： 用于加载类路径（包括jar包）中的所有匹配的资源。带通配符的classpath使用“ClassLoader”的“Enumeration<URL> getResources(String name)”方法来查找通配符之前的资源，然后通过模式匹配来获取匹配的资源。如“classpath:META-INF/*.LIST”将首先加载通配符之前的目录“META-INF”，然后再遍历路径进行子路径匹配从而获取匹配的资源。

 

java代码：

@Test
public void testClasspathAsteriskPrefix () throws IOException {
     ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();
     //将加载多个绝对匹配的所有Resource
    //将首先通过ClassLoader.getResources("META-INF")加载非模式路径部分
    //然后进行遍历模式匹配
    Resource[] resources=resolver.getResources("classpath*:META-INF/INDEX.LIST");
    Assert.assertTrue(resources.length > 1);
    //将加载多个模式匹配的Resource
    resources = resolver.getResources("classpath*:META-INF/*.LIST");
    Assert.assertTrue(resources.length > 1);
}

 

注意“resources.length >1”说明返回多个Resource。不管模式匹配还是非模式匹配只要匹配的都将返回。

 

       在“com.springsource.cn.sf.cglib-2.2.0.jar”里包含“asm-license.txt”文件，对于使用“classpath*: asm-*.txt”进行通配符方式加载资源将什么也加载不了“asm-license.txt”文件，注意一定是模式路径匹配才会遇到这种问题。这是由于“ClassLoader”的“getResources(String name)”方法的限制，对于name为“”的情况将只返回文件系统的类路径，不会包换jar包根路径。

 

 

java代码：

@Test
public void testClasspathAsteriskPrefixLimit() throws IOException {
    ResourcePatternResolver resolver = new PathMatchingResourcePatternResolver();      //将首先通过ClassLoader.getResources("")加载目录，
    //将只返回文件系统的类路径不返回jar的跟路径
    //然后进行遍历模式匹配
    Resource[] resources = resolver.getResources("classpath*:asm-*.txt");
    Assert.assertTrue(resources.length == 0);
    //将通过ClassLoader.getResources("asm-license.txt")加载
    //asm-license.txt存在于com.springsource.net.sf.cglib-2.2.0.jar
    resources = resolver.getResources("classpath*:asm-license.txt");
    Assert.assertTrue(resources.length > 0);
    //将只加载文件系统类路径匹配的Resource
    resources = resolver.getResources("classpath*:LICENS*");
    Assert.assertTrue(resources.length == 1);
}

 

对于“resolver.getResources("classpath*:asm-*.txt");”，由于在项目“resources”目录下没有所以应该返回0个资源；“resolver.getResources("classpath*:asm-license.txt");”将返回jar包里的Resource；“resolver.getResources("classpath*:LICENS*");”，因为将只返回文件系统类路径资源，所以返回1个资源。

 

因此加载通配符路径时（即路径中包含通配符），必须包含一个根目录才能保证加载的资源是所有的，而不是部分。

 

 

三、“file”：加载一个或多个文件系统中的Resource。如“file:D:/*.txt”将返回D盘下的所有txt文件；      

 

四、无前缀：通过ResourceLoader实现加载一个资源。

 

AppliacationContext提供的getResources方法将获取资源委托给ResourcePatternResolver实现，默认使用PathMatchingResourcePatternResolver。所有在此就无需介绍其使用方法了。

 

4.4.2  注入Resource数组

       Spring还支持注入Resource数组，直接看配置如下：

 

java代码：

<bean id="resourceBean1" class="cn.javass.spring.chapter4.bean.ResourceBean4">
<property name="resources">
        <array>
            <value>cn/javass/spring/chapter4/test1.properties</value>
            <value>log4j.xml</value>
        </array>
    </property>
</bean>
<bean id="resourceBean2" class="cn.javass.spring.chapter4.bean.ResourceBean4">
<property name="resources" value="classpath*:META-INF/INDEX.LIST"/>
</bean>
<bean id="resourceBean3" class="cn.javass.spring.chapter4.bean.ResourceBean4">
<property name="resources">
        <array>
            <value>cn/javass/spring/chapter4/test1.properties</value>
            <value>classpath*:META-INF/INDEX.LIST</value>
        </array>
    </property>
</bean>

 

       “resourceBean1”就不用多介绍了，传统实现方式；对于“resourceBean2”则使用前缀“classpath*”，看到这大家应该懂的，加载匹配多个资源；“resourceBean3”是混合使用的；测试代码在“cn.javass.spring.chapter4.ResourceInjectTest.testResourceArrayInject”。

       Spring通过ResourceArrayPropertyEditor来进行类型转换的，而它又默认使用“PathMatchingResourcePatternResolver”来进行把路径解析为Resource对象。所有大家只要会使用“PathMatchingResourcePatternResolver”，其它一些实现都是委托给它的，比如AppliacationContext的“getResources”方法等。

 

4.4.3  AppliacationContext实现对各种Resource的支持

       一、ClassPathXmlApplicationContext：默认将通过classpath进行加载返回ClassPathResource，提供两类构造器方法：

 

java代码：

public class ClassPathXmlApplicationContext {
    //1）通过ResourcePatternResolver实现根据configLocation获取资源
       public ClassPathXmlApplicationContext(String configLocation);
       public ClassPathXmlApplicationContext(String... configLocations)；
       public ClassPathXmlApplicationContext(String[] configLocations, ……);

    //2）通过直接根据path直接返回ClasspathResource
       public ClassPathXmlApplicationContext(String path, Class clazz);
       public ClassPathXmlApplicationContext(String[] paths, Class clazz);
       public ClassPathXmlApplicationContext(String[] paths, Class clazz, ……);
}

 

       第一类构造器是根据提供的配置文件路径使用“ResourcePatternResolver ”的“getResources()”接口通过匹配获取资源；即如“classpath:config.xml”

       第二类构造器则是根据提供的路径和clazz来构造ClassResource资源。即采用“public ClassPathResource(String path, Class<?> clazz)”构造器获取资源。

 

 

       二、FileSystemXmlApplicationContext：将加载相对于当前工作目录的“configLocation”位置的资源，注意在linux系统上不管“configLocation”是否带“/”，都作为相对路径；而在window系统上如“D:/resourceInject.xml”是绝对路径。因此在除非很必要的情况下，不建议使用该ApplicationContext。

 

java代码：

public class FileSystemXmlApplicationContext{
       public FileSystemXmlApplicationContext(String configLocation);
       public FileSystemXmlApplicationContext(String... configLocations,……);
}

 

 

 

java代码：

//linux系统，以下全是相对于当前vm路径进行加载
new FileSystemXmlApplicationContext("chapter4/config.xml");
new FileSystemXmlApplicationContext("/chapter4/confg.xml");

//windows系统，第一个将相对于当前vm路径进行加载；
//第二个则是绝对路径方式加载
new FileSystemXmlApplicationContext("chapter4/config.xml");
new FileSystemXmlApplicationContext("d:/chapter4/confg.xml");

 

 

       此处还需要注意：在linux系统上，构造器使用的是相对路径，而ctx.getResource()方法如果以“/”开头则表示获取绝对路径资源，而不带前导“/”将返回相对路径资源。如下：

 

java代码：

//linux系统，第一个将相对于当前vm路径进行加载；
//第二个则是绝对路径方式加载
ctx.getResource ("chapter4/config.xml");
ctx.getResource ("/root/confg.xml");
//windows系统，第一个将相对于当前vm路径进行加载；
//第二个则是绝对路径方式加载
ctx.getResource ("chapter4/config.xml");
ctx.getResource ("d:/chapter4/confg.xml");

 

       因此如果需要加载绝对路径资源最好选择前缀“file”方式，将全部根据绝对路径加载。如在linux系统“ctx.getResource ("file:/root/confg.xml");”    

 

 

原创内容，转自请注明出处【http://sishuok.com/forum/blogPost/list/0/2458.html】

 

评论

10 楼 veesn 2019-07-19  

-----------------------------
在“com.springsource.cn.sf.cglib-2.2.0.jar”里包含“asm-license.txt”文件，对于使用“classpath*: asm-*.txt”进行通配符方式加载资源将什么也加载不了“asm-license.txt”文件，注意一定是模式路径匹配才会遇到这种问题。这是由于“ClassLoader”的“getResources(String name)”方法的限制，对于name为“”的情况将只返回文件系统的类路径，不会包换jar包根路径。
-----------------------
备注一下，看了下源码，spring4已经修复这个问题，在PathMatchingResourcePatternResolver.doFindAllClassPathResources()中有addAllClassLoaderJarRoots()处理这个问题。

9 楼 一团毛线 2015-05-15  

 Resource[] resources=resolver.getResources("classpath:META-INF/INDEX.LIST");

这一句代码只能匹配到jar包里的INDEX.LIST，无法匹配ressources文件夹里的资源，为什么?
我用的是spring4

8 楼 leilitop 2014-06-24  

yunye 写道

  博主， 我还是不怎么理解InputStreamResource只能读取一次的问题，
 
  例如，使用InputStreamResource构造XmlBeanFactory会抛异常。
 
 

     InputStream is = new FileInputStream(new File("conf/beans.xml"));
     Resource resource = new InputStreamResource(is);
     BeanFactory beanFactory = new XmlBeanFactory(resource);
   

   spring文档也说，这是个 已经 打开资源的描述符-因此 isOpen() 函数返回 true。 如果你需要在其它位置保持这个资源的描述符或者多次读取一个流，请不要使用它。

  我的问题是：怎么怎么理解InputStreamResource只能读取一次呢？ 是不是因为构造InputStreamResource的时候，资源（假设是Xml配置文件）已经被打开了，返回一个InputStream字节流，因为这个资源没有被关闭，spring需要再次读取资源（Xml配置文件）验证xml schema 语法， 以致构造XmlBeanFactory抛异常？ 如果是这样，spring怎么不直接读取这个返回的InputStream字节流呢？
  
  使用InputStreamResource构造XmlBeanFactory抛异常， 是spring1.x和spring2.x版本差异导致的问题吗？

网上看到的
“原因是从spring2.0开始，为了支持xml schema，spring会在后台打开配置文件，检查配置文件是否遵循了DTD 和 schema，所以 isOpen() 方法返回true。以致抛出异常。从spring2.0开始，已经不建议使用InputStreamResource。”

7 楼 wsj356428476 2012-11-14  

6 楼 縌流而上的魚 2012-10-16  

再问一个2B的问题，如有懂的请教下，谢谢！！！！

“在项目的“resources”创建“META-INF”目录”中“resources”是指“src”目录下吗？

5 楼 feipigzi 2012-10-14  

zuisanlang 写道

博主，能再详细解释一下下面这段话的意思吗？

在“com.springsource.cn.sf.cglib-2.2.0.jar”里包含“asm-license.txt”文件，对于使用“classpath*: asm-*.txt”进行通配符方式加载资源将什么也加载不了“asm-license.txt”文件，注意一定是模式路径匹配才会遇到这种问题。这是由于“ClassLoader”的“getResources(String name)”方法的限制，对于name为“”的情况将只返回文件系统的类路径，不会包换jar包根路径。

我们是想加载“asm-license.txt”文件，如果使用“classpath*: asm-*.txt”作为通配符的话，跟你后面说的name为“”的情况有什么关系？

结合作者这段注释理解
//将加载多个绝对匹配的所有Resource 
    //将首先通过ClassLoader.getResources("META-INF")加载非模式路径部分 
    //然后进行遍历模式匹配 
    Resource[] resources=resolver.getResources("classpath*:META-INF/INDEX.LIST"); 

4 楼 縌流而上的魚 2012-10-12  

你好。又碰到问题了。

resources = resolver.getResources("classpath*:META-INF/*.LIST");  
    Assert.assertTrue(resources.length > 1);

这里我总是找不到INDEX.LIST文件，是怎么回事啊？

我之前建立的工程是“Dynamic Web Project”而不是单纯的java工程，这个web工程自带了META-INF的目录，路径是“WebContent/META-INF”。而不是在工程目录下直接建了“META-INF”的目录，这个有影响吗？
前面一句代码：

Resource[] resource = resolver				.getResources("classpath:META-INF/INDEX.LIST");

读取是正常的！但是好像读取的不是我建立的这个文件。。能帮忙解释下吗。

3 楼 zuisanlang 2012-06-21  

博主，能再详细解释一下下面这段话的意思吗？

在“com.springsource.cn.sf.cglib-2.2.0.jar”里包含“asm-license.txt”文件，对于使用“classpath*: asm-*.txt”进行通配符方式加载资源将什么也加载不了“asm-license.txt”文件，注意一定是模式路径匹配才会遇到这种问题。这是由于“ClassLoader”的“getResources(String name)”方法的限制，对于name为“”的情况将只返回文件系统的类路径，不会包换jar包根路径。

我们是想加载“asm-license.txt”文件，如果使用“classpath*: asm-*.txt”作为通配符的话，跟你后面说的name为“”的情况有什么关系？

2 楼 jinnianshilongnian 2012-03-20  

yunye 写道

  博主， 我还是不怎么理解InputStreamResource只能读取一次的问题，
 
  例如，使用InputStreamResource构造XmlBeanFactory会抛异常。
 
 

     InputStream is = new FileInputStream(new File("conf/beans.xml"));
     Resource resource = new InputStreamResource(is);
     BeanFactory beanFactory = new XmlBeanFactory(resource);
   

   spring文档也说，这是个 已经 打开资源的描述符-因此 isOpen() 函数返回 true。 如果你需要在其它位置保持这个资源的描述符或者多次读取一个流，请不要使用它。

  我的问题是：怎么怎么理解InputStreamResource只能读取一次呢？ 是不是因为构造InputStreamResource的时候，资源（假设是Xml配置文件）已经被打开了，返回一个InputStream字节流，因为这个资源没有被关闭，spring需要再次读取资源（Xml配置文件）验证xml schema 语法， 以致构造XmlBeanFactory抛异常？ 如果是这样，spring怎么不直接读取这个返回的InputStream字节流呢？
  
  使用InputStreamResource构造XmlBeanFactory抛异常， 是spring1.x和spring2.x版本差异导致的问题吗？

我这里说的只能读取一次意思是
InputStream 这个流读完后 不能返回到流开头（重新读，即不reset，所以只能读取一次【如果还需使用需要再创建一个】），表达的不好，请见谅

1 楼 yunye 2012-03-19  

  博主， 我还是不怎么理解InputStreamResource只能读取一次的问题，
 
  例如，使用InputStreamResource构造XmlBeanFactory会抛异常。
 
 

     InputStream is = new FileInputStream(new File("conf/beans.xml"));
     Resource resource = new InputStreamResource(is);
     BeanFactory beanFactory = new XmlBeanFactory(resource);
   

   spring文档也说，这是个 已经 打开资源的描述符-因此 isOpen() 函数返回 true。 如果你需要在其它位置保持这个资源的描述符或者多次读取一个流，请不要使用它。

  我的问题是：怎么怎么理解InputStreamResource只能读取一次呢？ 是不是因为构造InputStreamResource的时候，资源（假设是Xml配置文件）已经被打开了，返回一个InputStream字节流，因为这个资源没有被关闭，spring需要再次读取资源（Xml配置文件）验证xml schema 语法， 以致构造XmlBeanFactory抛异常？ 如果是这样，spring怎么不直接读取这个返回的InputStream字节流呢？
  
  使用InputStreamResource构造XmlBeanFactory抛异常， 是spring1.x和spring2.x版本差异导致的问题吗？