Spring MVC整合 freemarker教程

1、介绍

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

                 开发工具：idea                 项目构建：maven                 开发语言：Java                 整合框架：SpringMVC                 技术简介：freemarker模板                 GitHub代码下载：点击下载

1.1、freemarker手册的介绍freemarker

1.2、项目模块结构截图

2、整合案例
2.1、添加依赖
[java] view plain copy
print?在CODE上查看代码片派生到我的代码片

<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的配置没变
[java] view plain copy
print?在CODE上查看代码片派生到我的代码片

<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的配置）
[java] view plain copy
print?在CODE上查看代码片派生到我的代码片

<?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）
[java] view plain copy
print?在CODE上查看代码片派生到我的代码片

<!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入门案例（页面、其实就是想两个模板来回切换）
[java] view plain copy
print?在CODE上查看代码片派生到我的代码片

<%@ 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
[java] view plain copy
print?在CODE上查看代码片派生到我的代码片

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，则字符串内的所有字符都将直接输出。

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

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

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

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

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

6. 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!