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
语法
普通文本
渲染数据为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
// 有表格头 有数据
datas.put("table", new TableRenderData(new ArrayList() {
{
add(new TextRenderData("1E915D", "province"));
add(new TextRenderData("1E915D", "city"));
}
}, new ArrayList
如果没有数据,表格会显示“no datas”
更加详细的请参考:poi-tl处理Word表格(Table)的最佳实践
列表
渲染数据为:NumbericRenderData
模版文件中使用:{{numbering}}*
/**
* @param numFmt 编号字符
* @param fmtStyle 编号样式
* @param numbers 列表内容
*/
public NumbericRenderData(Pair numFmt, Style fmtStyle, List numbers) {
this.numFmt = numFmt;
this.numbers = numbers;
this.fmtStyle = fmtStyle;
}
datas.put("unorderlist", new NumbericRenderData(new ArrayList(){{
add(new TextRenderData("Deeply in love with the things you love, just deepoove."));
add(new TextRenderData("Deeply in love with the things you love, just deepoove."));
add(new TextRenderData("Deeply in love with the things you love, just deepoove."));
}}));
datas.put("orderlist", new NumbericRenderData(NumbericRenderData.FMT_DECIMAL, new ArrayList(){{
add(new TextRenderData("Deeply in love with the things you love, just deepoove."));
add(new TextRenderData("Deeply in love with the things you love, just deepoove."));
add(new TextRenderData("Deeply in love with the things you love, just deepoove."));
}}));
NumbericRenderData类中有编号的符号常量
/**
* 1. 2. 3.
*/
public static final Pair FMT_DECIMAL = Pair.of(STNumberFormat.DECIMAL, "%1.");
/**
* 1) 2) 3)
*/
public static final Pair FMT_DECIMAL_PARENTHESES = Pair.of(STNumberFormat.DECIMAL,
"%1)");
/**
* ● ● ●
*/
public static final Pair FMT_BULLET = Pair.of(STNumberFormat.BULLET, "●");
/**
* a. b. c.
*/
public static final Pair FMT_LOWER_LETTER = Pair.of(STNumberFormat.LOWER_LETTER,
"%1.");
/**
* i ⅱ ⅲ
*/
public static final Pair FMT_LOWER_ROMAN = Pair.of(STNumberFormat.LOWER_ROMAN,
"%1.");
/**
* A. B. C.
*/
public static final Pair FMT_UPPER_LETTER = Pair.of(STNumberFormat.UPPER_LETTER,
"%1.");
/**
* Ⅰ Ⅱ Ⅲ
*/
public static final Pair FMT_UPPER_ROMAN = Pair.of(STNumberFormat.UPPER_ROMAN,
"%1.");
样式
Style类
主要样式如下:
- 颜色
- 字体
- 字号
- 粗体
- 斜体
- 删除线
public class Style {
//颜色
private String color;
//字体
private String fontFamily;
//字号
private int fontSize;
//粗体
private Boolean isBold;
//斜体
private Boolean isItalic;
//删除线
private Boolean isStrike;
public Style() {
}
public Style(String color) {
this.color = color;
}
public Style(String fontFamily, int fontSize) {
this.fontFamily = fontFamily;
this.fontSize = fontSize;
}
......
}
poi-tl 的 Change log
v1.2.0 2017-10-12
- 新增api:
XWPFTemplate compile(InputStream inputStream)
- 不兼容升级:文本模板换行符由原先的\\n替换成更符合语言的\n
v1.1.0 2017-09-15
- 修复老版本office打开表格模板时出错
- 新增列表字符样式:设置编号颜色、字体、粗体、斜体等
v1.0.0
- 以插件的思想进行了重新设计
- 高度扩展性:语法即插件,像新增插件一样新增语法
- 新增工具类BytePictureUtils,便于操作图片的byte[]数据
- 新增Annotation @Name
- NiceXWPFDocument新增插入段落insertNewParagraph方法
- 新增代码生成工具类CodeGenUtils
V0.0.5
- bugfix: 解决0.0.4版本解析模板时CTSignedTwips类加载不到的问题
- new feature: 新增列表语法*,支持对有序列表和无序列表的插入
V0.0.4
- 增加新的api:XWPFTemplate.compile
- 渲染数据除了支持Map以外,还支持JavaBean渲染
- 升级poi组件至最新版本3.16
V0.0.3
- 新增表单语法#
- 支持表单插入
- 渲染器支持对table动态处理DynamicTableRenderPolicy
- 支持单元格的合并
- 丰富文本样式
Office Open XML -- OOXML
为了让微软的office用其他软件打开不会出现错乱的问题,所以出现了docx格式的文档(xlsx,pptx也是)。微软的OOXML文档格式已被批准为全球行业标准。
如果要了解比apache poi 更低层的ooxml,可以访问office open xml
在office open xml网站里,你会知道文件是怎样实现的,颜色、字体、粗体等是怎么设置的。
docx 文档转成xml后,普通文本就是这个样子的:
我是文本
设置文本为粗体:
我是文本
基本所有的属性,在office open xml都有详细的解析。
Word文档生成目录问题
我一直在找POI生成目录的方法,Jacob可以实现。如果你知道,麻烦告诉我!谢谢