Bucket4j 8.10.1版本新增Hazelcast灵活过期策略支持

Bucket4j是一个流行的Java限流库，它提供了多种分布式存储后端的支持。在最新的8.10.1版本中，Bucket4j为Hazelcast后端添加了灵活的键值过期策略功能，使其与Redis后端的功能保持一致。

背景

在分布式限流场景中，Bucket4j需要将令牌桶的状态存储在分布式缓存中。对于不同的存储后端，Bucket4j提供了相应的ProxyManager实现。在之前的版本中，Redis后端的AbstractRedisProxyManagerBuilder已经提供了withExpirationStrategy方法，允许开发者灵活配置键的过期策略，但在Hazelcast后端中这一功能是缺失的。

新特性详解

8.10.1版本为HazelcastProxyManager添加了与Redis相同的过期策略支持。这一功能是通过以下方式实现的：

1. 在HazelcastEntryProcessor中，将java.util.Map.Entry转换为com.hazelcast.map.ExtendedMapEntry
2. 复制Redis后端的过期逻辑到Hazelcast实现中
3. 提供统一的API接口，使不同后端的配置方式保持一致

使用示例

开发者现在可以像下面这样配置Hazelcast后端的过期策略：

HazelcastProxyManager.builder()
    .withExpirationStrategy(ExpirationAfterWriteStrategy.basedOnTimeForRefillingBucketUpToMax(
        Duration.ofDays(1)
    ))
    .build(hazelcastInstance, "rateLimits");

这与Redis后端的配置方式完全一致，提供了良好的API一致性。

技术实现细节

在底层实现上，Bucket4j利用了Hazelcast的ExtendedMapEntry接口来设置每个条目的生存时间(TTL)。这种方式比全局配置Map的过期策略更加灵活，允许根据每个令牌桶的实际使用情况来动态管理其生命周期。

版本兼容性

这一特性从Bucket4j 8.10.1版本开始提供，需要Hazelcast 4.x或更高版本的支持。开发者可以放心升级，因为这一改动是完全向后兼容的，不会影响现有的功能。

总结

Bucket4j 8.10.1版本为Hazelcast后端添加的灵活过期策略支持，使得开发者在使用Hazelcast作为分布式缓存时，能够更精细地控制限流数据的生命周期，减少不必要的内存占用。这一改进使得Bucket4j对不同存储后端的支持更加一致，提升了开发体验。