Servlet 3.0 开发手记之---使用Freemarker替代JSP，更快更轻更高效

nieyong

于 2010-07-03 18:38:56 发布

阅读量137

点赞数

文章标签： Servlet JSP freemarker HTML Blog

曾经写过一篇博文《很轻的，Servlet + Freemarker 组合体,没有那么硬~ 》，不过那是基于Servlet 2.× 系列的，今天谈谈如何在Servlet 3.0 下使用Freemarker进行更快的开发方式。

Servlet 3.0的强大、简单的，摆脱以前的约束，重构类名还得需要到web.xml中手动修改，如今再也没有那么多烦恼，当然这仅仅是一个侧面而已，就已经说明了其强大。

Freemarker强大的模板化能力，据说解析速度超越JSP，让讨厌JSP+ JAVA混合体编程的人得到一种解脱，身心的。还有一点就是快速的模型填充，不需要随处可见的JAVA代码，任何角落都是。

总之：Servlet 3.0 + Freemarker, 超级轻的MVC组合，让人愉悦。

闲话短说，先来一个Servlet + JSP组合体：

TemplateTestAction.java

@WebServlet("/test1")
public class TemplateTest1Action extends HttpServlet {
	private static final long serialVersionUID = 6576879808909808L;
       
	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		String id = "1688";
		
		String title = "使用freemarker";
		String content = "这是测试";
		
		request.setAttribute("blog", new UserBlog(id, title, content, new Date()));
		
		request.getRequestDispatcher("/WEB-INF/pages/template1.html").forward(request, response);
	}
}

@WebServlet("/test ")
public class TemplateTestAction extends HttpServlet {
private static final long serialVersionUID = 88687687987980L;

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
String id = "1687 ";

String title = "JSP测试 ";
String content = "这是JSP测试 ";

request.setAttribute("blog ", new UserBlog(id, title, content, new Date()));

request.getRequestDispatcher("/WEB-INF/pages/template.jsp ").forward(request, response);
}
}

对应JSP：

<%@page import="java.text.SimpleDateFormat"%>
<%@page import="com.demo.UserBlog"%>
<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>JSP + Servlet</title>
</head>
<body>
	<%UserBlog blog = (UserBlog)request.getAttribute("blog"); %>
	<h1>ID : <%=blog.getId() %></h1>
	<h5>TITLE : <%=blog.getTitle() %></h5>
	<p>DATETIME : <%=new SimpleDateFormat("yyyy-MM-dd HH:mm").format(blog.getDate()) %></p>
	<div>
	CONTENT : <br/>
	<p><%=blog.getContent() %></p>
	</div>
</body>
</html>

看看代码，以前大家也都是这么写过来的。

对比一下Servlet + Freemarker ：

@WebServlet("/test1")
public class TemplateTest1Action extends HttpServlet {
	private static final long serialVersionUID = 6576879808909808L;
       
	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
		String id = "1688";
		
		String title = "使用freemarker";
		String content = "这是测试";
		
		request.setAttribute("blog", new UserBlog(id, title, content, new Date()));
		
		request.getRequestDispatcher("/WEB-INF/pages/template1.html").forward(request, response);
	}
}

Servlet代码没有发生什么变化，只是这次转向了html文件：

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Freemaker模板测试1</title>
</head>
<body>
	<h1>ID : ${blog.id}</h1>
	<h5>TITLE : ${blog.title}</h5>
	<p>DATETIME : ${blog.date?string("yyyy-MM-dd HH:mm")}</p>
	<div>CONTENT : <br />
	<p>${blog.content}</p>
	</div>
</body>
</html>

请再次对比一下JSP 和 html文件的区别，您会选择写HTML还是JSP页面呢 ?

要想让TemplateTest1Action转向HTML页面生效，您需要配置一个Freemarker的控制器，用以解析html页面。

这里控制器为:TemplateController.java 文件：

@WebServlet(
		urlPatterns = {"*.html"}, // 需要定义Freemarker解析的页面后缀类型
		asyncSupported = false, 
		loadOnStartup = 0, 
		name = "templateController", 
		displayName = "TemplateController", 
		initParams = {
			@WebInitParam(name = "TemplatePath", value = "/"),
			@WebInitParam(name = "NoCache", value = "true"),//定义是否缓存
			@WebInitParam(name = "ContentType", value = "text/html; charset=UTF-8"),// 定义内容类型 
			@WebInitParam(name = "template_update_delay", value = "0"), // 开发环境中可设置为0
			@WebInitParam(name = "default_encoding", value = "UTF-8"),
			@WebInitParam(name = "number_format", value = "0.##########")
		} 
)
public class TemplateController extends FreemarkerServlet {
	private static final long serialVersionUID = 8714019900490761087L;	
}

这里仅仅需要继承FreemarkerServlet，再加上一些注解即可，内容代码不用写。当然也可以省去

TemplateController，直接在web.xml文件中配置：

  <servlet>
    <servlet-name>freemarker</servlet-name>
    <servlet-class>freemarker.ext.servlet.FreemarkerServlet</servlet-class>
    <init-param>
      <param-name>TemplatePath</param-name>
      <param-value>/</param-value>
    </init-param>
    <init-param>
      <param-name>NoCache</param-name>
      <param-value>true</param-value>
    </init-param>
    <init-param>
      <param-name>ContentType</param-name>
      <param-value>text/html; charset=UTF-8</param-value>
    </init-param>
    <init-param>
      <param-name>template_update_delay</param-name>
      <param-value>0</param-value>
    </init-param>
    <init-param>
      <param-name>default_encoding</param-name>
      <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
      <param-name>number_format</param-name>
      <param-value>0.##########</param-value>
    </init-param>
    <load-on-startup>2</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>freemarker</servlet-name>
    <url-pattern>*.html</url-pattern>
  </servlet-mapping>

记得把 freemarker-2.3.13.jar 文件扔进WEB-INF/lib 目录下。

项目源代码下载地址：

下载地址

接下来一篇将体验一下Servlet 3.0 的WebFragment功能，支持组件、功能的插拔，使之可以模块化构造一个站点服务，大的跨越，一个变革，必将受益开发者社区。