首页 > 代码库 > FreeMarker之生成页面(三)
FreeMarker之生成页面(三)
这篇文章介绍Freemarker最核心的功能,或者说它的出现是用来解决什么问题的。在第一篇提到了Freemarker是一种模板语言,那么什么叫做模板语言呢。
自己也是接触没多久就在网上搜了搜资料,下面是我搜到的一篇介绍Java模板技术的博客觉得写的听清楚的,觉得我想知道的关于模板的知识,这篇博客中基本上都讲到了,有兴趣的可以看看:http://blog.csdn.net/logic_202/article/details/573850。
我简单的总结一下我理解的模板语言,从本质上讲他就是一个占位符动态替换技术。而我们在web开发中经常使用的EL表达式,struts tablib等技术也是一种占位符动态替换技术。但是Freemarker和他们却有不同的地方,第一篇博客中提到了Freemarker是一种独立的模板技术,他是脱离servlet容器独立运行的,这一点与我们平时经常使用的jsp技术是不同的。Jsp必须依赖servlet容器才可以运行,因为jsp本质上就是servlet。使用jsp这种机制,向前台传送数据是通过request流中,而Freemarker中向前台传送数据只需要向页面传入一个POJO就行而不是request对象。
简单了解模板语言之后就来实现一个例子吧!
1. 在MyEclipse上创建一个web项目,然后添加Freemarker的jar包; 在WebRoot文件夹下新建templates文件夹,用于存放需要输出的页面模板。
2. 编写模板
新建名为ftl的文件放到templates文件夹中,文件的内容如下所示。
(注意:如果创建文件之后文件报红,可以使用如下的方式就可以消除)
3. 后台代码获得数据
从上面的ftl文件中得出我们需要的数据有:${title},userList,${user.id},${user.name};那么我们在后台就需要传递给她这些占位符上数据
FreeMarkerHandler类中的代码:
package com.ftl; import java.io.IOException; import java.io.PrintWriter; import java.util.ArrayList; 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.entity.User; import freemarker.template.Configuration; import freemarker.template.Template; import freemarker.template.TemplateException; public class FreeMarkerHandler extends HttpServlet { private Configuration configuration = null; //解释Configuration //构造函数 public FreeMarkerHandler(){ //创建Configuration实例 configuration = new Configuration(); //输出的数据默认的编码类型 configuration.setDefaultEncoding("utf-8"); } @SuppressWarnings("unchecked") public void doGet(HttpServletRequest request,HttpServletResponse response) throws ServletException,IOException { //---------------1.准备数据----------------- //要填入的数据文件 Map dataMap = new HashMap();//解释数据的容器 //添加数据 dataMap.put("title", "FreeMarker示例"); List<User> userList = new ArrayList<User>(); User user1 = new User(); user1.setId("1"); user1.setName("小依"); User user2 = new User(); user2.setId("2"); user2.setName("小耳"); userList.add(user1); userList.add(user2); dataMap.put("userList", userList); //将数据放到Map中 //--------------------------------------- //---------------2.设置模板装载的方法(有多种方法)- //介绍两种方法: configuration.setServletContextForTemplateLoading(getServletContext(),"templates"); // configuration.setClassForTemplateLoading(this.getClass(),"/com/template"); //--------------------------------------- //----------------3.获得模板---------------- //获得需要装载的模版 Template template = null; try { template = configuration.getTemplate("hello.ftl"); template.setEncoding("utf-8"); } catch (IOException e) { e.printStackTrace(); } //--------------------------------------- //--------------4.开始准备生成输出-------------- //使用模版文件的charset作为本页面的charset //使用text/html MIME-type response.setContentType("text/html; charset=" + template.getEncoding()); PrintWriter out = response.getWriter(); //合并数据模型和模版,并将结果输出到out中 try { template.process(dataMap,out);// 用模板来开发servlet可以只在代码里面加入动态的数据 } catch(TemplateException e) { throw new ServletException("处理Template模版中出现错误", e); } //------------------------------------------ } }
4. web.xml中的配置信息
<?xml version="1.0" encoding="UTF-8"?> <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <servlet> <servlet-name>FreeMarkerHandler</servlet-name> <servlet-class>com.ftl.FreeMarkerHandler</servlet-class> </servlet> <servlet-mapping> <servlet-name>FreeMarkerHandler</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping> </web-app>
5. index.jsp提供访问位置
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%> <% String path = request.getContextPath(); String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/"; %> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <base href=http://www.mamicode.com/"">>
6. 效果展示
将项目部署到tomcat上,然后访问就可以看到效果了。
总结
以上测试的例子没有使用任何的web框架,其实这种模板语言是可以和我们常用的框架一起使用的,自己查找到了一些相关的资料分享给大家,有兴趣的可以去看看!
Freemarker全部文档:http://www.open-open.com/doc/list/101?o=p
具体实例:http://www.zuidaima.com/share/kfreemarker-p1-s1.htm
FreeMarker之生成页面(三)