目录
- 概述： 模板渲染引擎 := 模板引擎
- Thymeleaf (Apache 2.0) : 推荐指数=9.0/10
- FreeMarker(LGPL => Apache2.0 => MIT) 【不推荐】
- Apache Velocity(Apache 2.0) : 推荐指=8.0/10
- JSP 【不推荐】
- Jinja2(Apache 2.0) : 推荐指数=7.0/10
- Y 推荐文献
- X 参考文献
概述： 模板渲染引擎 := 模板引擎
为什么要使用【模板(渲染)引擎】？模板(渲染)引擎的作用?
- 模板引擎可以让（网站）程序实现界面与数据分离，业务代码与逻辑代码的分离，大大提升了开发效率，良好的设计也使得代码重用变得更加容易。
- 我们司空见惯的模板安装卸载等概念，基本上都和模板引擎有着千丝万缕的联系。
- 模板引擎不只是可以让你实现代码分离（业务逻辑代码和用户界面代码），也可以实现数据分离（动态数据与静态数据），还可以实现代码单元共享（代码重用），甚至是多语言、动态页面与静态页面自动均衡（SDE）等等与用户界面可能没有关系的功能。
Thymeleaf (Apache 2.0) : 推荐指数=9.0/10
简介
- 项目URL
github star / fork
20250528 : 2.9k star / 510 fork
- 开源许可协议: Apache 2.0
特点
- Thymeleaf 支持在有网络和无网络的环境下皆可运行。
即 它可以让美工在浏览器查看页面的静态效果，也可以让程序员在服务器查看带数据的动态页面效果。
这是由于它支持 html 原型，然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。
浏览器解释 html 时会忽略未定义的标签属性，所以 thymeleaf 的模板可以静态地运行；
当有数据返回到页面时，Thymeleaf 标签会动态地替换掉静态内容，使页面动态显示。
- Thymeleaf 开箱即用的特性。
它提供标准和spring标准两种方言，可以直接套用模板实现JSTL、 OGNL表达式效果，避免每天套模板、该jstl、改标签的困扰。
同时开发人员也可以扩展和创建自定义的方言。
- Thymeleaf 提供
spring标准方言和一个与Spring MVC集成的可选模块————可以快速的实现表单绑定、属性编辑器、国际化等功能。
目前主流的模板引擎之一，Spring Boot推荐
优点：语法简洁，功能强大。
缺点：性能差。
语法
-
获取变量的值
${...} -
链接
@{...} -
文本替换
th:text=${...}
这里可以替换id值，class值以及内容等
- 判断语句
th:if
th:unless
th:switch
等
- 遍历
th:each
...
可参考下图，如果需要了解更多可以查看对应的API文档
依赖安装
<!-- 方式1 https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-thymeleaf -->
<!--
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
<version>${spring-boot.version}</version>
</dependency>
-->
<!-- 方式2 https://mvnrepository.com/artifact/org.thymeleaf/thymeleaf -->
<dependency>
<groupId>org.thymeleaf</groupId>
<artifactId>thymeleaf</artifactId>
<version>${thymeleaf.version}</version>
</dependency>
spring-boot.version: 3.3.5thymeleaf.version: 3.1.2.RELEASE
普通Java程序中的基本使用
import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import org.thymeleaf.ITemplateEngine;
import org.thymeleaf.TemplateEngine;
import org.thymeleaf.context.Context;
import org.thymeleaf.context.WebContext;
import org.thymeleaf.templatemode.TemplateMode;
import org.thymeleaf.templateresolver.ITemplateResolver;
import org.thymeleaf.templateresolver.StringTemplateResolver;
import org.thymeleaf.web.IWebExchange;
import java.util.Calendar;
@Slf4j
public class ThymeleafTemplateEngineUtils {
//ITemplateEngine templateEngine
private static TemplateEngine templateEngine = null;
//ITemplateResolver templateResolver
private static StringTemplateResolver templateResolver = null;
//IContext
//IWebExchange webExchange;
//WebContext context = new WebContext(webExchange, webExchange.getLocale());
private static Context context = new Context();//实际场景中，不建议此属性为静态属性
static {
init();
}
private static void init(){
templateResolver = new StringTemplateResolver();
templateEngine = new TemplateEngine();
templateEngine.setTemplateResolver(templateResolver);
context = new Context();
}
/**
* TEXT 渲染模式
*/
@Test
public void textRenderTest() {
templateResolver.setTemplateMode(TemplateMode.TEXT);
context.setVariable("today", "2011-11-11");
String text = templateEngine.process("Today is: [(${today})]", context);
log.info("{}", text);//Today is: 2011-11-11
}
/**
* HTML 渲染模式
*/
@Test
public void htmlRenderTest() {
templateResolver.setTemplateMode(TemplateMode.HTML);
context.setVariable("today", "2011-11-11");
String text = templateEngine.process("<p>Today is: <span th:text=\"${today}\">13 february 2011</span>.</p>", context);
log.info("{}", text);//<p>Today is: <span>2011-11-11</span>.</p>
}
}
Spring MVC 应用程序中的基本使用
- 配置 TemplateResolver
import org.thymeleaf.templateresolver.ITemplateResolver;
import org.thymeleaf.templateresolver.StringTemplateResolver;
@Configuration
public class TemplateResolverConfiguration {
@Bean
public StringTemplateResolver defaultTemplateResolver() {
StringTemplateResolver resolver = new StringTemplateResolver();
templateResolver.setTemplateMode(TemplateMode.HTML);
return resolver;
}
}
- 对 HTTP 接口请求内容的动态渲染
import org.thymeleaf.ITemplateEngine;
import org.thymeleaf.TemplateEngine;
import org.thymeleaf.context.Context;
import org.thymeleaf.context.WebContext;
@Autowired
private SpringTemplateEngine templateEngine;
@RequestMapping("test")
public String test(){
Context ctx = new Context();
ctx.setVariable("today", "2011-11-11");
String str = templateEngine.process("<p>Today is: <span th:text=\"${today}\">13 february 2011</span>.</p>", ctx);
return str;
}
SpringBoot 应用程序中的基本使用
- SpringBoot 应用中 : 直接在pom文件中引入依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
- 然后，只要将
html文件放入classpath:templates文件下，thymeleaf就能自动完成渲染
例如， Controller 中返回的字符串会直接到该文件夹中找到对应的页面。
- 导入
Thymeleaf命名空间：在html文件中添加代码:
<html lang="en" xmlns:th="http://www.thymeleaf.org">
FreeMarker(LGPL => Apache2.0 => MIT) 【不推荐】
简介
FreeMarker是一款 模板引擎： 即一种基于模板和要改变的数据， 并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。 它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。
模板编写为
FreeMarker Template Language(FTL)。它是简单的，专用的语言， 不是 像PHP那样成熟的编程语言。
那就意味着要准备数据在真实编程语言中来显示，比如数据库查询和业务运算， 之后模板显示已经准备好的数据。
在模板中，你可以专注于如何展现数据， 而在模板之外可以专注于要展示什么数据。
http://freemarker.foofun.cn/
这种方式通常被称为MVC(模型-视图-控制器) 模式，对于动态网页来说，是一种特别流行的模式。
它帮助从开发人员(Java 程序员)中分离出网页设计师(HTML设计师)。
设计师无需面对模板中的复杂逻辑， 在没有程序员来修改或重新编译代码时，也可以修改页面的样式。
-
而
FreeMarker最初的设计，是被用来在MVC模式的Web开发框架中生成HTML页面的，它没有被绑定到 Servlet或HTML或任意Web相关的东西上。它也可以用于非Web应用环境中。 -
URL
https://github.com/freemarker/freemarker-old
https://github.com/freemarker/freemarker3
github star / fork
[freemarker-old]
20250528 : 360 star / 126 fork
[freemarker3]
20250528 : 11 star / 3 fork
PS : 从 star 数可大致猜测，这个项目因为盲目废弃了老项目、并新创建了一个不能向下兼容的新项目，导致了这个项目逐渐走向灭亡。
- 开源许可协议:
图: freemarker3
FreeMarker 1.x : LGPL
FreeMarker 2.x(2.3.21 +) : Apache 2.0
图: freemarker-old
特点
- 在所有采用网页静态化手段的网站中，
FreeMarker使用的比例大大的超过了其他的一些技术。 - HTML静态化也是某些缓存策略使用的手段，对于系统中频繁使用数据库查询但是内容更新很小的应用，可以使用FreeMarker将HTML静态化。
比如，一些网站的公用设置信息，这些信息基本都是可以通过后台来管理并存储在数据库中，这些信息其实会大量的被前台程序调用，每一次调用都会去查询一次数据库，但是这些信息的更新频率又会很小。
因此，也可以考虑将这部分内容进行后台更新的时候进行静态化，这样就避免了大量的数据库访问请求，提高了网站的性能。
- 优点
- 不能轻易突破模板语言开始编写Java代码，因此降低了领域逻辑漏进视图层的危险几率，也提高了网站的性能。
- 缺点
- 需要一点附加配置来将其平稳地集成到应用程序中，一些IDE可能并不完全支持它，当然还有开发者或设计者也许需要学习一门陌生的模板语言。
SpringBoot应用程序中的基本使用
- 引入依赖
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
- 在配置文件中添加FreeMaker的配置如下后就可以使用了
# 设定ftl文件路径
spring.freemarker.tempalte-loader-path=classpath:/templates
# 关闭缓存，及时刷新
spring.freemarker.cache=false
spring.freemarker.charset=UTF-8
spring.freemarker.check-template-location=true
spring.freemarker.content-type=text/html
spring.freemarker.expose-request-attributes=true
spring.freemarker.expose-session-attributes=true
spring.freemarker.request-context-attribute=request#设置FreeMaker文件的后缀
spring.freemarker.suffix=.ftl
语法
语法：可以参考API文档
Apache Velocity(Apache 2.0) : 推荐指=8.0/10
简介
- 项目URL
- https://velocity.apache.org
- https://velocity.apache.org/engine/2.4.1/
- https://github.com/apache/velocity-engine
github star / fork
20240528 : 386 star / 134 fork
-
开源许可协议 : Apache 2.0
-
Velocity 是一个基于 Java 的模板引擎。它允许任何人使用简单而强大的模板语言来引用 Java 代码中定义的对象。
-
当 Velocity 用于 Web 开发时，Web 设计人员可以与 Java 程序员并行工作，根据模型-视图-控制器 （MVC） 模型开发网站，这意味着网页设计人员可以只专注于创建看起来不错的网站，而程序员可以只专注于编写一流的代码。Velocity 将 Java 代码与 Web 页面分开，使 Web 站点在其生命周期内更易于维护，并为 Java Server Pages （JSP） 或 PHP 提供了可行的替代方案。
-
Velocity 的功能远远超出了 Web 的领域;例如，它可用于从模板生成 SQL、PostScript 和 XML。它既可以用作生成源代码和报告的独立实用程序，也可以用作其他系统的集成组件。例如，Velocity 为各种 Web 框架提供模板服务，使它们能够使用视图引擎，从而根据真正的 MVC 模型促进 Web 应用程序的开发。
-
Velocity是Apache Software Foundation的一个项目，负责创建和维护与 Apache Velocity 引擎相关的开源软件。
在 Velocity 项目中创建的所有软件都可以在 Apache 软件许可下免费向公众开放。
特点
-
Velocity是一个基于Java的模板引擎。它允许任何人使用简单但功能强大的模板语言来引用Java代码中定义的对象。
-
优点：
- 使用了模板缓冲。
在模板缓冲机制的作用下，模板不再是每次出现请求的时候从磁盘读取，而是以最理想的方式在内存中保存和解析。
在开发期间，模板缓冲通常处于禁用状态，因为这时请求数量较少，而且要求对页面的修改立即产生效果。
开发完毕之后，模板一般不再改变，此时就可以启用模板缓冲功能。因此，Velocity执行速度明显优于JSP。
- 缺点：
- 不是官方标准
- 用户群体和第三方标签库较少，且对
JSP标签支持不够好。
JSP 【不推荐】
不推荐的理由：太老了、页面与业务代码的耦合度太高、性能差。
简介
- 虽然是一款功能比较强大的模板引擎，并被广大开发者熟悉，但它前后端耦合比较高。
比如，前端的html页面还要手动修改成jsp页面，大大加重了工作量，而且动态和静态资源也是耦合性太高。
-
其次，JSP页面的效率没有HTML高，因为JSP是同步加载，而且JSP需要
Tomcat，但又不支持nginx等，已经跟不上时代的潮流。 -
综上：目前开发中已经很少用JSP了，只是我们很多时候会在碰到一些以前的框架里有用到JSP技术，实在感兴趣的朋友可以试一试、体验下。
Jinja2(Apache 2.0) : 推荐指数=7.0/10
简介
- 项目URL
git star / fork
20250528 : 731 star / 170 fork
-
开源许可协议: Apache 2.0
-
基于 Java 的模板引擎，基于 Python django 模板语法，适用于渲染 jinja 模板（至少是 HubSpot 内容中使用的 jinja 子集）。目前用于生产，在 HubSpot CMS 上呈现数千个网站，每月页面浏览量达数亿次。
注意：需要 Java >= 8。最初从 jangod 分叉而来。
依赖安装
<dependency>
<groupId>com.hubspot.jinjava</groupId>
<artifactId>jinjava</artifactId>
<version>{ LATEST_VERSION }</version>
</dependency>
适用场景
- 适合原来以 Python 语言为主开发语言的工程师/团队
- Jinja2 是在 Python 领域是最火的模板引擎之一。
- 不适合需要与 Spring 框架集成，以实现动态网页渲染功能的情况。
扫一扫
1277
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
