Bucket4j 新增对 MariaDB 的支持

在分布式系统中，限流是一个非常重要的功能。Bucket4j 是一个基于令牌桶算法的 Java 限流库，它提供了多种存储后端支持。最新发布的 8.8.0 版本中，Bucket4j 新增了对 MariaDB 数据库的支持。

背景

MariaDB 是 MySQL 的一个流行分支，在许多生产环境中被广泛使用。虽然 MariaDB 和 MySQL 高度兼容，但在某些细节上还是存在差异。在之前的版本中，Bucket4j 只提供了 MySQL 的支持，用户在使用 MariaDB 时不得不依赖 MySQL 的 JDBC 驱动，这带来了不必要的依赖问题。

技术实现

新的 MariaDB 支持是通过 MariaDbSelectForUpdateBasedProxyManager 类实现的。这个类采用了 SELECT FOR UPDATE 的数据库锁机制来保证分布式环境下的原子性操作。主要特点包括：

1. 事务管理：通过 JDBC 连接实现了完整的事务生命周期管理，包括开始事务、提交、回滚等操作。

2. CRUD 操作：

   • 使用 INSERT IGNORE 语句处理初始记录插入
   • 通过 UPDATE 语句更新令牌桶状态
   • 使用 SELECT FOR UPDATE 获取并锁定记录
   • 提供 DELETE 语句支持删除操作

3. 异常处理：对 SQLException 进行了统一封装，转换为 Bucket4j 自定义异常。

与 MySQL 实现的区别

虽然 MariaDB 实现与 MySQL 实现在功能上相似，但有以下关键改进：

1. 移除了对 MySQL JDBC 驱动的强制依赖
2. 使用了 MariaDB 官方推荐的连接方式
3. 针对 MariaDB 的特性进行了优化

测试保障

为了确保新功能的可靠性，实现中包含了基于 Docker 的集成测试，验证了在各种场景下的正确性，包括并发访问、事务隔离等关键特性。

使用建议

对于已经在使用 MariaDB 的用户，建议升级到 8.8.0 版本以获得更好的兼容性和性能。新用户可以直接使用这个实现来构建基于 MariaDB 的分布式限流方案。

这个新增功能进一步丰富了 Bucket4j 的生态系统，使得在 MariaDB 环境下的限流实现更加简单和可靠。