如何在Freemarker模板中调用反射方法并处理注解的nullable属性？

嘿，这个问题我刚好踩过坑，给你几个实用的解决方案：

方案一：提前在Java层预处理数据（最推荐） #

Freemarker本质是视图层模板，更适合做数据展示而非复杂的反射逻辑。最稳妥的方式是在Java后端把需要的nullable值提前处理好，封装成Map或者DTO，再传到模板里直接遍历展示。

举个具体的例子：
假设你有个实体类User，字段上有自定义注解@MyNullable（包含nullable()方法），可以写一个工具方法把字段名和对应的nullable值封装成Map：

public Map<String, Boolean> extractFieldNullableInfo(Class<?> targetClass) {
    Map<String, Boolean> nullableMap = new HashMap<>();
    for (Field field : targetClass.getDeclaredFields()) {
        MyNullable nullableAnnotation = field.getAnnotation(MyNullable.class);
        // 有注解就取nullable值，默认设为false
        boolean isNullable = nullableAnnotation != null ? nullableAnnotation.nullable() : false;
        nullableMap.put(field.getName(), isNullable);
    }
    return nullableMap;
}

然后把这个Map放到模板上下文里：

// 假设用Spring MVC，把数据传到模板
model.addAttribute("fieldNullableMap", extractFieldNullableInfo(User.class));

最后在Freemarker模板里直接遍历展示：

<#list fieldNullableMap?keys as fieldName>
    ${fieldName}: ${fieldNullableMap[fieldName]}
</#list>

这种方式把复杂的反射逻辑放在Java层，模板只负责渲染，不仅符合MVC的职责划分，也更容易维护和排查问题。

方案二：自定义Freemarker方法封装反射逻辑 #

如果必须在模板里处理，可以通过自定义Freemarker方法把反射调用的逻辑封装起来，绕开模板不能直接调用method.invoke()的限制。

首先写一个实现TemplateMethodModelEx的自定义方法类：

public class GetNullableValueMethod implements TemplateMethodModelEx {
    @Override
    public Object exec(List<?> arguments) throws TemplateModelException {
        // 校验参数数量：需要传入字段对象和注解对象
        if (arguments.size() != 2) {
            throw new TemplateModelException("参数错误：需要传入字段对象和注解对象");
        }
        try {
            // 从Freemarker的包装对象中取出真实的Field和Annotation实例
            Field field = (Field) ((SimpleObject) arguments.get(0)).getWrappedObject();
            Annotation annotation = (Annotation) ((SimpleObject) arguments.get(1)).getWrappedObject();
            
            // 调用注解的nullable方法并返回结果
            Method nullableMethod = annotation.annotationType().getMethod("nullable");
            return nullableMethod.invoke(annotation);
        } catch (NoSuchMethodException | IllegalAccessException | InvocationTargetException e) {
            throw new TemplateModelException("获取nullable值失败", e);
        }
    }
}

然后把这个自定义方法注册到Freemarker配置中：

Configuration freemarkerCfg = new Configuration(Configuration.VERSION_2_3_32);
// 注册自定义方法，模板里用${getNullableValue(...)}调用
freemarkerCfg.setSharedVariable("getNullableValue", new GetNullableValueMethod());

最后在模板里调用这个方法：

<#list userClass.declaredFields as field>
    <#assign nullableAnnotation = field.getAnnotation("com.example.MyNullable")>
    <#if nullableAnnotation??>
        ${field.name}: ${getNullableValue(field, nullableAnnotation)}
    <#else>
        ${field.name}: false
    </#if>
</#list>

为什么Freemarker里不能直接调用method.invoke()？ #

Freemarker的模板语言做了安全限制，默认不允许调用反射相关的方法（比如Method.invoke()），一方面是为了防止模板执行危险操作，另一方面也是为了让模板更专注于视图渲染，避免混入复杂的业务逻辑。

内容的提问来源于stack exchange，提问作者Rasool Ghafari