将 java.lang.Iterable 视为 Freemarker 中的 #list 表达式

Question

我有一个 java.lang.Iterable （实际上是一个 com.google.gson.JsonArray 实例）。

我想使用 freemarker (2.3.16) 枚举列表中的项目。

[#assign sports = controller.sports]
[#-- At this point, sports is bound to a com.google.gson.JsonArray instance. --]

[#list sports as sport]
  ${sport_index}
[/#list]

我希望避免编写自定义 bean 和 Gson 反序列化器只是为了获得显式的项目集合。使用 Gson（它已经为我将 JSON 字符串反序列化为 JsonObject）然后从该 JsonObject 创建我自己的对象 DAG 对我来说似乎很浪费。

不幸的是，我无法找到一种方法让 Freemarker 将 java.lang.Iterable 视为列表。我得到：

freemarker.template.TemplateException : Expected collection or sequence.
  controller.sports evaluated instead to freemarker.ext.beans.XMLStringModel on line 8, column 16 in sports.html.
freemarker.core.TemplateObject.invalidTypeException(line:135)
freemarker.core.IteratorBlock$Context.runLoop(line:190)
freemarker.core.Environment.visit(line:417)
freemarker.core.IteratorBlock.accept(line:102)
freemarker.core.Environment.visit(line:210)

Answer 1

显式循环迭代器应该可以工作，例如：

[#list sports.iterator() as sport]
   ${sport_index}
[/#list]

Answer 2

您所要做的就是将 JsonArray 上的 iterator() 结果添加到上下文中。 Freemarker 足够智能，可以从那里处理它，并且您可以在模板中引用它，就像处理任何其他类似列表的变量一样。

Answer 3

Freemarker 现在支持 Iterable，通过以下方式创建 freemarker 配置：

configuration = new Configuration(VERSION_2_3_28);
DefaultObjectWrapper objectWrapper = new DefaultObjectWrapper(VERSION_2_3_28);
objectWrapper.setIterableSupport(true);
configuration.setObjectWrapper(objectWrapper);

并更新到 2.3.28 版本（我不太确定哪个版本添加了此功能，但 .23 没有它），然后只需实例化您的 Template 并传入该配置即可。

return new Template("somename", someReader, configuration);