4.5. SpringMVC集成高级

spring集成还允许注册被spring容器管理的Function，Tag等，也允许配置多个视图解析器等功能

  1. <bean name="beetlConfig" class="org.beetl.ext.spring.BeetlGroupUtilConfiguration" init-method="init">
  2.         <property name="configFileResource" value="/WEB-INF/beetl.properties"/>
  3.         <property name="functions">
  4.                 <map>
  5.                         <entry key="testFunction" value-ref="testFunction"/>
  6.                 </map>
  7.         </property>
  9.         <property name="functionPackages">
  10.                 <map>
  11.                         <entry key="fp" value-ref="testFunctionPackage"/>
  12.                 </map>
  13.         </property>
  15.         <property name="tagFactorys">
  16.                 <map>
  17.                         <entry key="html.output" value-ref="testTagFactory"/>
  18.                         <entry key="html.output2" value-ref="testTagFactory2"/>
  19.                 </map>
  20.         </property>
  22. </bean>
  24. <bean name="testTagFactory" class="org.beetl.ext.spring.SpringBeanTagFactory">
  25.         <property name="name" value="testTag"/>
  26. </bean>
  27. <bean name="testTagFactory2" class="org.beetl.ext.spring.SpringBeanTagFactory">
  28.         <property name="name" value="testTag2"/>
  29. </bean>
  32. <bean name="beetlViewResolver" class="org.beetl.ext.spring.BeetlSpringViewResolver">
  33.         <property name="config" ref="beetlConfig"/>
  34.         <property name="contentType" value="text/html;charset=UTF-8"/>
  35. </bean>

如上图所示，BeetlGroupUtilConfiguration有很多属性，列举如下

  • configFileResource 属性指定了配置文件所在路径，如果不指定，则默认在classpath下
  • functions 指定了被spring容器管理的function，key为注册的方法名，value-ref 指定的bean的名称
  • functionPackages，指定了被spring容器管理的functionPackage，key为注册的方法包名，value-ref 指定的bean的名称
  • tagFactorys ，注册tag类，key是tag类的名称，value-ref指向一个org.beetl.ext.spring.SpringBeanTagFactory实例，该子类是一个Spring管理的Bean。属性name对应的bean就是tag类。需要注意，由于Tag是有状态的，因此，必须申明Scope为 "prototype"。如代码:
  1. @Service
  2. @Scope("prototype")
  3. public class TestTag extends Tag {
  4. }
  • typeFormats: 同functions，参数是 Map, Format>，其中key为类型Class
  • formats：同functions，参数是 Map，其中key为格式化函数名
  • virtualClassAttributes 同functions，参数Map, VirtualClassAttribute>，其中key为类型Class
  • virtualAttributeEvals ，类型为List
  • resourceLoader，资源加载器 ，值是 实现ResourceLoader的一个Bean
  • errorHandler ，错误处理，值是实现ErrorHandler的一个Bean
  • sharedVars,同functions，类型是Map，可以在此设置共享变量
  • configProperties，类型是Properties，可以覆盖配置文件的某些属性
    如下配置，指定了三个视图解析器，一个用于beetl页面渲染，一个用于cms，采用了beetl技术，另外一个是一些遗留的页面采用jsp
  1. <bean name="beetlConfig" class="org.beetl.ext.spring.BeetlGroupUtilConfiguration" init-method="init">
  2.         <property name="configFileResource" value="/WEB-INF/beetl.properties"/>
  3. </bean>
  6. <bean name="cmsbeetlConfig" class="org.beetl.ext.spring.BeetlGroupUtilConfiguration" init-method="init">
  7.         <property name="configFileResource" value="/WEB-INF/cms-beetl.properties"/>
  8. </bean>
  11. <!-- Beetl视图解析器1 -->
  12. <bean name="beetlViewResolver" class="org.beetl.ext.spring.BeetlSpringViewResolver">
  13.         <!-- 多视图解析器，需要设置viewNames和order -->
  14.         <property name="viewNames">
  15.                 <list>
  16.                         <value>/template/**</value>
  17.                 </list>
  18.         </property>
  19.         <property name="suffix" value=".btl"/>
  20.         <property name="contentType" value="text/html;charset=UTF-8"/>
  21.         <property name="order" value="0"/>
  22.         <!-- 多GroupTemplate，需要指定使用的bean -->
  23.         <property name="config" ref="beetlConfig"/>
  25. </bean>
  27. <!-- Beetl视图解析器2 -->
  28. <bean name="cmsBeetlViewResolver" class="org.beetl.ext.spring.BeetlSpringViewResolver">
  29.         <!-- 多视图解析器，需要设置viewNames和order -->
  30.         <property name="viewNames">
  31.                 <list>
  32.                         <value>/cmstemplate/**</value>
  33.                 </list>
  34.         </property>
  35.         <property name="contentType" value="text/html;charset=UTF-8"/>
  36.         <property name="order" value="1"/>
  37.         <!-- 多GroupTemplate，需要指定使用的bean -->
  38.         <property name="config" ref="cmsbeetlConfig"/>
  40. </bean>
  42. <!-- JSP视图解析器 -->
  43. <bean name="JSPViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  44.         <!-- 注意JSP的这个视图解析器order必须在最后 -->
  45.         <property name="order" value="256"/>
  46.         <!-- beetl配置不支持前缀，这不同于jsp 和 freemaker -->
  47.         <property name="prefix" value="/WEB-INF/"/>
  48.         <property name="suffix" value=".jsp"/>
  49.         <property name="contentType" value="text/html;charset=UTF-8"/>
  50. </bean>

Beetl视图解析器属性同spring自带的视图解析器一样，支持contentType,order,prefix,suffix等属性。

注意视图解析器里的属性viewNames，这个用于判断controller返回的path到底应该交给哪个视图解析器来做。

  • 以/template开头的是beetlViewResolver来渲染。
  • 以/cmstemplate是交给cmsBeetlViewResolver渲染。
  • 如果都没有匹配上，则是jsp渲染
    你也可以通过扩展名来帮助Spring决定采用哪种视图解析器，比如
  1. <property name="viewNames">
  2.   <list>
  3.     <value>/**/*.btl</value>
  4.   </list>
  5. </property>

如果你想更改此规则，你只能增加canHandle方法指定你的逻辑了。详情参考org.springframework.web.servlet.view.UrlBasedViewResolver.canHandle

对于仅仅需要redirect和forward的那些请求，需要加上相应的前缀

  • 以"redirect:"为前缀时：表示重定向，不产生BeetlView渲染模版，而直接通过Servlet的机制返回重定向响应.redirect:前缀后面的内容为重定向地址，可以采用相对地址（相对当前url)，绝对地址(完整的url)，如果采用/开头的地址，会自动的在前面接上当前Web应用的contextPath，即contextPath为test的Web应用中使用redirect:/admin/login.html 实际重定向地址为 /test/admin/login.html

  • 以"forward:"为前缀时：表示转发，不产生BeetlView渲染模版。而是直接通过Servlet的机制转发请求（关于转发和重定向的区别，请自行查看Servlet API) forward:前缀后面的内容为转发地址，一般都是以/开头相对于当前Web应用的根目录
    其他集成需要注意的事项:

  • spring集成，请不要使用spring的 前缀配置,改用beetl的RESOURCE.ROOT 配置，否则include，layout会找不到模板

  • 如果根目录不是默认目录，可以通过添加root属性
  1. <bean name="cmsbeetlConfig" class="org.beetl.ext.spring.BeetlGroupUtilConfiguration" init-method="init">
  3.         <property name="root" value="/WEB-INF/views"/>
  4. </bean>