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

古城微笑少年丶 2023-10-16 21:44 10阅读 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. Template.process( Object dataModel, Writer out) throws TemplateException, IOException

void freemarker.template. Template.process( Object dataModel, Writer out, ObjectWrapper wrapper) throws TemplateException, IOException

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

答案是：第一个方法中默认了 ObjectWrapper 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