Aspose.Words简单使用

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 文档	✓	✓
PDF	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 文件	✓	✓

该篇简单介绍了如何下载Aspose.Words的依赖，并实现了一个demo，以及aspose所支持的文件格式，下篇将继续介绍Aspose.Words的各种功能