freemarker

1. 什么是Freemarker
   FreeMarker是一个用Java语言编写的模板引擎，它基于模板来生成文本输出。FreeMarker与Web容器无关，即在Web运行时，它并不知道Servlet或HTTP。它不仅可以用作表现层的实现技术，而且还可以用于生成XML，JSP或Java 等。

目前企业中:主要用Freemarker做静态页面或是页面展示

2. Freemarker的使用方法
   把freemarker的jar包添加到工程中。
   Maven工程添加依赖

org.freemarker freemarker 2.3.23 原理：

使用步骤：
第一步：创建一个Configuration对象，直接new一个对象。构造方法的参数就是freemarker对于的版本号。
第二步：设置模板文件所在的路径。
第三步：设置模板文件使用的字符集。一般就是utf-8.
第四步：加载一个模板，创建一个模板对象。
第五步：创建一个模板使用的数据集，可以是pojo也可以是map。一般是Map。
第六步：创建一个Writer对象，一般创建一FileWriter对象，指定生成的文件名。
第七步：调用模板对象的process方法输出文件。
第八步：关闭流。

模板：
${hello}

@Test
public void genFile() throws Exception {
// 第一步：创建一个Configuration对象，直接new一个对象。构造方法的参数就是freemarker对于的版本号。
Configuration configuration = new Configuration(Configuration.getVersion());
// 第二步：设置模板文件所在的路径。
configuration.setDirectoryForTemplateLoading(new File(“D:/workspaces-itcast/term197/taotao-item-web/src/main/webapp/WEB-INF/ftl”));
// 第三步：设置模板文件使用的字符集。一般就是utf-8.
configuration.setDefaultEncoding(“utf-8”);
// 第四步：加载一个模板，创建一个模板对象。
Template template = configuration.getTemplate(“hello.ftl”);
// 第五步：创建一个模板使用的数据集，可以是pojo也可以是map。一般是Map。
Map dataModel = new HashMap<>();
//向数据集中添加数据
dataModel.put(“hello”, “this is my first freemarker test.”);
// 第六步：创建一个Writer对象，一般创建一FileWriter对象，指定生成的文件名。
Writer out = new FileWriter(new File(“D:/temp/term197/out/hello.html”));
// 第七步：调用模板对象的process方法输出文件。
template.process(dataModel, out);
// 第八步：关闭流。
out.close();
}
3. 模板的语法
访问map中的key
${key}

访问pojo中的属性
Student对象。学号、姓名、年龄
${key.property}

取集合中的数据
<#list 集合 as 循环的变量>

<#list studentList as student>
$student.id/${studnet.name}
</#list>
去循环中的下标

<#list studentList as student>
${student_index}
</#list>
判断

<#if student_index % 2 == 0>
<#else>
</#if>
日期类型格式化

Null值的处理

Include标签
<#include “模板名称”>

4. Freemarker整合spring
   4.1. 创建整合spring的配置文件

<?xml version="1.0" encoding="UTF-8"?>

<bean id="freemarkerConfig"
    class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
    <property name="templateLoaderPath" value="/WEB-INF/ftl/" />
    <property name="defaultEncoding" value="UTF-8" />
    <property name="freemarkerSettings">
        <!-- 设置默认的编码方式，原先是GBK，需要设置成utf-8 -->
        <props>
                <!--用于解决前端报空指针问题 不用再空值后面+ ！号-->
            <prop key="classic_compatible">true</prop>
           <!--  <prop key="defaultEncoding">utf-8</prop>
            <prop key="template_exception_handler">rethrow</prop> -->
        </props>
    </property>
</bean>

需要编写一Controller进行测试

4.2 Controller
请求的url：/genhtml
参数：无
返回值：ok （String， 需要使用@ResponseBody）
业务逻辑：
1、从spring容器中获得FreeMarkerConfigurer对象。
2、从FreeMarkerConfigurer对象中获得Configuration对象。
3、使用Configuration对象获得Template对象。
4、创建数据集
5、创建输出文件的Writer对象。
6、调用模板对象的process方法，生成文件。
7、关闭流。

加载配置文件：

@Controller
public class HtmlGenController {

@Autowired
private FreeMarkerConfigurer freeMarkerConfigurer;

@RequestMapping("/genhtml")
@ResponseBody
public String genHtml()throws Exception {
    // 1、从spring容器中获得FreeMarkerConfigurer对象。
    // 2、从FreeMarkerConfigurer对象中获得Configuration对象。
    Configuration configuration = freeMarkerConfigurer.getConfiguration();
    // 3、使用Configuration对象获得Template对象。
    Template template = configuration.getTemplate("hello.ftl");
    // 4、创建数据集
    Map dataModel = new HashMap<>();
    dataModel.put("hello", "1000");
    // 5、创建输出文件的Writer对象。
    Writer out = new FileWriter(new File("D:/temp/term197/out/spring-freemarker.html"));
    // 6、调用模板对象的process方法，生成文件。
    template.process(dataModel, out);
    // 7、关闭流。
    out.close();
    return "OK";
}

}
5. 商品详情页面静态化
5.1 网页的静态化方案
输出文件的名称：商品id+“.html”
输出文件的路径：工程外部的任意目录。
网页访问：使用nginx访问网页。在此方案下tomcat只有一个作用就是生成静态页面。
工程部署：可以把taotao-item-web部署到多个服务器上。
生成静态页面的时机：商品添加后，生成静态页面。可以使用Activemq，订阅topic（商品添加）

3.5.2. MessageListener
需要实现MessageListener，把Active的客户端jar包的依赖添加到工程中。

业务逻辑：
1、创建一个MessageListener接口的实现类
2、从message中取商品id
3、查询商品基本消息、商品描述。
4、创建商品详情页面的模板。
5、指定文件输出目录
6、生成静态文件。

安装http服务器。

public class HtmlGenListener implements MessageListener {

@Autowired
private ItemService itemService;
@Autowired
private FreeMarkerConfigurer freeMarkerConfigurer;
@Value("${HTML_OUT_PATH}")
private String HTML_OUT_PATH;

@Override
public void onMessage(Message message) {
    try {
        // 1、创建一个MessageListener接口的实现类
        // 2、从message中取商品id
        TextMessage textMessage = (TextMessage) message;
        String strItemId = textMessage.getText();
        Long itemId = new Long(strItemId);
        // 3、查询商品基本消息、商品描述。
        TbItem tbItem = itemService.getItemById(itemId);
        Item item = new Item(tbItem);
        TbItemDesc tbItemDesc = itemService.getItemDescById(itemId);
        //创建数据集
        Map data = new HashMap<>();
        data.put("item", item);
        data.put("itemDesc", tbItemDesc);
        // 4、创建商品详情页面的模板。
        // 5、指定文件输出目录
        Configuration configuration = freeMarkerConfigurer.getConfiguration();
        Template template = configuration.getTemplate("item.htm");
        FileWriter out = new FileWriter(new File(HTML_OUT_PATH + itemId + ".html"));
        // 6、生成静态文件。
        template.process(data, out);
        //关闭流
        out.close();
    } catch (Exception e) {
        e.printStackTrace();
    }
}

}
3.5.3. Spring配置文件

<?xml version="1.0" encoding="UTF-8"?>

<!-- 真正可以产生Connection的ConnectionFactory，由对应的 JMS服务厂商提供 -->
<bean id="targetConnectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">
    <property name="brokerURL" value="tcp://192.168.25.168:61616" />
</bean>
<!-- Spring用于管理真正的ConnectionFactory的ConnectionFactory -->
<bean id="connectionFactory"
    class="org.springframework.jms.connection.SingleConnectionFactory">
    <!-- 目标ConnectionFactory对应真实的可以产生JMS Connection的ConnectionFactory -->
    <property name="targetConnectionFactory" ref="targetConnectionFactory" />
</bean>
<!--这个是主题目的地，一对多的 -->
<bean id="topicDestination" class="org.apache.activemq.command.ActiveMQTopic">
    <constructor-arg value="item-add-topic" />
</bean>

<!-- 配置消息监听器 -->
<bean id="htmlGenListener" class="com.taotao.item.listener.HtmlGenListener"/>
<!-- 配置监听容器 -->
<!-- 消息监听容器 -->
<bean class="org.springframework.jms.listener.DefaultMessageListenerContainer">
    <property name="connectionFactory" ref="connectionFactory" />
    <property name="destination" ref="topicDestination" />
    <property name="messageListener" ref="htmlGenListener" />
</bean>