本文旨在解决在使用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模板。掌握这些技巧将有助于提高模板开发效率，并减少潜在的错误。
