开涛spring3(4.4) - 资源之 4.4 Resource通配符路径

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：

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*:”前缀；

@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”，然后再遍历路径进行子路径匹配从而获取匹配的资源。

@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包根路径。

    @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数组，直接看配置如下：

    <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”是混合使用的；

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

时间： 2024-08-05 23:29:04

开涛spring3(4.4) - 资源之 4.4 Resource通配符路径

4.4.1 使用路径通配符加载Resource

4.4.2 注入Resource数组