1、maven 坐标

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

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

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

3、Spring Boot 整合

Spring boot 下整合配置如下：

  1. @Configuration
  2. public class SpringBootConfig {
  4.   @Bean(name = "jfinalViewResolver")
  5.   public JFinalViewResolver getJFinalViewResolver() {
  7.     // 创建用于整合 spring boot 的 ViewResolver 扩展对象
  8.     JFinalViewResolver jfr = new JFinalViewResolver();
  10.     // 对 spring boot 进行配置
  11.     jfr.setSuffix(".html");
  12.     jfr.setContentType("text/html;charset=UTF-8");
  13.     jfr.setOrder(0);
  15.     // 设置在模板中可通过 #(session.value) 访问 session 中的数据
  16.     jfr.setSessionInView(true);
  18.     // 获取 engine 对象，对 enjoy 模板引擎进行配置，配置方式与前面章节完全一样
  19.     Engine engine  = JFinalViewResolver.engine;
  21.     // 热加载配置能对后续配置产生影响，需要放在最前面
  22.     engine.setDevMode(true);
  24.     // 使用 ClassPathSourceFactory 从 class path 与 jar 包中加载模板文件
  25.     engine.setToClassPathSourceFactory();
  27.     // 在使用 ClassPathSourceFactory 时要使用 setBaseTemplatePath
  28.     // 代替 jfr.setPrefix("/view/")
  29.     engine.setBaseTemplatePath("/view/");
  31.     // 添加模板函数
  32.     engine.addSharedFunction("/common/_layout.html");
  33.     engine.addSharedFunction("/common/_paginate.html");
  35.     // 更多配置与前面章节完全一样
  36.     // engine.addDirective(...)
  37.     // engine.addSharedMethod(...);
  39.     return jfr;
  40.   }
  41. }

如上所示，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"/>
  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 头部的注释来了解，在绝大部分情况下，上面的配置项可以满足需求。