ssm整合freemarker的入门案例

本案例使用IDEA创建的maven的webapp项目
本案例注意要点：freemarker有专门的视图解析器，ssm整合freemarker时，springmvc的视图解析器一定不要出现，只能使用freemarker的视图解析器，不然会报错。两个视图解析器具体见下面的spring.xml

ssm整合freemarker要点： 一个是spring.xml配置文件freemarker视图解析器的配置，另一个是index.ftl模板文件的书写

---

步骤一：在pom.xml文件中导入依赖

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.7</maven.compiler.source>
    <maven.compiler.target>1.7</maven.compiler.target>
    <springversion>5.0.8.RELEASE</springversion>
  </properties>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
    </dependency>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope>
    </dependency>
    <!-- 加入ServletAPI --><!--从此处下面，依赖权威重点，上面一个依赖是自带的-->
    <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>3.1.0</version>
      <scope>provided</scope>
    </dependency>

    <!-- MySQL依赖 start -->
    <dependency>
      <groupId>mysql</groupId>
      <artifactId>mysql-connector-java</artifactId>
      <version>5.1.38</version>
    </dependency>

    <!-- 加入MyBatis 依赖 start -->
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis</artifactId>
      <version>3.2.8</version>
    </dependency>

    <!-- 引入Spring(包含SpringMVC) 依赖 start -->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-core</artifactId>
      <version>${springversion}</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-web</artifactId>
      <version>${springversion}</version>
    </dependency>
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-oxm</artifactId>
      <version>${springversion}</version>
    </dependency>

    <!--service层事务管理的包-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-tx</artifactId>
      <version>${springversion}</version>
    </dependency>


    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-jdbc</artifactId>
      <version>${springversion}</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>${springversion}</version>
    </dependency>
    <!--写aop增强的包-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-aop</artifactId>
      <version>${springversion}</version>
    </dependency>
    <!--aop使用一定要导cglib，因为aop底层就是用cglib实现的-->
    <dependency>
      <groupId>cglib</groupId>
      <artifactId>cglib</artifactId>
      <version>3.2.4</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-context-support</artifactId>
      <version>${springversion}</version>
    </dependency>

    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-test</artifactId>
      <version>${springversion}</version>
    </dependency>

    <!-- 引用c3p0 依赖 start
    <dependency>
        <groupId>com.mchange</groupId>
        <artifactId>c3p0</artifactId>
        <version>0.9.2.1</version>
    </dependency>
     -->
    <!-- 引用插件依赖：MyBatis整合Spring,如果mybatis版本在3.4及以上版本
       mybatis-spring的版本要在1.3以上	  -->
    <dependency>
      <groupId>org.mybatis</groupId>
      <artifactId>mybatis-spring</artifactId>
      <version>1.2.2</version>
    </dependency>

    <!-- JSTL -->
    <dependency>
      <groupId>jstl</groupId>
      <artifactId>jstl</artifactId>
      <version>1.2</version>
    </dependency>

    <!-- 德鲁伊数据连接池 -->
    <dependency>
      <groupId>com.alibaba</groupId>
      <artifactId>druid</artifactId>
      <version>1.0.9</version>
    </dependency>

    <!-- pagehelper -->
    <dependency>
      <groupId>com.github.pagehelper</groupId>
      <artifactId>pagehelper</artifactId>
      <version>4.1.6</version>
    </dependency>
    <!--处理json-->
    <dependency>
      <groupId>com.fasterxml.jackson.core</groupId>
      <artifactId>jackson-databind</artifactId>
      <version>2.9.5</version>
    </dependency>
    <!--导出excel-->
    <dependency>
      <groupId>org.apache.poi</groupId>
      <artifactId>poi</artifactId>
      <version>3.6</version>
    </dependency>
    <!--javaee-->
    <dependency>
      <groupId>javax</groupId>
      <artifactId>javaee-api</artifactId>
      <version>7.0</version>
      <scope>provided</scope>
    </dependency>
    <!--文件上传下载-->
    <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.3.1</version>
    </dependency>

    <dependency>
      <groupId>commons-io</groupId>
      <artifactId>commons-io</artifactId>
      <version>2.4</version>
    </dependency>
    <dependency>
      <groupId>joda-time</groupId>
      <artifactId>joda-time</artifactId>
      <version>2.9.9</version>
    </dependency>

    <dependency>
      <groupId>org.mybatis.generator</groupId>
      <artifactId>mybatis-generator-core</artifactId>
      <version>1.3.5</version>
    </dependency>
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-api</artifactId>
      <version>1.7.5</version>
    </dependency>
    <dependency>
      <groupId>org.slf4j</groupId>
      <artifactId>slf4j-log4j12</artifactId>
      <version>1.7.12</version>
    </dependency>
    <dependency>
      <groupId>log4j</groupId>
      <artifactId>log4j</artifactId>
      <version>1.2.17</version>
    </dependency>
    <dependency>
      <groupId>org.apache.poi</groupId>
      <artifactId>poi</artifactId>
      <version>3.6</version>
    </dependency>
    
<!--freemarker依赖-->
    <dependency>
      <groupId>org.freemarker</groupId>
      <artifactId>freemarker</artifactId>
      <version>2.3.23</version>
    </dependency>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>RELEASE</version>
    </dependency>
  </dependencies>

步骤二：在resouces下创建spring.xml问价配置freemarker视图解析器解析器，controller类跳转页面的前后缀

<?xml version="1.0" encoding="UTF-8"?>
<!--加p、tx、mvc、context命名空间-->
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:p="http://www.springframework.org/schema/p"
       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/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
http://www.springframework.org/schema/tx
                           http://www.springframework.org/schema/tx/spring-tx.xsd">



    <!--连接数据库，即创建数据库连接对象-->
    <bean id="db" class="com.alibaba.druid.pool.DruidDataSource"><!--druid连接池包路径，其他两个连接池路径自己不知道可以网上找找。找到评论留言，分享给其他人吧-->
        <property name="username" value="root"></property><!--你连接的数据库的用户名-->
        <property name="password" value="root"></property><!--连接的数据库的密码-->
        <property name="url" value="jdbc:mysql://localhost:3306/hospital"></property><!--连接的数据库的地址，此处的数据库名叫hospital-->
        <property name="driverClassName" value="com.mysql.jdbc.Driver"></property><!--根据使用的数据库连接池以及数据库，找对应的连接池，三种连接池，druid,c3p0，dbcp。去百度吧。此处用的druid连接池和myql数据库-->
    </bean>
    <!--用context命名空间扫描注解包-->
    <context:component-scan base-package="com"><!--扫描com包下的所有注解，这个com包是我们自定义的，我们创建的所有java类都放在该包下面，具体可见最下面的案例框架图的com包的位置--></context:component-scan>
    <!--创建InternalResourceViewResolver视图解析器，注意下面这四行，尤其是前后缀的这两行会影响你在跳转页面的前后缀名，如return "/index.jsp"，在使用这两句前后缀语句后，只需return "index"即可-->
    <!--<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">-->
        <!--<property name="prefix" value="/"></property> &lt;!&ndash;给return跳转页面时加前缀&ndash;&gt;-->
        <!--<property name="suffix" value=".html"></property>&lt;!&ndash;加后缀&ndash;&gt;-->
    <!--</bean>-->
    <!--用MVC命名空间加注解驱动-->
    <mvc:annotation-driven></mvc:annotation-driven><!--也是用于转换json必不可少的部分，另一个就是jackson包-->
    <!--创建sqlsesion工厂,专门读取xml文件的-->
    <bean id="factory" class="org.mybatis.spring.SqlSessionFactoryBean"><!--org.mybatis.spring.SqlSessionFactoryBean整合了mybatis和sring中的sqlsession-->
        <property name="dataSource" ref="db"></property><!--将数据库连接赋进dataSource属性中-->
        <!--<property name="mapperLocations" value="classpath:mapper/*.xml"></property>&lt;!&ndash;mapper文件下的所有xml文件,不然创建一个扫描一个。此处*.xml爆红代表你mapper文件夹下还没创建xml文件&ndash;&gt;-->
        <property name="configLocation" value="classpath:mybatis-config.xml"></property><!--加载mybatis-config.xml配置文件-->
    </bean>
    <!--使用dao层实现类的时候，需要得到sqlSessionTemplate对象
      <bean class="org.mybatis.spring.SqlSessionTemplate">
          <constructor-arg index="0" ref="factory"></constructor-arg>&lt;!&ndash;将上面创建好的sqlsesion对象当成SqlSessionTemplate类的一个构造参数&ndash;&gt;
      </bean>-->
    <!--6.省略dao实现类，扫描dao层的接口-->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.qf.dao"></property>
        <property name="sqlSessionFactoryBeanName" value="factory" ></property>
    </bean>
    <bean id="tx" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="db"></property>
    </bean>
    <tx:advice id="ad"  transaction-manager="tx" ></tx:advice><!--id必须起个名字-->

    <!--8.配置静态资源，如果不写，静态资源无法显示在网页中。这段话是根据后缀名判断是否是静态资源的，这是其优势也是劣势。当controller的RequestMapping的请求地址为jsp时可测试出来。这是因为我们在web.xml文件中拦截了除jsp外的所有静态资源，而所有资源走的都是dispatcherservlet，然后dispatcherservlet会去找到handler，这也是为什么最终由RequestMapping请求路径后缀来判断-->
    <mvc:default-servlet-handler></mvc:default-servlet-handler>


    <!--freemarker解析器-->
    <bean id="configruration"
          class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
        <!-- 模板放置的位置  / classpath resources-->
        <property name="templateLoaderPath" value="/" /><!--"/"表示ftl模板文件必须放在webapp下。ftl模板放在WEB-INF下的ftl文件夹下时value=/WEB-INF/ftl/，这表示ftl模板文件的位置-->
        <property name="defaultEncoding" value="UTF-8" />
    </bean>

    <!-- 页面访问-->
    <bean class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver"><!--使用了freemarker视图解析器则必须把InternalResourceViewResolver这个springmvc的视图解析器去掉-->
        <property name="contentType" value="text/html;charset=utf-8"/>
        <property name="prefix" value="/" /><!--前缀，此时省略也没事-->
        <property name="suffix" value=".ftl" /><!--controller层跳转的后缀，当index.ftl模板文件放在webapp下时访问路径：http://localhost:8080/index.ftl-->
    </bean>
</beans>

步骤三：创建mybatis-config.xml配置文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
    <!--给类起别名,默认是包下的类名首字母小写，后面字母不变就是它对应的别名。这个别名是给mapper文件省略类路径用的，如parameter、resultType等。基本类型mybatis已经七号别名了，因此只用管我们自建的实体类即可-->
    <!--<typeAliases>
        &lt;!&ndash;<typeAlias type="com.entity.Student" alias="abc"></typeAlias>&ndash;&gt;
        <package name="com.qf.entity"></package>
    </typeAliases>-->

    <!--   &lt;!&ndash;展示出mapper文件中执行的sql语句的详细情况&ndash;&gt;
   <settings>
       <setting name="logImpl" value="STDOUT_LOGGING"></setting>
   </settings>-->

    <!--插件写在plugins标签中，这里使用的就是分页插件-->
    <plugins>
        <plugin interceptor="com.github.pagehelper.PageHelper">
            <property name="dialect" value="mysql"/>
        </plugin>
    </plugins>
</configuration>

步骤四：配置web.xml文件

<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns="http://java.sun.com/xml/ns/javaee"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5"><!--头部信息换成2.5的,不然下面的某些东西可能无发生效-->


  <display-name>Archetype Created Web Application</display-name>
  <!--利用DispatcherServlet核心类加载spring.xml配置文件-->
  <servlet>
    <servlet-name>aa</servlet-name><!--与servlet-mapping中的servlet-name要保持一致-->
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:spring.xml</param-value>
    </init-param>
  </servlet>

  <servlet-mapping>
    <servlet-name>aa</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>



  <!--处理post乱码，设置字符集-->
  <filter>
    <filter-name>bb</filter-name><!--与下面的filter-mapping中的filter-name一致-->
    <filter-class>
      org.springframework.web.filter.CharacterEncodingFilter
    </filter-class>
    <init-param>
      <param-name>encoding</param-name>
      <param-value>utf-8</param-value>
    </init-param>
  </filter>

  <filter-mapping>
    <filter-name>bb</filter-name>
    <url-pattern>/*
  

步骤五：在controller层创建类，传递数据测试f配置好的tl模板是否好用

该案例将该controller类命名为：IndexController

package com.qf.controller;

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

import java.util.ArrayList;
import java.util.List;



@Controller
public class IndexController {

    @RequestMapping("/index")
    public String index(Model model){
        //跳转到 index.ftl
        //共享域
        model.addAttribute("name", "二狗子");

        List<String> list = new ArrayList<>();
        for (int i = 0; i < 10; i++) {
            list.add("小花"+i);
        }

        model.addAttribute("list",list);//将集合放进共享域，list必须与ftl模板中的key保持一致
        return "index";
    }


}

步骤六：创建ftl模板文件

该案例将该模板文件命名为：index.ftl

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>


    ${name}

    <#list list as item>

          ${item}

    </#list>

</body>
</html>

---

本案例框架结构图：

页面访问效果：
注意访问由于由controller跳转，加上此时ftl是在webapp下生成，直接访问不会被拦截，因此它有两种访问方式：①通过controller请求地址转发访问，地址为：http://localhost:8080/index。
②通过页面名称直接访问,地址为：http://localhost:8080/index.ftl
页面展示结果：