关于Freemarker生成静态html文件及中文乱码的问题

最新推荐文章于 2021-07-14 16:13:10 发布

iteye_16154

最新推荐文章于 2021-07-14 16:13:10 发布

阅读量457

点赞数

分类专栏： Java 文章标签： freemarker HTML Servlet 框架 Web

本文链接：https://blog.csdn.net/iteye_16154/article/details/81767774

版权

Java 专栏收录该内容

77 篇文章 0 订阅

订阅专栏

转自：http://blog.csdn.net/it_man/archive/2009/01/17/3808697.aspx

先看生成静态html文件：
FreeMarker允许Java servlet保持图形设计同应用程序逻辑的分离，这是通过在模板中密封HTML完成的。模板用servlet提供的数据动态地生成 HTML。模板语言是强大的直观的，编译器速度快，输出接近静态HTML页面的速度。

FreeMarker是一个模板引擎，一个基于模板生成文本输出的通用工具，使用纯Java编写
FreeMarker被设计用来生成HTML Web页面，特别是基于MVC模式的应用程序
虽然FreeMarker具有一些编程的能力，但通常由Java程序准备要显示的数据，由FreeMarker生成页面，通过模板显示准备的数据
FreeMarker不是一个Web应用框架，而适合作为Web应用框架一个组件
FreeMarker与容器无关，因为它并不知道HTTP或Servlet；FreeMarker同样可以应用于非Web应用程序环境
FreeMarker更适合作为Model2框架（如Struts）的视图组件，你也可以在模板中使用JSP标记库
FreeMarker是免费的

模板:
　

<html>
<head>
<title>查看文章: ${newsitem.title} </title>
</head>
<body>
<table width="100%" border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF">
<tr><td>
<table width="95%" border="0" align="center" cellpadding="2" cellspacing="6" >
	<tr> 
      <td height="10" align="left" colspan=2 ></td>
    </tr>
    <tr>
     	  <td align="left" width="538" >
     	  <strong>${newsitem.title}</strong> ( ${newsitem.addtime} )
          </td>
          <td align="right">
			<a href="index.jsp">返回</a>
			        
          </td>
    </tr>
    <tr>                      
         <td align="left" valign=top colspan=2>
         <hr align="left"  width="95%" size="1" noshade color="#cc0000" >
         </td>
    </tr>
    <tr>                      
      <td colspan=2>${newsitem.showContent}
	  </td>
    </tr>
</table>            

<br>
</td></tr>
</table>
</body>

</html>

　

代码:

import java.io.*;
import java.util.HashMap;
import java.util.Map;

import org.apache.commons.logging.Log;
import org.apache.commons.logging.LogFactory;
import freemarker.template.*;
/*
* Created on 2005-4-7
 *
 */

/**
 * 测试FreeMarker.
 *
 * @author scud
 *
 */
public class FreeMarkerTest
{

        private final Log logger = LogFactory.getLog(getClass());
        private Configuration freemarker_cfg = null;
        public static void main(String[] args)
        {
            //@todo 自己的一个类
            NewsItem aItem = null;

            //@todo 装入新闻
            //NewsItem = loadNewsItem(1);

            FreeMarkerTest test = new FreeMarkerTest();

            Map root = new HashMap();
            root.put("newsitem", aItem);
            String sGeneFilePath = "/tpxw/";
            String sFileName = "1.htm";
            boolean bOK = test.geneHtmlFile("/tpxw/view.ftl",root, sGeneFilePath,sFileName);
        }


        /**
         * 获取freemarker的配置. freemarker本身支持classpath,目录和从ServletContext获取.
         */
        protected Configuration getFreeMarkerCFG()
        {
            if (null == freemarker_cfg)
            {
                // Initialize the FreeMarker configuration;
                // - Create a configuration instance
                freemarker_cfg = new Configuration();

                // - FreeMarker支持多种模板装载方式,可以查看API文档,都很简单:路径,根据Servlet上下文,classpath等等

                //htmlskin是放在classpath下的一个目录
                freemarker_cfg.setClassForTemplateLoading(this.getClass(), "/htmlskin");
            }
            return freemarker_cfg;
        }

        /**
         * 生成静态文件.
         *
         * @param templateFileName 模板文件名,相对htmlskin路径,例如"/tpxw/view.ftl"
         * @param propMap 用于处理模板的属性Object映射
         * @param htmlFilePath 要生成的静态文件的路径,相对设置中的根路径,例如 "/tpxw/1/2005/4/"
         * @param htmlFileName 要生成的文件名,例如 "1.htm"
         */
        public boolean geneHtmlFile(String templateFileName,Map propMap, String htmlFilePath,String htmlFileName )
        {
               //@todo 从配置中取得要静态文件存放的根路径:需要改为自己的属性类调用
            String sRootDir = "e:/webtest/htmlfile" ;

            try
            {
                Template t = getFreeMarkerCFG().getTemplate(templateFileName);

                //如果根路径存在,则递归创建子目录
                creatDirs(sRootDir,htmlFilePath);

                File afile = new File(sRootDir +"/" +htmlFilePath + "/" + htmlFileName);
                Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(afile)));
                t.process(propMap, out);
            }
            catch (TemplateException e)
            {
                logger.error("Error while processing FreeMarker template " + templateFileName,e);
                return false;
            }
            catch (IOException e)
            {
                logger.error("Error while generate Static Html File " + htmlFileName,e);
                return false;
            }
            return true;
        }


        /**
         * 创建多级目录
         *
         * @param aParentDir String
         * @param aSubDir  以 / 开头
         * @return boolean 是否成功
         */
        public static boolean creatDirs(String aParentDir, String aSubDir)
        {
            File aFile = new File(aParentDir);
            if (aFile.exists())
            {
                File aSubFile = new File(aParentDir + aSubDir);
                if (!aSubFile.exists())
                {
                    return aSubFile.mkdirs();
                }
                else
                {
                    return true;
                }
            }
            else
            {
                return false;
            }
        }   



}

编码的问题

这里说的是编码的问题。项目使用的都是UTF-8编码，生成的文件在UTF-8编码下察看是乱码，而GBK正常(后来发现因为我用的中文操作系统所以用GBK查看正常)。
当然我把Freemarker的配置都改成了UTF-8，我的模版文件也是UTF-8编码的。下面是原来的代码

public void setTemplatePath(Resource templatePath) {
        this.templatePath = templatePath;
        //设置freemarker的参数
        freemarkerCfg = new Configuration();
        try {
            freemarkerCfg.setDirectoryForTemplateLoading(this.templatePath.getFile());
            freemarkerCfg.setObjectWrapper(new DefaultObjectWrapper());

            //解决freemarker模板读取后出现乱码的问题
            freemarkerCfg.setDefaultEncoding("UTF-8");
        } catch (IOException ex) {
            throw new SystemException("No Directory found,please check you config.");
        }
    }
    /**
     * 生成静态文件
     * @param templateFileName 模版名称eg:(biz/order.ftl)
     * @param propMap 用于处理模板的属性Object映射 
     * @param htmlFilePath 要生成的静态文件的路径,相对设置中的根路径,例如 "/biz/2006/5/" 
     * @param htmlFileName 要生成的文件名,例如 "123.htm" 
     * @return
     */
    private boolean buildHtml(String templateFileName,Map propMap, String htmlFilePath,String htmlFileName){
        try {
            Template template = freemarkerCfg.getTemplate(templateFileName);
            template.setEncoding("UTF-8");
            //创建生成文件目录
            creatDirs(buildPath.getFilename(),htmlFilePath);
            File htmlFile = new File(buildPath + htmlFilePath + htmlFileName);
            Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(htmlFile)));
            template.process(propMap,out);
            out.flush();
            return true;
        } catch (TemplateException ex){
            log.error("Build Error"+templateFileName,ex);
            return false;
        } catch (IOException e) {
            log.error("Build Error"+templateFileName,e);
            return false;
        }

    }

下面是修改之后的代码

/**
     * 生成静态文件
     * @param templateFileName 模版名称eg:(biz/order.ftl)
     * @param propMap 用于处理模板的属性Object映射 
     * @param htmlFilePath 要生成的静态文件的路径,相对设置中的根路径,例如 "/biz/2006/5/" 
     * @param htmlFileName 要生成的文件名,例如 "123.htm" 
     * @return
     */
    private boolean buildHtml(String templateFileName,Map propMap, String htmlFilePath,String htmlFileName){
        try {
            Template template = freemarkerCfg.getTemplate(templateFileName);
            template.setEncoding("UTF-8");
            //创建生成文件目录
            creatDirs(buildPath.getFilename(),htmlFilePath);
            File htmlFile = new File(buildPath + htmlFilePath + htmlFileName);
            Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(htmlFile),"UTF-8"));
            template.process(propMap,out);
            out.flush();
            return true;
        } catch (TemplateException ex){
            log.error("Build Error"+templateFileName,ex);
            return false;
        } catch (IOException e) {
            log.error("Build Error"+templateFileName,e);
            return false;
        }

    }

原因就在于OutputStreamWriter的不同构造方法

OutputStreamWriter(OutputStream out)
创建使用默认字符编码的 OutputStreamWriter。
OutputStreamWriter(OutputStream out, String charsetName)
创建使用指定字符集的 OutputStreamWriter。

这个是中文JDK的文档说明，刚开始我使用默认的构造函数，所以使用了系统默认的编码，GBK，所以在生成静态文件的时候把UTF-8内容用GBK编码写入了，所以在UTF-8下浏览就有问题。

还有关于修改模版文件同样也要注意这个问题。

public String loadTemplate(String templateName) {
        StringBuffer sb = new StringBuffer();
        try {
            File file = new File(templatePath+"/"+templateName);
            BufferedReader reader = new BufferedReader(new InputStreamReader(new FileInputStream(file),"UTF-8"));
            String line = reader.readLine();
            while(line != null)    {
                sb.append(line);
                sb.append("\r\n");
                line = reader.readLine();
            }
            reader.close();
        } catch (IOException e) {
            throw new SystemException("Loading template Error:",e);
        }
        return sb.toString();
    }
    public void saveTemplate(String templateName, String templateContent) {
        try {
            File file = new File(templatePath + "/" + templateName);
            Writer out = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(file),"UTF-8"));
            out.write(templateContent);
            out.flush();
            //扔出templatesave事件
            TemplateSaveEvent evt = new TemplateSaveEvent();
            evt.setTemplateName(templateName);
            dispatchTemplateEvent(evt);
        } catch (IOException e) {
            throw new SystemException("Write template Error",e);
        }
    }