FreeMarker环境搭建

FreeMarker 概述

FreeMarker 是⼀款 模板引擎： 即⼀种基于模板和要改变的数据， 并⽤来⽣成输出⽂本(HTML⽹⻚，电⼦邮件，配置⽂件，源代码等)的通⽤⼯具。 是⼀个Java类库
FreeMarker 被设计⽤来⽣成 HTML Web ⻚⾯，特别是基于 MVC 模式的应⽤程序，将视图从业务逻辑中
抽离处理，业务中不再包括视图的展示，⽽是将视图交给 FreeMarker 来输出。虽然 FreeMarker 具有⼀
些编程的能⼒，但通常由 Java 程序准备要显示的数据，由 FreeMarker ⽣成⻚⾯，通过模板显示准备的
数据（如下图）

FreeMarker不是⼀个Web应⽤框架，⽽适合作为Web应⽤框架⼀个组件。
FreeMarker与容器⽆关，因为它并不知道HTTP或Servlet。FreeMarker同样可以应⽤于⾮Web应⽤程序环境。
FreeMarker更适合作为Model2框架（如Struts）的视图组件，你也可以在模板中使⽤JSP标记库。
FreeMarker特性
通⽤⽬标
能够⽣成各种⽂本：HTML、XML、RTF、Java 源代码等等
易于嵌⼊到你的产品中：轻量级；不需要 Servlet 环境
插件式模板载⼊器：可以从任何源载⼊模板，如本地⽂件、数据库等等
你可以按你所需⽣成⽂本：保存到本地⽂件；作为 Email 发送；从 Web 应⽤程序发送它返回给 Web 浏览器

FreeMarker环境搭建

新建 Maven Web项⽬

配置坐标依赖和部署插件
pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<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/xsd/maven-4.0.0.xsd">
 <modelVersion>4.0.0</modelVersion>
 <groupId>com.xxxx</groupId>
 <artifactId>freemarker</artifactId>
 <version>1.0-SNAPSHOT</version>
 <packaging>war</packaging>
 <name>freemarker Maven Webapp</name>
 <!-- FIXME change it to the project's website -->
 <url>http://www.example.com</url>
 <properties>
 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 <maven.compiler.source>1.8</maven.compiler.source>
 <maven.compiler.target>1.8</maven.compiler.target>
 </properties>
  <dependencies>
 <!-- freemarker的坐标依赖 -->
 <dependency>
 <groupId>org.freemarker</groupId>
 <artifactId>freemarker</artifactId>
 <version>2.3.23</version>
 </dependency>
 <!-- servlet-api的坐标依赖 -->
 <dependency>
 <groupId>javax.servlet</groupId>
 <artifactId>javax.servlet-api</artifactId>
 <version>3.0.1</version>
 </dependency>
 </dependencies>
 <build>
 <finalName>freemarker</finalName>
 <!--
 插件地址：
 Tomcat
 http://tomcat.apache.org/maven-plugin-2.2/
 Jetty
 https://www.eclipse.org/jetty/documentation/current/jetty-mavenplugin.html
 -->
 <plugins>
 <!-- 配置jetty插件 -->
 <plugin>
 <groupId>org.eclipse.jetty</groupId>
 <artifactId>jetty-maven-plugin</artifactId>
 <version>9.2.1.v20140609</version>
 </plugin>
 </plugins>
 </build>
</project>

修改配置⽂件 web.xml

在项⽬的webapp/WEB-INF⽬录下的web.xml⽂件中，添加freemarker 相关 servlet 配置
<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="3.0"
 xmlns="http://java.sun.com/xml/ns/javaee"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
 <!-- FreeMarker 的Servlet配置 -->
 <servlet>
 <servlet-name>freemarker</servlet-name>
 <servlet-class>freemarker.ext.servlet.FreemarkerServlet</servlet-class>
 <init-param>
 <!-- 模板路径 -->
 <param-name>TemplatePath</param-name>
 <!-- 默认在webapp⽬录下查找对应的模板⽂件 -->
 <param-value>/</param-value>
 </init-param>
 <init-param>
 <!-- 模板默认的编码：UTF-8 -->
 <param-name>default_encoding</param-name>
 <param-value>UTF-8</param-value>
 </init-param>
 </servlet>
 <!-- 处理所有以.ftl结尾的⽂件；ftl是freemarker默认的⽂件后缀 -->
 <servlet-mapping>
 <servlet-name>freemarker</servlet-name>
 <url-pattern>*.ftl</url-pattern>
 </servlet-mapping>
</web-app>

编写Servlet类

package com.xxxx.controllter;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
@WebServlet("/f01")
public class FreeMarker01 extends HttpServlet {
 @Override
 protected void service(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
 // 添加数据
 request.setAttribute("msg","Hello FreeMarker!");
 // 请求转发跳转到ftl⽂件中
 request.getRequestDispatcher("template/f01.ftl").forward(request,response);
 }
}

新建模板⽂件 ftl
在webapp⽬录下新建template⽂件夹，创建f01.ftl⽂件

启动项⽬

访问项⽬
浏览器地址栏输⼊：http://localhost:8989/f01