当前位置：首页 > news >正文

POI操作Docx的踩坑指南（一）

news 2025/10/5 14:56:13

Java的POI库是Apache软件基金会的一个开源项目，全称为Apache POI（Poor Obfuscation Implementation）。提供了Java操作Microsoft Office格式文件（如Word、Excel、PowerPoint等）的功能。

基本概念

Docx文档主要由文档（doc）、表格（table）、段落（paragraph）、运行（run）组成。

POI中表达对象表格：

中文描述	表达	POI对象
文档	doc	XWPFDocument
表格	table	XWPFTable
单元格	cell	XWPFTableCell
段落	paragraph	XWPFParagraph
段落中的一部分	run	XWPFRun

`XWPFDocument`文档的常用方法

List<XWPFParagraph> getParagraphs()：获取文档中所有的段落，注意表格中的段落不会包含在内。

List<XWPFTable> getTables()：获取文档中所有的表格。

XWPFParagraph createParagraph()：创建一个段落到文档最后。

XWPFParagraph insertNewParagraph(XmlCursor)：插入一个段落到指定光标之前。

void write(OutputStream)：将文档写入到一个输出流中。

`XWPFParagraph`段落的常用方法

XWPFRun createRun()：在段落中创建一个新运行。

List<XWPFRun> getRuns()：获取段落中所有的运行，获取到的运行列表是不可修改的。

String getText()：获取段落的文本内容，包括所有运行的文本。

void setIndentationFirstLine(int indentation)：设置段落的首行缩进。

void setAlignment(ParagraphAlignment align)：设置段落的对齐方式。

void setSpacingBetween(double spacing)：设置段落的多倍行距，注意固定值和多倍行距的设置有区别。

`XWPFRun`运行的常用方法

String text()：获取运行的文本内容。

void setText(String value, int pos)：设置运行的文本内容，pos是可选参数，如果要设置成空字符串，那pos则必须有。

void setFontSize(double size)：设置字体大小。

常用操作

将某一个run替换为空字符串

run.setText("",0);

复制段落字体大小

int fontSize = oldParagraph.getRuns().get(0).getFontSize();
if (fontSize == -1 && oldParagraph.getStyle() != null) {// 从run中没有获取到字体大小XWPFStyle style = oldParagraph.getDocument().getStyles().getStyle(oldParagraph.getStyle());if (style != null && style.getCTStyle().isSetRPr()) {CTHpsMeasure sz = style.getCTStyle().getRPr().getSz();fontSize = sz.getVal().intValue() / 2;}
}
if(fontSize != -1){newParagraph.getRuns().get(0).setFontSize(fontSize);
}

复制段落行高以及段前后间距

// 获取旧段落的CTPPr来操作行高
CTSpacing oldSpacing = oldParagraph.getCTP().getPPr().getSpacing();if (oldSpacing != null) {CTSpacing newSpacing = newParagraph.getCTP().getPPr().isSetSpacing() ?newParagraph.getCTP().getPPr().getSpacing() :newParagraph.getCTP().getPPr().addNewSpacing();// 如果旧段落有固定行高设置，将其复制到新段落if (oldSpacing.isSetLine()) {newSpacing.setLine(oldSpacing.getLine());newSpacing.setLineRule(oldSpacing.getLineRule()); // 确保行高规则也复制}// 复制间距前后设置if (oldSpacing.isSetBefore()) {newSpacing.setBefore(oldSpacing.getBefore());}if (oldSpacing.isSetAfter()) {newSpacing.setAfter(oldSpacing.getAfter());}
}else{newParagraph.setSpacingBetween(oldParagraph.getSpacingBetween());
}