17370845950

freemarker 模板中直接使用 `isxxx()` 方法名会导致“期望 boolea

n 却得到 method+sequence”错误；应优先访问对应 javabean 属性（如 `xxx`），或显式调用方法（`isxxx()`）并加括号，确保获取返回值而非方法引用。

在 FreeMarker 中对布尔值做条件判断时，常见误区是将 Java Bean 的 getter 方法名（如 isOtherInsurance()）直接当作属性使用：

<#if documentData.isOtherInsurance>  

FreeMarker 默认遵循 JavaBeans 规范：若类中定义了形如 public boolean isOtherInsurance() 的方法，它会自动将其映射为名为 otherInsurance 的属性（即去掉 is 前缀，首字母小写）。因此，推荐写法是直接访问属性名：

<#if documentData.otherInsurance>
  
✔ Да
<#else>
  
✘ Нет

✅ 这样 FreeMarker 会自动调用 isOtherInsurance() 并取其返回的 boolean 值，语义清晰且符合模板最佳实践。

⚠️ 若因历史原因无法修改 Java 类（例如方法声明为 public Boolean isOtherInsurance() — 返回 Boolean 而非原始 boolean），或该方法未遵循标准命名（如误写为 getIsOtherInsurance()），则需显式调用方法并加括号，强制执行：

<#if documentData.isOtherInsurance()>
  
✔ Да
<#else>
  
✘ Нет

注意：() 不可省略，否则 documentData.isOtherInsurance 仍表示方法引用（SimpleMethodModel），而非执行结果。

? 补充建议：

• 避免在 Java 端使用 Boolean isXxx()（包装类型 + is 前缀），易引发空指针与模板兼容问题；应统一为 boolean isXxx() 或 Boolean getXxx()；
• 在模板中可结合默认值操作增强健壮性，例如 （仅当属性可能为 null 且 Java 类型为 Boolean 时适用）；
• 使用 ?has_content 或 ?? 判断存在性前，请确认目标确实是字符串或容器类型——对布尔值不适用。

总之，核心原则是：FreeMarker 条件表达式中必须出现一个明确的 boolean 值，而非方法、null 或其他类型。通过规范 Java Bean 命名或显式方法调用，即可彻底规避此类类型错误。