Spring Freemarker詳解

一、什麼是Spring Freemarker

Spring Freemarker是一個Spring MVC的模板引擎，它基於Freemarker模板引擎，提供了一種方便的方式來處理模板頁面，並且與Spring框架集成。

Spring Freemarker可以幫助我們更好地處理MVC模型中的視圖層問題，使用Freemarker提供的強大功能，可以實現更加靈活和易於維護的視圖層。

二、怎樣使用Spring Freemarker

使用Spring Freemarker非常簡單，我們只需要添加對應的依賴，然後配置Spring MVC即可。下面是一個基本的Spring Freemarker配置：

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

    <bean id="viewResolver" class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
        <property name="prefix" value="/WEB-INF/views/" />
        <property name="suffix" value=".ftl" />
        <property name="cache" value="true" />
        <property name="contentType" value="text/html;charset=UTF-8" />
    </bean>

    <bean id="freemarkerConfig" class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
        <property name="templateLoaderPath" value="/WEB-INF/views/" />
        <property name="defaultEncoding" value="UTF-8" />
    </bean>

在這個配置中，我們使用了Spring Boot的starter-freemarker依賴，以及FreeMarker的視圖解析器和配置器。我們指定了視圖頁面所在的路徑，以及對應的後綴名，同時還設置了緩存和字元編碼。

三、Freemarker基礎語法

下面我們看一下Freemarker模板引擎的基礎語法。

1、輸出變數：
要輸出一個變數，我們只需要使用${}語法即可，例如：

    <p>Hello, ${name}!</p>

這個語法會在模板頁面渲染時將變數name的值輸出到頁面。

2、條件判斷：
我們可以使用if語句來進行條件判斷，例如：

    <#if user?has_content>
        <p>Welcome, ${user}!</p>
    </#if>

這個語法會判斷變數user是否存在內容，如果存在就輸出歡迎信息。

3、循環：
我們可以使用list或array變數的一個有用的指令是list、array和sequence。例如：

    <#list users as user>
        <p>User: ${user}</p>
    </#list>

這個語法會循環遍歷變數users中的所有用戶，並輸出每個用戶的信息。

四、Spring Freemarker實戰應用

下面我們來看一個簡單的Spring Freemarker實戰應用。

1、創建一個簡單的Spring Boot項目：

    spring init --dependencies=web,thymeleaf,database my-project

2、添加對應的依賴，包括spring-boot-starter-freemarker和mysql-connector-java。

3、創建一個User實體類，包括id、name、age等屬性，以及對應的getter和setter方法。

4、創建一個UserRepository介面，繼承CrudRepository，用於操作User的數據。

    public interface UserRepository extends CrudRepository<User, Long> {
        List<User> findAll();
        User findById(long id);
        void deleteById(long id);
    }

5、創建一個UserServiceImpl實現類，用於實現從資料庫中獲取User信息的方法。

    @Service
    public class UserServiceImpl implements UserService {
        @Autowired
        private UserRepository userRepository;
        @Override
        public List<User> getUsers() {
            return userRepository.findAll();
        }
        @Override
        public User getUserById(long id) {
            return userRepository.findById(id);
        }
        @Override
        public void deleteUser(long id) {
            userRepository.deleteById(id);
        }
    }

6、創建一個UserController類，用於將User信息傳遞給Freemarker模板展示。

    @Controller
    public class UserController {
        @Autowired
        private UserService userService;
        @RequestMapping("/")
        public String index(Model model) {
            List<User> users = userService.getUsers();
            model.addAttribute("users", users);
            return "index";
        }
    }

7、創建一個index.ftl的模板文件，用於展示用戶信息。

    <!DOCTYPE html>
    <html>
    <head>
        <meta charset="UTF-8">
        <title>User List</title>
    </head>
    <body>
        <h1>User List</h1>
        <#if users?has_content>
            <#list users as user>
                <li>${user.name}, ${user.age}</li>
            </#list>
        </#if>
    </body>
    </html>

最後我們啟動應用，訪問http://localhost:8080/，我們就可以看到所有用戶的信息展示出來了。

五、總結

Spring Freemarker是一個非常實用的Spring MVC的模板引擎，它讓我們可以更加方便地處理MVC模型中的視圖層問題，並且提供了很多強大的功能和語法。通過實戰應用，我們可以看到Spring Freemarker的用法非常簡單，只需要配置好依賴和視圖解析器即可快速上手。

原創文章，作者：小藍，如若轉載，請註明出處：https://www.506064.com/zh-tw/n/311266.html