springmvc整合freemarker教程

来源：互联网发布：hypermill软件编辑：程序博客网时间：2024/05/17 22:29

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地址 * @进度描述 */@Controllerpublic 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. !：逻辑非
逻辑运算符只能用于布尔值。

0 0