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>
  8. <property name="functionPackages">
  9. <map>
  10. <entry key="fp" value-ref="testFunctionPackage"/>
  11. </map>
  12. </property>
  13. <property name="tagFactorys">
  14. <map>
  15. <entry key="html.output" value-ref="testTagFactory"/>
  16. <entry key="html.output2" value-ref="testTagFactory2"/>
  17. </map>
  18. </property>
  19. </bean>
  20. <bean name="testTagFactory" class="org.beetl.ext.spring.SpringBeanTagFactory">
  21. <property name="name" value="testTag"/>
  22. </bean>
  23. <bean name="testTagFactory2" class="org.beetl.ext.spring.SpringBeanTagFactory">
  24. <property name="name" value="testTag2"/>
  25. </bean>
  26. <bean name="beetlViewResolver" class="org.beetl.ext.spring.BeetlSpringViewResolver">
  27. <property name="config" ref="beetlConfig"/>
  28. <property name="contentType" value="text/html;charset=UTF-8"/>
  29. </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>
  4. <bean name="cmsbeetlConfig" class="org.beetl.ext.spring.BeetlGroupUtilConfiguration" init-method="init">
  5. <property name="configFileResource" value="/WEB-INF/cms-beetl.properties"/>
  6. </bean>
  7. <!-- Beetl视图解析器1 -->
  8. <bean name="beetlViewResolver" class="org.beetl.ext.spring.BeetlSpringViewResolver">
  9. <!-- 多视图解析器,需要设置viewNames和order -->
  10. <property name="viewNames">
  11. <list>
  12. <value>/template/**</value>
  13. </list>
  14. </property>
  15. <property name="suffix" value=".btl"/>
  16. <property name="contentType" value="text/html;charset=UTF-8"/>
  17. <property name="order" value="0"/>
  18. <!-- 多GroupTemplate,需要指定使用的bean -->
  19. <property name="config" ref="beetlConfig"/>
  20. </bean>
  21. <!-- Beetl视图解析器2 -->
  22. <bean name="cmsBeetlViewResolver" class="org.beetl.ext.spring.BeetlSpringViewResolver">
  23. <!-- 多视图解析器,需要设置viewNames和order -->
  24. <property name="viewNames">
  25. <list>
  26. <value>/cmstemplate/**</value>
  27. </list>
  28. </property>
  29. <property name="contentType" value="text/html;charset=UTF-8"/>
  30. <property name="order" value="1"/>
  31. <!-- 多GroupTemplate,需要指定使用的bean -->
  32. <property name="config" ref="cmsbeetlConfig"/>
  33. </bean>
  34. <!-- JSP视图解析器 -->
  35. <bean name="JSPViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
  36. <!-- 注意JSP的这个视图解析器order必须在最后 -->
  37. <property name="order" value="256"/>
  38. <!-- beetl配置不支持前缀,这不同于jsp 和 freemaker -->
  39. <property name="prefix" value="/WEB-INF/"/>
  40. <property name="suffix" value=".jsp"/>
  41. <property name="contentType" value="text/html;charset=UTF-8"/>
  42. </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">
  2. <property name="root" value="/WEB-INF/views"/>
  3. </bean>