天道不一定酬所有勤
但是,天道只酬勤

webx学习(四)——ResourceLoadingService

ResourceLoadingService是一个可以从各种输入源中(例如从File System、Classpath、Webapp中)查找和读取资源文件的服务。
资源表现形式的多样性,给应用程序的接口设计带来一点麻烦,为了统一资源的获取,Spring框架中提供了这方面的服务,即Resource Loader,但是Resource Loader还存在一些不合理的地方,于是webx中提供了Resource Loading Service对资源进行统一管理,在Resource Loading Service中可以包含多个不同的Resource Loader进行资源的加载,使得加载资源具有多样性,同时也很好的完成了资源加载的大部分功能。

请输入图片描述

ResourceLoadingService是从 Spring的ResourceLoader派生过来的。

你只需要在配置文件中增加以下内容,就可以将Spring ResourceLoader机制替换成Webx的Resource Loading服务:
Resource Loading服务的基本配置(/WEB-INF/webx.xml)

<resource-loading
        xmlns="http://www.alibaba.com/schema/services"
        xmlns:res-loaders="http://www.alibaba.com/schema/services/resource-loading/loaders">

    <resource-alias pattern="/" name="/webroot" />

    <resource pattern="/webroot" internal="true">
        <res-loaders:webapp-loader />
    </resource>
    <resource pattern="/classpath" internal="true">
        <res-loaders:classpath-loader />
    </resource>

</ resource-loading>

1.定义新资源:

<resource pattern="/jdk">
        <res-loaders:file-loader basedir="${java.home}" />
 </resource>

定义新资源,资源名以/jdk为前缀。
表示从文件系统中装载资源。

2.重命名资源

<resource-alias pattern="/myapp/conf" name="/webroot/WEB-INF" />

<resource pattern="/webroot" internal="true">
    <res-loaders:webapp-loader />
</resource>

定义了一个资源的别名:/myapp/conf。
当你查找/myapp/conf/myFile.xml时,Resource Loading服务实际上会去找/webroot/WEB-INF/myFile.xml

internal=true是一个可选项,当它的值为true时,代表它所修饰的资源是不能被外界所直接访问的。例如,你想直接在myBean中注入/webroot/WEB-INF/myFile.xml是不行的。把internal选项设成true,可以让强制用户转向新的资源名称。Internal参数的默认值为false,意味着,新旧两种名称同时可用。

3.重定向资源

<resource-alias pattern="/templates" name="/webroot/templates" />

    <resource pattern="/templates/cms">
        <res-loaders:file-loader basedir="${cms_root}" />
    </resource>

    <resource pattern="/webroot" internal="true">
        <res-loaders:webapp-loader />
    </resource>

定义了一个资源的别名:/templates,指向internal资源:/webroot/templates。
将/templates的子目录/templates/cms重定向到某个外部的文件目录$cms_root中
举几个例子:

将/myapp/conf/my/file.xml转换成/webroot/WEB-INF/my/file.xml。
<resource-alias pattern="/myapp/conf/*/.xml" name="/webroot/WEB-INF/$1/$2.xml" />

将/myapp/conf/myfile.conf转换成/webroot/WEB-INF/myfile.xml。
<resource-alias pattern="/myapp/conf/*.conf" name="/WEB-INF/$1.xml"/>

将/profiles/myname转换成文件路径${profile_root}/m/myname;将/profiles/othername转换成文件路径${profile_root}/o/othername。
<resource pattern="/profiles/?*">
<res-loaders:file-loader basedir="${profile_root}">
<res-loaders:path>$1/$1$2</res-loaders:path>
</res-loaders:file-loader>
</resource>

请输入图片描述
每个Spring容器都可以配置自己的Resource Loading服务。
当调用子容器的Resource Loading服务时,遵循这样的逻辑:
先在子容器的Resource Loading服务中查找资源,如果找不到,
则再到parent容器的Resource Loading服务中查找,如果找不到,则放弃。
运用这种级联装载资源的方法,子应用可以把共享的资源定义在root context中,而把自己独享的资源定义在自己的容器当中。

资源文件里的内容不仅可以读取出来,ResourceLoadingService还可以修改资源文件的内容:

<resource-filters pattern="test-*.xml">
        <res-filters:xslt-filter xslt="/stylesheet.for.test/test.xsl" saveTo="/tempdir" />
    </resource-filters>

    <resource pattern="/tempdir">
        <loaders:file-loader basedir="${project.home}/target/test" />
    </resource>

将所有目录下(因为是相对路径)的名称为test-*.xml文件,用指定的XSL文件进行转换。
这里引进了一种新的扩展点:ResourceFilter。ResourceFilter可以在应用获取资源之前,取得控制,以便对资源做一点事。
是对ResourceFilter的扩展,它能够把XML资源用指定的xsl文件转换成新的格式。假如指定了saveTo参数,就可以把转换的结果保存下来,避免每次访问都重新转换。

此处定义tempdir目录资源,以便保存xslt转换的结果。

ResourceLoader参考:

FileResourceLoader
<resource pattern="/my/virtual">
             <res-loaders:file-loader />
          </resource>

file-loader会从当前配置文件所在的目录中装载
<resource pattern="/my/virtual">
              <res-loaders:file-loader basedir="${my.basedir}" />
          </resource>

这样,它就会从指定的basedir的子目录中查找资源。

WebappResourceLoader:
<resource pattern="/my/virtual">
              <res-loaders:webapp-loader />
          </resource>

从当前WEB应用中装载资源,也就是从ServletContext对象中装载资源。

ClasspathResourceLoader:
<resource pattern="/my/virtual">
              <res-loaders:classpath-loader />
          </resource>

从classpath中装载资源,也就是从当前的ClassLoader对象中装载资源。

SuperResourceLoader:
调用Resource Loading服务来取得资源。它有点像Java里面的super操作符。
<resource pattern="/my/virtual">
              <res-loaders:super-loader basedir="/webroot/WEB-INF" />
          </resource>

这个操作类似于<resource-alias>。
(全文完)
欢迎关注HollisChuang微信公众账号
打赏

如未加特殊说明,此网站文章均为原创,转载必须注明出处。HollisChuang's Blog » webx学习(四)——ResourceLoadingService

分享到:更多 ()

HollisChuang's Blog

联系我关于我