被 Apache POI 折磨三周后，我用 Java 17 封装了一个“米其林级”的 PPT 自动化库

Quaternion
6 阅读3分钟

PotShaper.png

一、 事情的起因 —— 被“火锅”烫到了 🥢

最近尝试进行 PowerPoint 解析 —— 本以为 Apache POI 这种老牌库能轻松搞定，结果一进代码库，我直接掉进了 XML 沼泽：

  • 为了改个字体颜色，我得翻三层底层的 CT 类（XML 对象）。
  • 画个带圆角的矩形，代码多到屏幕装不下。
  • 动画设置？那简直是玄学，全靠在 String 常量里猜参数。

那种感觉，就像是拿着牙签在吃沸腾的火锅（Hot Pot）（好不形象的比喻） ——虽然能吃到，但效率低得想撞墙，还经常被烫伤（报各种低级 XML 异常）。

二、 既然不好用，那就重塑它！🎨

在写完第 1000 行冗余代码后，我决定不再忍受。我利用工作之余，借助 AI ，用 Java 17 快速开发了 PotShaper。

它的核心逻辑很简单：把乱七八糟的底层 XML 彻底封装，给开发者一个“会说话”的 Fluent API。

来看一组残酷的代码对比：

❌ 传统 Apache POI（写到怀疑人生）：

Java

XSLFSlide slide = ppt.createSlide();
XSLFTextBox tb = slide.createTextBox();
tb.setText("这段代码谁写谁麻...");
tb.setAnchor(new Rectangle2D.Double(50, 50, 300, 50));
// 后面还有一大堆关于颜色、字体、对齐的繁杂设置...

✅ 使用 PotShaper（丝般顺滑）：

Java

slide.addTextBox("优雅，真是太优雅了")
    .at(50, 50)
    .size(300, 50)
    .font(PotFont.of("微软雅黑", 24).bold().color(PotColor.BLUE))
    .animate(PotAnimation.fadeIn()); // 一行代码搞定淡入动画

三、 为什么 PotShaper 值得你一个 Star？🌟

我不只是做了一个简单的 Wrapper，而是按照现代工程化的标准去雕琢它：

  1. 链式调用 (Fluent API) ：代码读起来就像在写英语句子，IDE 提示点一下，功能全出来。
  2. 动画引擎 (Motion Engine) ：内置常用动画效果，再也不用去翻 OOXML 的文档。
  3. 强类型检查：摒弃了大量的 Magic String，颜色、形状、对齐方式全部枚举化，编译期就解决 Bug。
  4. 工程质量：90%+ 的测试覆盖率。我还让 AI 写了大量的单元测试来确保它在生产环境的稳定性。
  5. 现代化：原生支持 Java 17+ 特性，完美适配 Maven/Gradle。

四、 快速上手：三分钟生成一份商业报告

先导入：

<dependency>
    <groupId>cc.quaternion</groupId>
    <artifactId>potshaper</artifactId>
    <version>1.0.1</version>
</dependency>

然后 ——

try (PotPresentation ppt = PotPresentation.create()) {
    PotSlide slide = ppt.getSlide(0);
    
    // 添加一个带渐变色的图形，并绑定点击跳转动作
    slide.addShape(PotShapeType.ROUNDED_RECTANGLE)
        .at(100, 150).size(200, 100)
        .fill(PotFill.gradient(PotGradient.linear(90)
            .addStop(0, PotColor.BLUE)
            .addStop(1, PotColor.CYAN)));

    ppt.save("精美的报告.pptx");
}

五、 写在最后

目前 PotShaper 已经在 GitHub 开源（Apache 2.0 协议）并发布在 Maven Center。我非常希望这个项目能让更多被 POI 折磨的 Java 小伙伴“脱离苦海” —— 在IDE中按下 . 的那一瞬间，一切都是那么水到渠成。（更希望大家一起来帮我维护这个小项目（深知一个人的精力有限，POI 的坑也远不止于此）（然后捞捞有兴趣的Collaborators））

如果你觉得这个项目有点意思，或者它刚好能解决你手头的痛点，求一个 GitHub Star ⭐️ 支持一下！

你的每一个 Star 都是我持续更新（尤其是接下来要搞的 3D 效果和图表 API）的最大动力！

评论区互动： 你在用 Apache POI 或其他文档库时，遇到过最离谱的坑是什么？欢迎吐槽！👇

avatar
文章
阅读
粉丝