签章缓存定义

约 998 字大约 3 分钟

2026-06-18

概述

在实际开发过程中，我们经常会遇到需要将某种标识型数据缓存一定时间的需求。例如：手机短信验证码、登录错误次数记录等。这一类需求代码实现逻辑除了生成标识数据值的方式（有些可能不需要标识值），基本都是一致的。

为了方便开发，Dante Cloud 将这一需求进行抽象，并提取了一个专门的概念【签章】。

[一]使用方法

开发一个“签章”功能非常简单，编写一类，继承 cn.herodotus.stirrup.cache.jetcache.stamp.AbstractStampManager 抽象类。然后根据自己指定的签章值的类型，指定值的生成策略即可。

示例代码如下，这个示例是 Dante Cloud 中生成手机验证码的源代码：

public class VerificationCodeStampManager extends AbstractStampManager<String, String> {

    private final SmsProperties smsProperties;

    public VerificationCodeStampManager(SmsProperties smsProperties) {
        super(AccessConstants.CACHE_NAME_TOKEN_VERIFICATION_CODE);
        this.smsProperties = smsProperties;
    }


    @Override
    public String nextStamp(String key) {
        if (smsProperties.getSandbox()) {
            return smsProperties.getTestCode();
        } else {
            return RandomUtil.randomNumbers(smsProperties.getLength());
        }
    }

    @Override
    public void afterPropertiesSet() throws Exception {
        super.setExpire(smsProperties.getExpire());
    }

    public Boolean getSandbox() {
        return smsProperties.getSandbox();
    }

    public String getVerificationCodeTemplateId() {
        return smsProperties.getVerificationCodeTemplateId();
    }
}

如果 cn.herodotus.stirrup.cache.jetcache.stamp.AbstractStampManager 不能满足你的需求，您可以选择直接实现 cn.herodotus.stirrup.cache.jetcache.stamp.StampManager 接口，来实现你的逻辑。

[二]缓存方式

Dante Cloud 中的【签章】，是基于 JetCache 缓存组件实现。 Jetcache 支持本地（Caffeine）和远程（Redis）缓存，也支持多级缓存的混用。

在 cn.herodotus.stirrup.cache.jetcache.stamp.AbstractStampManager 默认实现中，使用的是 JetCache 多级缓存模式，即本地和远程都会存储缓存数据，这样就可以很便捷的支持服务多实例的场景。

当然，您也可以根据自己的需求进行调整，例如：只想将数据存储在服务本地，或者只想将数据存储在远程 Redis 中。

想要进行更改也非常方便，仅需要再你的签章实现类中，实现 cn.herodotus.stirrup.cache.jetcache.stamp.AbstractStampManager，类的不同构造函数。


public class MyStampManager extends AbstractStampManager<String,String> {

    public MyStampManager(String cacheName) {
        super(cacheName, CacheType.REMOTE);
    }

    @Override
    public String nextStamp(String key) {
        return "";
    }

    @Override
    public void afterPropertiesSet() throws Exception {

    }
}