在程序开发的入门章节中,我们已经知道如何使用基本的Java类(Map,String等)构建一个数据模型了。在内部,模板中可用的变量都是实现了freemarker.template.TemplateModel接口的Java对象但在你自己的数据模型中,可以使用基本的Java集合类作为变量,因为这些变量会在内部被替换为适当的TemplateModel类型。这种功能特性被称作是object wrapping对象包装。对象包装功能可以透明地把任何类型的对象转换为实现了TemplateModel接口类型的实例。这就使得下面的转换成为可能,如在模板中把java.sql.ResultSet转换为序列变量,把javax.servlet.ServletRequest对象转换成包含请求属性的哈希表变量,甚至可以遍历XML文档作为FTL变量。包装(转换)这些对象,需要使用合适的,也就是所谓的对象包装器实现(可能是自定义的实现);这将在后面讨论。现在的要点是想从模板访问任何对象,它们早晚都要转换为实现了TemplateModel接口的对象。那么首先你应该熟悉来写TemplateModel接口的实现类。
有一个freemarker.template.TemplateModel粗略的子接口对应每种基本变量类型(TemplateHashModel对应哈希表,TemplateSequenceModel对应序列,TemplateNumberModel对应数字等等)。例如,想为模板使用java.sql.ResultSet变量作为一个序列,那么就需要编写一个TemplateSequenceModel的实现类,这个类要能够读取java.sql.ResultSet中的内容。我们常这么说,你使用TemplateModel的实现类包装了java.sql.ResultSet,基本上只是封装java.sql.ResultSet,来提供使用普通的TemplateSequenceModel接口访问它。要注意一个类可以实现多个TemplateModel接口,这就是为什么FTL变量可以有多种类型(参考:模板开发指南/数值和类型/基本内容部分)。
注意这些接口的一个细小的实现是和freemarker.template包一起提供的。例如,将一个String转换成FTL的字符串变量,可以使用SimpleScalar,将java.util.Map转换成FTL的哈希表变量,可以使用SimpleHash等等。
如果想尝试自己的TemplateModel实现,一个简单的方式是创建它的实例,然后将这个实例放入数据模型中(也就是把它放在哈希表的根上)。对象包装器将会给模板提供它的原状,因为它已经实现了TemplateModel接口,所以没有转换(包装)的需要。(这个技巧当你不想用对象包装器来包装(转换)某些对象时仍然有用。)
1.如在模板中把java.sql.ResultSet转换为序列变量 什么事序列变量
2.把javax.servlet.ServletRequest对象转换成包含请求属性的哈希表变量 这句话也不太理解
|
|