Java 对Word文件的生成（基于Apache POI）

Java 对Word文件的生成（基于Apache POI）

Apache POI 是一个开源的跨平台的对Microsoft Office格式档案具有读和写功能工具。
在Github上有一个开源的Word模版引擎poi-tl ,这个模版引擎是基于Apache POI。主要是为了解决下面的问题：

• java操作word使用apache poi的复杂性
• 使用freemarker，转化为xml操作word的难度
• 依赖服务器上安装软件openoffice来调用转化
• 依赖windows的word lib库，不具有跨平台性

注意！
HSSF － 提供读写Microsoft Excel XLS格式档案的功能。（*.doc），HWPFDocument类
XSSF － 提供读写Microsoft Excel OOXML XLSX格式档案的功能。(*.docx)，XWPFDocument类
因为这个模版引擎是只使用XWPFDocument类，所以只对*.docx文档生效。

poi-tl demo

调用方法

/*
* datas 是你要渲染的数据
* datas 可以是JavaBean，也可以是Map
*/
XWPFTemplate template = XWPFTemplate.compile("~/file.docx").render(datas);

除了传入模版文件路径，还可以传入模版文件输入流

public static XWPFTemplate compile(InputStream inputStream) {
    .....
    }

datas TO Map

看看数据类转Map的实现

private static Map convert2Map(Object dataSrouce) {
        Map ret = new HashMap();
        try {
            Class clazz = dataSrouce.getClass();
            while (clazz != Object.class) {
                Field[] fields = clazz.getDeclaredFields();
                PropertyDescriptor pd = null;
                for (Field f : fields) {
                    pd = new PropertyDescriptor(f.getName(), dataSrouce.getClass());
                    Name annotation = f.getAnnotation(Name.class);
                    Object value = pd.getReadMethod().invoke(dataSrouce);
                    ret.put(null == annotation ? f.getName() : annotation.value(), value);
                }
                clazz = clazz.getSuperclass();
            }
        } catch (Exception e) {
            logger.error("Convert datasource failed.", e);
            throw new RenderException("Convert datasource failed.");
        }
        return ret;
    }
    

利用反射，把datas类和它的父类的字段属性转成Map,Object除外。所以我们传的参数是JavaBean或Map就可以了（传Map参数，会调用同名的的重载方法）。

语法

普通文本

渲染数据为String或者TextRenderData

模版文件中使用：{{template}}

...
Map datas = new HashMap();
datas.put("template", "我是渲染的数据");
// 参数1：颜色 9d55b8；参数2：文本内容
datas.put("title", new TextRenderData("9d55b8", "Deeply in love with the things you love,\n just deepoove."));

...         

• 文本中可用\n 来进行换行

图片

渲染数据为：PictureRenderData

模版文件中使用：{{@picture}}

/*
* 参数1：宽度；参数2：高度；参数3：图片路径
*/
datas.put("picture", new PictureRenderData(100, 120, "src/test/resources/logo.png"));

表格

渲染数据为：TableRenderData

模版文件中使用：{{#table}}

/**
     * @param headers 表格头
     * @param datas 表格数据
     * @param noDatadesc 没有数据显示的文案
     * @param width 宽度
     */
    public TableRenderData(List headers, List