带有docx4j的Java Word（.docx）文档

几个月前，我需要创建一个包含许多表和段落的动态Word文档。过去，我曾使用POI来实现此目的，但是我发现它很难使用，并且在创建更复杂的文档时对我来说效果不佳。因此，对于这个项目，经过一番搜索，我决定使用docx4j 。 Docx4j，根据他们的网站是：

“ docx4j是一个Java库，用于创建和处理Microsoft Open XML（Word docx，Powerpoint pptx和Excel xlsx）文件。
它类似于Microsoft的OpenXML SDK，但适用于Java。 ”

在本文中，我将向您展示几个示例，您可以使用这些示例来生成Word文档的内容。更具体地说，我们将看以下两个示例：

加载模板Word文档以添加内容并另存为新文档
将段落添加到此模板文档
将表添加到此模板文档

这里的一般方法是首先创建一个Word文档，其中包含最终文档的布局和主要样式。在本文档中，您将需要添加占位符（简单字符串），我们将使用这些占位符来搜索并替换为真实内容。

例如，一个非常基本的模板如下所示：

在本文中，我们将向您展示如何填写此内容，以便获得：

加载模板Word文档以添加内容并另存为新文档

首先是第一件事。让我们创建一个简单的Word文档，将其用作模板。为此，只需打开Word，创建一个新文档并将其另存为template.docx。这是我们用来向其添加内容的单词模板。我们需要做的第一件事是用docx4j加载该文档。您可以使用以下一段Java代码：

private WordprocessingMLPackage getTemplate(String name) throws Docx4JException, FileNotFoundException {WordprocessingMLPackage template = WordprocessingMLPackage.load(new FileInputStream(new File(name)));return template;}

这将返回一个Java对象，该对象表示完整的（此时）空文档。现在，我们可以使用Docx4J API在此Word文档中添加，删除和修改内容。 Docx4J有许多帮助程序类，可用于遍历此文档。我确实写了一些帮助程序，尽管它们确实使查找特定的占位符并将其替换为实际内容变得非常容易。让我们看看其中之一。该操作是对几个JAXB操作的包装，使您可以搜索特定元素及其所有子元素来查找某个类。例如，您可以使用它来获取文档中的所有表，表中的所有行等等。

private static List<Object> getAllElementFromObject(Object obj, Class<?> toSearch) {List<Object> result = new ArrayList<Object>();if (obj instanceof JAXBElement) obj = ((JAXBElement<?>) obj).getValue();if (obj.getClass().equals(toSearch))result.add(obj);else if (obj instanceof ContentAccessor) {List<?> children = ((ContentAccessor) obj).getContent();for (Object child : children) {result.addAll(getAllElementFromObject(child, toSearch));}}return result;}

没什么复杂的，但真的很有帮助。让我们看看如何使用此操作。对于此示例，我们将使用不同的值替换一个简单的文本占位符。例如，这是您用来动态设置文档标题的内容。不过，首先，在您创建的Word模板中添加一个自定义占位符。我将为此使用SJ_EX1。我们将用我们的名字替换这个值。 docx4j中的基本文本元素由org.docx4j.wml.Text类表示。要替换此简单的占位符，我们要做的就是调用此方法：

private void replacePlaceholder(WordprocessingMLPackage template, String name, String placeholder ) {List<Object> texts = getAllElementFromObject(template.getMainDocumentPart(), Text.class);for (Object text : texts) {Text textElement = (Text) text;if (textElement.getValue().equals(placeholder)) {textElement.setValue(name);}}}

这将查找文档中的所有Text元素，并将匹配的元素替换为我们指定的值。现在，我们要做的就是将文档写回到文件中。

private void writeDocxToStream(WordprocessingMLPackage template, String target) throws IOException, Docx4JException {File f = new File(target);template.save(f);}

如您所见，并不难。

通过此设置，我们还可以将更复杂的内容添加到Word文档中。确定如何添加特定内容的最简单方法是查看word文档的XML源代码。这将告诉您需要哪些包装器以及Word如何编组XML。对于下一个示例，我们将研究如何添加完整的段落。

将段落添加到此模板文档

您可能想知道为什么我们需要添加段落？我们已经可以添加文本了，一个段落不只是一大段文本吗？好，是的，不是。一段确实看起来像是一段很大的文本，但是您需要考虑的是换行符。如果像我们之前那样添加Text元素，并在文本中添加换行符，它们将不会显示。需要换行符时，需要创建一个新段落。幸运的是，使用Docx4j也很容易做到这一点。
我们将通过以下步骤进行操作：

从模板中找到要替换的段落
将输入文本分成单独的行
对于每一行，根据模板中的段落创建一个新段落
删除原始段落

我们应该已经拥有的辅助方法不应该太难了。

private void replaceParagraph(String placeholder, String textToAdd, WordprocessingMLPackage template, ContentAccessor addTo) {// 1. get the paragraphList<Object> paragraphs = getAllElementFromObject(template.getMainDocumentPart(), P.class);P toReplace = null;for (Object p : paragraphs) {List<Object> texts = getAllElementFromObject(p, Text.class);for (Object t : texts) {Text content = (Text) t;if (content.getValue().equals(placeholder)) {toReplace = (P) p;break;}}}// we now have the paragraph that contains our placeholder: toReplace// 2. split into seperate linesString as[] = StringUtils.splitPreserveAllTokens(textToAdd, '\n');for (int i = 0; i < as.length; i++) {String ptext = as[i];// 3. copy the found paragraph to keep styling correctP copy = (P) XmlUtils.deepCopy(toReplace);// replace the text elements from the copyList texts = getAllElementFromObject(copy, Text.class);if (texts.size() > 0) {Text textToReplace = (Text) texts.get(0);textToReplace.setValue(ptext);}// add the paragraph to the documentaddTo.getContent().add(copy);}// 4. remove the original one((ContentAccessor)toReplace.getParent()).getContent().remove(toReplace);}

在此方法中，我们用提供的文本替换段落的内容，然后将新段落替换为用addTo指定的参数。

String placeholder = "SJ_EX1";String toAdd = "jos\ndirksen";replaceParagraph(placeholder, toAdd, template, template.getMainDocumentPart());

如果您在Word模板中使用更多内容来运行此程序，则会注意到这些段落将出现在文档的底部。原因是将段落添加回了主文档。如果您希望将段落添加到文档中的特定位置（通常需要这样做），则可以将其包装在1×1无边界表格中。该表被视为段落的父级，可以在此处添加新段落。

将表添加到此模板文档

我想展示的最后一个示例是如何向单词模板添加表格。实际上，更好的描述是如何在Word模板中填充预定义的表格。就像我们对简单的文本和段落所做的一样，我们将替换占位符。对于此示例，向您的Word文档中添加一个简单的表格（您可以随意设置样式）。向此表添加1个哑行，用作内容模板。在代码中，我们将查找该行，将其复制，并将内容替换为来自Java代码的新行，如下所示：

查找包含我们的关键字之一的表
复制用作行模板的行
对于每行数据，根据行模板向表中添加一行
删除原始模板行

与我们在段落中显示的方法相同。首先，让我们看一下如何提供替换数据。对于此示例，我仅提供了一组哈希图，其中包含要替换的占位符的名称和要替换为其的值。我还提供了可在表格行中找到的替换令牌。

Map<String,String> repl1 = new HashMap<String, String>();repl1.put("SJ_FUNCTION", "function1");repl1.put("SJ_DESC", "desc1");repl1.put("SJ_PERIOD", "period1");Map<String,String> repl2 = new HashMap<String,String>();repl2.put("SJ_FUNCTION", "function2");repl2.put("SJ_DESC", "desc2");repl2.put("SJ_PERIOD", "period2");Map<String,String> repl3 = new HashMap<String,String>();repl3.put("SJ_FUNCTION", "function3");repl3.put("SJ_DESC", "desc3");repl3.put("SJ_PERIOD", "period3");replaceTable(new String[]{"SJ_FUNCTION","SJ_DESC","SJ_PERIOD"}, Arrays.asList(repl1,repl2,repl3), template);

现在，这个replaceTable方法是什么样的。

private void replaceTable(String[] placeholders, List<Map<String, String>> textToAdd,WordprocessingMLPackage template) throws Docx4JException, JAXBException {List<Object> tables = getAllElementFromObject(template.getMainDocumentPart(), Tbl.class);// 1. find the tableTbl tempTable = getTemplateTable(tables, placeholders[0]);List<Object> rows = getAllElementFromObject(tempTable, Tr.class);// first row is header, second row is contentif (rows.size() == 2) {// this is our template rowTr templateRow = (Tr) rows.get(1);for (Map<String, String> replacements : textToAdd) {// 2 and 3 are done in this methodaddRowToTable(tempTable, templateRow, replacements);}// 4. remove the template rowtempTable.getContent().remove(templateRow);}}

此方法查找表，获取第一行，并为每个提供的地图在表中添加新行。返回之前，它将删除模板行。此方法使用两个帮助器：addRowToTable和getTemplateTable。我们首先来看最后一个：

private Tbl getTemplateTable(List<Object> tables, String templateKey) throws Docx4JException, JAXBException {for (Iterator<Object> iterator = tables.iterator(); iterator.hasNext();) {Object tbl = iterator.next();List<?> textElements = getAllElementFromObject(tbl, Text.class);for (Object text : textElements) {Text textElement = (Text) text;if (textElement.getValue() != null && textElement.getValue().equals(templateKey))return (Tbl) tbl;}}return null;}

此函数只是查看表是否包含我们的占位符之一。如果是这样，则返回该表。 addRowToTable操作也非常简单。

private static void addRowToTable(Tbl reviewtable, Tr templateRow, Map<String, String> replacements) {Tr workingRow = (Tr) XmlUtils.deepCopy(templateRow);List textElements = getAllElementFromObject(workingRow, Text.class);for (Object object : textElements) {Text text = (Text) object;String replacementValue = (String) replacements.get(text.getValue());if (replacementValue != null)text.setValue(replacementValue);}reviewtable.getContent().add(workingRow);}

此方法复制我们的模板，并使用提供的值替换此模板行中的占位符。该副本将添加到表中。就是这样。通过这段代码，我们可以在Word文档中填写套利表，同时保留表的布局和样式。

到本文为止。使用段落和表格，您可以创建许多不同类型的文档，这与最常生成的文档类型非常匹配。但是，也可以使用这种方法将其他类型的内容添加到Word文档中。

参考：来自Smart Java博客的JCG合作伙伴 Jos Dirksen 使用docx4j以编程方式创建复杂的Word（.docx）文档。