Freemarker模板引擎：解决NonHashException，正确比较字符串

本文旨在解决在使用Apache Freemarker模板引擎时，遇到的freemarker.core.NonHashException: Expected a hash, but this has evaluated to a string 错误。通过分析问题原因，提供使用Freemarker比较字符串的正确方法，帮助开发者避免类似错误，提升开发效率。

问题分析

在使用Freemarker模板引擎时，你可能会遇到如下错误：

freemarker.core.NonHashException: For "." left-hand operand: Expected a hash, but this has evaluated to a string (wrapper: f.t.SimpleScalar):
==> previousSearch.status  [in template "ticket/search.ftlh" at line 22, column 66]

这个错误通常发生在尝试访问一个字符串的属性时，例如，使用.equals()方法。Freemarker认为.操作符是用来访问哈希（类似于Java中的Map或对象）的属性的，而你却试图在一个字符串上使用它。

例如，以下代码可能会导致该错误：

<#if previousSearch.status.equals("ALL")>
  ...
</#if>

在这个例子中，previousSearch.status被认为是字符串，而.equals()方法是Java中字符串的方法，Freemarker并不直接支持这种用法。

解决方案：使用 == 比较字符串

在Freemarker中，比较字符串应该使用 == 操作符，而不是 .equals() 方法。

修改后的代码如下：

<#if previousSearch.status == "ALL">
  ...
</#if>

这样，Freemarker就能正确地比较字符串，避免NonHashException错误。

示例代码

假设你有一个名为 ticketSearchForm 的对象，包含一个 status 属性，你想根据 status 的值来设置 标签的默认选项。

import lombok.Data;

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

Freemarker模板代码如下：

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

在这个例子中，我们使用 == 操作符来比较 ticketSearchForm.status 属性的值，从而正确地设置 标签的默认选项。

注意事项

• Freemarker与Java的区别： 务必记住，Freemarker与Java在处理字符串的方式上存在差异。不要将Java的习惯带入Freemarker模板中。

• 空值处理： 在比较字符串之前，最好先检查变量是否为空。可以使用 ?has_content 指令来判断变量是否存在且不为空。例如：

  <#if ticketSearchForm.status?? && ticketSearchForm.status == "ALL">
    ...
  </#if>

  登录后复制

  或者使用 ?default('') 来设置默认值，避免空指针异常。

  <#if (ticketSearchForm.status?default('')) == "ALL">
    ...
  </#if>

  登录后复制

• 其他数据类型： == 操作符也适用于比较其他数据类型，例如数字和布尔值。

总结

在使用Freemarker模板引擎时，正确理解其语法和特性至关重要。特别是字符串比较，要记住使用 == 操作符，而不是 .equals() 方法。通过本文的讲解和示例，希望能帮助你解决NonHashException错误，编写出更加健壮和可维护的Freemarker模板代码。记住在比较之前进行判空处理，可以提高代码的健壮性。

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