在 Freemarker 宏中模拟空参数

Question

我正在使用 Freemarker 构建一个网站，并开始大量使用宏。我知道在 Freemarker 2.3 中将 null 值作为参数传递给宏相当于根本不传递参数，因此我创建了一个名为“null”的全局变量来模拟宏中的 null 检查：

<#assign null="NUL" />

现在在我的宏中我可以这样做：

<#maco doSomething param1=null>
  <#if param1 != null>
    <div>WIN!</div>
  </#if>
</#macro>

如果我想传递一个不是标量的参数，问题就来了。例如，将 List（在 Freemarker 中是 SimpleSequence）传递给宏并检查我的 null 关键字会产生错误：

freemarker.template.TemplateException： 唯一合法的比较是 两个数字、两个字符串或两个 日期。左手操作数是 freemarker.template.SimpleSequence 右手操作数是 freemarker.template.SimpleScalar

我查看了freemarker代码，我可以看到问题（ComparisonExpression.isTrue()）：

if(ltm instanceof TemplateNumberModel && rtm instanceof TemplateNumberModel) { 
  ...
}
else if(ltm instanceof TemplateDateModel && rtm instanceof TemplateDateModel) {
  ...
}
else if(ltm instanceof TemplateScalarModel && rtm instanceof TemplateScalarModel) {
  ...
}
else if(ltm instanceof TemplateBooleanModel && rtm instanceof TemplateBooleanModel) {
  ...
}
// Here we handle compatibility issues
else if(env.isClassicCompatible()) {
  ...
}
else {
  throw new TemplateException("The only legal comparisons...", env);
}

所以我能想到的唯一解决方案是将 isClassicCompatible 设置为 true，我认为这会在两个对象上调用 toString() 并比较结果。但是，文档明确指出，任何依赖旧功能的东西都应该重写。

我的问题是，是否有不依赖于已弃用功能的解决方案？

Answer 1

null 引用是 FreeMarker 中的设计错误。由于您提到的原因，定义自定义 null 值（它是一个字符串）并不是一个好主意。应使用以下结构：

• 宏和函数参数可以有默认值，所以调用者可以省略它们
• 要检查变量是否为null，您应该使用?? 运算符：<#if (name??)>
• 当你使用一个可以是null的变量时，你应该使用!操作符来指定一个默认值：name!"No name"
• 要检查序列（或字符串）是否为空，请使用 ?has_content 内置函数：<#if (names?has_content)>

你可以在宏中指定一个空序列作为默认参数值，并简单地测试它是否为空。

Answer 2

一位同事建议空值检查功能可能是最优雅的解决方案：

<#assign null="NUL" />

<#function is_null variable>
  <#if variable?is_string & variable == null>
    <#return true />
  <#else>
    <#return false />
  </#if>
</#function>

带着这个想法，我在mailing list中找到了另一种可能的解决方案，即通过扩展TemplateMethodModelEx在Java中创建一个空检查函数。然后我可以将它直接插入到我的模型映射中，并让它在我的所有模板中全局可用。生成的 Freemarker 代码非常干净：

<#maco doSomething param1=null>
  <#if !is_null(param1)>
    <div>WIN!</div>
  </#if>
</#macro>

这似乎是在宏中模拟空参数的最佳方式。

Answer 3

您可以先检查它是否不是标量：

<#if !param1?is_scalar || param1 != null)>

Answer 4

这是我所做的，这似乎在大多数情况下都有效：

默认值应该是空字符串，null-check应该是?has_content。

<#macro someMacro optionalParam="" >
    <#if (optionalParam?has_content)>
        <#-- NOT NULL -->
    <#else>
        <#-- NULL -->
    </#if>
</#macro>

Answer 5

这是另一种可能适合您需要的解决方案。

<#macro el user={}>
...
<input type="text" class="form-control" name="firstName"
                                       value="${(user.identity.firstName)!''}">
...
</#macro>

我定义了一个默认的空对象 {} 而不是 null 以避免在我的元素中出现 2 个大 if else 块。

确保当您为属性（在我的情况下为 firstName）提供默认值时，将括号放在所有表达式中，然后 !签名。

所以无论identity 未定义或firstName 未定义，freemarker 都使用默认值

(user.identity.firstName)!''

Answer 6

实际上我不明白为什么不允许使用空值。我有一个 java 函数来检索具有给定可选/可为空参数（如 height）的特定图像 URL。

我使用以下解决方法为它编写了一个宏：

Java 函数

/**
 * Converts the given value to <code>null</code> if it equals the default
 * value, else returns it directly.
 *
 * @param value
 * @param defaultValue
 *
 * @return
 */
public static Object nullIfDefault(final Object value, final Object defaultValue)
{
    if (value != null && value.equals(defaultValue))
        return null;
    return value;
}

/**
 * Converts the given value to <code>null</code> if it equals an empty
 * string, else returns it directly.
 *
 * @param value
 *
 * @return
 */
public static Object nullIfEmpty(final Object value)
{
    return ObjectUtils.nullIfDefault(value, "");
}

宏

导入静态函数

<#assign ObjectUtils=statics['com.example.ObjectUtils']/>

<#macro compEntityImage imageRetriever entity height="" width="">

    <img src="${imageRetriever.getMediaFileUrl(entity, 
        ObjectUtils.nullIfEmpty(height), 
        ObjectUtils.nullIfEmpty(width))}">

</#macro>

标记

<@compEntityImgage imageRetriever=imageRetriver entity=product height=500/>