java-使用 freemarker 替换 jstl EL 开发 springmvc web项目

java-使用 freemarker 替换 jstl EL 开发 springmvc web项目


freemarker 是一款模板引擎，不限于 web 中，但与 springmvc 结合可以替换 jstl 的功能，且更加灵活。
资源：
freemarker 官网：http://freemarker.org/
官网提供了中文的手册可以下载到本地看：
https://sourceforge.net/projects/freemarker/files/chinese-manual/


目标：
借助springmvc 中 controller 向页面传值的模式，利用 freemarker 对页面进行填充
借助 org.springframework.ui.Model 对象或 Map 对象将信息传到 springmvc 的页面中


需要：
1.freemarker 组件
2.springmvc 组件


1.创建项目名称为 “mavers-web” 的maven web项目,添加 maven 添加依赖：

  <properties>
	<!-- 文件拷贝时的编码 -->
	<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
	<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
	<!-- 编译时的编码 -->
	<maven.compiler.encoding>UTF-8</maven.compiler.encoding>
	<org.springframework.version>4.3.7.RELEASE</org.springframework.version>
  </properties>
  <dependencies>
	<!-- spring -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${org.springframework.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${org.springframework.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-websocket</artifactId>
        <version>${org.springframework.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <version>${org.springframework.version}</version>
    </dependency>
	<dependency>
	    <groupId>org.springframework</groupId>
	    <artifactId>spring-context-support</artifactId>
	    <version>${org.springframework.version}</version>
	</dependency>    
    <!-- jstl(jsp 标准标签库) -->
	<dependency>
	    <groupId>jstl</groupId>
	    <artifactId>jstl</artifactId>
	    <version>1.2</version>
	</dependency>
	<!-- freemarker 模板引擎 -->
	<dependency>
		<groupId>org.freemarker</groupId>
		<artifactId>freemarker</artifactId>
		<version>2.3.26-incubating</version>
	</dependency>
  </dependencies>

2.配置 spring 和 freemarker（需要配置三个xml）


2.1 web.xml 配置

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
	<display-name>Archetype Created Web Application</display-name>
	<listener>
		<!-- applicationContext.xml spring 配置文件加载器 -->
        <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
     </listener>
	<context-param>
	 	<!--  Spring 上下文参数 --> 
	    <param-name>contextConfigLocation</param-name>  
    	<param-value>/WEB-INF/applicationContext.xml</param-value>  
	</context-param>
	<!-- 配置DispatchcerServlet -->
	<servlet>  
	    <servlet-name>demoServlet</servlet-name>  
	    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>  
	    <load-on-startup>1</load-on-startup>  
	</servlet>  
	<servlet-mapping>  
	    <servlet-name>demoServlet</servlet-name>
	    <!-- / 表示对于所有的请求的拦截，包括静态资源如html, js, jpg等 -->
	    <url-pattern>/</url-pattern>  
	</servlet-mapping>	
	<welcome-file-list>
		<welcome-file>/index.html</welcome-file>
	</welcome-file-list>
</web-app>

2.2 demoServlet-servlet.xml 配置

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:context="http://www.springframework.org/schema/context"
	xmlns:mvc="http://www.springframework.org/schema/mvc"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">


	<mvc:annotation-driven /> 
	<!-- 不拦截静态资源 -->
	<mvc:resources location="/content/" mapping="/content/**"/>
	<!-- 配置自动扫描的包 -->
	<context:component-scan base-package="demo.mvc"></context:component-scan>
		
</beans>

2.3 applicationContext.xml 配置

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans   
       http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">
       
	<!-- springmvc 视图解析器 ,如何把handler 方法返回值解析为实际的物理视图 -->
	<bean id="springmvcViewResolver"
		class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<!-- 拼接物理视图的地址前缀 -->
		<property name="prefix" value="/views/"></property>
		<!-- 拼接物理视图的地址后缀 -->
		<property name="suffix" value=".jsp"></property>
		<!-- 页面编码 -->
		<property name="contentType" value="text/html; charset=UTF-8"></property>
		<!-- 视图解析器调用顺序 order 小的先调用 -->
		<property name="order" value="1"/>
	</bean>
	
	<!-- freemarker 视图解析器 -->
	<bean id="freeMarkerViewResolver"
		class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
		<property name="viewClass" value="org.springframework.web.servlet.view.freemarker.FreeMarkerView"/>  
		<property name="cache" value="false" />
		<!-- 拼接物理视图的地址前缀 -->
		<property name="prefix" value="" />
		<!-- 拼接物理视图的地址后缀 -->
		<property name="suffix" value=".ftl" />
		<!-- 页面编码 -->
		<property name="contentType" value="text/html; charset=UTF-8"></property>
		<!-- 视图解析器调用顺序 order 小的先调用 -->
		<property name="order" value="0"/>
	</bean>
		
	<!-- Freemarker配置 -->
	<bean id="freemarkerConfig"
		class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
		<!-- 模板加载路径 -->
		<property name="templateLoaderPath" value="/views/"/>
        <property name="freemarkerVariables">    
            <map>    
                <entry key="xml_escape" value-ref="fmXmlEscape" />    
            </map>    
        </property> 
        <property name="defaultEncoding">    
            <value>utf-8</value>    
        </property>
		<!-- 参数设定 -->
		<property name="freemarkerSettings">
			<props>
				<prop key="template_update_delay">0</prop>
				<prop key="default_encoding">UTF-8</prop>
				<prop key="number_format">0.##########</prop>
				<prop key="datetime_format">yyyy-MM-dd HH:mm:ss</prop>
				<prop key="classic_compatible">true</prop>
				<prop key="template_exception_handler">ignore</prop>
				<!-- 模板更新时间秒数 -->
                <prop key="template_update_delay">3600</prop>    
			</props>
		</property>
	</bean>
	<bean id="fmXmlEscape" class="freemarker.template.utility.XmlEscape"/>
</beans>  

3.创建演示用的 controller ， HelloController.java 

package demo.mvc.controllers;


import java.util.ArrayList;
import java.util.Date;
import java.util.List;
import java.util.Map;


import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;


import demo.models.hello.UserInfoModel;


/** 
*
*/
@Controller
@RequestMapping("/hello")
public class HelloController {
	/**
	 * 请求地址：项目名/hello/userinfo
	 * @return
	 */
	@RequestMapping("freemarker")
	public String freemarker(org.springframework.ui.Model model,Map<String, Object> map){
		//传递一个值
		model.addAttribute("val_name","张三");
		model.addAttribute("cur_time",new Date());
		
		//传递单个对象
		UserInfoModel info = new UserInfoModel("张三",99,"男");
		model.addAttribute("info",info);		
		
		List<UserInfoModel> list = new ArrayList<UserInfoModel>();
		list.add(new UserInfoModel("李四",20,"男"));
		list.add(new UserInfoModel("王五",21,"女"));
		list.add(new UserInfoModel("赵六",22,"男"));
		
		//传递多个对象
		map.put("user_list", list);
		
		return "hello/freemarker"; //servlet.xml 中定义的 前缀（prefix）+返回值+后缀（suffix）拼接的物理地址
	}
}

4.创建 freemarker 模板
三个模板：
freemarker.ftl  主模板
freemarker-header.ftl 页头模板
freemarker-footer.ftl 页脚模板


4.1 freemarker.ftl  主模板,内容

<!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>Insert title here</title>
	<script scr="/content/index.js"></script>
	<link href="/content/index.css"/>
</head>
<body>
	<h3>freemarker演示</h3>
	<h4>一、传递一个值</h4>
	<div>姓名：${val_name}</div>
	<div>当前时间：${cur_time?string("yyyy-MM-dd HH:mm:ss zzzz")}</div>
	
	<h4>二、传递一个对象</h4>
	<div>name：${info.name}</div>
	<div>age：${info.age}</div>
	<div>sex：${info.sex}</div>
	<div>当前时间：${info.date?string("yyyy-MM-dd HH:mm:ss zzzz")}</div>
	
	<h4>三、传递一个 list 对象</h4>
	<table border="1">
		<tr>
			<td>name</td>
			<td>age</td>
			<td>sex</td>
			<td>date</td>
		</tr>
	<#list user_list as p>
		<tr>
			<td>${p.name}</td>
			<td>${p.age}</td>
			<td>${p.sex}</td>
			<td>${info.date?string("yyyy-MM-dd HH:mm:ss zzzz")}</td>
		</tr>      
    </#list>
    </table>
	<h4>四、引用其它 ftl 文件：引用路径是以配置文件中（xxx.xml） templateLoaderPath 配置为基础目录开始的！</h4>
	<div>
		<div><#include "/hello/freemarker-header.ftl"></div>
		<div>这里是内容</div>
		<div><#include "/hello/freemarker-footer.ftl"></div>
	</div>
    
</body>
</html>

4.2 freemarker-header.ftl 页头模板,内容

<h5>页头文件</h5>

4.3 freemarker-footer.ftl 页脚模板,内容

<h5>页脚文件</h5>

5.请求测试，部署到 tomcat 后
访问：http://localhost:8080/mavens-web/hello/freemarker 查看效果