如何在Spring Boot项目中集成FreeMarker？

提示信息

迷离

10月25日发表在 FreeMarker Java模板引擎阅读 24 评论 20 | 免费使用 “AI大模型GPT4.0” 提问

在Spring Boot项目中集成FreeMarker模板引擎，可以按照以下步骤进行：

创建Spring Boot项目：如果尚未创建项目，首先使用Spring Initializr（可以通过官方网页或者IDE内置工具）创建新的Spring Boot项目。选择所需的Spring Boot版本和基础依赖。
添加FreeMarker依赖：
在项目的pom.xml文件中添加FreeMarker依赖。在Spring Boot项目中，通常你只需要添加spring-boot-starter-freemarker这个起动器依赖，它会自动导入所需的FreeMarker库：
```
<dependency>  
   <groupId>org.springframework.boot</groupId>  
   <artifactId>spring-boot-starter-freemarker</artifactId>  
</dependency>  
```
对于使用Gradle的项目，可以在build.gradle文件中添加：
```
implementation 'org.springframework.boot:spring-boot-starter-freemarker'  
```

配置FreeMarker模板位置：
Spring Boot默认会在src/main/resources/templates目录下查找FreeMarker模板文件。你可以在application.properties或application.yml中自定义FreeMarker的设置，例如：

spring.freemarker.template-loader-path=classpath:/templates/  
spring.freemarker.suffix=.ftl  
spring.freemarker.charset=UTF-8  
spring.freemarker.check-template-location=true

或者在application.yml中配置：

spring:  
 freemarker:  
   template-loader-path: classpath:/templates/  
   suffix: .ftl  
   charset: UTF-8  
   check-template-location: true

创建FreeMarker模板文件：
在src/main/resources/templates目录中创建.ftl文件。例如创建index.ftl：

<!DOCTYPE html>  
<html>  
<head>  
   <title>Hello FreeMarker</title>  
</head>  
<body>  
   <h1>${message}</h1>  
</body>  
</html>

编写控制器：
创建Spring MVC控制器来处理Web请求并返回视图名称（.ftl文件的名称）和数据模型。例如：

import org.springframework.stereotype.Controller;  
import org.springframework.ui.Model;  
import org.springframework.web.bind.annotation.GetMapping;  
@Controller  
public class HomeController {  
   @GetMapping("/")  
   public String index(Model model) {  
       model.addAttribute("message", "Hello, FreeMarker!");  
       return "index"; // returns index.ftl  
   }  
}

运行项目：
启动Spring Boot应用程序，访问http://localhost:8080，如果一切配置正确，你应该能看到“Hello, FreeMarker!”的信息显示在页面上。

通过这些步骤，你可以成功地在Spring Boot项目中集成FreeMarker模板引擎，使用它来生成动态的HTML内容。

遇到难题？ "AI大模型GPT4.0、GPT" 是你的私人解答专家！点击按钮去提问......

迷离赞 | 0

最近一次登录：2024-10-26 10:50:30

暂时还没有签名，请关注我或评论我的文章

20条评论

按时间正序按时间倒序按喜欢排序

网名大全

10月30日

集成FreeMarker的步骤详细清晰，尤其是依赖的添加和配置，能帮助快速上手。

赞 0 回复举报

xianggelila： @网名大全

在整合FreeMarker时，除了配置依赖和基础设置，还可以添加一些常用的自定义配置，使模板更灵活。例如，可以设置默认编码和模板加载路径：

@Bean
public FreeMarkerConfigurer freemarkerConfig() {
    FreeMarkerConfigurer configurer = new FreeMarkerConfigurer();
    configurer.setTemplateLoaderPath("classpath:/templates/");
    configurer.setDefaultEncoding("UTF-8");
    return configurer;
}

通过这种方式，可以确保模板的正确读取和中文的支持。此外，结合FreeMarker与Spring MVC时，可以通过返回ModelAndView来更加灵活地管理模板和数据：

@GetMapping("/example")
public ModelAndView example() {
    ModelAndView modelAndView = new ModelAndView("example");
    modelAndView.addObject("message", "Hello, FreeMarker!");
    return modelAndView;
}

对于更复杂的项目，建议查看官方文档，以深入了解FreeMarker的强大功能和更多配置选项。

11月14日回复举报

添加新评论

痴心易碎

11月02日

创建FreeMarker模板文件的示例非常实用，能清楚地看到如何渲染数据，代码如下：

<h1>${message}</h1>

赞 0 回复举报

初礼： @痴心易碎

在FreeMarker模板中，除了展示简单的变量渲染，还可以通过控制结构进行更复杂的逻辑处理。例如，可以使用条件语句或循环来动态生成内容。以下是一个简单的示例，展示如何在FreeMarker中使用if语句和循环：

<#if users?? && users?size > 0>
    <h1>用户列表</h1>
    <ul>
        <#list users as user>
            <li>${user.name} - ${user.email}</li>
        </#list>
    </ul>
<#else>
    <h1>没有找到用户</h1>
</#if>

这个示例中，首先检查 users 集合是否存在且非空，如果有用户，则列出他们的姓名和邮箱；否则，显示“没有找到用户”的信息。这种方式使得生成的HTML更加灵活和动态。

进一步了解FreeMarker的使用，可以参考官方文档：FreeMarker Documentation。在Spring Boot项目中集成时，确保配置正确的视图解析器，以便于模板的渲染。通过结合Spring Boot的控制器，能够将数据直接传递到FreeMarker模板中，形成完整的MVC架构。

在实践中，多尝试使用不同的FreeMarker特性会有助于提升模板的可复用性和逻辑性。

刚才回复举报

添加新评论

看不透

11月09日

控制器部分讲解得当，能很快速地理解如何将数据和视图联系起来。尤其对初学者友好。

赞 0 回复举报

物是人非╰： @看不透

在Spring Boot中使用FreeMarker，确实很重要的是理解控制器与视图之间的连接。通过控制器将数据装填到模型中，FreeMarker模板引擎则负责将这些数据呈现在视图层中。这样可以很好地实现分层架构，增强代码的可维护性。

例如，以下是一个简单的控制器示例，展示了如何将数据传递给FreeMarker视图：

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class MyController {

    @GetMapping("/greet")
    public String greet(Model model) {
        model.addAttribute("message", "Hello, FreeMarker!");
        return "greet"; //对应greet.ftl模板
    }
}

在上面的示例中，控制器通过Model将一条信息传递给FreeMarker模板，然后该模板可以通过${message}来访问这条信息。在greet.ftl中：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Greeting</title>
</head>
<body>
    <h1>${message}</h1>
</body>
</html>

通过这种方式，初学者可以轻松地学习如何将数据绑定到视图，并理解MVC的基本原理。进一步深入学习，可以访问 Spring Boot with FreeMarker 以获取更详细的示例和最佳实践。

11月12日回复举报

添加新评论

结艺坊

4天前

对于配置FreeMarker位置的设置，建议大家结合其他模板引擎的使用，比如Thymeleaf，这样可以更灵活地处理不同的需求。

赞 0 回复举报

简单： @结艺坊

在集成FreeMarker与其他模板引擎（例如Thymeleaf）的过程中，可以通过配置不同的4个位置来增强项目的灵活性。例如，你可以将FreeMarker和Thymeleaf的模板放在同一目录下，并根据需要动态选择模板引擎进行渲染。

以下是一个简单的集成示例：

@Configuration
public class TemplateConfig {

    @Bean
    public FreeMarkerConfigurer freemarkerConfig() {
        FreeMarkerConfigurer configurer = new FreeMarkerConfigurer();
        configurer.setTemplateLoaderPath("/templates/");
        return configurer;
    }

    @Bean
    public ThymeleafViewResolver thymeleafViewResolver() {
        ThymeleafViewResolver resolver = new ThymeleafViewResolver();
        resolver.setTemplateEngine(templateEngine());
        resolver.setOrder(1); // 优先级设置
        return resolver;
    }

    @Bean
    public SpringTemplateEngine templateEngine() {
        SpringTemplateEngine templateEngine = new SpringTemplateEngine();
        // 可以在这里设置Thymeleaf的相关配置
        return templateEngine;
    }
}

通过上述配置，项目可以根据请求的类型或条件，灵活地使用FreeMarker或Thymeleaf。例如，可以基于URL路径的不同来决定使用哪个模板引擎。这样不仅可以复用现有模板，还能够提高开发和维护的效率。

对于更复杂的需求，可以考虑实现一个自定义的视图解析器，支持从同一请求中返回不同格式的视图。如欲深入了解，可以参考Spring Boot官方文档。

3天前回复举报

添加新评论

金峰

刚才

代码示例简单清晰，尤其是Controller部分，非常适合新手学习！

@GetMapping("/")
public String index(Model model) {
    model.addAttribute("message", "Hello, FreeMarker!");
    return "index";
}

赞 0 回复举报

蔚蓝天空： @金峰

在集成FreeMarker时，Controller部分的代码确实展示了如何灵活地使用模型数据输出到视图。我认为可以进一步探讨如何配置FreeMarker的视图解析器，以便更好地支持模板的加载。

可以通过在application.properties中进行如下配置：

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

这样，我们就能够将FreeMarker模板文件放置在src/main/resources/templates目录下，且文件后缀为.ftl，这会让项目结构更清晰，更易于管理。

另外，可以考虑使用@RequestMapping来处理其他路由，比如：

@GetMapping("/greet")
public String greet(@RequestParam(name = "name", defaultValue = "World") String name, Model model) {
    model.addAttribute("message", "Hello, " + name + "!");
    return "greet"; // 对应 greet.ftl 模板
}

这可以使得应用更具交互性，用户可以通过URL传递参数，显示不同的消息。如果想了解更多FreeMarker的使用，可以参考FreeMarker官方文档。这样的深入了解会帮助更好地掌握模板引擎的使用，提升项目的灵活性和可扩展性。

7天前回复举报

添加新评论

直尺

刚才

FreeMarker的集成过程相对简单，但对初学者可能会有些复杂，建议视频教程配合学习，比如可以参考 Spring Boot + FreeMarker 视频教程。

赞 0 回复举报

韦小翔： @直尺

在Spring Boot项目中集成FreeMarker的确是一个值得探索的过程。一种常用的方式是在application.properties文件中进行相关配置，比如：

spring.freemarker.prefix=classpath:/templates/
spring.freemarker.suffix=.ftl
spring.freemarker.charset=UTF-8

这样就能正确设置模板文件的存放路径和后缀名。此外，使用@Controller和ModelAndView来处理请求和返回视图也是非常常见的做法。例如：

@Controller
public class HelloController {

    @GetMapping("/hello")
    public ModelAndView hello() {
        ModelAndView mv = new ModelAndView("hello");
        mv.addObject("message", "Hello, FreeMarker!");
        return mv;
    }
}

在templates目录下创建一个hello.ftl文件，内容可以是：

<html>
<body>
    <h1>${message}</h1>
</body>
</html>

对于想要快速上手的开发者，建议多查阅一些社区分享的开源项目，或者观看视频教程，这样能更直观地理解整个流程。可以参考一些完整的示例项目，比如这个GitHub上的资源 Spring Boot + FreeMarker Example。

对于FreeMarker模板的灵活运用，了解其语法规则和功能可以极大提升开发效率，值得深入研究。

4天前回复举报

添加新评论

莫逆于心

刚才

能加入一些实战案例，比如如何处理列表数据展示，或者与数据库结合，将使文档更加完善。

赞 0 回复举报

炫彩流沙： @莫逆于心

在集成FreeMarker的实际应用中，展示列表数据和与数据库的结合确实是常见的需求。例如，可以通过Spring Data JPA从数据库中获取数据，并将其传递给FreeMarker模板进行展示。以下是一个简单的示例：

首先，定义一个实体类，例如User：

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;

    // Getters and Setters
}

接着，创建一个Repository接口：

public interface UserRepository extends JpaRepository<User, Long> {
    List<User> findAll();
}

然后，在Controller中，获取用户列表并将其传递给FreeMarker模板：

@Controller
public class UserController {

    @Autowired
    private UserRepository userRepository;

    @GetMapping("/users")
    public String listUsers(Model model) {
        List<User> users = userRepository.findAll();
        model.addAttribute("users", users);
        return "userList"; // 对应的FreeMarker模板
    }
}

最后，在FreeMarker模板userList.ftl中，我们可以渲染用户列表：

<html>
<body>
    <h2>User List</h2>
    <table>
        <tr>
            <th>ID</th>
            <th>Name</th>
            <th>Email</th>
        </tr>
        <#list users as user>
        <tr>
            <td>${user.id}</td>
            <td>${user.name}</td>
            <td>${user.email}</td>
        </tr>
        </#list>
    </table>
</body>
</html>

这样的案例展示既实用又可操作，能帮助理解如何在Spring Boot中灵活运用FreeMarker来处理动态数据展示。可以参考 Spring Boot Documentation 以获取更多相关信息和使用技巧。

5天前回复举报

添加新评论

飘雪的季节

刚才

在配置模板加载路径时，注意不同环境下路径的区分，使用相对路径有时会造成问题，建议明确路径标准化。

赞 0 回复举报

韦弘荃： @飘雪的季节

在Spring Boot项目中集成FreeMarker时，确实要特别注意模板加载路径的配置。使用相对路径有时可能会导致在不同环境间出现问题。我的建议是使用明确的绝对路径，确保在各个环境中都能正确加载模板。例如，可以这样配置FreeMarker的模板加载路径：

@Bean
public freemarker.template.Configuration freemarkerConfig() throws IOException {
    freemarker.template.Configuration config = new freemarker.template.Configuration(freemarker.template.Configuration.VERSION_2_3_31);
    config.setClassForTemplateLoading(this.getClass(), "/templates/");
    config.setDefaultEncoding("UTF-8");
    return config;
}

这个配置在使用setClassForTemplateLoading时，指定了模板的目录，确保在任何情况下都能正确找到模板文件。同时，也可以考虑将模板放在resources目录下，保持与代码的一致性，并避免在不同环境中路径问题。

另外，建议参考 Spring Boot官网的官方文档，获取更加详细的配置信息和建议。这样可以帮助更好地实现FreeMarker与Spring Boot的整合。

4天前回复举报

添加新评论

暗恋

刚才

很喜欢这种方式，FreeMarker确实是生成动态HTML的好工具。整合后开发效率高，而且模板逻辑清晰，利于资源管理。

赞 0 回复举报

别来： @暗恋

在Spring Boot项目中集成FreeMarker的确能显著提升开发效率。使用FreeMarker的模板语言来组织动态内容，不仅使代码结构更加清晰，还方便了团队协作和资源管理。

在具体实现中，可以通过在application.properties中设置FreeMarker的配置来简化模板加载。例如：

spring.freemarker.allow-request-override=true
spring.freemarker.prefix=classpath:/templates/
spring.freemarker.suffix=.ftl

这样就可以很方便地将模板文件放置在src/main/resources/templates目录下。同时，利用@Controller注解来处理请求非常直接。以下是一个简单的示例：

@Controller
public class HelloController {

    @GetMapping("/hello")
    public String hello(Model model) {
        model.addAttribute("name", "World");
        return "hello"; // 返回templates/hello.ftl的模板
    }
}

在hello.ftl模板中，可以采用如下方式来展示数据：

<!DOCTYPE html>
<html>
<head>
    <title>Hello</title>
</head>
<body>
    <h1>Hello, ${name}!</h1>
</body>
</html>

这种方式的优雅之处在于，模板逻辑清晰且容易维护，同时支持丰富的模板功能，能够有效地生成动态HTML。如果对FreeMarker的使用有更深入的需求，建议确认官方文档以获取更多高级特性和用法。

11月13日回复举报

添加新评论

格桑花

刚才

很高兴看到对FreeMarker的整合讲解，可以期望加入更复杂的模板逻辑和条件判断示例。比如：

<#if list?? && list?size > 0>
    <#list list as item>
        <p>${item}</p>
    </#list>
</#if>

赞 0 回复举报

治中： @格桑花

在FreeMarker模板中实现条件判断与循环时，像您提到的那种逻辑非常实用。除了在循环中处理列表，还可以利用FreeMarker的其他功能，增强模板的灵活性。可以考虑使用内置的键值过滤器以及函数来处理一些常见的格式问题。

例如，处理日期格式的情况，可以这样做：

<#if date??>
    <p>日期：${date?string("yyyy-MM-dd")}</p>
</#if>

通过这种方式，您不仅能够有效地处理空值，还能格式化输出，从而增强模板的可读性。

还可以结合?has_content判断非空字符串，在进行字符串的展示时非常有用：

<#if message?has_content>
    <p>消息：${message}</p>
</#if>

关于复杂逻辑的实现，可以参阅FreeMarker的官方网站，提供了丰富的模板语法示例与指南，帮助更深入理解如何运用这些功能：FreeMarker Documentation。

通过这些方式，能够让模板的逻辑更为清晰，也提升了维护性。希望以后能看到更多详细的示例及技术探讨！

刚才回复举报

添加新评论

免费图表工具，画流程图、架构图

如何在Spring Boot项目中集成FreeMarker？

举报评论

删除

删除后，将不可回复，确认要删除？

提示

复制代码，请先登录