Aspose.Words简单使用
简介
Aspose.Words for Java 是一个用于处理和操作 Word 文档的强大 Java 库。本文档提供了使用 Maven 在你的 Java 项目中集成和使用 Aspose.Words 的简单步骤。
安装步骤
1. 配置 Aspose Maven 仓库
在你的 pom.xml 文件中添加以下配置，指定 Aspose Maven 仓库的位置：
<repositories>
<repository>
<id>AsposeJavaAPI</id>
<name>Aspose Java API</name>
<url>https://releases.aspose.com/java/repo/</url>
</repository>
</repositories>
2. 定义 Aspose.Words for Java 依赖
在 pom.xml 中添加 Aspose.Words for Java 的依赖。这个依赖包括了组ID、Artifact ID、版本号以及可选的分类器：
<dependencies>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-words</artifactId>
<version>22.11</version>
<classifier>jdk17</classifier>
</dependency>
<dependency>
<groupId>com.aspose</groupId>
<artifactId>aspose-words</artifactId>
<version>22.11</version>
<classifier>javadoc</classifier>
</dependency>
</dependencies>
确保根据需要调整版本号和分类器。
还有就是直接从aspose官网去下载依赖，适用于需要离线部署的情况
https://releases.aspose.com/java/repo/com/aspose/aspose-words/
安装完毕后，使用官网的第一个的demo
Aspose.Words for Java “Hello, World!” 示例
// 完整示例和数据文件，请访问 https://github.com/aspose-words/Aspose.Words-for-Java.git。
Document docA = new Document();
DocumentBuilder builder = new DocumentBuilder(docA);
// 在文档开头插入文本。
builder.moveToDocumentStart();
builder.write("第一个Hello World段落");
Document docB = new Document(getMyDir() + "Document.docx");
// 将文档B追加到文档A的末尾，保留文档B的格式。
docA.appendDocument(docB, ImportFormatMode.KEEP_SOURCE_FORMATTING);
docA.save(getArtifactsDir() + "HelloWorld.SimpleHelloWorld.pdf");
完整代码
import com.aspose.words.Document;
import com.aspose.words.DocumentBuilder;
import com.aspose.words.ImportFormatMode;
import com.aspose.words.License;
import java.io.InputStream;
public class AsposeTest {
public static void main(String[] args) throws Exception {
//添加证书
ClassLoader loader = Thread.currentThread().getContextClassLoader();
InputStream license = loader.getResourceAsStream("license/Aspose.Total.Java.lic");
License word = new License();
word.setLicense(license);
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
// 完整示例和数据文件，请访问 https://github.com/aspose-words/Aspose.Words-for-Java.git。
Document docA = new Document();
DocumentBuilder builder = new DocumentBuilder(docA);
// Insert text to the document start.
// 在文档开头插入文本。
builder.moveToDocumentStart();
builder.write("First Hello World paragraph");
Document docB = new Document("G:/" + "Document.docx");
// Add document B to the and of document A, preserving document B formatting.
// 将文档B追加到文档A的末尾，保留文档B的格式。
docA.appendDocument(docB, ImportFormatMode.KEEP_SOURCE_FORMATTING);
docA.save("G:/" + "HelloWorld.SimpleHelloWorld.pdf");
}
}
执行后会生成
效果就是生成的pdf开头会有 First Hello World paragraph然后第二页是之前docB的内容
aspose-word支持的文档格式
查看文件格式Wiki以获取有关每种文件格式的更多详细信息。
| 格式 | 描述 | 加载 | 保存 | 备注 |
|---|---|---|---|---|
| DOC | Microsoft Word 97 – 2007 文档 | ✓ | ✓ | |
| DOT | Microsoft Word 97 – 2007 模板 | ✓ | ✓ | |
| DocPreWord60 | 文档采用 Word 6 或 Word 95 格式 | ✓ | ||
| DOCX | Office Open XML WordprocessingML 文档（无宏） | ✓ | ✓ | |
| DOCM | Office Open XML WordprocessingML 启用宏的文档 | ✓ | ✓ | |
| DOTX | Office Open XML WordprocessingML 模板（无宏） | ✓ | ✓ | |
| DOTM | Office Open XML WordprocessingML 启用宏的模板 | ✓ | ✓ | |
| XLSX | 表示电子表格的基于 XML 的文件格式 | ✓ | ||
| FlatOpc | Office Open XML WordprocessingML 存储在平面 XML 文件中 | ✓ | ✓ | |
| FlatOpcMacroEnabled | Office Open XML WordprocessingML 启用宏的文档，存储在平面 XML 文件中 | ✓ | ✓ | |
| FlatOpcTemplate | Office Open XML WordprocessingML 模板（无宏），存储在平面 XML 文件中 | ✓ | ✓ | |
| FlatOpcTemplateMacroEnabled | Office Open XML WordprocessingML 启用宏的模板，存储在平面 XML 文件中 | ✓ | ✓ | |
| XML | XML 文档 | ✓ | ||
| RTF | RTF 格式 | ✓ | ✓ | |
| WordML | Microsoft Word 2003 WordprocessingML 格式 | ✓ | ✓ | |
| HTML | HTML 或 XHTML 格式 | ✓ | ✓ | |
| MHTML | MHTML（Web 存档）格式 | ✓ | ✓ | |
| MOBI | MOBI 是由 MobiPocket Reader 和 Amazon Kindle Readers 使用的 eBook 格式 | ✓ | ✓ | |
| AZW3 | AZW3 是由 Amazon Kindle Readers 使用的 eBook 格式 | ✓ | ✓ | |
| CHM | CHM（编译的 HTML 帮助）格式 | ✓ | ||
| ODT | ODF 文本文档 | ✓ | ✓ | |
| OTT | ODF 文本文档模板 | ✓ | ✓ | |
| TXT | 纯文本 | ✓ | ✓ | |
| MD | Markdown 文档 | ✓ | ✓ | |
| Adobe 可移植文档格式 | ✓ | |||
| EPS | 封装的 Postscript 文件格式 | ✓ | ||
| XPS | 以 XPS（XML Paper Specification）格式保存文档 | ✓ | ||
| XamlFixed | 将文档保存为 Extensible Application Markup Language (XAML) 格式，作为固定文档 | ✓ | ||
| SVG | 将文档保存为可缩放矢量图形（Scalable Vector Graphics）格式 | ✓ | ||
| HtmlFixed | 将文档保存为 HTML 格式，使用绝对定位元素 | ✓ | ||
| OpenXps | 将文档保存为 OpenXPS（Ecma-388）格式 | ✓ | ||
| PS | 将文档保存为 PostScript 格式 | ✓ | ||
| PCL | 将文档保存为 PCL（打印机控制语言）格式 | ✓ | ||
| EPUB | IDPF EPUB 格式 | ✓ | ✓ | |
| XamlFlow (Beta) | 将文档保存为 Extensible Application Markup Language (XAML) 格式，作为流文档 | ✓ | ||
| XamlFlowPack (Beta) | 将文档保存为 Extensible Application Markup Language (XAML) 封装格式，作为流文档 | ✓ | ||
| TIFF | 渲染文档的一个或多个页面，并将它们保存为单页或多页 TIFF 文件 | ✓ | ✓ | |
| PNG | 渲染文档的一个页面并将其保存为 PNG 文件 | ✓ | ✓ | |
| BMP | 渲染文档的一个页面并将其保存为 BMP 文件 | ✓ | ✓ | |
| EMF | 渲染文档的一个页面并将其保存为矢量 EMF（增强型图元文件）文件 | ✓ | ✓ | |
| JPEG | 渲染文档的一个页面并将其保存为 JPEG 文件 | ✓ | ✓ | |
| GIF | 渲染文档的一个页面并将其保存为 GIF 文件 | ✓ | ✓ |
