首页 > 代码库 > 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之生成页面(三)