快速开始

3 分钟把第一个文档转成 PDF。

环境要求

• JDK 17+（Officia 以 Java 17 为基线）
• Maven 或 Gradle

1. 引入依赖

引入聚合包 officia-all 即获得全部能力（对标 hutool-all）：

Maven

<dependency>
  <groupId>plus.ruoyi</groupId>
  <artifactId>officia-all</artifactId>
  <version>1.0.0</version>
</dependency>

Gradle

implementation 'plus.ruoyi:officia-all:1.0.0'

只需要单个能力时也可单独引入对应模块（如 officia-pdf、officia-barcode）。多数场景直接用 officia-all 最省心。

2. 第一个 PDF

import plus.ruoyi.officia.words.OfficiaWords;
import java.nio.file.Files;
import java.nio.file.Path;

public class Demo {
    public static void main(String[] args) throws Exception {
        byte[] docx = Files.readAllBytes(Path.of("hello.docx"));
        byte[] pdf  = OfficiaWords.toPdf(docx);          // Word → PDF
        Files.write(Path.of("hello.pdf"), pdf);
        System.out.println("生成成功，大小 " + pdf.length + " 字节");
    }
}

运行后得到 hello.pdf。若未加载授权，输出会带评估水印并限制页数 —— 这是正常的评估态。

3. 加载授权（可选，去水印）

购买后你会得到一个 officia.lic 文件。放到约定位置即可，零代码自动加载：

• 放进 classpath：src/main/resources/officia.lic
• 或放工作目录：./officia.lic
• 或设环境变量：OFFICIA_LICENSE=<路径或令牌>

Officia 首次使用能力时自动查找并离线验签，加载成功即去除水印、解锁全部授权模块。详见 授权与加载。

4. 更多能力

// Excel → PDF
byte[] pdf = OfficiaCells.toPdf(Files.readAllBytes(Path.of("report.xlsx")));

// 合并多个 PDF
byte[] merged = OfficiaPdf.merge(List.of(pdfA, pdfB));

// 生成二维码 PNG
byte[] qr = OfficiaBarCode.qrPng("https://officia.ruoyi.plus");

// PDF 加 AES-256 加密
byte[] enc = OfficiaPdf.encryptAes256(pdf, "openpwd", "ownerpwd");

每个模块的完整方法见左侧「能力模块」。