使用freemarker生成word文档

项目有时候需要将一些内容导出成word格式，实现方式很多种，如：POI导出，freemarker导出。freemarker导出比较简单。

主要分三步：

1. 新建一个word文档
2. 生成模板
3. 动态生成word。

新建一个word文档。

新建一个word文档，把格式和内容定好。如下图：导出内容和导出人两部分，到时候会根据运行时内容替换。

为了方便修改模板，建议写一些文字，否则修改模板的时候，不知道在哪改。

最好不要直接写freemarker标记。word有可能会将${marker}这几个字符分开存储。

生成模板

将填好的模板，保存成xml格式。

用xml编辑工具，记事本即可。将里面导出内容和导出人这两个动态内容换成freemarker模板语言。

改成：

注意编辑工具的字符集一定要和XML字符集一致，否则会造成乱码。

动态生成word内容

java代码：

public class WordHandler {
    private Configuration configuration = null;
    Log logger = LogFactory.getLog(WordHandler.class);

    public WordHandler() {
        configuration = new Configuration();
        configuration.setDefaultEncoding("UTF-8");
    }
    
    private Template getTemplate(String templatePath, String templateName) throws IOException {
        configuration.setClassForTemplateLoading(this.getClass(), templatePath);
        Template t = null;
        t = configuration.getTemplate(templateName);
        t.setEncoding("UTF-8");
        return t;
    }

    
    public void write(String templatePath, String templateName, Map dataMap, Writer out) throws WordHandlerException {
        try {
            Template t = getTemplate(templatePath, templateName);
            t.process(dataMap, out);
        } catch (IOException e) {
            logger.error(e);
            throw new WordHandlerException(e);
        } catch (TemplateException e) {
            logger.error(e);
            throw new WordHandlerException(e);
        } finally {
            try {
                out.close();
            } catch (IOException e) {
                logger.error(e);
                throw new WordHandlerException(e);
            }
        }
    }
}

测试代码：

        Map map = new HashMap();
        map.put("content","这是基于freemarker导出成word格式。包含图片");
        map.put("userName","二土");
        WordHandler handler = new WordHandler();
        Writer out = new OutputStreamWriter(new FileOutputStream("D:\\uploadFiles\\测试.doc"), "UTF-8");
        handler.write("/test/com/sinoprof/tiger/doc", "test.xml", map, out);
    

为了保证生成的正确性，输出流一定要设字符集。

上表的测试代码是生成本地文件。如果是基于servlet的导出，如下表：

ServletOutputStream out = res.getOutputStream();
Writer writer = new OutputStreamWriter(out, "UTF-8");
//其他内容相同

测试结果：

内容被替换，格式保持完好。图片正常。