一个开源的工具类轮子是怎么造出来的

心路历程

为什么要做

在22年9月的某一天,在公司开需求评审时,接到了一个给PDF、图片添加水印的需求。

做为一个刚工作的CURD程序员,在遇到这些问题时,第一反应是去github上找找有没有类似的开源框架。

但是,出乎我意料的是竟然没有一个统一的框架 ,都是各个文件有着各个文件添加水印的框架。并没有一个大一统 的框架。此时就萌生出一个想法了,我能不能写一个呢?

于是EasyWatermark 出现了,在一开始的想法中,框架的主要的作用就是传入一个文件,并设置本次要添加的水印,即可在文件中添加水印内容。

但在开发的途中,却意外连连。

自我怀疑以及坚持下去

从git提交记录可以发现一点端倪,整个仓库的提交时间可以大致的分为三个阶段

  1. 2022年11月:框架初期搭建,自我怀疑期

框架刚搭建时,由于已经在工作上实现了PDF添加水印的功能了,所以能够很快的搭建完初始框架。

但是问题也随之而来了,那个时候我常常在想,这个框架真的有人用嘛,添加水印这么简单的功能,为什么要写一个框架出来呢?

这个时候陷入了深深的怀疑当中,于是乎,开发进度也就停止了下来。

  1. 2023年2月:确定框架入口类

在2月这个时间点,我也忘记了为什么自己又重新开始了框架的开发😂。

但是在这个月中,实际上是没有开发任何框架的功能的,只是在想着框架该如何规划好

  • 项目名称变更:从all-watermark变为easy-watermark
  • 增加框架入口类:参照easy-excel的使用方式进行了开发,创建了EasyWatermark入口类
  • 毫无用处的水印位置计算策略类

写着写着代码,问题又出现了,内部逻辑设计已经规划好了,但是该如何设计简单易用 的API供其他人使用呢?开发进度又双叒叕停滞了。

  1. 以及最近的4月5月

忘记是在4月的哪一天了,在床上刷抖音时看到一个视频,视频的大致内容是两个人,其中一个人让一个男生去做一件事情,一开始这个男生就说不会,做得不好,别让他做。那个人又说,我本来就没想着让你做的多好,你先去试试。于是乎那个男生就去做了,做完之后觉得,自己做的蛮不错的。那个人又说一开始肯定做的不好,但是你一直想着做得不好,就不去做,那永远都不会好。

不要一开始就想要做的多好,重要的是得先开始做,哪怕做的再不好,也好过不去尝试。

正是看了这个视频之后,我又想起了我还有一个开源框架仍在开发中,并且开发这个框架的经历跟视频的差不多,于是乎我又开始完善的我水印框架了。

在最近的两个月中,我重构了大部分代码 ,定义好了四种水印渲染类型 ,定义了一个扩展接口用于用户自定义页面的水印。

说了这么多,简单介绍一下我开发的水印框架吧。

Easy-Watermark

框架功能

抽象了各个文件类型对于添加水印的API,内部提供了多种预设水印类型以供使用,无需二次开发。

快速开始

pom文件中引入依赖

xml 复制代码
<dependency>
    <groupId>org.easywatermark</groupId>
    <artifactId>easy-watermark</artifactId>
    <version>0.0.2</version>
</dependency>

使用水印框架

java 复制代码
byte[] result = EasyWatermark.create()
        .file(fileData)
        .text("Easy-Watermark")
        .execute();

支持文件类型

PDF、图片类型、Office套件文件(仍在开发中)

内置水印类型

  • CUSTOM:自定义水印,使用框架抽象的统一方法,对传入文件的每个页面进行特殊处理
  • CENTER:居中,在页面的各个居中位置上添加。
  • OVERSPREAD:页面铺满,可设置倾斜角度
  • DIAGONAL:页面对角水印

最后

更多的信息可以去到仓库页面查看:https://github.com/AzirZsk/easy-watermark,如果觉得我的框架写的还不错,请帮忙在GitHub点个⭐️Star,你的支持是我开发的动力。

相关推荐
一起养小猫9 分钟前
LeetCode100天Day6-回文数与加一
java·leetcode
张二娃同学14 分钟前
深度学习入门篇——Github的使用和项目的导入
人工智能·git·深度学习·开源·github
FIT2CLOUD飞致云42 分钟前
飞致云开源社区月度动态报告(2025年12月)
开源·飞致云·开源大屏·月度报告
程序员小假44 分钟前
我们来说一下 MySQL 的慢查询日志
java·后端
独自破碎E1 小时前
Java是怎么实现跨平台的?
java·开发语言
To Be Clean Coder1 小时前
【Spring源码】从源码倒看Spring用法(二)
java·后端·spring
xdpcxq10292 小时前
风控场景下超高并发频次计算服务
java·服务器·网络
想用offer打牌2 小时前
你真的懂Thread.currentThread().interrupt()吗?
java·后端·架构
橘色的狸花猫2 小时前
简历与岗位要求相似度分析系统
java·nlp
独自破碎E2 小时前
Leetcode1438绝对值不超过限制的最长连续子数组
java·开发语言·算法