提交


四、FreeMarker模板引擎实战
4.1 FreeMarker简介
FreeMarker是一个强大的模板引擎，广泛应用于各种场景，特别适合生成静态HTML、电子邮件模板等。
4.2 引入依赖

org.springframework.boot
spring-boot-starter-freemarker

4.3 配置FreeMarker
@Configuration
public class FreeMarkerConfig {

@Bean
public FreeMarkerConfigurer freeMarkerConfigurer() {
FreeMarkerConfigurer configurer = new FreeMarkerConfigurer();
configurer.setTemplateLoaderPath(“/templates/”);
configurer.setDefaultEncoding(“UTF-8”);
return configurer;
}

@Bean
public FreeMarkerViewResolver freeMarkerViewResolver() {
FreeMarkerViewResolver resolver = new FreeMarkerViewResolver();
resolver.setPrefix(“”);
resolver.setSuffix(“.ftl”);
resolver.setContentType(“text/html;charset=UTF-8”);
return resolver;
}
}
4.4 FreeMarker基础示例
4.4.1 基本语法

${user.name}

年龄: ${user.age}

<#if user.active>

状态: 活跃

<#else>

状态: 未激活

<#list users as user>
• ${user.name} – ${user.email}

用户数: ${users?size}

第一个用户: ${users?first.name}

最后一个用户: ${users?last.name}

4.4.2 宏定义（类似函数）

<#macro userCard user>

<#macro pagination currentPage totalPages>

<#include "macros.ftl">

用户列表

<#list users as user>
<@userCard user=user />

<@pagination currentPage=currentPage totalPages=totalPages />


五、解决常见渲染难题
5.1 问题1：模板缓存导致修改不生效
问题描述：
在开发环境中修改模板文件后，刷新页面看不到变化。
解决方案：
5.1.1 Thymeleaf配置
# application.yml
spring:
thymeleaf:
cache: false # 开发环境关闭缓存
prefix: classpath:/templates/
suffix: .html
mode: HTML
encoding: UTF-8
5.1.2 FreeMarker配置
# application.yml
spring:
freemarker:
cache: false # 开发环境关闭缓存
template-loader-path: classpath:/templates/
suffix: .ftl
5.1.3 JSP配置
@Configuration
public class JspConfig {

@Bean
public ViewResolver viewResolver() {
InternalResourceViewResolver resolver = new InternalResourceViewResolver();
resolver.setPrefix(“/WEB-INF/jsp/”);
resolver.setSuffix(“.jsp”);
resolver.setViewClass(JstlView.class);

// 开发环境关闭缓存
if (isDevelopment()) {
resolver.setCache(false);
}

return resolver;
}

private boolean isDevelopment() {
return “dev”.equals(System.getProperty(“spring.profiles.active”));
}
}
5.2 问题2：国际化（i18n）处理
问题描述：
多语言环境下，模板中的文本需要根据用户语言动态显示。
解决方案：
5.2.1 配置国际化
@Configuration
public class I18nConfig {

@Bean
public MessageSource messageSource() {
ReloadableResourceBundleMessageSource messageSource = new ReloadableResourceBundleMessageSource();
messageSource.setBasename(“classpath:messages”);
messageSource.setDefaultEncoding(“UTF-8”);
messageSource.setCacheSeconds(3600);
return messageSource;
}

@Bean
public LocaleResolver localeResolver() {
SessionLocaleResolver resolver = new SessionLocaleResolver();
resolver.setDefaultLocale(Locale.CHINA);
return resolver;
}

@Bean
public LocaleChangeInterceptor localeChangeInterceptor() {
LocaleChangeInterceptor interceptor = new LocaleChangeInterceptor();
interceptor.setParamName(“lang”);
return interceptor;
}

@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(localeChangeInterceptor());
}
}
5.2.2 消息文件
# messages.properties
user.welcome=欢迎
user.list=用户列表
user.create=创建用户

# messages_zh_CN.properties
user.welcome=欢迎
user.list=用户列表
user.create=创建用户

# messages_en_US.properties
user.welcome=Welcome
user.list=User List
user.create=Create User
5.2.3 Thymeleaf国际化

Welcome

Hello, John!

You have 5 messages

中文
English


5.2.4 JSP国际化

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>

5.3 问题3：模板继承和布局管理
问题描述：
多个页面共享相同的头部、尾部和导航，需要避免代码重复。
解决方案：
5.3.1 Thymeleaf布局

5.3.2 FreeMarker布局

<#include "layout.ftl">
<#assign title="页面标题">
<#assign content>

页面标题

这是页面内容

<#nested content>
5.4 问题4：性能优化
问题描述：
大量数据渲染时，页面加载缓慢。
解决方案：
5.4.1 分页处理
@Controller
public class PaginationController {

@GetMapping(“/users”)
public String listUsers(
@RequestParam(defaultValue = “1”) int page,
@RequestParam(defaultValue = “10”) int size,
Model model) {

Pageable pageable = PageRequest.of(page – 1, size, Sort.by(“id”).ascending());
Page userPage = userService.findAll(pageable);

model.addAttribute(“users”, userPage.getContent());
model.addAttribute(“currentPage”, page);
model.addAttribute(“totalPages”, userPage.getTotalPages());
model.addAttribute(“totalElements”, userPage.getTotalElements());

return “user/list”;
}
}
5.4.2 懒加载和异步渲染
@Controller
public class AsyncController {

@GetMapping(“/dashboard”)
public String dashboard(Model model) {
// 主要数据立即加载
model.addAttribute(“mainData”, getMainData());

// 异步加载次要数据
CompletableFuture> chartData = CompletableFuture.supplyAsync(() -> {
return getChartData();
});

CompletableFuture> tableData = CompletableFuture.supplyAsync(() -> {
return getTableData();
});

// 等待所有异步任务完成
try {
CompletableFuture.allOf(chartData, tableData).get(5, TimeUnit.SECONDS);
model.addAttribute(“chartData”, chartData.get());
model.addAttribute(“tableData”, tableData.get());
} catch (Exception e) {
// 超时或异常处理
model.addAttribute(“chartData”, Collections.emptyList());
model.addAttribute(“tableData”, Collections.emptyList());
}

return “dashboard”;
}
}
5.4.3 缓存策略
@Service
public class UserService {

@Cacheable(value = “users”, key = “#id”)
public User findById(Long id) {
// 数据库查询
return userRepository.findById(id).orElse(null);
}

@CacheEvict(value = “users”, key = “#user.id”)
public User save(User user) {
return userRepository.save(user);
}

@CacheEvict(value = “users”, allEntries = true)
public void delete(Long id) {
userRepository.deleteById(id);
}
}
5.5 问题5：安全防护
问题描述：
模板中直接输出用户输入可能导致XSS攻击。
解决方案：
5.5.1 Thymeleaf自动转义

5.5.2 JSP安全输出

${userInput}

${userInput}

<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>

${fn:escapeXml(userInput)}

5.5.3 FreeMarker安全配置
@Configuration
public class FreeMarkerSecurityConfig {

@Bean
public FreeMarkerConfigurer freeMarkerConfigurer() {
FreeMarkerConfigurer configurer = new FreeMarkerConfigurer();
configurer.setTemplateLoaderPath(“/templates/”);
configurer.setDefaultEncoding(“UTF-8”);

// 配置FreeMarker安全设置
Configuration configuration = configurer.getConfiguration();
configuration.setNewBuiltinClassResolver(TemplateClassResolver.SAFER_RESOLVER);
configuration.setAPIBuiltinEnabled(false);

return configurer;
}
}

六、高级技巧和最佳实践
6.1 自定义视图解析器
@Component
public class CustomViewResolver extends UrlBasedViewResolver {

@Override
protected View createView(String viewName, Locale locale) throws Exception {
// 自定义逻辑
if (viewName.startsWith(“redirect:”)) {
return new RedirectView(viewName.substring(9), true);
}

if (viewName.startsWith(“forward:”)) {
return new InternalResourceView(viewName.substring(8));
}

return super.createView(viewName, locale);
}
}
6.2 自定义模板引擎
@Configuration
public class CustomTemplateEngineConfig {

@Bean
public ViewResolver customViewResolver() {
return new ViewResolver() {
@Override
public View resolveViewName(String viewName, Locale locale) throws Exception {
return new View() {
@Override
public String getContentType() {
return “text/html;charset=UTF-8”;
}

@Override
public void render(Map model, HttpServletRequest request,
HttpServletResponse response) throws Exception {
// 自定义渲染逻辑
response.getWriter().write(“

自定义渲染

“);
response.getWriter().write(“

Model: ” + model + “

“);
}
};
}
};
}
}
6.3 模板热部署
@Configuration
public class HotReloadConfig {

@Bean
public ViewResolver viewResolver() {
InternalResourceViewResolver resolver = new InternalResourceViewResolver();
resolver.setPrefix(“/WEB-INF/views/”);
resolver.setSuffix(“.jsp”);

// 开发环境热部署
if (isDevelopment()) {
resolver.setCache(false);
}

return resolver;
}

@Bean
public ThymeleafViewResolver thymeleafViewResolver() {
ThymeleafViewResolver resolver = new ThymeleafViewResolver();
resolver.setTemplateEngine(templateEngine());
resolver.setCharacterEncoding(“UTF-8”);

// 开发环境热部署
if (isDevelopment()) {
resolver.setCache(false);
}

return resolver;
}

@Bean
public SpringTemplateEngine templateEngine() {
SpringTemplateEngine engine = new SpringTemplateEngine();
engine.setTemplateResolver(templateResolver());
engine.setEnableSpringELCompiler(true);
return engine;
}

@Bean
public TemplateResolver templateResolver() {
TemplateResolver resolver = new TemplateResolver();
resolver.setPrefix(“classpath:/templates/”);
resolver.setSuffix(“.html”);
resolver.setTemplateMode(“HTML”);
resolver.setCharacterEncoding(“UTF-8”);

// 开发环境不缓存
if (isDevelopment()) {
resolver.setCacheable(false);
}

return resolver;
}

private boolean isDevelopment() {
return “dev”.equals(System.getProperty(“spring.profiles.active”));
}
}
七、实战项目示例
7.1 完整的用户管理系统
7.1.1 项目结构
src/main/java/com/example/
├── controller/
│ ├── UserController.java
│ └── DashboardController.java
├── service/
│ └── UserService.java
├── model/
│ └── User.java
└── config/
└── WebConfig.java

src/main/resources/
├── templates/
│ ├── layout/
│ │ ├── base.html
│ │ └── admin-layout.html
│ ├── user/
│ │ ├── list.html
│ │ ├── detail.html
│ │ └── form.html
│ └── dashboard.html
├── static/
│ ├── css/
│ └── js/
└── application.yml
7.1.2 核心控制器
@RestController
@RequestMapping(“/api/users”)
public class UserController {

@Autowired
private UserService userService;

@GetMapping
public ResponseEntity> getUsers(
@RequestParam(defaultValue = “0”) int page,
@RequestParam(defaultValue = “10”) int size) {
Pageable pageable = PageRequest.of(page, size);
return ResponseEntity.ok(userService.findAll(pageable));
}

@GetMapping(“/{id}”)
public ResponseEntity getUser(@PathVariable Long id) {
return userService.findById(id)
.map(ResponseEntity::ok)
.orElse(ResponseEntity.notFound().build());
}

@PostMapping
public ResponseEntity createUser(@Valid @RequestBody User user) {
User saved = userService.save(user);
return ResponseEntity.status(HttpStatus.CREATED).body(saved);
}

@PutMapping(“/{id}”)
public ResponseEntity updateUser(@PathVariable Long id,
@Valid @RequestBody User user) {
if (!userService.existsById(id)) {
return ResponseEntity.notFound().build();
}
user.setId(id);
return ResponseEntity.ok(userService.save(user));
}

@DeleteMapping(“/{id}”)
public ResponseEntity deleteUser(@PathVariable Long id) {
if (!userService.existsById(id)) {
return ResponseEntity.notFound().build();
}
userService.delete(id);
return ResponseEntity.noContent().build();
}
}
7.1.3 前端模板示例

八、调试和故障排除
8.1 启用调试日志
# application.yml
logging:
level:
org.springframework.web: DEBUG
org.thymeleaf: DEBUG
org.apache.velocity: DEBUG
org.springframework.web.servlet.view: DEBUG
8.2 常见错误及解决方案
8.2.1 ViewResolver配置错误
错误信息：
Could not resolve view with name ‘xxx’
解决方案：
// 检查视图解析器配置
@Bean
public ViewResolver viewResolver() {
InternalResourceViewResolver resolver = new InternalResourceViewResolver();
resolver.setPrefix(“/WEB-INF/views/”); // 确保路径正确
resolver.setSuffix(“.jsp”); // 确保后缀正确
return resolver;
}

// 在控制器中确认返回的视图名称
@GetMapping(“/test”)
public String test() {
System.out.println(“视图名称: test”); // 调试输出
return “test”; // 对应 /WEB-INF/views/test.jsp
}
8.2.2 模板找不到
错误信息：
Template not found
解决方案：
// Thymeleaf配置检查
@Configuration
public class ThymeleafConfig {

@Bean
public TemplateResolver templateResolver() {
TemplateResolver resolver = new TemplateResolver();
resolver.setPrefix(“classpath:/templates/”); // 确保路径正确
resolver.setSuffix(“.html”);
resolver.setTemplateMode(“HTML”);

// 开发环境调试
resolver.setCacheable(false);

return resolver;
}

@Bean
public SpringTemplateEngine templateEngine() {
SpringTemplateEngine engine = new SpringTemplateEngine();
engine.setTemplateResolver(templateResolver());

// 添加调试信息
engine.setEnableSpringELCompiler(true);

return engine;
}
}
8.2.3 模型数据未传递
错误信息：
Variable ‘xxx’ not found
解决方案：
// 确保模型数据正确传递
@GetMapping(“/user/{id}”)
public String getUser(@PathVariable Long id, Model model) {
User user = userService.findById(id);

// 调试输出
System.out.println(“用户数据: ” + user);
System.out.println(“模型属性: ” + model.asMap());

model.addAttribute(“user”, user); // 确保添加到模型
model.addAttribute(“title”, “用户详情”);

return “user/detail”;
}
九、总结
Spring MVC的模板渲染技术是构建现代Web应用的核心技能。通过本文的学习，您应该能够：
掌握基础配置
：正确配置各种模板引擎的视图解析器
熟练使用语法
：掌握Thymeleaf、JSP、FreeMarker的核心语法
解决常见问题
：处理缓存、国际化、布局、性能和安全等难题
实践最佳实践
：应用分页、异步加载、缓存等优化策略
调试和排错
：快速定位和解决模板渲染问题
9.1 技术选型建议
场景
推荐模板引擎
理由
新项目（Spring Boot）
Thymeleaf
官方推荐，自然模板，功能强大
传统Java EE项目
JSP
标准支持，兼容性好
邮件模板/静态生成
FreeMarker
强大的宏和函数，适合复杂逻辑
高性能要求
Thymeleaf + 缓存
编译后性能优秀
9.2 学习路径建议
入门阶段
：掌握一种模板引擎的基础语法
进阶阶段
：学习模板继承、国际化、表单处理
高级阶段
：掌握性能优化、安全防护、自定义扩展
实战阶段
：参与完整项目，解决实际问题
9.3 持续学习资源
官方文档
：
Spring MVC:
https://docs.spring.io/spring-framework/docs/current/reference/html/web.html
Thymeleaf:
https://www.thymeleaf.org/documentation.html
FreeMarker:
https://freemarker.apache.org/docs/
社区资源
：
Stack Overflow: 搜索Spring MVC相关问题
GitHub: 查看开源项目中的模板使用
博客：关注技术博客的最新实践
通过不断实践和学习，您将能够熟练运用Spring MVC的模板渲染技术，构建出高效、安全、易维护的Web应用。