Freemarker NonHashException: 如何正确访问模板中的对象属性

第一段引用上面的摘要

本文旨在解决在使用 Apache Freemarker 模板引擎时遇到的 NonHashException 异常，该异常通常发生在尝试访问对象属性时，Freemarker 却将对象识别为字符串。通过分析问题原因和提供解决方案，帮助开发者正确地在 Freemarker 模板中访问和使用对象属性，避免类型不匹配导致的错误。

在使用 Spring Boot 和 Apache Freemarker 构建 Web 应用时，经常需要将 Java 对象传递到 Freemarker 模板中进行渲染。然而，有时会遇到 freemarker.core.NonHashException 异常，提示 "Expected a hash, but this has evaluated to a string"。 这通常发生在试图通过点号（.）访问对象属性时，Freemarker 引擎错误地将该对象识别为字符串。

问题分析

Freemarker 模板引擎对数据类型的处理与 Java 有所不同。当你在模板中使用点号（.）访问对象属性时，Freemarker 期望左侧的操作数是一个哈希表（Hash），也就是一个可以像 Map 一样通过键值对访问数据的对象。 如果 Freemarker 认为左侧的操作数是一个字符串，就会抛出 NonHashException 异常。

例如，假设你有一个 Java 类 TicketSearchForm，包含一个 status 属性：

import lombok.Data;

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

你将 TicketSearchForm 对象 previousSearch 传递到 Freemarker 模板中，并尝试使用以下代码进行比较：

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

这段代码在 Java 中是完全有效的，但是在 Freemarker 中却可能抛出 NonHashException 异常。

解决方案

问题的根源在于 Freemarker 处理字符串的方式与 Java 不同。在 Freemarker 中，字符串比较应该使用 == 运算符，而不是 equals() 方法。

因此，正确的 Freemarker 代码应该如下所示：

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

将 equals() 方法替换为 == 运算符后，Freemarker 就可以正确地比较字符串，避免 NonHashException 异常。

示例代码

以下是一个完整的示例，展示了如何在 Freemarker 模板中使用 == 运算符比较字符串：

  Alle anzeigen
  selected>Offen
  selected>Geschlossen

在这个例子中，previousSearch.status 属性的值将与 "ALL"、"OPEN" 和 "DONE" 进行比较，如果匹配，则对应的 标签将被标记为 selected。

注意事项

• 字符串比较： 在 Freemarker 中，始终使用 == 运算符进行字符串比较，而不是 equals() 方法。
• 对象属性访问： 确保传递到 Freemarker 模板中的对象属性是可访问的，并且具有正确的类型。
• 数据模型： 仔细检查传递到 Freemarker 模板中的数据模型，确保包含所有需要的属性，并且属性名称正确。
• 异常信息： 仔细阅读 Freemarker 抛出的异常信息，通常可以提供有关问题的线索。

总结

NonHashException 异常是 Freemarker 中常见的错误，通常是由于字符串比较方式不正确导致的。通过使用 == 运算符代替 equals() 方法，可以有效地解决这个问题。此外，还需要注意对象属性的访问权限和数据模型的正确性，以确保 Freemarker 模板能够正确地渲染数据。理解 Freemarker 的数据类型处理方式，是避免此类问题的关键。

以上就是Freemarker NonHashException: 如何正确访问模板中的对象属性的详细内容，更多请关注php中文网其它相关文章！