Java 读取 Word 文本框中的文本和图片：Spire.Doc for Java 实践指南
日常工作中有许多处理Office文档的痛点。尤其是在Java后端，如何高效、准确地从Word文档中提取特定内容，例如文本框中的文本和图片，常常是项目中的一道难题。传统方法往往复杂且容易出错。今天，我将为大家带来一套基于 Spire.Doc for Java 库的解决方案，让你轻松应对这些挑战。
1. 库介绍与安装：Spire.Doc for Java 初探
Spire.Doc for Java 是一个功能强大的Word文档处理库，它允许开发者在Java应用程序中创建、读取、写入、转换和打印Word文档。其最显著的优势在于对Word文档复杂元素（如文本框、表格、图片、批注等）的良好支持，以及对多种Word文档格式（DOC、DOCX、RTF等）的兼容性。相较于其他一些文档处理库，Spire.Doc 在处理复杂布局和嵌入对象方面表现出色。
Maven 依赖配置
要在你的Java项目中使用 Spire.Doc for Java，只需在 pom.xml 文件中添加以下 Maven 依赖：
<repositories><repository><id>com.e-iceblue</id><name>e-iceblue</name><url>https://repo.e-iceblue.cn/repository/maven-public/</url></repository>
</repositories>
<dependencies><dependency><groupId>e-iceblue</groupId><artifactId>spire.doc</artifactId><version>13.10.6</version></dependency>
</dependencies>请确保你使用的是最新稳定版本，可以通过访问 Spire.Doc for Java 官方网站 获取最新版本号。
2. Java 获取 Word 文本框中的文本
Word文档中的文本框（TextBox）是一种特殊的容器，它可以包含文本、图片甚至其他形状。与普通的段落文本不同，文本框的内容通常需要通过特定的API来访问。Spire.Doc for Java 提供了直观的接口来遍历和提取这些内容。
以下是获取Word文档中所有文本框文本的Java代码示例：
import com.spire.doc.*;
import com.spire.doc.documents.Paragraph;
import com.spire.doc.fields.TextBox;
import java.io.BufferedWriter;
import java.io.File;
import java.io.FileWriter;
import java.io.IOException;public class ExtractText {public static void main(String[] args) throws IOException {//加载含有文本框的Word文档Document doc = new Document();doc.loadFromFile("test.docx");//获取文本框TextBox textbox = doc.getTextBoxes().get(0);//保存文本框中的文本到指定文件File file = new File("ExtractedText.txt");if (file.exists()){file.delete();}file.createNewFile();FileWriter fw = new FileWriter(file, true);BufferedWriter bw = new BufferedWriter(fw);//遍历文本框中的对象for (Object object:textbox.getBody().getChildObjects()){//判定是否为文本段落if(object instanceof Paragraph){//获取段落中的文本String text = ((Paragraph) object).getText();//写入文本到txt文档bw.write(text);}}bw.flush();bw.close();fw.close();}
}关键API说明：
- Document: 代表整个Word文档。
- TextBox: 表示Word文档中的一个文本框对象。
- TextBox.getBody(): 获取文本框内部的 TextBody，它是一个独立的文档内容容器，可以包含段落、表格等。
- Paragraph.getText(): 获取段落的纯文本内容。
3. Java 获取 Word 文本框中的图片
文本框不仅可以包含文本，还可以嵌入图片。提取文本框中的图片在某些场景下非常有用，例如内容审核、资产管理等。Spire.Doc for Java 同样提供了便捷的方式来访问这些嵌入的图片。
以下是获取Word文档中所有文本框内图片的Java代码示例：
import com.spire.doc.*;
import com.spire.doc.documents.Paragraph;
import com.spire.doc.fields.DocPicture;
import com.spire.doc.fields.TextBox;
import javax.imageio.ImageIO;
import java.awt.image.RenderedImage;
import java.io.File;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;public class ExtractImg {public static void main(String[] args) throws IOException {//加载含有文本框的Word文档Document doc = new Document();doc.loadFromFile("test.docx");//获取文本框TextBox textbox = doc.getTextBoxes().get(0);//创建List对象List images = new ArrayList();//遍历文本框中所有段落for (int i = 0 ; i < textbox.getBody().getParagraphs().getCount();i++){Paragraph paragraph = textbox.getBody().getParagraphs().get(i);//遍历段落中的所有子对象for (int j = 0; j < paragraph.getChildObjects().getCount(); j++){Object object = paragraph.getChildObjects().get(j);//判定对象是否为图片if (object instanceof DocPicture){//获取图片DocPicture picture = (DocPicture) object;images.add(picture.getImage());}}}//将图片以PNG文件格式保存for (int z = 0; z < images.size(); z++) {File file = new File(String.format("图片-%d.png", z));ImageIO.write((RenderedImage) images.get(z), "PNG", file);}}
}关键API说明：
- DocPicture: 代表Word文档中的一个图片对象。
- DocPicture.getImage(): 获取图片的 BufferedImage 对象，方便后续保存或处理。
- ImageIO.write(): Java标准库方法，用于将 BufferedImage 写入文件。
4. 常见问题与注意事项
在实际的Word文档处理中，可能会遇到各种复杂情况。
- 文本框嵌套与复杂布局： Word文档的灵活性使得文本框可能嵌套在其他形状或表格中，甚至文本框内部又包含其他文本框。上述示例代码主要针对直接嵌入在段落中的文本框。对于更复杂的结构，可能需要递归遍历 Shape 对象或 Table 对象来查找文本框。Spire.Doc 提供了 Shape 和 Table 等API，可以进一步探索。
- 不同Word版本兼容性： Spire.Doc for Java 通常能很好地兼容不同版本的Word文档（如DOC、DOCX）。但偶尔仍可能遇到特定版本或特定创建工具生成的文档出现解析异常，此时建议更新到最新版本的 Spire.Doc 库。
- 图片格式与大小处理： 提取出的 BufferedImage 可以通过 ImageIO 进行进一步处理，如缩放、转换格式等。对于超大图片，需要注意内存消耗问题，可以考虑分块处理或使用流式读取。
- 授权许可问题： Spire.Doc for Java 免费版在处理文档时通常有页数或功能限制（例如，只能处理前几页或文档大小有限制）。对于商业项目或需要处理大量、复杂文档的场景，建议购买其商业授权以获得完整功能和技术支持。在免费版中，有时会在生成或保存的文档中添加水印。
- 性能考虑： 对于非常大的Word文档，遍历所有文档对象可能会消耗较多时间和内存。可以考虑优化遍历逻辑，或者在内存允许的情况下，一次性加载文档后，进行多次查询操作。
总结
通过本文的介绍和示例，相信你已经掌握了如何使用 Spire.Doc for Java 库高效地从Word文档的文本框中提取文本和图片。Spire.Doc 凭借其强大的功能和易用的API，无疑是Java开发中处理Office文档的利器。它不仅解决了日常开发中的痛点，更在文档自动化、内容分析等领域展现出广阔的应用前景。希望这篇文章能帮助你更好地利用Java处理Word文档，快去尝试一下吧！