springmvc整合freemarker教程

1、介绍

我最近喜欢freemarker在网上找了大半天、都没有找到一个简单又容易理解的案例。虽然只是一个模板技术、但是相对刚开始什么都不知道的，很难入手。下面是自学（其实是谷歌和百度的东找西补）、写了个小案例，入门的。喜欢的可以看看、不喜欢的可以微笑！

                     开发工具：idea

                     项目构建：maven

                     开发语言：java

                     整合框架：SpringMVC

                     技术简介：freemarker模板

                     GitHub代码下载：点击下载

1.1、freemarker手册的介绍freemarker

1.2、项目模块结构截图

2、整合案例

2.1、添加依赖

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
	<parent>
		<artifactId>SSM-MVC</artifactId>
		<groupId>org.ssm.com</groupId>
		<version>1.0-SNAPSHOT</version>
	</parent>
	<modelVersion>4.0.0</modelVersion>
	<artifactId>springmvc</artifactId>
	<packaging>war</packaging>
	<name>springmvc Maven Webapp</name>
	<url>http://maven.apache.org</url>


	<properties>
		<!-- maven依赖-->
		<junit.version>3.8.1</junit.version>
		<jstl.version>1.2</jstl.version>
		<servlet-api.version>2.5</servlet-api.version>
		<javax.servlet-apiversion>3.1.0</javax.servlet-apiversion>
		<javaee-api.version>7.0</javaee-api.version>
		<jsp-api.version>2.2</jsp-api.version>
		<!--下面这两个是springAOP需要用到-->
		<aspectjweaver.version>1.7.2</aspectjweaver.version>
		<persistence-api.version>1.0.2</persistence-api.version>
		<!-- springmvc -->
		<spring.version>4.3.4.RELEASE</spring.version>
	</properties>

	<dependencies>

		<!-- 1)junit -->
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>${junit.version}</version>
			<scope>test</scope>
		</dependency>
		<!-- 2)jstl -->
		<dependency>
			<groupId>jstl</groupId>
			<artifactId>jstl</artifactId>
			<version>${jstl.version}</version>
		</dependency>
		<dependency>
			<groupId>javax.servlet</groupId>
			<artifactId>javax.servlet-api</artifactId>
			<version>${javax.servlet-apiversion}</version>
			<scope>provided</scope>
		</dependency>
		<dependency>
			<groupId>javax.servlet</groupId>
			<artifactId>servlet-api</artifactId>
			<version>${servlet-api.version}</version>
			<scope>provided</scope>
		</dependency>
		<!-- java ee jar 包 -->
		<dependency>
			<groupId>javax</groupId>
			<artifactId>javaee-api</artifactId>
			<version>${javaee-api.version}</version>
			<scope>provided</scope>
		</dependency>
		<dependency>
			<groupId>javax.servlet.jsp</groupId>
			<artifactId>jsp-api</artifactId>
			<version>${jsp-api.version}</version>
			<scope>provided</scope>
		</dependency>

		<dependency>
			<groupId>org.codehaus.jackson</groupId>
			<artifactId>jackson-mapper-asl</artifactId>
			<version>1.9.8</version>
			<type>jar</type>
			<scope>compile</scope>
		</dependency>

		<!-- 4)springmvc -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-context</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<!-- springmvc-webmvc -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-webmvc</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<!-- springmvc-orm-->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-orm</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-test</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-aspects</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<!--下面两个提供对 AspectJ 的支持，是 springmvc-aspects 所需要依赖的-->
		<dependency>
			<groupId>org.aspectj</groupId>
			<artifactId>aspectjweaver</artifactId>
			<version>${aspectjweaver.version}</version>
		</dependency>

		<dependency>
			<groupId>javax.persistence</groupId>
			<artifactId>persistence-api</artifactId>
			<version>${persistence-api.version}</version>
		</dependency>

		<!--这个一定要有、不用报错-->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-context-support</artifactId>
			<version>3.2.4.RELEASE</version>
		</dependency>
		<!-- https://mvnrepository.com/artifact/org.freemarker/freemarker -->
		<dependency>
			<groupId>org.freemarker</groupId>
			<artifactId>freemarker</artifactId>
			<version>2.3.25-incubating</version>
		</dependency>


	</dependencies>

	<build>
		<finalName>springmvc</finalName>

		<!-- 配置插件 -->
		<plugins>
			<plugin>
				<groupId>org.apache.tomcat.maven</groupId>
				<artifactId>tomcat7-maven-plugin</artifactId>
				<configuration>
					<port>8080</port>
					<path>/</path>
				</configuration>
			</plugin>
		</plugins>
		<resources>
			<!--表示把java目录下的有关xml文件,properties文件编译/打包的时候放在resource目录下-->
			<resource>
				<directory>${basedir}/src/main/java</directory>
				<includes>
					<include>**/*.config</include>
					<include>**/*.xml</include>
				</includes>
			</resource>
			<resource>
				<directory>${basedir}/src/main/resources</directory>
			</resource>
		</resources>



	</build>
</project>

问题截图：这是没有添加spring-context-support依赖的时候

2.2、web.xml配置、其实是springmvc的配置没变

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
		 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		 xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee
         http://xmlns.jcp.org/xml/ns/javaee/web-app_3_0.xsd"
		 version="3.1">

	<display-name>Archetype Created Web Application</display-name>
	<welcome-file-list>
		<welcome-file>default.jsp</welcome-file>
		<welcome-file>index.jsp</welcome-file>
	</welcome-file-list>



	<!-- Spring MVC servlet -->
	<servlet>
		<servlet-name>dispatcherServlet</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>classpath*:spring/application-*.xml</param-value>
		</init-param>
	</servlet>
	<servlet-mapping>
		<servlet-name>dispatcherServlet</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>




	<!-- 编码过滤器 -->
	<filter>
		<filter-name>encodingFilter</filter-name>
		<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
		<async-supported>true</async-supported>
		<init-param>
			<param-name>encoding</param-name>
			<param-value>UTF-8</param-value>
		</init-param>
	</filter>
	<filter-mapping>
		<filter-name>encodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>


</web-app>

2.3、application-springmvc.xml配置（多了freemarker的配置）

<?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:tx="http://www.springframework.org/schema/tx"
	   xmlns:mvc="http://www.springframework.org/schema/mvc"
	   xmlns:context="http://www.springframework.org/schema/context"
	   xsi:schemaLocation="http://www.springframework.org/schema/beans
	   http://www.springframework.org/schema/beans/spring-beans.xsd
	   http://www.springframework.org/schema/tx
	   http://www.springframework.org/schema/tx/spring-tx.xsd
	   http://www.springframework.org/schema/context
	   http://www.springframework.org/schema/context/spring-context.xsd
	   http://www.springframework.org/schema/mvc
       http://www.springframework.org/schema/mvc/spring-mvc.xsd">


	<!--指明 controller 所在包，并扫描其中的注解-->
	<context:component-scan base-package="com.springmvc"/>


	<!-- 静态资源(js、image等)的访问 -->
	<!--<mvc:default-servlet-handler/>-->

	<!-- 启用spring mvc 注解 -->
	<mvc:annotation-driven />


	<!-- 配置freeMarker的模板路径 -->
	<bean class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
		<property name="templateLoaderPath" value="WEB-INF/ftl/" />
		<property name="defaultEncoding" value="UTF-8" />
	</bean>
	<!-- freemarker视图解析器 -->
	<bean class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
		<property name="suffix" value=".ftl" />
		<property name="contentType" value="text/html;charset=UTF-8" />
		<!-- 此变量值为pageContext.request, 页面使用方法：rc.contextPath -->
		<property name="requestContextAttribute" value="rc" />
	</bean>

	<!--ViewResolver 视图解析器-->
	<!--用于支持Servlet、JSP视图解析-->
	<bean id="jspViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/>
		<property name="prefix" value="/WEB-INF/jsp/"/>
		<property name="suffix" value=".jsp"/>
	</bean>

</beans>

2.4、定义模板（其实也是一个页面、后者不一样、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=ISO-8859-1">
    <title>Insert title here</title>
</head>
<body>
Hello ${name}
</body>
</html>

2.5、springmvc入门案例（页面、其实就是想两个模板来回切换）

<%@ 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>Insert title here</title>
</head>
<body>
		
		<h1>第一个参数：${message1 }</h1>
		<h1>第二个参数：${message2}</h1>
</body>
</html>

2.6、Controller

package com.springmvc.freemarker;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;

/**
 * @auther 陈郑游
 * @create 2016/12/29 0029
 * @功能
 * @问题
 * @说明
 * @URL地址
 * @进度描述
 */
@Controller
public class FreemarkerAndJsp {

    /**Freemarker模板的Controller*/
    @RequestMapping(value="/welcome",method={RequestMethod.GET})
    public ModelAndView getFirstPage(HttpServletRequest request) {
        //welcom就是视图的名称（welcom.ftl）
        ModelAndView mv = new ModelAndView("welcome");
        mv.addObject("name", "My First Spring Mvc and Freemarker !");
        return mv;
    }


    /**jsp模板的Controller*/
    @RequestMapping(value="/jsp",method={RequestMethod.GET})
    public ModelAndView getJsp(HttpServletRequest request) {

        ModelAndView mv = new ModelAndView("index");
        mv.addObject("message1", "切换到jsp模板、");
        mv.addObject("message2", "My First Spring Mvc");
        mv.setViewName("hello/index");
        return mv;
    }
}

2.7、效果图

3、freemarker的数据类型

3.1、直接指定值

    直接指定值可以是字符串、数值、布尔值、集合及Map对象。

1. 字符串
    直接指定字符串值使用单引号或双引号限定。字符串中可以使用转义字符”\"。如果字符串内有大量的特殊字符，则可以在引号     的前面加上一个字母r，则字符串内的所有字符都将直接输出。


2. 数值
    数值可以直接输入，不需要引号。FreeMarker不支持科学计数法。


3. 布尔值 
    直接使用true或false，不使用引号。


4. 集合
    集合用中括号包括，集合元素之间用逗号分隔。
    使用数字范围也可以表示一个数字集合，如1..5等同于集合[1, 2, 3, 4, 5]；同样也可以用5..1来表示[5, 4, 3, 2, 1]。


5. Map对象
    Map对象使用花括号包括，Map中的key-value对之间用冒号分隔，多组key-value对之间用逗号分隔。
    注意：Map对象的key和value都是表达式，但key必须是字符串。


6. 时间对象
    root.put("date1", new Date());
    ${date1?string("yyyy-MM-dd HH:mm:ss")}


7. JAVABEAN的处理
    Freemarker中对于javabean的处理跟EL表达式一致，类型可自动转化！非常方便！

3.2、输出变量值

FreeMarker的表达式输出变量时，这些变量可以是顶层变量，也可以是Map对象的变量，还可以是集合中的变量，并可以使用点（.）语法来访问Java对象的属性。


1. 顶层变量
    所谓顶层变量就是直接放在数据模型中的值。输出时直接用${variableName}即可。


2. 输出集合元素
    可 以根据集合元素的索引来输出集合元素，索引用中括号包括。如： 输出[“1”， “2”， “3”]这个名为number的集合，可以用              ${number[0]}来输出第一个数字。FreeMarker还支持用number[1..2]来表示原 集合的子集合[“2”， “3”]。


3. 输出Map元素
    对于JavaBean实例，FreeMarker一样把它看作属性为key，属性值为value的Map对象。
    输出Map对象时，可以使用点语法或中括号语法，如下面的几种写法的效果是一样的：
             book.author.name                                                                                                                         
             book.author["name"]                                                                                                                      
             book["author"].name                                                                                                                      
             book["author"]["name"]                                                                                                           

使用点语法时，变量名字有和顶层变量一样的限制，但中括号语法没有任何限制。

3.3字符串操作

1. 字符串连接
    字符串连接有两种语法：
        (1)使用${..}或#{..}在字符串常量内插入表达式的值；
        (2)直接使用连接运算符“+”连接字符串。
        如，下面两种写法等效：
              ${"Hello, ${user}"}                                                                                                                
              ${"Hello, " + user + "!"}        

                                                                                                 
有一点需要注意： ${..}只能用于文本部分作为插值输出，而不能用于比较等其他用途，如：
              <#if ${isBig}>Wow!</#if>                                                                                                                
              <#if "${isBig}">Wow!</#if>                                                                                                              
应该写成：
              <#if isBig>Wow!</#if>                                                                                                                     


2. 截取子串
    截取子串可以根据字符串的索引来进行，如果指定一个索引值，则取得字符串该索引处的字符；如果指定两个索引值，则截取两     个索引中间的字符串子串。如：
              <#assign number="01234">
              ${number[0]} <#-- 输出字符0 -->
              ${number[0..3]} <#-- 输出子串“0123” -->

3.4、集合连接操作

    连接集合的运算符为“+”

3.5、Map连接操作

    Map连接操作的运算符为“+”

3.6、算术运算符

    FreeMarker表达式中支持“+”、“－”、“*”、“/”、“%”运算符。

3.7、比较运算符

表达式中支持的比较运算符有如下几种：
    1. =（或者==）： 判断两个值是否相等；
    2. !=： 判断两个值是否不相等；
    注： =和!=可以用作字符串、数值和日期的比较，但两边的数据类型必须相同。而且FreeMarker的比较是精确比较，不会忽略大小写及空格。
    3. >（或者gt）： 大于
    4. >=（或者gte）： 大于等于
    5. <（或者lt）： 小于
    6. <=（或者lte）： 小于等于
    注： 上面这些比较运算符可以用于数字和日期，但不能用于字符串。大部分时候，使用gt比>有更好的效果，因为FreeMarker会把>解释成标签的结束字符。可以使用括号来避免这种情况，如：<#if (x>y)>。

if else 语句测试：
<#if num0 gt 18>  <#--不是使用>，大部分时候，freemarker会把>解释成标签结束！ -->
及格！
<#else>
不及格！
</#if>
root.put("num0", 18);

3.8、逻辑运算符

1. &&： 逻辑与；
2. ||： 逻辑或；
3. !： 逻辑非
逻辑运算符只能用于布尔值。