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 <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为前缀。
<file-loader>表示从文件系统中装载资源。
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。 将/myapp/conf/myfile.conf转换成/webroot/WEB-INF/myfile.xml。 将/profiles/myname转换成文件路径${profile_root}/m/myname;将/profiles/othername转换成文件路径${profile_root}/o/othername。 |
每个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可以在应用获取资源之前,取得控制,以便对资源做一点事。
<xslt-filter>是对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>。