springmvc+freemarker生成静态html文件

参考资料：

http://mylfd.iteye.com/blog/1896501

http://www.cnblogs.com/xxt19970908/p/5553045.html

个人实践：

1、需求：创建优惠券功能模块，操作人员选择若干条商品，点击生成按钮，程序在服务器指定目录下生成静态的优惠券页面。

2、实现：此处只列出使用freemarker生成优惠券部分的解决方案。

2.1、dispatcher-servlet.xml文件

<!--freemarker页面解析器 -->
    <bean id="viewResolver"
        class="org.springframework.web.servlet.view.freemarker.FreeMarkerViewResolver">
        <property name="suffix" value=".ftl"></property>
        <property name="contentType" value="text/html;charset=UTF-8" />
    <!--         <property name="viewClass" value="org.springframework.web.servlet.view.freemarker.FreeMarkerView" /> -->
        <!-- 将Spring的FreeMarkerView改成我们扩展的View -->
        <property name="viewClass" value="com.fx.controller.ExFreeMarkerView" />
        <property name="exposeRequestAttributes" value="true" />
        <property name="exposeSessionAttributes" value="true" />
        <property name="exposeSpringMacroHelpers" value="true" />
    </bean>
    <bean id="fmXmlEscape" class="freemarker.template.utility.XmlEscape" />
    <!--配置Freemarker -->
    <bean id="freemarkerConfigurer"
        class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
        <!-- 模版页面存放的位置 -->
         <property name="templateLoaderPath" value="/WEB-INF/freemarker/"></property>
        <property name="freemarkerVariables">
            <map>
                <entry key="xml_escape" value-ref="fmXmlEscape" />
            </map>
        </property>
        <property name="freemarkerSettings">
            <props>
                <prop key="template_update_delay">10</prop>
                <prop key="defaultEncoding">UTF-8</prop>
            </props>
        </property>
    </bean>
    <!-- 定义跳转的文件的前后缀 ，视图模式配置 -->
    <bean
        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>

说明：在加入freemarker以前，我的internalResourceViewResolver就存在，加入freemarker以后，需要把freemarker的viewResolver放在它前面，让freemarker优先过滤用户请求的url，如果发现模板

目录（用户自定义的templateLoaderPath属性）下有对应名字的模板文件(后缀名.ftl)，就在contoller执行以后由freemarker的viewResolver处理页面的展示；如果没发现对应的模板文件，就由internalResourceViewResolver

处理。比如：用户有个请求"/abc"，如果存在abc.ftl模板，则RequestMapping("/abc")的controller方法执行后，由freemarker的viewResolver的viewClass，来处理。

2.2、viewClass类

 import java.io.BufferedWriter;
 import java.io.File;
 import java.io.FileOutputStream;
 import java.io.IOException;
 import java.io.OutputStreamWriter;
 import java.io.Writer;
 import java.util.Locale;
 import java.util.Map;

 import javax.servlet.ServletException;
 import javax.servlet.http.HttpServletRequest;
 import javax.servlet.http.HttpServletResponse;

 import org.springframework.web.servlet.support.RequestContextUtils;
 import org.springframework.web.servlet.view.freemarker.FreeMarkerView;

 import com.fx.util.PathUtil;

 import freemarker.template.SimpleHash;
 import freemarker.template.Template;
 import freemarker.template.TemplateException;

 public class ExFreeMarkerView extends FreeMarkerView {
     @Override
     protected void doRender(Map<String, Object> model, HttpServletRequest request, HttpServletResponse response)
             throws Exception {

         exposeModelAsRequestAttributes(model, request);

         SimpleHash fmModel = buildTemplateModel(model, request, response);

         if (logger.isDebugEnabled()) {
             logger.debug("Rendering FreeMarker template [" + getUrl() + "] in FreeMarkerView '" + getBeanName() + "'");
         }

         Locale locale = RequestContextUtils.getLocale(request);

         /*
          * 在这里我们默认生成静态文件,当ModelAndView有指定STATIC_HTML = false时,就不会输出HTML文件
          * 例如：ModelAndView modelAndView = new ModelAndView("htmlTest");
          * modelAndView.addObject("STATICHTML", false);
          */
         if (Boolean.FALSE.equals(model.get("STATIC_HTML"))) {
             processTemplate(getTemplate(locale), fmModel, response);
         } else {
             createHTML(getTemplate(locale), fmModel, request, response);
         }

     }

     public void createHTML(Template template, SimpleHash model, HttpServletRequest request,
             HttpServletResponse response) throws IOException, TemplateException, ServletException {
         // create file
         String ftlFilesSaveDiskFolderPath = PathUtil.getStaticHtmlsSaveDiskFolderPath(request);
         String randomDatePath = PathUtil.getRandomDatePath();
         String randomDatePath2 = PathUtil.parseRandomDatePathToUrlPattern(randomDatePath);
         String fileName = PathUtil.getNewHtmlFileName("test.html");
         File htmlFile = new File(ftlFilesSaveDiskFolderPath+randomDatePath+fileName);
         htmlFile.deleteOnExit();
         if (!htmlFile.getParentFile().exists()) {
             htmlFile.getParentFile().mkdirs();
         }
         if (!htmlFile.exists()) {
             htmlFile.createNewFile();
         }

         // write file
         Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(htmlFile), "UTF-8"));
         template.process(model, out);
         out.flush();
         out.close();

         // store info
         request.getSession().setAttribute("addCoupon_staticPage", randomDatePath2+fileName);

         // request forward
         request.getRequestDispatcher("/coupons/previewCoupon").forward(request, response);
     }
 }

说明：createHTML方法主要目的是将model通过输出流输出到我们自定义的文件中。doRender方法中，如果不需要静态页面，需要手动给model的STATIC_HTML传值为false，默认调用用户自定义的createHTML，当然，这个逻辑可以自己扩展。

3、freemarker模板页面的常用语法：

http://mylfd.iteye.com/blog/1894407