JFinal

登录 注册

1 快速上手

2 JFinalConfig

3 Controller

4 AOP

5 ActiveRecord

6 Enjoy 模板引擎

7 EhCachePlugin

8 RedisPlugin

9 Cron4jPlugin

10 Validator

11 国际化

12 Json 转换

13 JFinal架构及扩展

14 升级到 3.5

6.10 Spring整合

1、maven 坐标

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

<dependency>
  <groupId>com.jfinal</groupId>
  <artifactId>enjoy</artifactId>
  <version>3.4</version>
</dependency>

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


2、Spring MVC整合

    在Spring mvc下整合JFinal Template Engine非常简单,只需要配置一个bean即可,如下是具体配置方式:

<bean id="viewResolver" class="com.jfinal.template.ext.spring.JFinalViewResolver">
  <!-- 是否热加载模板文件 -->
  <property name="devMode" value="true"/>
  <!-- 配置shared function,多文件用逗号分隔 -->
  <property name="sharedFunction" value="/view/_layout.html, /view/_paginate.html"/>

  <!-- 是否支持以 #(session.value) 的方式访问 session -->
  <property name="sessionInView" value="true"/>
  <property name="prefix" value="/view/"/>
  <property name="suffix" value=".html"/>
  <property name="order" value="1"/>
  <property name="contentType" value="text/html; charset=utf-8"/>
</bean>

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


3、Spring Boot整合

    Spring boot 下整合配置如下:

@Configuration
public class SpringBootConfig {
  @Bean(name = "jfinalViewResolver")
  public JFinalViewResolver getJFinalViewResolver() {
    JFinalViewResolver jfr = new JFinalViewResolver();
    // setDevMode 配置放在最前面
    jfr.setDevMode(true);

    // 使用 ClassPathSourceFactory 从 class path 与 jar 包中加载模板文件
    jfr.setSourceFactory(new ClassPathSourceFactory());
    
    // 在使用 ClassPathSourceFactory 时要使用 setBaseTemplatePath
    // 代替 jfr.setPrefix("/view/")
    JFinalViewResolver.engine.setBaseTemplatePath("/view/");
    
    jfr.setSuffix(".html");
    jfr.setContentType("text/html;charset=UTF-8");
    jfr.setOrder(0);
    jfr.addSharedFunction("/view/common/_layout.html");
    jfr.addSharedFunction("/view/common/_paginate.html");
    return jfr;
  }
}

    如上所示,jfr.setSourceFactory(...) 配置的 ClassPathSourceFactory 将从class path和jar包中加载模板文件。jfr.addSharedFunction(...) 配置共享模板函数。

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