Freemarker模板引擎NonHashException：字符串比较的正确方式-java教程-PHP中文网

Freemarker模板引擎NonHashException：字符串比较的正确方式

碧海醫心

发布： 2025-06-30 18:32:26

原创

459人浏览过

freemarker模板引擎nonhashexception：字符串比较的正确方式

本文旨在解决在使用Apache Freemarker模板引擎时遇到的NonHashException，该异常通常发生在尝试访问字符串属性时，提示期望一个哈希值却得到了字符串。文章将详细解释Freemarker中字符串比较的正确方法，并提供示例代码，帮助开发者避免类似错误，提高模板开发效率。

在使用Freemarker模板引擎时，开发者可能会遇到freemarker.core.NonHashException异常，特别是当处理字符串比较时。这个异常通常表明Freemarker期望一个哈希（类似于Java中的Map或对象），但实际却得到了一个字符串。本文将深入探讨这个问题，并提供解决方案。

问题分析

在Java代码中，使用.equals()方法比较字符串的内容是很常见的做法。然而，在Freemarker模板中，情况有所不同。Freemarker对字符串的处理方式与Java有所区别，直接使用.equals()方法可能会导致NonHashException。

考虑以下示例，假设有一个名为previousSearch的对象，其中包含一个名为status的字符串属性：

import lombok.Data;

@Data
public class TicketSearchForm {
    private String status = "ALL";
    //More fields...
}

登录后复制

在Freemarker模板中，尝试使用.equals()方法进行字符串比较：

<select name="status" id="status" class="form-control select2">
    <option value="ALL" <#if previousSearch.getStatus().equals("ALL")>selected</#if>>Alle anzeigen</option>
    <option value="OPEN" <#if previousSearch.status.equals("OPEN")>selected</#if>>Offen</option>
    <option value="DONE" <#if previousSearch.status.equals("DONE")>Geschlossen</option>
</select>

登录后复制

这段代码可能会抛出NonHashException，因为Freemarker不推荐使用.equals()方法进行字符串比较。

解决方案

在Freemarker中，应该使用==运算符来比较字符串。这与Java中比较对象引用是否相等不同，在Freemarker中，==运算符用于比较字符串的内容是否相等。

修改上面的示例代码，使用==运算符进行字符串比较：

<select name="status" id="status" class="form-control select2">
    <option value="ALL" <#if previousSearch.status == "ALL">selected</#if>>Alle anzeigen</option>
    <option value="OPEN" <#if previousSearch.status == "OPEN">selected</#if>>Offen</option>
    <option value="DONE" <#if previousSearch.status == "DONE">Geschlossen</option>
</select>

登录后复制

通过将.equals()替换为==运算符，可以避免NonHashException，并正确地比较字符串的内容。

示例代码

以下是一个更完整的示例，展示了如何在Spring MVC中使用Freemarker进行字符串比较：

Java Controller:

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

@Controller
public class TicketController {

    @GetMapping("/search")
    public String search(Model model) {
        TicketSearchForm previousSearch = new TicketSearchForm();
        previousSearch.setStatus("OPEN"); // 设置初始状态
        model.addAttribute("previousSearch", previousSearch);
        return "ticket/search";
    }
}

登录后复制

Freemarker Template (ticket/search.ftlh):

<!DOCTYPE html>
<html>
<head>
    <title>Ticket Search</title>
</head>
<body>
    <h1>Ticket Search Form</h1>
    <select name="status" id="status" class="form-control select2">
        <option value="ALL" <#if previousSearch.status == "ALL">selected</#if>>Alle anzeigen</option>
        <option value="OPEN" <#if previousSearch.status == "OPEN">selected</#if>>Offen</option>
        <option value="DONE" <#if previousSearch.status == "DONE">Geschlossen</option>
    </select>
</body>
</html>

登录后复制

在这个例子中，Controller将TicketSearchForm对象传递给Freemarker模板。模板使用==运算符比较previousSearch.status属性与不同的字符串值，从而正确地设置

注意事项

空值处理: 在进行字符串比较之前，确保要比较的字符串不为空。可以使用Freemarker的?has_content指令来检查变量是否为空。
```
<#if previousSearch.status?? && previousSearch.status == "OPEN">
    ...
</#if>
```
登录后复制
大小写敏感: Freemarker的字符串比较是大小写敏感的。如果需要进行大小写不敏感的比较，可以使用?lower_case或?upper_case指令将字符串转换为统一的大小写形式。
```
<#if previousSearch.status?lower_case == "open">
    ...
</#if>
```
登录后复制

总结

在使用Freemarker模板引擎时，理解其字符串比较的特殊性至关重要。通过使用==运算符而不是.equals()方法，可以避免NonHashException，并正确地进行字符串比较。此外，注意空值处理和大小写敏感性，可以编写出更健壮、更可靠的Freemarker模板。掌握这些技巧将有助于提高模板开发效率，并减少潜在的错误。

以上就是Freemarker模板引擎NonHashException：字符串比较的正确方式的详细内容，更多请关注php中文网其它相关文章！