6.10 Spring boot 整合

1、maven 坐标

Spring 整合可以在pom.xml中配置 jfinal 坐标，也可以配置 Enjoy Template Engine 的独立发布版本坐标，其 maven 坐标如下：

  1. <dependency>
  2.   <groupId>com.jfinal</groupId>
  3.   <artifactId>enjoy</artifactId>
  4.   <version>4.8</version>
  5. </dependency>

JFinal Template Engine 的独立发布版本 Enjoy 只有 207K 大小，并且无任何第三方依赖。

3、Spring Boot 整合

Spring boot 下整合配置如下：

  1. @Configurationpublic class SpringBootConfig {
  2.   @Bean(name = "jfinalViewResolver")  public JFinalViewResolver getJFinalViewResolver() {
  3. // 创建用于整合 spring boot 的 ViewResolver 扩展对象
  4. JFinalViewResolver jfr = new JFinalViewResolver();
  6. // 对 spring boot 进行配置
  7. jfr.setSuffix(&#34;.html&#34;);
  8. jfr.setContentType(&#34;text/html;charset=UTF-8&#34;);
  9. jfr.setOrder(0);
  11. // 获取 engine 对象，对 enjoy 模板引擎进行配置，配置方式与前面章节完全一样
  12. Engine engine  = JFinalViewResolver.engine;
  14. // 热加载配置能对后续配置产生影响，需要放在最前面
  15. engine.setDevMode(true);
  17. // 使用 ClassPathSourceFactory 从 class path 与 jar 包中加载模板文件
  18. engine.setToClassPathSourceFactory();
  20. // 在使用 ClassPathSourceFactory 时要使用 setBaseTemplatePath
  21. // 代替 jfr.setPrefix(&#34;/view/&#34;)
  22. engine.setBaseTemplatePath(&#34;/view/&#34;);
  24. // 添加模板函数
  25. engine.addSharedFunction(&#34;/common/_layout.html&#34;);
  26. engine.addSharedFunction(&#34;/common/_paginate.html&#34;);
  28. // 更多配置与前面章节完全一样
  29. // engine.addDirective(...)
  30. // engine.addSharedMethod(...);
  32. return jfr;
  33.   }}

如上所示，jfr.setToClassPathSourceFactory() 配置的 ClassPathSourceFactory 将从class path和jar包中加载模板文件。jfr.addSharedFunction(…) 配置共享模板函数。其上有关 enjoy 的配置本质上与对 Engine 对象的配置是一致的

如果从项目的 webapp 路径下加载模板文件则无需配置为 ClassPathSourceFactory。

2、Spring MVC 整合

在 Spring mvc下整合 Enjoy 非常简单，只需要配置一个 bean 即可，如下是具体配置方式：

  1. <bean id="viewResolver" class="com.jfinal.template.ext.spring.JFinalViewResolver">
  2.   <!-- 是否热加载模板文件 -->
  3.   <property name="devMode" value="true"/>
  4.   <!-- 配置shared function，多文件用逗号分隔 -->
  5.   <property name="sharedFunction" value="/view/_layout.html, /view/_paginate.html"/>
  6.  
  7.   <!-- 是否支持以 #(session.value) 的方式访问 session -->
  8.   <property name="sessionInView" value="true"/>
  9.   <property name="prefix" value="/view/"/>
  10.   <property name="suffix" value=".html"/>
  11.   <property name="order" value="1"/>
  12.   <property name="contentType" value="text/html; charset=utf-8"/>
  13. </bean>

更多、更详细的配置项及其说明，可以通过查看 JFinalViewResolver 头部的注释来了解，在绝大部分情况下，上面的配置项可以满足需求。