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>。