目录
- Enjoy 模板引擎集成
- Freemarker 模板引擎集成
- Thymeleaf 模板引擎集成
- Beetl 模板引擎集成
- 多模板引擎共存配置
- 模板文件示例
1. Spring Boot 集成 Enjoy 模板引擎
添加依赖
<dependency> <groupId>com.jfinal</groupId> <artifactId>enjoy</artifactId> <version>5.1.5</version> </dependency>配置类
@Configuration public class EnjoyConfig { @Bean public EnjoyTemplateEngine enjoyTemplateEngine() { EnjoyTemplateEngine engine = new EnjoyTemplateEngine(); engine.setDevMode(true); engine.setBaseTemplatePath("templates/"); engine.addSharedFunction("/common/_layout.html"); engine.addSharedMethod(new MyEnjoyExt()); return engine; } @Bean public ViewResolver enjoyViewResolver() { EnjoyViewResolver resolver = new EnjoyViewResolver(); resolver.setSuffix(".html"); resolver.setContentType("text/html;charset=UTF-8"); resolver.setOrder(0); resolver.setEngine(enjoyTemplateEngine()); return resolver; } } // Enjoy 扩展方法 public class MyEnjoyExt { public String formatDate(Date date) { return new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(date); } }控制器示例
@Controller public class UserController { @GetMapping("/user") public String user(Model model) { model.addAttribute("userName", "张三"); model.addAttribute("createTime", new Date()); return "user"; // 对应 templates/user.html } }2. Spring Boot 集成 Freemarker 模板引擎
添加依赖
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-freemarker</artifactId> </dependency>配置文件 (application.yml)
spring: freemarker: suffix: .ftl charset: UTF-8 content-type: text/html cache: false template-loader-path: classpath:/templates/ settings: datetime_format: yyyy-MM-dd HH:mm:ss number_format: 0.## classic_compatible: true控制器示例
@Controller public class ProductController { @GetMapping("/products") public String products(Model model) { List<Product> products = Arrays.asList( new Product("手机", 2999.00), new Product("电脑", 5999.00) ); model.addAttribute("products", products); return "product/list"; // 对应 templates/product/list.ftl } }3. Spring Boot 集成 Thymeleaf 模板引擎
添加依赖
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-thymeleaf</artifactId> </dependency> <dependency> <groupId>org.thymeleaf.extras</groupId> <artifactId>thymeleaf-extras-springsecurity5</artifactId> </dependency> <dependency> <groupId>org.thymeleaf.extras</groupId> <artifactId>thymeleaf-extras-java8time</artifactId> </dependency>配置文件 (application.yml)
spring: thymeleaf: prefix: classpath:/templates/ suffix: .html mode: HTML encoding: UTF-8 servlet: content-type: text/html cache: false check-template-location: true配置类
@Configuration public class ThymeleafConfig { @Bean public ITemplateResolver templateResolver() { SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver(); resolver.setPrefix("classpath:/templates/"); resolver.setSuffix(".html"); resolver.setTemplateMode(TemplateMode.HTML); resolver.setCharacterEncoding("UTF-8"); resolver.setCacheable(false); return resolver; } @Bean public SpringTemplateEngine templateEngine() { SpringTemplateEngine engine = new SpringTemplateEngine(); engine.setTemplateResolver(templateResolver()); engine.setEnableSpringELCompiler(true); Set<IDialect> dialects = new HashSet<>(); dialects.add(new SpringSecurityDialect()); dialects.add(new Java8TimeDialect()); engine.setAdditionalDialects(dialects); return engine; } }控制器示例
@Controller public class ArticleController { @GetMapping("/articles") public String articles(Model model) { List<Article> articles = Arrays.asList( new Article("Spring Boot教程", "内容..."), new Article("Thymeleaf指南", "内容...") ); model.addAttribute("articles", articles); model.addAttribute("currentTime", LocalDateTime.now()); return "article/index"; } }4. Spring Boot 集成 Beetl 模板引擎
添加依赖
<dependency> <groupId>com.ibeetl</groupId> <artifactId>beetl</artifactId> <version>3.15.10.RELEASE</version> </dependency>配置类
@Configuration public class BeetlConfig { @Bean public BeetlGroupUtilConfiguration getBeetlGroupUtilConfiguration() { BeetlGroupUtilConfiguration beetlGroupUtilConfiguration = new BeetlGroupUtilConfiguration(); try { String root = "templates/"; ClasspathResourceLoader classpathResourceLoader = new ClasspathResourceLoader( BeetlConfig.class.getClassLoader(), root); beetlGroupUtilConfiguration.setResourceLoader(classpathResourceLoader); Properties properties = new Properties(); properties.setProperty("DELIMITER_STATEMENT_START", "@"); properties.setProperty("DELIMITER_STATEMENT_END", null); properties.setProperty("RESOURCE.autoCheck", "true"); beetlGroupUtilConfiguration.setConfigProperties(properties); return beetlGroupUtilConfiguration; } catch (Exception e) { throw new RuntimeException(e); } } @Bean public BeetlSpringViewResolver getBeetlSpringViewResolver() { BeetlSpringViewResolver resolver = new BeetlSpringViewResolver(); resolver.setConfig(getBeetlGroupUtilConfiguration()); resolver.setContentType("text/html;charset=UTF-8"); resolver.setSuffix(".btl"); resolver.setOrder(0); return resolver; } }自定义函数
public class BeetlFunctions { public String formatPrice(Object price) { if (price == null) return "0.00"; return String.format("¥%.2f", Double.parseDouble(price.toString())); } public String substring(String str, int length) { if (str == null || str.length() <= length) { return str; } return str.substring(0, length) + "..."; } }注册自定义函数
@Configuration public class BeetlExtConfig { @Autowired private BeetlGroupUtilConfiguration beetlConfig; @PostConstruct public void config() { GroupTemplate groupTemplate = beetlConfig.getGroupTemplate(); groupTemplate.registerFunction("formatPrice", new BeetlFunctions()); groupTemplate.registerFunction("substring", new BeetlFunctions()); } }控制器示例
@Controller public class OrderController { @GetMapping("/orders") public String orders(Model model) { List<Order> orders = Arrays.asList( new Order("ORDER001", 199.99, new Date()), new Order("ORDER002", 299.99, new Date()) ); model.addAttribute("orders", orders); model.addAttribute("totalAmount", 499.98); return "order/list"; } }5. 多模板引擎共存配置
@Configuration public class MultiTemplateConfig { @Bean @Order(1) public ThymeleafViewResolver thymeleafViewResolver() { ... } @Bean @Order(2) public FreeMarkerViewResolver freeMarkerViewResolver() { ... } @Bean @Order(3) public BeetlSpringViewResolver beetlSpringViewResolver() { ... } }通过设置
@Order值，可以控制不同模板引擎的视图解析优先级。
6. 模板文件示例
Enjoy 模板 (user.html)
<h1>用户信息</h1> <p>用户名：#{userName}</p> <p>创建时间：#(formatDate(createTime))</p>Freemarker 模板 (product/list.ftl)
<h1>商品列表</h1> <table> <#list products as product> <tr> <td>${product.name}</td> <td>${product.price?string("0.00")}</td> </tr> </#list> </table>Thymeleaf 模板 (article/index.html)
<h1>文章列表</h1> <div th:each="article : ${articles}"> <h3 th:text="${article.title}">标题</h3> <p th:text="${article.content}">内容</p> </div> <p>当前时间：<span th:text="${#temporals.format(currentTime, 'yyyy-MM-dd HH:mm')}"></span></p>Beetl 模板 (order/list.btl)
<h1>订单列表</h1> <table> <% for(order in orders){ %> <tr> <td>${order.orderNo}</td> <td>${formatPrice(order.amount)}</td> <td>${order.createTime, dateFormat="yyyy-MM-dd"}</td> </tr> <% } %> </table> <p>总金额：${formatPrice(totalAmount)}</p>✅ 以上就是 Spring Boot 集成四大主流模板引擎的完整配置和示例，开发者可以根据项目需求自由选择或共存使用。
