关于在freemarker模板中遍历数据模型List的经验

时间 2019-11-13

标签关于 freemarker 模板遍历数据模型 list 经验栏目 FreeMarker 繁體版

原文原文链接

本文采用简单的servlet做为后台处理数据的工具，前台使用freemarker的ftl模板做为输出工具，简单说明怎样将封装有实体类对象的List集合注入到ftl模板中而且成功的在遍历显示出来，以前在网上找了不少这方面的资料，可是都没有解决这个问题，因此本身就从头认真的研读的一番freemarker的API文档，阅读了相关的类和接口的功能说明，终于找到了突破口，在这里写出来供和我有相同经历的孩纸(初学者)使用：html

首先看我写的domain实体类：News.javajava

public class News {
private Integer news_id;
private String news_title;
private String news_publish_date;
private String news_url;
public Integer getNews_id() {
return news_id;
}
public void setNews_id(Integer news_id) {
this.news_id = news_id;
}app

.....如下的set和get方法都省略..dom

接着看我写的newsSql.xml文件中查询全部News对象的并返回List<News>或者Map<String,News>型数据的配置信息：eclipse

<typeAlias alias="news" type="cn.domain.News"/>
<resultMap class="news" id="getMap">
<result property="news_id" column="news_id"/>
<result property="news_title" column="news_title"/>
<result property="news_publish_date" column="news_publish_date"/>
<result property="news_url" column="news_url"/>
</resultMap>
<select id="queryAllNews" resultMap="getMap">
select *from news
</select>函数

下面是本身第一次写的NewsListServlet代码：工具

public class NewsListServlet extends HttpServlet {oop

private static final long serialVersionUID = 1L;
private NewsDao dao;
private Configuration cfg;this

public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
request.setCharacterEncoding("utf-8");
response.setContentType("text/html;charset=utf-8");
dao = new NewsDao();
List<News> newslist = dao.getAllNews();
Map<String,List<News>> map=new HashMap<String, List<News>>();
map.put("newslist",newslist);
cfg = new Configuration();
cfg.setServletContextForTemplateLoading(this.getServletContext(),"/ftl");
Template template = cfg.getTemplate("newsList.ftl");
try {
template.process(map,response.getWriter());
} catch (TemplateException e) {
e.printStackTrace();
}url

}}

下面是newslist.ftl模板代码：

<html>
<div style="background-color:#AABBCD">
<table style="border:0px">
<tr style="border:0px" align="center">
<td colspan="4">如下是今天的主要新闻</td>
</tr>
<tr align="center">
<td>编号</td>
<td>标题</td>
<td>发布时间</td>
<td>操做</td>
</tr>
<#if newslist?exists >
<#list newslist as news>
<tr align="center">
<td>${news.news_id}</td>
<td align="left">${news.news_title}</td>
<td>${news.news_publish_date}</td>
<td><a href="${news.news_url}">查看详情</a></td>
</tr>
</#list></#if>
</table>
</div>
</html>

可是运行时会出现下面的异常信息,着实让人很头疼：

freemarker.template.TemplateModelException: Don't know how to present an object of this type to a template: cn.domain.News
at freemarker.template.SimpleObjectWrapper.handleUnknownType(SimpleObjectWrapper.java:139)
at freemarker.template.SimpleObjectWrapper.wrap(SimpleObjectWrapper.java:116)
at freemarker.template.WrappingTemplateModel.wrap(WrappingTemplateModel.java:131)
at freemarker.template.SimpleSequence.get(SimpleSequence.java:197)
at freemarker.template.IteratorBlock$Context.runLoop(IteratorBlock.java:163)
at freemarker.template.Environment.visit(Environment.java:316)
at freemarker.template.IteratorBlock.accept(IteratorBlock.java:94)
at freemarker.template.Environment.visit(Environment.java:180)
at freemarker.template.ConditionalBlock.accept(ConditionalBlock.java:78)
at freemarker.template.Environment.visit(Environment.java:180)
at freemarker.template.MixedContent.accept(MixedContent.java:91)
at freemarker.template.Environment.visit(Environment.java:180)
at freemarker.template.Environment.process(Environment.java:166)
at freemarker.template.Template.process(Template.java:238)

这里我声明一下，数据的封装和传递绝对没有问题，这个异常信息的关键是：

Don't know how to present an object of this type to a template: cn.domain.News

没法引述新闻类对象到模版，也就是说模板不认识list里面的数据是News对象，因此没法经过news.news_title来访问属性对象

到这里我想你们明白我说的是什么意思了吧，经过查询API文档，能够容易看到Template.process()函数有两种形式，一个是含有两个参数的，而另外一个则含有三个参数，他们分别为：

void freemarker.template. .process( dataModel, out) throws ,

void freemarker.template. .process( dataModel, out, wrapper) throws ,

其实两者没什么大的区别，只是第二个方法比第一个多增长了一个 wrapper参数而已，那个增长这个参数有什么做用呢？

答案是：第一个方法中默认了 wrapper参数是ObjectWrapper.SIMPLE_WRAPPER型的，可是在咱们的状况下须要另外一种类型，也即：ObjectWrapper.BEANS_WRAPPER，观看英文单词也理解是什么意思了吧，再看看官方的文档说明：

An ObjectWrapper that exposes the object methods and JavaBeans properties as hash elements, and has custom handling for Java Map-s, ResourceBundle-s, etc. It doesn't treat org.w3c.dom.Node-s and Jython objects specially, however.

Object wrapper that uses SimpleXXX wrappers only. It behaves like the DEFAULT_WRAPPER, but for objects that it does not know how to wrap as a SimpleXXX it throws an exception. It makes no use of reflection-based exposure of anything, which may makes it a good candidate for security-restricted applications.

因此错误的修改就本简单了：

Map<String,List<News>> map=new HashMap<String, List<News>>();
map.put("newslist",newslist);
cfg = new Configuration();

cfg.setServletContextForTemplateLoading(this.getServletContext(),"/ftl");
Template template = cfg.getTemplate("newsList.ftl");
try {
template.process(map,response.getWriter(),ObjectWrapper.BEANS_WRAPPER);
} catch (TemplateException e) {
e.printStackTrace();
}

如下是改正后的运行效果：

如下是今天的主要新闻
编号	标题	发布时间	操做
1	MH-17航班又在乌克兰和俄罗斯边境出事了	2014-07-15 22:19:45.0	查看详情
2	中国和巴西签定了不少外贸上的关系文件	2014-07-17 21:23:45.0	查看详情
3	全国大学生软件大赛初赛成绩公布了，三人组合团队表现很出色	2014-07-14 15:18:22.0	查看详情
4	山东交通学院未来要成为一所名副其实的大学真的很困难	2012-06-11 13:18:49.0	查看详情

呵呵，本身的一点总结，大手们不要见笑。。。