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

小虾米阅读：609 2021-03-31 22:30:17 评论：0

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

首先看我写的domain实体类：Animals.java

package com.vixuan.pojo; 
public class Animals{ 
	private String name; 
	private String price; 
	 
	public String getName() { 
		return name; 
	} 
	public void setName(String name) { 
		this.name = name; 
	} 
	public String getPrice() { 
		return price; 
	} 
	public void setPrice(String price) { 
		this.price = price; 
	} 
 
}

接着看我写AnimalsDao中查询所有Animals对象的并返回List<Animals>数据的信息：

package com.vixuan.dao; 
 
import java.util.ArrayList; 
import java.util.List; 
 
import com.vixuan.pojo.Animals; 
 
public class AnimalsDao { 
	public List<Animals> getAnimals(){ 
		List<Animals> list=new ArrayList<Animals>(); 
		 
		for(int i=0;i<10;i++){ 
			Animals animals=new Animals(); 
			animals.setName("animals:"+i); 
			animals.setPrice("price:"+i); 
			list.add(animals); 
		} 
		return list; 
	} 
 
}

下面是自己第一次写的ListServlet代码：

package com.vixuan.freemark; 
 
import java.io.IOException; 
import java.io.Writer; 
import java.util.HashMap; 
import java.util.List; 
import java.util.Map; 
 
import javax.servlet.ServletException; 
import javax.servlet.http.HttpServlet; 
import javax.servlet.http.HttpServletRequest; 
import javax.servlet.http.HttpServletResponse; 
 
import com.vixuan.dao.AnimalsDao; 
import com.vixuan.pojo.Animals; 
 
import freemarker.template.Configuration; 
import freemarker.template.ObjectWrapper; 
import freemarker.template.SimpleObjectWrapper; 
import freemarker.template.Template; 
import freemarker.template.TemplateException; 
 
public class ListServlet extends HttpServlet { 
 
	/** 
	 * 测试freemarker模板的list 指令 
	 */ 
	private static final long serialVersionUID = 1L; 
	 
	 
	// 负责管理FreeMarker模板的Configuration实例   
    private Configuration cfg = null; 
	@Override 
	public void init() throws ServletException { 
		// TODO Auto-generated method stub 
		// 创建一个FreeMarker实例   
        cfg = new Configuration();   
        // 指定FreeMarker模板文件的位置   
        cfg.setServletContextForTemplateLoading(getServletContext(),   
                "/WEB-INF/templates");   
	} 
 
	@Override 
	public void doGet(HttpServletRequest request, HttpServletResponse response) 
			throws ServletException, IOException { 
		// TODO Auto-generated method stub 
		AnimalsDao dao=new AnimalsDao(); 
		List<Animals> list=dao.getAnimals(); 
		 // 建立数据模型   
        Map root = new HashMap();   
        root.put("animals", list);  
        
         
        // 获取模板文件   
        Template t = cfg.getTemplate("list.ftl");   
        // 使用模板文件的Charset作为本页面的charset   
        // 使用text/html MIME-type   
        response.setContentType("text/html; charset=" + t.getEncoding());   
        Writer out = response.getWriter();   
        // 合并数据模型和模板，并将结果输出到out中   
        try {          	 
            t.process(root, out,ObjectWrapper.BEANS_WRAPPER); // 往模板里写数据   
        } catch (TemplateException e) {   
            e.printStackTrace();   
        }   
	} 
 
	@Override 
	public void doPost(HttpServletRequest request, HttpServletResponse response) 
			throws ServletException, IOException { 
		// TODO Auto-generated method stub 
		this.doGet(request, response); 
	} 
 
}

下面是list.ftl模板代码：

<html> 
<head> 
<title>Welcome!</title> 
</head> 
<body> 
<p>We have these animals: 
<table border=1> 
<tr><th>Name<th>Price 
<#list animals as a> 
<tr><td>${a.name}<td>${a.price} Euros 
</#list> 
</table> 
</body> 
</html>

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

freemarker.template.TemplateModelException: Don't know how to present an object of this type to a template: com.vixuan.pojo.Animals
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: com.vixuan.pojo.Animals

无法引述动物类对象到模版，也就是说模板不认识list里面的数据是Animals对象，所以无法通过animals.name来访问属性对象

到这里我想大家明白我说的是什么意思了吧，通过查询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.

所以错误的修改就本简单了：

// 合并数据模型和模板，并将结果输出到out中
try {
t.process(root, out,ObjectWrapper.BEANS_WRAPPER); // 往模板里写数据
} catch (TemplateException e) {
e.printStackTrace();
}

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

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