SpringMVC 中的视图如何使用 FreeMarker

缺乏、安全感 2023-10-13 14:35 73阅读 0赞

## SpringMVC 中的视图如何使用 FreeMarker ##

SpringMVC 是一个基于 Spring 框架的 Web 框架，它提供了一种方便的方式来处理 HTTP 请求和响应。在 SpringMVC 中，视图是用来渲染模型数据的组件，它们负责将模型数据转换为 HTML、JSON、XML 等格式的响应。在本文中，我们将讨论如何在 SpringMVC 中的视图中使用 FreeMarker 渲染模型数据。

![在这里插入图片描述][6028971dd3f940a29f19fb57d6031ca3.png]

### FreeMarker 简介 ###

FreeMarker 是一个开源的模板引擎，它可以将模型数据渲染为 HTML、XML、JSON 等格式的文本。FreeMarker 的语法简单易懂，开发效率高，因此在 SpringMVC 中被广泛使用。

### 集成 FreeMarker ###

在 SpringMVC 中，使用 FreeMarker 渲染视图需要进行一些配置。下面是配置 FreeMarker 的步骤：

1.  添加 FreeMarker 依赖

在 pom.xml 文件中添加以下依赖：

<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-freemarker</artifactId>
    </dependency>

1.  配置 FreeMarker

在 application.properties 文件中添加以下配置：

spring.freemarker.template-loader-path=classpath:/templates/
    spring.freemarker.suffix=.ftl

在上面的配置中，我们指定 FreeMarker 模板文件的位置和后缀名。

1.  编写 FreeMarker 模板

在 src/main/resources/templates 目录下创建一个 index.ftl 文件，内容如下：

<!DOCTYPE html>
    <html>
    <head>
      <meta charset="UTF-8">
      <title>${title}</title>
    </head>
    <body>
      <h1>${title}</h1>
      <ul>
        <#list items as item>
          <li>${item}</li>
        </#list>
      </ul>
    </body>
    </html>

在上面的 FreeMarker 模板中，使用 FreeMarker 的语法将模型数据渲染到 HTML 页面中。`${title}` 和 `${items}` 分别代表模型中的 title 和 items 属性。

1.  编写控制器

在控制器中设置模型数据并返回 FreeMarker 视图：

@Controller
    public class HomeController {
        
      
      @GetMapping("/")
      public String home(Model model) {
        
        model.addAttribute("title", "Welcome to my website");
        model.addAttribute("items", Arrays.asList("Item 1", "Item 2", "Item 3"));
        return "index";
      }
      
    }

在上面的控制器中，我们通过 `model.addAttribute` 方法将 title 和 items 属性添加到模型中，并将视图名称设置为 “index”。SpringMVC 会自动查找名为 “index” 的 FreeMarker 模板文件，并将模型数据渲染到 HTML 页面中。

### FreeMarker 的语法 ###

FreeMarker 的语法类似于 JSP 和 Thymeleaf，下面是一些常用的语法：

#### 输出变量 ####

输出变量的语法为 `${variable}`，其中 variable 代表模型中的属性名称。

#### 条件语句 ####

使用 `<#if>` 和 `<#else>` 可以编写条件语句。例如：

<#if user.isAdmin>
      <p>Welcome Admin</p>
    <#else>
      <p>Welcome User</p>
    </#if>

#### 循环语句 ####

使用 `<#list>` 和 `<#items>` 可以编写循环语句。例如：

#### 宏定义 ####

使用 `<#macro>` 可以定义一个宏。例如：

<#macro hello name>
      <p>Hello ${name}!</p>
    </#macro>
    
    <@hello name="John" />

在上面的代码中，我们定义了一个名为 hello 的宏，它接受一个名为 name 的参数。在模板中使用 `<@hello name="John" />` 可以调用宏并传递参数。

### 总结 ###

在本文中，我们介绍了如何在 SpringMVC 中使用 FreeMarker 渲染视图。首先，我们需要添加 FreeMarker 依赖并配置 FreeMarker。然后，我们编写了一个简单的 FreeMarker 模板文件和一个控制器，展示了如何将模型数据渲染到 HTML 页面中。最后，我们介绍了 FreeMarker 的语法，包括输出变量、条件语句、循环语句和宏定义。

使用 FreeMarker 可以帮助我们更方便地渲染模型数据，提高开发效率。如果您正在开发一个 SpringMVC 应用程序，并且需要渲染模型数据，可以考虑使用 FreeMarker。

[6028971dd3f940a29f19fb57d6031ca3.png]: https://img-blog.csdnimg.cn/6028971dd3f940a29f19fb57d6031ca3.png